ibexa

Path

ez publish / technical manual / 3.9 / installation / normal installation / installing ez publish on a...


Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.

Installing eZ publish on a Linux/UNIX based system

The requirements for doing a normal installation must be met. Read the previous section if you're not sure about the requirements. Proceed only if you have access to a UNIX based environment with Apache, PHP, MySQL or PostgreSQL already installed and running. (Note that PHP 5 should not be used.) As mentioned earlier, the database server may run on a different computer than the web server. This section will guide you through the following steps:

  • Setting up a database (MySQL or PostgreSQL)
  • Downloading eZ Publish
  • Unpacking eZ Publish
  • Initiating the setup wizard

Setting up a database

A database must be created before the initiation of the setup wizard takes place. The following text explains how to set up a database using either MySQL or PostgreSQL.

MySQL

  1. Login as root:

    $ mysql -u <mysql_username> -p<mysql_password>
    

     

    The MySQL client should display a "mysql>" prompt.

  2. Create a new database:
    mysql> create database <database> character set <character_set>;
    
  3. Grant access permissions:
    mysql> grant all on <database>.* to <username>@<host> identified by '<password>';
    

mysql_username

The MySQL user (if no user is set up, use "root").

mysql_password

The password that belongs to the mysql_username.

username

The username that will be used to access the database.

password

The password you wish to set in order to limit access to the database.

database

The name of the database, for example "my_new_database".

host

The hostname of the server on which eZ Publish will be running. (may be "localhost" if MySQL is installed on the same server).

character_set

The character encoding scheme to be used in the database.

PostgreSQL

  1. Become the PostgreSQL super user (normally called postgres):
    $ su <postgres_super_user>
    
  2. Create a PostgreSQL user:
    $ createuser <username>
    
  3. Create a database:
    $ createdb -E <encoding> <database>
    
  4. Import the "pgcrypto" module into the database:
    $ psql <database> < /usr/share/pgsql/contrib/pgcrypto.sql
    

username

The username that will be used to access the database.

database

The name of the database, for example "my_new_database".

encoding

The character encoding scheme to be used in the database.

Downloading eZ Publish

The latest stable version of eZ Publish can be downloaded from http://ez.no/download/ez_publish.

Unpacking eZ Publish

Use your favorite tool to unpack the downloaded eZ Publish distribution to a web-served directory (a directory that is reachable using a web browser). The following example shows how to do this using the tar utility (to unpack a tar.gz file, assuming that the "tar" and the "gzip" utilities are installed on the system):

$ tar zxvf ezpublish-<version_number>.tar.gz -C <web_served_directory>

version_number

The version number of eZ Publish that was downloaded.

web_served_directory

Full path to a directory that is served by the web server. This can be the path to the document root of the web server, or a personal web-directory (usually called "public_html" or "www", and located inside a user's home directory).

The extraction utility will unpack eZ Publish into a subdirectory called "ezpublish-3.x.x". Feel free to rename this directory to something more meaningful, for example "my_site".

Initiating the setup wizard

The setup wizard can be started using a web browser immediately after the previous steps (described in this section) are completed. It will be automatically run the first time someone tries to access/browse the index.php file located in the eZ Publish directory. Let's assume that we are using a server with the hostname "www.example.com" and that after unpacking, the eZ Publish directory was renamed to "my_site".

Document root example

If eZ Publish was unpacked into a directory called "my_site" under the document root, the setup wizard can be initiated by browsing the following URL: http://www.example.com/my_site/index.php.

Home directory example

If eZ Publish was unpacked to a web-served directory located inside the home directory of a user with the username "peter", (usually called "public_html", "www", "http", "html" or "web"), the setup wizard can be initiated by browsing the following URL: http://www.example.com/~peter/my_site/index.php.

Refer to "The setup wizard" section for a detailed description of the web based setup wizard.

Balazs Halasy (13/01/2005 10:25 am)

Svitlana Shatokhina (10/01/2008 11:41 am)

Svitlana Shatokhina, Julia Shymova


Comments

  • Setup wizard, memoy_limit issue

    Hi.

    I have question regarding eZ setup wizard. I am using a webhost with linux and Apache 1.3 and php 4. Now, I just finished uploading the eZ publish 3.8.4 and start the setup wizard. The "finetune" shows up, I click on it and following message (short version):

    1.PHP safe mode is enable
    2.File uploading is not possible

    I try to fix this issues, but nothing helps. I Ignore this and continiue finishing the wizard. But when I access the user_site, following occures:

    A login shows up and I have to write admin username and password.
    Also I cannot acces the admin_site, it says something like: ez publish.. fatal error..

    I'm stuck! Need help. I have tried this a couple of times and same problem occures.
    I know, to run the wizard the memory_limit has to be 64MB. I only have 16MB. Is it still possible ?

    Or is there other alternative to configure ez publish ?
  • User permissions/groups (Linux)

    If you change the owner of the var directory to nobody or apache (the webserver), you may want to add account user to that group. This allows you to edit those files through SSH, without being root.
  • Command line to create new database on MYSQL 5

    Hello,

    For example to create database on MySQL 5 debian with utf8 support, I use :
    create database <name_of_database> default character set utf8 collate utf8_general_ci;
    
  • error installing

    Hello,
    I just uploaded everything and tried to see the wizard from my http://www.domain.com/web/index.php but I actually recieve this error:

    Parse error: syntax error, unexpected ',', expecting '(' in /home/cdecc/public_html/web/index.php on line 111

    Any idea?

    Thanks

    fabianlujan@gmail.com
    • Re: error installing

      Hello Fabian! Looks like you're using wrong PHP version (check the requirements for your eZ Publish version). Next time, please post such questions to http://ez.no/developer/forum. Thank you!