eZ Publish 4.x : Installation sur un système Linux/UNIX

Date de publication: le vendredi 9 décembre 2011 à 12h23
Dernière modification: par Pascal BOYER le lundi 12 décembre 2011 à 23h57

02/11/2011 1:32

versions 4.x

The requirements for doing a normal installation must be met! Read the "Requirements for doing a normal installation" section first. Proceed only if you have access to a Linux/UNIX based system with Apache, PHP, MySQL or PostgreSQL already installed and running. 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:
Les prérequis à une installation normale doivent être remplis ! Consultez la document Prérequis à une installation normale (4.5+) dans l'index présent en début article. Vous ne devez suivre les instructions présentées ici que si vous avez accès à un système composé des serveurs suivants en état de fonctionnement: Apache, PHP, MySQL ou PostgreSQL. Comme nous l'indiquons par ailleurs, le serveur de bases de données peut tourner sur une machine différente de celle exécutant le serveur web. Cet article détaille les étapes suivantes:

• Setting up a database (MySQL or PostgreSQL)
  Configuration d'une base de données (MySQL ou PostgreSQL)

• Downloading eZ Publish
  Téléchargement d'eZ Publish

• Unpacking eZ Publish
  Extraction de l'archive d'eZ Publish

• Initiating the setup wizard
  Initialisation de l'assistant graphique

Setting up a database / Configurer une base de données

A database must be created before running the setup wizard. The following text explains how to set up a database using either MySQL or PostgreSQL.
Une base de données devant être créée avant de lancer l'assistant graphique, le texte qui suit explique comment faire avec MySQL ou PostgreSQL.

MySQL

1. Log in as the root user (or any other MySQL user that has the CREATE, CREATE USER and GRANT OPTION privileges):
   Connectez-vous en tant que root (ou en tant que tout autre utilisateur MySQL ayant les privilèges CREATE, CREATE USER et GRANT OPTION):

   mysql --host=<mysql_host> --port=<port> -u <mysql_user> -p<mysql_password>

   Note that if MySQL is installed on the same server, the "--host" parameter can be omitted. If the "--port" parameter is omitted, the default port for MySQL traffic will be used (port 3306).
   Notez que si MySQL est installé sur le même serveur que celui depuis lequel vous lancez la commande ci-dessus alors le paramètre --host est optionnel. Lorsque le paramètre --port est omis, c'est le port par défaut pour le trafic MySQL qui est utilisé (à savoir le port 3306).

   The MySQL client should display a "mysql>" prompt.
   Le client MySQL doit à présent afficher le prompt mysql>

2. Create a new database:
   Créez une nouvelle base de données:

   mysql> CREATE DATABASE <database> CHARACTER SET utf8;

3. Grant access permissions:
   Attribuez les permissions d'accès:

   mysql> GRANT ALL ON <database>.* TO <user>@<ezp_host> IDENTIFIED BY '<password>';

   Note that if the specified user account does not exist, it will be created.
   Notez que si le compte utilisateur spécifié n'existe pas alors il sera créé.

PostgreSQL

1. Log in as the postgres user (or any other PostgreSQL user that has sufficient privileges to create roles and databases):
   Connectez-vous en tant qu'utilisateur de postgres (ou en tant que tout autre utilisateur ayant les privilèges suffisants pour créer des rôles et des bases de données):

   psql -h <psql_host> -p <port> -U <psql_user> -W

   Note that if PostgreSQL is installed on the same server, the "-h" parameter can be omitted. If the "-p" parameter is omitted, the default port for PostgreSQL traffic will be used (in most cases, port 5432).
   Notez que si PostgreSQL est installé sur le même serveur que celui depuis lequel vous lancez la commande ci-dessus alors le paramètre -h est optionnel. Lorsque le paramètre -p est omis, c'est le port par défaut pour le trafic PostgreSQL qui est utilisé (à savoir le port 5432).

   The PostgreSQL client will ask you to specify the password that belongs to the <psql_user>. If the password is correct, the client should display a "<psql_user>=#" prompt.
   Le client PostgreSQL vous demandera de spécifier le mot de passe de l'utilisateur <psql_user> et si le mot de passe est correct alors il affiche le prompt <psql_user>=#

