Installing eZ publish on a Linux/UNIX based system

The requirements for doing a normal installation must be met. Please 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. (Please note that PHP 4.4, 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

Create a new database:

mysql> create database <database> character set <character_set>;

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

Become the PostgreSQL super user (normally called postgres):
```
$ su <postgres_super_user>
```
Create a PostgreSQL user:
```
$ createuser <username>
```
Create a database:
```
$ createdb -E <encoding> <database>
```

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.

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

Path

Table of contents