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>';
   

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
   

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>

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.