Install eZ publish 3 using the setup guide

• Requirements
• Installation on Linux, FreeBSD and Mac OS X
• Database setup
• Starting the setup guide
• Installation on Windows
• Database setup
• Starting the setup guide
• Security

eZ publish 3 requirements

You need to have Apache and PHP, and MySQL or PostgreSQL, installed to run eZ publish 3. PHP needs to have compiled-in support for either MySQL or PostgreSQL. For image conversion support you need to have GD compiled in PHP or ImageMagick installed on your system.

• PHP >= 4.2.3
  http://www.php.net
• Apache 1.3 (apache 2.0 works, but it is not well tested)
  http://www.apache.org
• Either MySQL or PostgreSQL
  http://www.mysql.org
  http://www.postgresql.org
• ImageMagick and/or GD compiled in PHP for image conversion and scaling (not required)
  http://www.imagemagick.org

The installation processes for the above programs are very well documented on their respective home pages, so we will not include that here.

Using the setup guide on Linux, FreeBSD and Mac OS X

Database setup

We need to login, create a new database, grant permissions to a user and insert a database. If you already have a database with correct permissions, then the setup guide can use that database. If not, you must create it yourself:

MySQL

1.  $ mysql -u root -p <password>

2. You should now have a "mysql>" prompt, create a new database

    mysql> create database <name_of_database>

3. Grant permissions (This will also create the user)

    mysql> grant all on <name_of_database>.* to <user>@localhost
   	identified by '<password>';

PostgreSQL

1. Become the PostgreSQL super user (normally called postgres)

   $ su <postgres_super_user>

2. Create a postgresql user

   $ createuser <user>

3. Create a database

   $ createdb <name_of_database>

Starting the setup guide

1. Make sure you have met the eZ publish requirements
2. Go to http://ez.no/developer/download and download the latest release of eZ publish
3. Extract the downloaded eZ publish file somewhere on Apache's DocumentRoot

    $ tar xvfz ezpublish-xxx.tar.gz -C <apache_document_root>

   and rename it to something nice like 'ezpublish'
4. Open a browser and enter the url for your eZ publish installation
5. Follow the setup guide instructions
6. When you have finished the setup guide you should be able to login on the admin page with 'admin' as username and 'publish' as password. If you installed demo data append '/demo' to the URL, if not append '/user' to view the user site.

See the site access section for more info on changing the way you access the user/admin site.

Note: The setup guide creates a new settings/site.ini.php which overrides the default settings/site.ini

Using the setup guide on Windows

Database setup

MySQL

We need to login, create a new database, grant permissions to a user and insert a database.

1. Open a console window (start->run->cmd.exe or start->run->command.exe depending on the Windows version)
2. Go to your the location of mysql and find the mysql.exe file (should be under bin\)
3. Run

   mysql.exe -u root -p <your_mysql_password>

4. You should now have a mysql> prompt. Type these mysql statements

   mysql> create database <name_of_database>;

5. Grant permissions (This will also create the user)

    mysql> grant all on .* to <user>@localhost identified
   	by '<password>';

Starting the setup guide

1. Make sure you have met the eZ publish requirements
2. Go to http://ez.no/developer/download and download the latest release of eZ publish
3. Extract the downloaded eZ publish file somewhere on Apache's DocumentRoot and rename it to something nice like 'ezpublish'
4. Open a browser and enter the url for your eZ publish installation
5. Follow the setup guide instructions
6. When you have finished the setup guide you should be able to login on the admin page with 'admin' as username and 'publish' as password. If you installed demo data append '/demo' to the URL, if not append '/user' to view the user site.

See the site access section for more info on changing the way you access the user/admin site.

Note: The setup guide creates a new settings/site.ini.php which overrides the default settings/site.ini

Security

It's important that steps are taken to secure the site, more information on this can be read at Securing the site