The requirements for doing a normal installation must be met! Please read the "Requirements for doing a normal installation" section first. Proceed only if you have access to a Windows based system with Apache, PHP, MySQL already installed and running. (Do not use Apache 2.x for Windows and PHP 5.x. Please note that eZ publish is supposed to work with PostgreSQL as well although this combination is not tested on Windows.) 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 MySQL database
• Downloading eZ publish
• Unpacking eZ publish
• Initiating the setup wizard

Setting up a MySQL 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 MySQL:

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

Downloading eZ publish

The latest stable version of eZ publish can be downloaded from http://ez.no/download/ez_publish. Windows users should download the ".zip" archive.

Unpacking eZ publish

Use your favorite utility to unpack the downloaded eZ publish archive to a web-served directory (a directory that is reachable using a web browser). 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.