Author: tchemit Date: 2012-05-01 19:55:38 +0200 (Tue, 01 May 2012) New Revision: 3338 Url: http://chorem.org/repositories/revision/pollen/3338 Log: fix doc refs #538: Improve install documentation Modified: trunk/src/site/fr/rst/install.rst.vm Modified: trunk/src/site/fr/rst/install.rst.vm =================================================================== --- trunk/src/site/fr/rst/install.rst.vm 2012-05-01 17:34:13 UTC (rev 3337) +++ trunk/src/site/fr/rst/install.rst.vm 2012-05-01 17:55:38 UTC (rev 3338) @@ -21,6 +21,7 @@ .. * along with this program. If not, see <http://www.gnu.org/licenses/>. .. * #L% .. - +============ Installation ============ @@ -42,70 +43,26 @@ ~~~~~~~~~~~~~~~~~ Pour modifier la configuration de Pollen, on doit créer un fichier nommé -*pollen.properties*. +**pollen.properties**. Pour plus d'information sur les options disponibles, rendez-vous sur la `page des options`_. -Stoquage des données -~~~~~~~~~~~~~~~~~~~~ -Pollen utilise une base de données. Par défaut Pollen utilise une base type -h2. - -Lors du premier lancement de Pollen, l'utilisateur admin / admin sera crée dans -la base de données. - -Pour modifier la configuration de la base de données, on modifie dans le -fichier de configuration les lignes: - -:: - - hibernate.connection.username=sa - hibernate.connection.password= - -Pour changer de type de base données, il faut modifier modidifer -les propriétés suivantes: - -:: - hibernate.dialect=Dialect de la base - hibernate.connection.driver_class=Driver de la base - hibernate.connection.url=Url de connexion à la base - -Voici un tableau d'utilisation pour les bases usuelles: - -+-------------------------+---------+--------------------------------+-----------------------+------------------------------------------+ -+ Type de base de données | dialect | driver | url de connexion + -+-------------------------+---------+--------------------------------+-----------------------+------------------------------------------+ -+ H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH/pollendb + -+ PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen + -+-------------------------+---------+--------------------------------+-----------------------+------------------------------------------+ - -Envoie des emails -~~~~~~~~~~~~~~~~~ - -Pour que Pollen puisse envoyer des emails vous devez modifier la configuration: - -:: - - email_host= Serveur smtp pour envoyer les emails - email_port= Port du serveur smtp - email_from= Adresse de l'envoyeur de mail - siteUrl= Adresse publique de votre instance de pollen (utilisé pour générer les liens d'accès au sondage dans les emails envoyés) - Se connecter à Pollen ~~~~~~~~~~~~~~~~~~~~~ Un utilisateur avec les droits d'administration est créé automatiquement -(identifiant *admin*, mot de passe *pollen*). Par mesure de sécurité il est -important de supprimer cet utilisateur après avoir créer un autre compte -administrateur. +(identifiant **admin**, mot de passe **pollen**). +Par mesure de sécurité il est important de supprimer cet utilisateur +après avoir créer un autre compte administrateur. + Installation en mode embarqué ----------------------------- -- Télécharger l'archive ${project.build.finalName}-bin.zip sur la - `page des Téléchargements`. +- Télécharger l'archive **${project.build.finalName}-bin.zip** sur la + `page des Téléchargements`_. - Décompresser l'archive téléchargée. - Lancer Pollen via l'un des deux commandes @@ -137,15 +94,15 @@ Installation en mode serveur ---------------------------- -- Télécharger le fichier ${project.build.finalName}.war sur la - `page des Téléchargements`. +- Télécharger le fichier **${project.build.finalName}.war** sur la + `page des Téléchargements`_. - Renseigner la configuration (voir section suivante) - Deployer le fichier war dans votre conteneur Web comme Tomcat_ ou Jetty_. Configuration ~~~~~~~~~~~~~ -Il faut créer un fichier de configuration nommé *pollen.properties* qui +Il faut créer un fichier de configuration nommé **pollen.properties** qui peut se trouver dans l'un des répertoires suivants : :: @@ -159,6 +116,55 @@ /var/local/pollen/data +Configuration avancés +--------------------- + +Base des données +~~~~~~~~~~~~~~~~ + +Pollen utilise une base de données. Par défaut Pollen utilise une base type +h2. + +Pour modifier la configuration de la base de données, on modifie dans le +fichier de configuration les lignes: + +:: + + hibernate.connection.username=sa + hibernate.connection.password= + +Pour changer de type de base données, il faut modifier modidifer +les propriétés suivantes: + +:: + hibernate.dialect=Dialect de la base + hibernate.connection.driver_class=Driver de la base + hibernate.connection.url=Url de connexion à la base + +Voici un tableau d'utilisation pour les bases usuelles: + ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| Type de base de données | dialect | driver | url de connexion | ++=========================+==========================================+=======================+==========================================+ +| H2 | org.hibernate.dialect.H2Dialect | org.h2.Driver | jdbc:h2:file:emplacementBaseH2/pollendb | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| PostgreSql | org.hibernate.dialect.PostgreSQLDialect | org.postgresql.Driver | jdbc:postgresql:pollen | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ +| MySql | org.hibernate.dialect.MySQLDialect | com.mysql.jdbc.Driver | jdbc:mysql:pollen | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ + +Envoie des emails +~~~~~~~~~~~~~~~~~ + +Pour que Pollen puisse envoyer des emails vous devez modifier la configuration: + +:: + + email_host= Serveur smtp pour envoyer les emails + email_port= Port du serveur smtp + email_from= Adresse de l'envoyeur de mail + siteUrl= Adresse publique de votre instance de pollen (utilisé pour générer les liens d'accès au sondage dans les emails envoyés) + .. _page des options: ./pollen-ui-struts2/application-config-report.html .. _page des Téléchargements: http://www.chorem.org/projects/pollen/files .. _Tomcat: http://tomcat.apache.org/