2. Create a new database:
   Créez une nouvelle base de données:

   postgres=# CREATE DATABASE <database> ENCODING='utf8';

3. Create a new user:
   Créez un nouvel utilisateur:

   postgres=# CREATE USER <user> PASSWORD '<password>';

4. Grant access permissions:
   Attribuez les permissions d'accès:

   postgres=# GRANT ALL PRIVILEGES ON DATABASE <database> TO <user>;

5. Import the "pgcrypto" module into the new database:
   Importez le module pgcrypto dans la nouvelle base de données:

   postgres=# \c <database>

   <database>=# \i '<path_to_pgcrypto>'

Note for version 9.1 of PostgreSQL users: The following changes might be necessary for these users:
Note à l'attention des utilisateurs de la version 9.1 de PostgreSQL: les modifications suivantes sont nécessaires:

postgres=# \c <database>

<database>=# CREATE EXTENSION pgcrypto;

Downloading eZ Publish / Télécharger eZ Publish

The latest stable version of eZ Publish can be downloaded from http://share.ez.no/download-develop/downloads.
Les dernières versions stable d'eZ Publish sont téléchargeables depuis cette page: share.ez.no/download-develop/downloads .

Unpacking eZ Publish / Extraire le contenu de l'archive téléchargée

Use your favorite tool to unpack the downloaded eZ Publish distribution to a web-served directory (a directory that is reachable using a web browser). The following example shows how to do this using the tar utility (to unpack a tar.gz file, assuming that the "tar" and the "gzip" utilities are installed on the system):
Utilisez votre outil favori pour extraire le contenu de l'archive eZ Publish que vous venez de télécharger dans un répertoire de votre serveur web (un répertoire accessible depuis votre navigateur). L'exemple qui suit montre comment faire à l'aide de l'utilitaire tar (pour extraire le contenu d'une archive tar.gz en supposant que les binaires tar et gzip sont installés sur votre système):

tar zxvf ezpublish-<version_number>-gpl.tar.gz -C <web_served_directory>

The extraction utility will unpack eZ Publish into a sub-directory called "ezpublish-<version_number>". Feel free to rename this directory to something more meaningful, for example "my_site".
L'utilitaire d'extraction va extraire le contenu de l'archive et le placer dans un sous-répertoire ezpublish-<version_number> que vous êtes libres de renommer de manière plus suggestive comme par exemple mon_site.

Initiating the setup wizard / Initialiser l'assistant de configuration

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 host name "www.example.com" and that after unpacking, the eZ Publish directory was renamed to "my_site".
L'assistant de configuration sera lancé à partir de votre navigateur web une fois terminées les étapes précédemment décrites dans cet article. Il sera automatiquement démarré lors du premier accès, via un navigateur, au fichier index.php situé à la racine du répertoire d'installation d'eZ Publish. Supposons que nous utilisions un serveur dont le nom d'hôte est www.example.com et que le répertoire d'installation d'eZ Publish ait été renommé mon_site.

Document root example / Exemple de répertoire racine du serveur web

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.
Si eZ Publish est installé dans un sous-répertoire mon_site du répertoire racine du serveur web alors l'assistant graphique sera initialisé grâce à cet URI: http://www.example.com/mon_site/index.php

Home directory example / Exemple de répertoire personnel

If eZ Publish was unpacked to a web-served directory located inside the home directory of a user with the user name "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.
Si le répertoire d'installation d'eZ Publish (mon_site) est installé dans le sous-répertoire (habituellement nommé public_html, www, http, html ou web) du répertoire personnel de l'utilisateur pierre alors l'assistant graphique sera initialisé grâce à cet URI: http://www.example.com/~peter/mon_site/index.php

Refer to the "The setup wizard" section for a detailed description of the web based setup wizard.
Référez-vous à l'article Installer eZ Publish avec l'assistant graphique d'installation et de configuration (voir l'index) pour une description détaillée de l'utilisation de cet assistant graphique.

Commentaires