Installation » History » Version 4

« Previous - Version 4/17 (diff) - Next » - Current version
Eric TOURAILLE, 09/14/2009 10:03 AM
Quelques corrections


Installation

Retour à la racine du manuel d'administration.

Modes de déploiement

Trois modes de déploiement sont disponibles :

  1. portlet : proposé pour les administrateurs de portail, il déploie l'application en une portlet JSR-168, exécutable dans une portail compatible (uPortal, liferay, infoglue, ...),
  2. servlet : proposé pour les administrateurs désireux d'exécuter l'application dans un conteneur de servlet existant (Tomcat, jetty, ...),
  3. quick-start : proposé pour tester l'application, l'application est exécuté dans un Tomcat embarqué.

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 (une machine virtuelle seule ne suffit pas).
  • Les commandes d'installation nécessitent l'utilitaire ant.
  • L'application est configurée par défaut pour se connecter à une base de données MySql. Toutefois, l'utilisation du framework Hibernate 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 (déploiements en servlet ou quick-start).

Téléchargement

La dernière version peut être récupérée 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.

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

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).

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

Propriétés communes

La propriété custom.recover.files permet de récupérer les 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.

Déploiement en quick-start

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

quick-start=true

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).

tomcat.port=8080
tomcat.shutdown-port=8009
tomcat.host=localhost

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.

Déploiement en portlet

Indiquer le déploiement en portlet :

deploy.type=portlet

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

deploy.home=/usr/local/uPortal/webapps/esup-geisha

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 :

<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>

Déploiement en servlet

Indiquer le déploiement en servlet :

deploy.type=servlet

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

deploy.home=/usr/local/tomcat/webapps/esup-geisha

Ce chemin doit être utilisé pour configurer le contexte de la servlet. Typiquement dans le fichier de configuration tomcat/conf/server.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>