ibexa

Path

ez publish / technical manual / 3.8 / installation / automated installation / automated installation of e...


Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.

Automated installation of eZ publish

The requirements for doing an automated installation must be met. Please read the previous section if you're not sure about the requirements. This section will guide you through the following steps:

  • Setting up a database (MySQL or PostgreSQL)
  • Downloading eZ publish
  • Unpacking eZ publish
  • Configuring the kickstart system
  • Starting the installation by initiating the web based setup wizard

Depending on the target system, please refer to either "Installing eZ publish on a Linux/UNIX based system" or "Installing eZ publish on Windows" for information about the first three steps (database setup, download and unpacking). The rest of the steps are explained below.

Configuring the kickstart system

The behavior of the automated installation is controlled by the "kickstart.ini" configuration file. This file makes it possible to specify parameters for each installation step of the web based setup wizard. For example, by providing the database connection parameters, the corresponding setup wizard step will have the input forms pre-filled. It is also possible to instruct the wizard to skip certain steps.

Initialization

Create a copy of the "kickstart.ini-dist" file (located in the root of your eZ publish installation) and make sure that the copy is named "kickstart.ini" (located in the root of eZ publish). The following example shows how this can be done on a Linux/UNIX based system:

  1. Navigate into the eZ publish directory:
    $ cd /path/to/ezpublish/
    
  2. Copy and rename the configuration file:
    $ cp kickstart.ini-dist kickstart.ini
    

Security issues

The web server must have read access to the "kickstart.ini" file during the installation process. This might become a security problem at a later stage if the file contains usernames, passwords, etc. To prevent this from happening, it is recommended to do one of the following:

  • Remove the file when the installation has completed.
  • Use rewrite rules to make sure that it is not readable from outside.

Configuration blocks

The "kickstart.ini" file contains a configuration block for every step of the setup wizard. The block names are encapsulated by square brackets. The following list shows an overview of the available blocks.

  • [email_settings]
  • [database_choice]
  • [database_init]
  • [language_options]
  • [site_types]
  • [site_access]
  • [site_details]
  • [site_admin]
  • [security]
  • [registration]

In the default kickstart file, everything is commented out. The blocks and the corresponding settings have to be uncommented in order to take effect. This can be done by removing the hash ("#") characters from the start of the lines that you should be activated. Make sure that there are no leading whitespace characters at the start of the lines.

Configuration parameters

Each parameter takes a text string as an input value. Some parameters are able to handle an array of strings. The following examples demonstrate the two parameter types.

  • Single parameter:
    Server=www.example.com
    
  • Array parameter:
    Title[]
    Title[news]=The news site
    Title[forums]=The forum site
    

Documentation and examples

The "kickstart.ini" file contains documentation in the file itself. Please refer to the embedded instructions and examples for a detailed explanation of the steps. The following table shows how the examples / inline instructions deal with required and optional parameters.

Syntax

Description

<value>

Angle brackets indicate that the parameter value is required, example:

#Server=<hostname>

[value]

Squared brackets indicate that the parameter value is optional, example:

#FirstName=[string]

A parameter will only take effect if it has been uncommented. Remove the leading hash ("#") and make sure that there ar no whitespace characters at the start of the lines that include the uncommented parameters.

Skipping steps

A step can be skipped by uncommenting and setting the "Continue" parameter to "true". This parameter can be used for each step / block. The following table shows the outcome for the different configurations of the "Continue" parameter.

Assignment

Result

Continue=false

The step will be shown and the input values will be pre-filled with the values (if any) defined in the "kickstart.ini" configuration file. This is the same as when the "Continue" parameter is missing or if it has been commented out.

Continue=true

The system will automatically use the values defined in the kickstart file and thus the step will not be shown. However, if something goes wrong (missing or wrong values, etc.), the step will be shown.

Starting the installation

The installation can be started by initiating the web based setup wizard. Please refer to the "Initiating the setup wizard" part of the "Normal installation" section.

Sandro Groganz (12/04/2005 1:29 pm)

Svitlana Shatokhina (18/05/2006 11:16 am)

Balazs Halasy, Svitlana Shatokhina


Comments

There are no comments.