Télechargement

Le projet esup-helpdesk est téléchargeable à l'URL http://sourceforge.net/project/showfiles.php?group_id=103530.
Selon le déploiement souhaité, il faudra télécharger esup-helpdesk-x.y.z-t.zip (déploiement portlet ou servlet) ou bien esup-helpdesk-quick-start-x.y.z-t.zip (déploiement quick-start).

Voir : Déploiements portlet, servlet, quick-start 

Décompression des sources 

Décompressez l'archive téléchargée sur votre système de fichiers, par exemple dans */usr/local/helpdesk/src*. La décompression de *esup-helpdesk\[-quick-start\]-x.y.z-t.zip* crée le répertoire */usr/local/helpdesk/src/esup-helpdesk\[-quick-start\]-x.y.z*.

Edition du fichier build.properties

Le fichier build.properties indique à esup-helpdesk comment l'application sera déployée. 

Propriétés communes à tous les déploiements

Quelque soit le déploiement, les propriétés cas.url et custom.recover.files devront être renseignées.

cas.url 

La propriété cas.url indique l'URL principale du serveur CAS, par exemple :

cas.url=https://sso-cas.univ-rennes1.fr

custom.recover.files 

La propriété custom.recover.files n'est utilisée que pour la récupération automatique des personnalisations lors des mises à jour, par exemple :

custom.recover.files= properties/domain/xmlDepartmentSelection.xml

Déploiement quick-start

quick-start 

Il suffit d'indiquer qu'il s'agit d'un déploiement quick-start, de cette manière :

quick-start=true

Autres propriétés facultatives

Les propriétés tomcat.host, tomcat.port,  

...

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

Déploiement en portlet

deploy.type

Il faut indiquer quil s'agit d'un déploiement en portlet :

deploy.type=portlet

deploy.home

Il faut ensuite indiquer l'endroit où l'application sera déployée pour être exécutée par le portail, typiquement dans un sous-répertoire du répertoire webapps d'un uPortal existant :

...

<Service name="Catalina">
    <Connector port="8080" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="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 className="org.apache.catalina.session.StandardManager" pathname="" />
            </Context>
        </Host>
    </Engine>
</Service>

Déploiement en portlet

deploy.type 

Il faut indiquer qu'il s'agit d'un déploiement en servlet :

deploy.type=portlet

deploy.home 

Il faut ensuite indiquer l'endroit où l'application sera déployée pour être exécutée par le conteneur de servlets, typiquement dans un sous-répertoire du répertoire webapps d'un Tomcat existant, mais pas nécessairement :

...