Author: tchemit Date: 2012-01-08 19:57:36 +0100 (Sun, 08 Jan 2012) New Revision: 248 Url: http://forge.codelutin.com/repositories/revision/echobase/248 Log: update install doc Modified: trunk/src/site/rst/install.rst Modified: trunk/src/site/rst/install.rst =================================================================== --- trunk/src/site/rst/install.rst 2012-01-06 18:15:34 UTC (rev 247) +++ trunk/src/site/rst/install.rst 2012-01-08 18:57:36 UTC (rev 248) @@ -37,42 +37,77 @@ Configuration d'Echobase ------------------------ -La configuration personnalisée d'Echobase ce trouve par défaut dans /etc/echobase.properties. +La configuration d'Echobase se trouve par défaut de le fichier +**/etc/echobase.properties**. -Par défaut le répertoire de travail ce trouve dans /var/local/echobase. Le war du projet (pour créer une application embarquée) ce trouve dans le repertoire "war" du répertoire de travail. Voici contenu de celui-ci par défaut:: +Ce fichier permet de surcharger la configuration par défaut. +*Nous préconisons* l'utilisation de la configuration par défaut. + +Par défaut le répertoire de travail ce trouve dans */var/local/echobase*. +Le war du projet (pour créer une application embarquée) se trouve dans le +repertoire "war" du répertoire de travail. Voici contenu de celui-ci par défaut:: + data.directory=/var/local/echobase # Repertoire de l'application war.directory=${data.directory}/war # Répertoire où est stoqué le war war.location=${war.directory}/echobase-ui-${project.version}.war # Chemin complêt d'accès au war -Vous pouvez surcharger toutes les propriétés ci-dessus, dans la plupart des cas, seul la modification de data.directory est normalement nécessaire. -Il suffit de créer le fichier /etc/echobase.properties et d'y ajouter la/les ligne(s) ci-dessus modifiée(s). +Vous pouvez surcharger toutes les propriétés ci-dessus, dans la plupart des +cas, seul la modification de data.directory est normalement nécessaire. -Une base de donnée h2 est crée dans le répertoire de travail (data.directory) mais il est possible de configurer une base Postgres. +Il suffit de créer le fichier */etc/echobase.properties* et d'y ajouter +la/les ligne(s) ci-dessus modifiée(s). -Installation Postgres ---------------------- +Une base de donnée h2 est crée dans le répertoire de travail (data.directory) +mais il est possible de configurer une base Postgres. +Installation de la base de données +---------------------------------- + Pré-requis : - - postgres doit être installé sur la machine (exemple pour un système Debian : apt-get install postgresql) + - **postgres** doit être installé sur la machine (exemple pour un système Debian : apt-get install postgresql) - être connecté avec l'utilisateur (postgres par défaut) qui a les droits d'administrer cette base de donnée. 1. Création de l'utilisateur Postgres :: - createuser -P echobase + createuser -U postgres -sdRP echobase 2. Création de la base de donnée "echobase" :: - createdb -E utf8 echobase -O echobase + createdb -U postgres -E UTF-8 -O echobase echobase -3. Il faut positionner le fichier de configuration echobase.properties_ dans /etc et remplacer le mot de passe (hibernate.connection.password) par celui rentré lors de la création de l'utilisateur Postgres. +3. Il faut positionner le fichier de configuration echobase.properties_ dans + /etc et remplacer le mot de passe (hibernate.connection.password) par celui + rentré lors de la création de l'utilisateur Postgres. .. _echobase.properties: echobase.properties +Installation de l'application +----------------------------- + +L'application qui est fournit sous forme le war doit être placée dans le +répertoire dédié dans le serveur web. + +Il faut aussi placer ce war dans le répertoire défini dans la configuration par +la propriété *war.location* qui par défaut est situé dans */var/local/echobase/war* + +Gestion des logs de l'application +--------------------------------- + +Avant de lancer l'application, il faut avoir positionner une variable +**echobase.log.dir** de jvm qui définit le répertoire où positionner les logs +de l'application.:: + + JAVA_OPTS="$JAVA_OPTS -Dechobase.log.dir=/var/local/echobase/logs" + +ou:: + + CATALINA_OPTS="$CATALINA_OPTS -Dechobase.log.dir=/var/local/echobase/logs" + Première utilisation -------------------- @@ -81,4 +116,5 @@ login : admin mot de passe : admin -Pour des raisons de sécurité, il est conseillé de modifier le mot de passe via l'interface de gestion des utilisateurs. \ No newline at end of file +Pour des raisons de sécurité, il est conseillé de modifier le mot de passe via +l'interface de gestion des utilisateurs. \ No newline at end of file