Author: tchemit Date: 2012-05-02 10:24:42 +0200 (Wed, 02 May 2012) New Revision: 3341 Url: http://chorem.org/repositories/revision/pollen/3341 Log: refs #538: Improve install documentation Added: trunk/src/site/fr/rst/configure.rst trunk/src/site/rst/configure.rst trunk/src/site/rst/install.rst.vm Removed: trunk/src/site/rst/install.rst Modified: trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java trunk/pollen-persistence/src/main/resources/META-INF/services/org.nuiton.util.ApplicationConfigProvider trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_en_GB.properties trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_fr_FR.properties trunk/src/site/fr/rst/index.rst trunk/src/site/fr/rst/install.rst.vm trunk/src/site/rst/index.rst trunk/src/site/site_en.xml trunk/src/site/site_fr.xml Modified: trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java =================================================================== --- trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java 2012-05-02 08:24:42 UTC (rev 3341) @@ -1,3 +1,26 @@ +/* + * #%L + * Pollen :: Persistence + * + * $Id$ + * $HeadURL$ + * %% + * Copyright (C) 2009 - 2012 CodeLutin + * %% + * This program is free software: you can redistribute it and/or modify + * it under the terms of the GNU Affero General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU Affero General Public License + * along with this program. If not, see <http://www.gnu.org/licenses/>. + * #L% + */ package org.chorem.pollen; import org.nuiton.util.ApplicationConfig; Property changes on: trunk/pollen-persistence/src/main/java/org/chorem/pollen/PollenApplicationConfigProvider.java ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Property changes on: trunk/pollen-persistence/src/main/resources/META-INF/services/org.nuiton.util.ApplicationConfigProvider ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_en_GB.properties =================================================================== --- trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_en_GB.properties 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_en_GB.properties 2012-05-02 08:24:42 UTC (rev 3341) @@ -1,4 +1,22 @@ +Version\ de\ l'application= pollen.application.config=Pollen configuration +pollen.configuration.adminEmail=email for default admin +pollen.configuration.charset=Charset of Pollen +pollen.configuration.contactEmail=email for contact link +pollen.configuration.dataDirectory=Directory where to put pollen data +pollen.configuration.db.login=login for default admin +pollen.configuration.db.password=password for default admin +pollen.configuration.defaultChoiceType=Default choice type to use at a new poll creation +pollen.configuration.defaultPollType=Default poll type to use at a new poll creation +pollen.configuration.defaultVoteCountingType=Default vote counting type to use at a new poll creation +pollen.configuration.emaiDirectory=directory to store emails before sending them +pollen.configuration.emailFrom=from for email sending configuration +pollen.configuration.emailHost=host for email sending configuration +pollen.configuration.emailPort=port for email sending configuration +pollen.configuration.feedDirectory=path for feed directory +pollen.configuration.imageDirectory=path for uploaded images directory +pollen.configuration.nbVoteByPage=nb votes to display per page +pollen.configuration.siteUrl=Application url pollen.exception.favorite_list_name_exist= pollen.exception.participant_doubloons= pollen.exception.participant_exist= @@ -12,20 +30,3 @@ pollen.exception.user_wrong_password= pollen.exception.vote_doubloon= pollen.exception.vote_not_allowed= -pollen.configuration.siteUrl=Application url -pollen.configuration.dataDirectory=Directory where to put pollen data -pollen.configuration.defaultChoiceType=Default choice type to use at a new poll creation -pollen.configuration.defaultVoteCountingType=Default vote counting type to use at a new poll creation -pollen.configuration.defaultPollType=Default poll type to use at a new poll creation -pollen.configuration.charset=Charset of Pollen -pollen.configuration.nbVoteByPage=nb votes to display per page -pollen.configuration.imageDirectory=path for uploaded images directory -pollen.configuration.db.login=login for default admin -pollen.configuration.db.password=password for default admin -pollen.configuration.adminEmail=email for default admin -pollen.configuration.contactEmail=email for contact link -pollen.configuration.emailHost=host for email sending configuration -pollen.configuration.emailPort=port for email sending configuration -pollen.configuration.emailFrom=from for email sending configuration -pollen.configuration.emaiDirectory=directory to store emails before sending them -pollen.configuration.feedDirectory=path for feed directory Modified: trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_fr_FR.properties =================================================================== --- trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_fr_FR.properties 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/pollen-persistence/src/main/resources/i18n/pollen-persistence_fr_FR.properties 2012-05-02 08:24:42 UTC (rev 3341) @@ -1,4 +1,22 @@ +Version\ de\ l'application= pollen.application.config=Configuration de Pollen +pollen.configuration.adminEmail=Email de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) +pollen.configuration.charset=Encodnig de Pollen +pollen.configuration.contactEmail=Email pour le lien Contact +pollen.configuration.dataDirectory=Répertoire des données de Pollen +pollen.configuration.db.login=Login de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) +pollen.configuration.db.password=Mot de passe de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) +pollen.configuration.defaultChoiceType=Choix par défaut utilisation lors de la création d'un sondage +pollen.configuration.defaultPollType=Type de sondage lors de la création d'un sondage +pollen.configuration.defaultVoteCountingType=Type de dépouillement lors de la création d'un sondage +pollen.configuration.emaiDirectory=Répertoire des emails +pollen.configuration.emailFrom=Email de l'envoyeur dans les emails +pollen.configuration.emailHost=Serveur d'envoie d'email +pollen.configuration.emailPort=Port du serveur d'envoi d'email +pollen.configuration.feedDirectory=Répertoire des flux rss +pollen.configuration.imageDirectory=répertoire où sont enregistrés les images +pollen.configuration.nbVoteByPage=Nombre de votes à afficher par page +pollen.configuration.siteUrl=Url publique de l'aplication (utilisée dans les emails envoyés) pollen.exception.favorite_list_name_exist=La liste %1$s existe déjà pour l'utilisateur %2$s pollen.exception.participant_doubloons=Les doublons de la liste %1$s ont été ignorés \: %2$s pollen.exception.participant_exist=La liste %1$s contient déjà un votant nommé %2$s avec un email %3$s @@ -12,20 +30,3 @@ pollen.exception.user_wrong_password=Le mot de passe renseigné est incorrect pour l'utilisateur '%1$s'. pollen.exception.vote_doubloon= pollen.exception.vote_not_allowed= -pollen.configuration.siteUrl=Url publique de l'aplication (utilisée dans les emails envoyés) -pollen.configuration.dataDirectory=Répertoire des données de Pollen -pollen.configuration.defaultChoiceType=Choix par défaut utilisation lors de la création d'un sondage -pollen.configuration.defaultVoteCountingType=Type de dépouillement lors de la création d'un sondage -pollen.configuration.defaultPollType=Type de sondage lors de la création d'un sondage -pollen.configuration.charset=Encodnig de Pollen -pollen.configuration.nbVoteByPage=Nombre de votes à afficher par page -pollen.configuration.imageDirectory=répertoire où sont enregistrés les images -pollen.configuration.db.login=Login de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) -pollen.configuration.db.password=Mot de passe de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) -pollen.configuration.adminEmail=Email de l'utilisateur par défaut (Utilisateur crée lors du premier lancement de pollen) -pollen.configuration.contactEmail=Email pour le lien Contact -pollen.configuration.emailHost=Serveur d'envoie d'email -pollen.configuration.emailPort=Port du serveur d'envoi d'email -pollen.configuration.emailFrom=Email de l'envoyeur dans les emails -pollen.configuration.emaiDirectory=Répertoire des emails -pollen.configuration.feedDirectory=Répertoire des flux rss Added: trunk/src/site/fr/rst/configure.rst =================================================================== --- trunk/src/site/fr/rst/configure.rst (rev 0) +++ trunk/src/site/fr/rst/configure.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -0,0 +1,107 @@ +.. - +.. * #%L +.. * Pollen +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2009 - 2012 CodeLutin +.. * %% +.. * This program is free software: you can redistribute it and/or modify +.. * it under the terms of the GNU Affero General Public License as published by +.. * the Free Software Foundation, either version 3 of the License, or +.. * (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Public License for more details. +.. * +.. * You should have received a copy of the GNU Affero General Public License +.. * along with this program. If not, see <http://www.gnu.org/licenses/>. +.. * #L% +.. - +Configurer Pollen +----------------- + +Comment configuer Pollen +------------------------ + +Toute la configuration de Pollen se fait via un fichier nommé **pollen.properties**. + +Ce fichier peut se trouver à différents endroits sur la machine qui démarre Pollen : + +:: + + /etc/pollen.properties + ~/.config/pollen/pollen.properties + repertoireOuEstLancePollen/pollen.properties + +A noter que si le fichier est déposé dans plusieurs endroits, alors les +configurations se cumulent. + +Pour plus d'information sur les options disponibles, +rendez-vous sur la `page des options`_. + +Configurer l'adresse publique +----------------------------- + +L'adresse publique de Pollen est l'adresse utilisée dans les emails générés. + +On peut la configurer via la propriété suivante de la configuration : + +:: + + 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) + +Configurer l'envoi d'email +-------------------------- + +Pour que Pollen puisse envoyer des emails vous devez bien renseigner la +configuration: + +:: + + email_host= Serveur smtp pour envoyer les emails + email_port= Port du serveur smtp + email_from= Adresse de l'envoyeur de mail + +Configurer la base de 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 | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ + +.. _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/ +.. _Jetty: http://eclipse.org/jetty/ Property changes on: trunk/src/site/fr/rst/configure.rst ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: trunk/src/site/fr/rst/index.rst =================================================================== --- trunk/src/site/fr/rst/index.rst 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/fr/rst/index.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -54,6 +54,15 @@ annuaires LDAP. - Vous pouvez importer/exporter des consultations. +Utiliser Pollen +--------------- + +Comment utiliser pollen ? + +- Utiliser notre `instance de Pollen`_, sans rien installer sur votre machine. +- `Télécharger Pollen`_ puis l'installer sur votre machine en suivant le + `guide d'installation`_ . + Mais encore... -------------- @@ -65,3 +74,6 @@ :alt: Page d'accueil de Pollen .. _modes de dépouillement: ./depouillement.html +.. _instance de Pollen: http://pollen.chorem.org/pollen +.. _Télécharger Pollen: http://www.chorem.org/projects/pollen/files +.. _guide d'installation: ./install.html Modified: trunk/src/site/fr/rst/install.rst.vm =================================================================== --- trunk/src/site/fr/rst/install.rst.vm 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/fr/rst/install.rst.vm 2012-05-02 08:24:42 UTC (rev 3341) @@ -21,51 +21,71 @@ .. * along with this program. If not, see <http://www.gnu.org/licenses/>. .. * #L% .. - -============ -Installation -============ +Installer Pollen +================ +Cette page décrit comment installer Pollen sur votre machine ou serveur. + Avant-propos ------------- +============ -Types d'installation -~~~~~~~~~~~~~~~~~~~~ +Modes d'installation +-------------------- -Il existe deux manières pour lancer Pollen: +Il existe deux modes d'installation de Pollen: -- en mode embarqué : dans ce mode Pollen possède un conteneur web embarqué, - il n'est pas pas nécessaire de posséder un conteneur web. +- **Mode embarqué** : dans ce mode Pollen se présente comme une application + autonome qui peut être lancée simplement sans besoin de conteneur web. -- en mode serveur : dans ce mode on déploit pollen dans un conteneur web - (tomcat, jetty,...) avec une configuration adapté pour un serveur. +- **Mode serveur** : dans ce mode on déploit Pollen dans un conteneur web + (tomcat, jetty,...) avec une configuration adaptée pour un serveur. Configurer Pollen -~~~~~~~~~~~~~~~~~ +----------------- -Pour modifier la configuration de Pollen, on doit créer un fichier nommé -**pollen.properties**. +Pour que Pollen soit pleinement opérationnel, il faut configurer deux choses : -Pour plus d'information sur les options disponibles, -rendez-vous sur la `page des options`_. +- l'adresse publique de Pollen (voir la section `Configurer l'adresse publique`_). +- la configuration d'envoie d'emails (voir la section `Configurer l'envoi d'email`_).). +Pour tout savoir sur la configuration de Pollen, reportez vous à la +`page de configuration`_. Se connecter à Pollen -~~~~~~~~~~~~~~~~~~~~~ +--------------------- Un utilisateur avec les droits d'administration est créé automatiquement -(identifiant **admin**, mot de passe **pollen**). +(identifiant **admin**, mot de passe **pollen**) lors du premier démarrage de +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é ------------------------------ +============================= +Installer +--------- + - 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 +Configurer +---------- + +En mode embarqué, le fichier de configuration **pollen.properties** se +trouve à la racine de l'archive décompressée. + +Toutes les données sont stoquées dans le répertoire *data*. + +Une base h2 est utilisée et stoquée (dans le répertoire *data/db*). + +Démarrer +-------- + +On démarre Pollen via l'un des deux commandes : + :: ./pollen.sh (sous linux) @@ -81,92 +101,43 @@ http://localhost:8888 -Configuration -~~~~~~~~~~~~~ -En mode embarqué, le fichier de configuration se trouve à la racine du fichier -décompressé. - -Toutes les données sont stoquées dans le répertoire *data*. - -Une base h2 est utilisée et stoquée (dans le répertoire *data/db*). - Installation en mode serveur ----------------------------- +============================ +Installer +--------- + - 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 -~~~~~~~~~~~~~ +Configurer +---------- -Il faut créer un fichier de configuration nommé **pollen.properties** qui -peut se trouver dans l'un des répertoires suivants : +En mode serveur, Il faut créer un fichier de configuration nommé +**pollen.properties** qui peut se trouver dans l'un des répertoires suivants : :: /etc/pollen.properties ~/.config/pollen.properties -Par défaut les données seront stoquées dans le répertoire suivant +Par défaut les données seront stoquées dans le répertoire suivant : :: /var/local/pollen/data -Configuration avancés ---------------------- +Démarrer +-------- -Base des données -~~~~~~~~~~~~~~~~ +Déployer le fichier war dans votre conteneur Web comme Tomcat_ ou Jetty_. -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 de configuration: ./configure.html .. _page des Téléchargements: http://www.chorem.org/projects/pollen/files .. _Tomcat: http://tomcat.apache.org/ .. _Jetty: http://eclipse.org/jetty/ +.. _Configurer l'adresse publique: ./configure.html#Configurer_ladresse_publique +.. _Configurer l'envoi d'email: ./configure.html#Configurer_lenvoi_demail Added: trunk/src/site/rst/configure.rst =================================================================== --- trunk/src/site/rst/configure.rst (rev 0) +++ trunk/src/site/rst/configure.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -0,0 +1,107 @@ +.. - +.. * #%L +.. * Pollen +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2009 - 2012 CodeLutin +.. * %% +.. * This program is free software: you can redistribute it and/or modify +.. * it under the terms of the GNU Affero General Public License as published by +.. * the Free Software Foundation, either version 3 of the License, or +.. * (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Public License for more details. +.. * +.. * You should have received a copy of the GNU Affero General Public License +.. * along with this program. If not, see <http://www.gnu.org/licenses/>. +.. * #L% +.. - +Configurer Pollen +----------------- + +Comment configuer Pollen +------------------------ + +Toute la configuration de Pollen se fait via un fichier nommé **pollen.properties**. + +Ce fichier peut se trouver à différents endroits sur la machine qui démarre Pollen : + +:: + + /etc/pollen.properties + ~/.config/pollen/pollen.properties + repertoireOuEstLancePollen/pollen.properties + +A noter que si le fichier est déposé dans plusieurs endroits, alors les +configurations se cumulent. + +Pour plus d'information sur les options disponibles, +rendez-vous sur la `page des options`_. + +Configurer l'adresse publique +----------------------------- + +L'adresse publique de Pollen est l'adresse utilisée dans les emails générés. + +On peut la configurer via la propriété suivante de la configuration : + +:: + + 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) + +Configurer l'envoi d'email +-------------------------- + +Pour que Pollen puisse envoyer des emails vous devez bien renseigner la +configuration: + +:: + + email_host= Serveur smtp pour envoyer les emails + email_port= Port du serveur smtp + email_from= Adresse de l'envoyeur de mail + +Configurer la base de 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 | ++-------------------------+------------------------------------------+-----------------------+------------------------------------------+ + +.. _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/ +.. _Jetty: http://eclipse.org/jetty/ Property changes on: trunk/src/site/rst/configure.rst ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: trunk/src/site/rst/index.rst =================================================================== --- trunk/src/site/rst/index.rst 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/rst/index.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -46,6 +46,15 @@ - You can import voters lists from CSV files or LDAP. - You can import/export votes/polls. +Use Pollen +---------- + +How to use Pollen? + +- Use our `shared instance of Pollen`_, with no install on your own computer. +- `Download Pollen`_ ans install it on our own computer following + `installation guide`_ . + But also... ----------- @@ -57,3 +66,6 @@ :alt: Pollen screenshot .. _vote counting methods: ./methods.html +.. _shared instance of Pollen: http://pollen.chorem.org/pollen +.. _Download Pollen: http://www.chorem.org/projects/pollen/files +.. _installation guide: ./install.html Deleted: trunk/src/site/rst/install.rst =================================================================== --- trunk/src/site/rst/install.rst 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/rst/install.rst 2012-05-02 08:24:42 UTC (rev 3341) @@ -1,99 +0,0 @@ -.. - -.. * #%L -.. * Pollen -.. * -.. * $Id$ -.. * $HeadURL$ -.. * %% -.. * Copyright (C) 2009 - 2012 CodeLutin -.. * %% -.. * This program is free software: you can redistribute it and/or modify -.. * it under the terms of the GNU Affero General Public License as published by -.. * the Free Software Foundation, either version 3 of the License, or -.. * (at your option) any later version. -.. * -.. * This program is distributed in the hope that it will be useful, -.. * but WITHOUT ANY WARRANTY; without even the implied warranty of -.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -.. * GNU General Public License for more details. -.. * -.. * You should have received a copy of the GNU Affero General Public License -.. * along with this program. If not, see <http://www.gnu.org/licenses/>. -.. * #L% -.. - -Installation guide -================== - -.. Author: Nolwenn Rannou <rannou@codelutin.com> -.. Revision: $Revision$ -.. Date: $Date$ - -.. contents:: - -Web container -------------- - -To install the application, you just need to deploy the war archive in a web -container like Tomcat_. - -By default, a H2 database is created in the */tmp* directory. To modify this -behaviour, you only need to create the */etc/pollen.properties* file ( you can -put it into the directory from which you launch the application or in a -*".config/"* directory in your home directory) and to fill it with the following -properties :: - - # database configuration - hibernate.show_sql=false - hibernate.dialect=org.hibernate.dialect.H2Dialect - hibernate.connection.username=username - hibernate.connection.password=password - hibernate.connection.driver_class=org.h2.Driver - hibernate.connection.url=jdbc:h2:file://tmp/pollen/pollen - - # transfered pictures directory - upImgDir=/tmp/pollen/uploadedImages - - # maximal size of transfered pictures (in bytes) - upload.filesize-max=1048576 - upload.requestsize-max=10485760 - - # automatic email sending configuration - email_host=smtp.free.fr - email_port=25 - email_from=bot@pollen.org - - # syndication flux directory (Atom) - feedDir=/tmp/pollen/feeds - - # site adresse (used for reminder emails) - siteUrl=http://www.site.org/pollen/ - -For example, for a PostgreSQL database, we will have :: - - hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect - hibernate.connection.driver_class=org.postgresql.Driver - hibernate.default_schema=public - -It may be necessary to redeploy the application after having modified this -file; - -A user with administration rights is automatically added (login "admin", -password "pollen"). For safety measures, it is really important to delete this -user (or modify its password) after having created another administrator account. - -Embedded container ------------------- - -Since pollen-1.1.1, the war bundle embed a servlet container based on winstone. -To run it, just launch with following command : - -:: - - java -jar pollen-x.x.x.war - - -Then open a browser to address : http://localhost:8080/. - -You can also use command line option to configure launch : http://winstone.sourceforge.net/#commandLine - -.. _Tomcat: http://tomcat.apache.org/ Copied: trunk/src/site/rst/install.rst.vm (from rev 3340, trunk/src/site/rst/install.rst) =================================================================== --- trunk/src/site/rst/install.rst.vm (rev 0) +++ trunk/src/site/rst/install.rst.vm 2012-05-02 08:24:42 UTC (rev 3341) @@ -0,0 +1,93 @@ +.. - +.. * #%L +.. * Pollen +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2009 - 2012 CodeLutin +.. * %% +.. * This program is free software: you can redistribute it and/or modify +.. * it under the terms of the GNU Affero General Public License as published by +.. * the Free Software Foundation, either version 3 of the License, or +.. * (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Public License for more details. +.. * +.. * You should have received a copy of the GNU Affero General Public License +.. * along with this program. If not, see <http://www.gnu.org/licenses/>. +.. * #L% +.. - +Installation guide +================== + +Web container +------------- + +To install the application, you just need to deploy the war archive in a web +container like Tomcat_. + +By default, a H2 database is created in the */tmp* directory. To modify this +behaviour, you only need to create the */etc/pollen.properties* file ( you can +put it into the directory from which you launch the application or in a +*".config/"* directory in your home directory) and to fill it with the following +properties :: + + # database configuration + hibernate.show_sql=false + hibernate.dialect=org.hibernate.dialect.H2Dialect + hibernate.connection.username=username + hibernate.connection.password=password + hibernate.connection.driver_class=org.h2.Driver + hibernate.connection.url=jdbc:h2:file://tmp/pollen/pollen + + # transfered pictures directory + upImgDir=/tmp/pollen/uploadedImages + + # maximal size of transfered pictures (in bytes) + upload.filesize-max=1048576 + upload.requestsize-max=10485760 + + # automatic email sending configuration + email_host=smtp.free.fr + email_port=25 + email_from=bot@pollen.org + + # syndication flux directory (Atom) + feedDir=/tmp/pollen/feeds + + # site adresse (used for reminder emails) + siteUrl=http://www.site.org/pollen/ + +For example, for a PostgreSQL database, we will have :: + + hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect + hibernate.connection.driver_class=org.postgresql.Driver + hibernate.default_schema=public + +It may be necessary to redeploy the application after having modified this +file; + +A user with administration rights is automatically added (login "admin", +password "pollen"). For safety measures, it is really important to delete this +user (or modify its password) after having created another administrator account. + +Embedded container +------------------ + +Since pollen-1.1.1, the war bundle embed a servlet container based on winstone. +To run it, just launch with following command : + +:: + + java -jar pollen-x.x.x.war + + +Then open a browser to address : http://localhost:8080/. + +You can also use command line option to configure launch : http://winstone.sourceforge.net/#commandLine + +.. _Tomcat: http://tomcat.apache.org/ Property changes on: trunk/src/site/rst/install.rst.vm ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:mergeinfo + Added: svn:eol-style + native Modified: trunk/src/site/site_en.xml =================================================================== --- trunk/src/site/site_en.xml 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/site_en.xml 2012-05-02 08:24:42 UTC (rev 3341) @@ -89,15 +89,13 @@ <item name="Libre-Entreprise" href="http://www.libre-entreprise.org/"/> </links> - <menu name="Download"> - <item name="Download" + <menu name="Install"> + <item name="Download Pollen" href="http://www.chorem.org/projects/pollen/files"/> + <item name="Install Pollen" href="install.html"/> + <item name="Configure Pollen" href="configure.html"/> </menu> - <menu name="Install"> - <item name="Install" href="install.html"/> - </menu> - <menu name="Demo"> <item name="Demo" href="http://pollen.chorem.org/"/> </menu> Modified: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2012-05-01 18:08:12 UTC (rev 3340) +++ trunk/src/site/site_fr.xml 2012-05-02 08:24:42 UTC (rev 3341) @@ -89,15 +89,13 @@ <item name="Libre-Entreprise" href="http://www.libre-entreprise.org/"/> </links> - <menu name="Téléchargement"> - <item name="Téléchargement" + <menu name="Installation"> + <item name="Télécharger Pollen" href="http://www.chorem.org/projects/pollen/files"/> + <item name="Installer Pollen" href="install.html"/> + <item name="Configurer Pollen" href="configure.html"/> </menu> - <menu name="Installation"> - <item name="Installation" href="install.html"/> - </menu> - <menu name="Demo"> <item name="Demo" href="http://pollen.chorem.org/"/> </menu>