Install eZ publish 3 using installers

• Install eZ publish 3 using installers
• Windows installer
• Linux installer
• FreeBSD installer
• Security

There are basically four ways of installing eZ publish 3. You can use one of the supplied installer packages, which will install Apache, PHP, MySQL, ImageMagick and set up everything needed to get eZ publish up and running. Another option is to use the eZ publish sources and follow the setup wizard which will guide you through the steps of configuring your system for eZ publish. If you are little more experienced you can disable the setup wizard and configure eZ publish 3 from scratch following the installation manual. If you don't want to install eZ publish 3 yourself you can always hire eZ systems to install the software for you. You can also buy a ready hosted eZ publish 3 solution.

The installers are designed as a quick way to get eZ publish up and running for testing purposes. If you plan on using eZ publish for more than just testing, we recommend you install it manually, either by letting the setup guide do the configuration or by configuring eZ publish by hand.

Install eZ publish 3 using installers

The installers will install the required software for running eZ publish 3 on your platform. You will get Apache, PHP, MySQL and ImageMagick. If you don't want this software installed automatically, we recommend that you do not use the installers, and install eZ publish 3 manually.

Windows installer

1. Go to http://ez.no/developer/download
2. Find the Windows installer matching your Windows version.
3. Download the installer to your hard drive.
4. Double click on the downloaded file and follow the instructions. Choose demo data if you want to see an example of how to use eZ publish.
5. Now the installation will start. This can take a few minutes.
6. When the installation is done, you need to start eZ publish by clicking on the eZ publish icon on the desktop. This will open eZ publish in your default browser. eZ publish will open at the User site. To start the Admin site simply write /admin at the end of the URL. Log in with admin as user name, and publish as password.
7. You are now ready to start using eZ publish.

Note: If you have anything listening on the same port as Apache (80) or MySQL (3306) you need to shut those services down. Apache and MySQL won't start if port 80 or 3306 are in use.

Linux installer

1. Open your web browser and go to http://ez.no/download
2. Find the Linux installer matching your distribution. These installers are tested on Redhat Linux, but will probably work fine on several other distributions as well.
3. Become root by running

    $ su - 

   Note: it is important that you run "su -", and not "su". The installer needs to have system variables for the root user.

4. Unpack the downloaded file

    # tar xvfz ezpublish-3.0-xxx-x-Linux-xxx.i386.tar.gz

   Replace ezpublish-3.0-xxx-x-Linux-xxx.i386.tar.gz with your current version.
5. Enter the extracted directory

    # cd ezpublish-3.0-xxx-x-Linux-xxx.i386 

6. Run the installation program

    # ./install.sh

7. Choose "install eZ publish" and press Enter
8. If you only have one network card press enter on the question on "What is your internal network card". If you have more than one card enter the name of the network device connected to your network.
9. Enter port number for the user demo site, press enter for default port (1337)
10. Enter port number for the admin site, press enter for default port (1338). Check for installation of demo data if you want this. If not you will get a clean setup. Clean setup is useful when starting to develop a new site. The demo data is useful for testing the system.
11. You will get a report of what's installed.
12. "OK" to quit

Installation of eZ publish 3 is now done. You can access the demo site at: http://localhost:1337 and the default admin site at http://localhost:1338

FreeBSD installer

1. Open your web browser and go to http://ez.no/download
2. Find the FreeBSD installer. This installer is tested on FreeBSD 4.6.2, but should work on other versions of FreeBSD as well.
3. Become root by running:

    $ su - 

   Note: it is important that you run "su -", and not "su". The installer needs to have system variables for the root user.

4. Unpack the downloaded file

    # tar xvfz ezpublish-3.0-xxx-x-FreeBSD-STABLE.i386.tar.gz

   Replace ezpublish-3.0-xxx-x-FreeBSD-STABLE.i386.tar.gz with your current version.
5. Enter the extracted directory

    # cd ezpublish-3.0-xxx-x-FreeBSD-STABLE.i386

6. Run the installation program:

    # ./install.sh

   Note: The FreeBSD Installer requires bash to be located under /usr/local/bin. If you do not have bash installed please refer to the FreeBSD Handbook for more help on installing bash.

7. Choose "install eZ publish 3" and press Enter
8. Enter the device name of your network card. You can find the name of your network card by running "ldconfig".
9. Enter port number for the user demo site, press enter for default port (1337).
10. Enter port number for the admin site, press enter for default port (1338). Check for installation of demo data if you want this. If not you will get a clean setup. Clean setup is useful when starting to develop a new site. The demo data is useful for testing the system.
11. You will get a report of what's installed.
12. "OK" to quit

Installation of eZ publish 3 is now done. You can access the demo site at: http://localhost:1337 and the default admin site at http://localhost:1338

Security

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