Installation » History » Version 4

Version 3 (Jérôme TRUFFOT, 09/11/2009 04:58 PM) → Version 4/17 (Eric TOURAILLE, 09/14/2009 10:03 AM)

h1. Installation

Retour à la racine du [[manuel d'administration]].

{{toc}}

h2. Modes de déploiement

Trois modes de déploiement sont disponibles :

# *portlet* : proposé pour les administrateurs de portail, il déploie l'application en une portlet JSR-168, exécutable dans une portail compatible ("uPortal":http://www.jasig.org/uportal, "liferay":http://www.liferay.com/web/guest/home, "infoglue":http://www.infoglue.org/, ...),
# *servlet* : proposé pour les administrateurs désireux d'exécuter l'application dans un conteneur de servlet existant ("Tomcat":http://tomcat.apache.org/, "jetty":http://www.mortbay.org/jetty/, ...),
# *quick-start* : proposé pour tester l'application, l'application est exécuté dans un Tomcat embarqué.

h2. Pré-requis

L'installation de l'application nécessite quelques pré-requis :

* Le package fourni contient les sources de l'application qui doivent être compilées. Cette opération requière un "kit de développement Java":http://java.sun.com/javase/downloads/index.jsp (une machine virtuelle seule ne suffit pas).
* Les commandes d'installation nécessitent nécessite l'utilitaire "ant":http://ant.apache.org/.
* L'application est configurée configuré par défaut pour se connecter à une base de données "MySql":http://www.mysql.fr. Toutefois, l'utilisation du framework "Hibernate":http://www.hibernate.org/ permet en principe d'utiliser d'autres formats de base de données (cf. [[configuration]] de la connexion à la base de données).
* L'authentification des utilisateurs nécessite l'accès à un annuaire LDAP, ainsi qu'à un "CAS":http://www.jasig.org/cas (déploiements en servlet ou quick-start).

h2. Téléchargement

La dernière version peut être récupérée récupérer sur http://forge.clermont-universite.fr/projects/list_files/esup-geisha.

Décompresser le package zip que vous venez de télécharger. La décompression du package *esup-geisha-x.y.z-t.zip* crée le dossier *esup-geisha-x.y.z*.

bq. *Notez que les versions successives de l'application doivent être installées installer dans un dossier commun afin de simplifier les mises à jour.*

h2. Propriétés du déploiement

Éditez le fichier *build.properties* pour définir les propriétés qui configurent l'installation de l'application.

Une fois ces paramètres définis (voir ci-dessous pour les détails), le comportement de l'application à l'exécution doit être configuré (cf. [[configuration]]).

bq. *Lorsque vous changez le mode de déploiement, il est recommandé de tout nettoyer (commande "ant clean") avant de déployer à nouveau.*

h3. Propriétés communes

La propriété *custom.recover.files* permet de récupérer les [[customisation|customisations]] réalisées par l'administrateur lors d'une mise à niveau de l'application. Indiquez, au besoin, dans cette propriété les fichiers que vous souhaitez conserver. Par défaut, les fichiers de configuration suivant sont récupérés :
* build.properties,
* properties/config.properties,
* properties/i18n/bundles/Custom_*.properties.

h3. Déploiement en quick-start

Indiquer simplement le déploiement en eb quick-start de cette façon :

<pre><code>quick-start=true</code></pre>

Toutes les autres propriétés sont optionnelles. Les propriétés @tomcat.host@, @tomcat.port@ and @tomcat.shutdown-port@ peuvent être utilisées pour configurer le Tomcat embarqué (valeurs par défaut ci-dessous).

<pre><code>tomcat.port=8080
tomcat.shutdown-port=8009
tomcat.host=localhost</code></pre>

bq. *Lors d'un déploiement en quick-start, l'application est déployée dans le dossier @deploy@. Un serveur Tomcat est installé automatiquement et configuré pour pointer vers le contexte de l'application.*

h3. Déploiement en portlet

Indiquer le déploiement en portlet :

<pre><code>deploy.type=portlet</code></pre>

Indiquer où l'application doit être déployée pour être exécutée exécuter par le portail (typiquement dans le dossier @webapps@ d'un portail existant) :

<pre><code>deploy.home=/usr/local/uPortal/webapps/esup-geisha</code></pre>

Ce chemin doit être utilisé par l'administrateur du portail pour configurer le context du portail. Typiquement dans le fichier de configuration @tomcat/conf/server.xml@ :

<pre><code class="xml">
<Host name="localhost"
appBase="webapps" unpackWARs="true"
autoDeploy="true" xmlValidation="false"
xmlNamespaceAware="false">
<Context path="/esup-geisha"
docBase="/usr/local/uPortal/webapps/esup-geisha"
crossContext="true" reloadable="true">
<Manager pathname="" />
</Context>
</Host>
</code></pre>

h3. Déploiement en servlet

Indiquer le déploiement en servlet :

<pre><code>deploy.type=servlet</code></pre>

Indiquer où l'application doit être déployée pour être exécutée exécuter par le conteneur de servlet. Typiquement, dans le dossier @webapps@ d'un Tomcat existant :

<pre><code>deploy.home=/usr/local/tomcat/webapps/esup-geisha</code></pre>

Ce chemin doit être utilisé pour configurer le contexte de la servlet. Typiquement dans le fichier de configuration @tomcat/conf/server.xml@ :

<pre><code class="xml">
<Service name="Catalina">
<Connector port="8080"
maxHttpHeaderSize="8192" maxThreads="150"
minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443"
acceptCount="100" connectionTimeout="20000"
disableUploadTimeout="true" emptySessionPath="true" />
<Engine name="Catalina" defaultHost="helpdesk.domain.edu">
<Host name="helpdesk.domain.edu"
appBase="webapps" unpackWARs="true"
autoDeploy="true" xmlValidation="false"
xmlNamespaceAware="false">
<Context
path="" docBase="/usr/local/tomcat/webapps/esup-helpdesk"
crossContext="true" reloadable="false">
<Manager pathname=""
className="org.apache.catalina.session.StandardManager" />
</Context>
</Host>
</Engine>
</Service>
</code></pre>