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

eZ publish 3 requirements

You need to have Apache, MySQL, ImageMagick and PHP 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.1.x
  http://www.php.net
• Apache 1.3 (apache 2.0 might/might not work)
  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 process for the above programs are very well documented on their homepage, so we will not include that here.

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

Database setup

MySQL

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

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

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

PosgreSQL

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

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/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

    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/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