Space Details - ESUP

Document generated by Confluence on Jun 10, 2008 08:53 Page 1
Space Details
Key: ESUPMU
Name: Projet uPortal-esup
Description: Le portail ESUP
Creator (Creation Date): jmarchal (May 27, 2008)
Last Modifier (Mod. Date): paubry (May 27, 2008)
Available Pages
•Documentation Package
•01 - Organisation
•02 - Tâches ANT
•04 - Configuration
•01 - build.properties
•02 - config.properties
•03 - custom.properties
•05 - Installation
•06 - Conseils d'utilisation
•07 - Personnalisations

Document generated by Confluence on Jun 10, 2008 08:53 Page 2
Documentation Package
This page last changed on Jun 03, 2008 by jmarchal.
Cette partie concerne la documentation l'utilisation du package en lui même.
Ce document décrit l'installation et le paramétrage du package du socle 'esup-portail' issu de la version
2.6 d'uPortal.
Le package contient l'intallation d'un serveur Tomcat (uniquement pour le package de développement),
de la distribution uPortal 2.6 et des librairies et personnalisations propres à l'environnement esup-portail.
Il permet de simplifier considérablement le paramétrage de base d'uPortal.
Le package ne livre pas les différents canaux esup-portail, à installer indépendamment.
On distingue 2 packaging différents :
•uPortal-esup : package de production contenant la distribution uPortal
•esupdev : package de développement contenant :
°la distribution uPortal
°tomcat
°hsql
°ant
Attention
Cette documentation est valable pour les distributions
-esupdev-2.6-esup-2.X.Y
-esup-2.6-esup-2.X.Y

Document generated by Confluence on Jun 10, 2008 08:53 Page 3
01 - Organisation
This page last changed on May 28, 2008 by vrepain.
Organisation file system de base
C'est l'organisation des dossiers et fichiers suite au décompactage du paquet Esup :
esup-2.6-esup-2.X.Y
| contribs
| | [...]
| custom
| | uPortal
| | Tomcat
| logs
| | [...]
| packages
| | [...]
| resources
| | [...]
| update
| | [...]
| build.sample.properties
| config.sample.properties
| build.xml
| CHANGELOG
| ant.[sh |cmd ]
Avec :
•contribs : Dossier contenant diverses contributions. Ces contributions ne sont pas déployées
automatiquement : vous devez les mettre vous-même dans votre dossier custom.
•custom : Dossier utilisé pour la personnalisation du portail : Vous pouvez y déposer vos propres
fichiers de configuration, sources, feuilles de transformation, feuilles de styles, etc. Ces fichiers
remplaceront ceux d'uPortal et du dossier update lors du déploiement. Pour chaque fichier,
vous devez respecter l'arborescence des dossiers dans lesquels il doit être déposé (exemple :
Une personnalisation de personDirectory.xml sera placée dans custom/uPortal/properties/
personDirectory.xml). Le dossier Tomcat n'est utilisable que dans le package esupdev.
•logs : Dossiers des logs par défaut
•packages : Dossier ou vont être stockés les distributions (compressées) des produits tiers
téléchargés avec ant getcomponents (uPortal, Ant, Tomcat, HSql...)
•ressources : Dossier contenant des fichiers nécessaire au fonctionnement du package.
•update : Dossier contenant les personnalisations Esup. Les sous-dossiers contiennent des fichiers
(fichiers de propriétés, librairies, sources, ...) qui seront déployés vers les sources uPortal
(esup.sources) lors du ant init, ou vers l'environnement tomcat (package esupdev uniquement)
et la racine de l'environnement exécutable (esup.deploy) lors du ant deploy. Ne pas modifier le
contenu de ce répertoire.
•build.sample.properties : Fichier d'exemple de configuration du fonctionnement du package. A
recopier en build.properties et adapter au minimum le paramètre java_home.
•config.sample.properties : Fichier d'exemple de configuration des distribution (uPortal). A recopier
en config.properties et à adapter.
•build.xml : Fichier servant à ant
•CHANGELOG : Fichier qui recense toute les changements dans le package
•ant.[sh | cmd] : Fichier de lancement des commandes ant.
Organisation file system après une première utilisation
esup-2.6-esup-2.X.Y
| contribs
| | [...]
| custom
| | uPortal

Document generated by Confluence on Jun 10, 2008 08:53 Page 4
| | Tomcat
| logs
| | last-ant-deploy-call.txt
| | last-ant-init-call.txt
| | [...]
| packages
| | [...]
| Portail
| | Ant-X.X.X
| | Hsqldb-X.X.X.X
| | Tomcat-X.X.X
| | uPortal_rel-X.X.X
| | webapps
| resources
| | [...]
| tmp
| update
| | [...]
| build.sample.properties
| config.sample.properties
| build.xml
| CHANGELOG
| ant.[sh |cmd ]
| env.[sh |cmd ]
| start-esup.[sh |cmd ]
| stop-esup.[sh |cmd ]
| esup-portail.keystore
On retrouve donc de nouveau :
•logs/last-ant-init-call.txt : Fichier trace du dernier ant init fait
•logs/last-ant-deploy-call.txt : Fichier trace du dernier ant deploy fait
•Portail/Ant-X.X.X : Dossier de distribution de Ant après ant unzip
•Portail/Hsqldb-X.X.X.X : Dossier de distribution Hsql après ant unzip (uniquement dans esupdev)
•Portail/Tomcat-X.X.X : Dossier de distribution Tomcat après ant unzip (uniquement dans esupdev)
•Portail/uPortal_rel-X.X.X : Dossier de distribution uPortal après ant unzip
•Portail/webapps : Dossier contenant le portail compilé après ant deploy. C'est le dossier qui sera
connu du moteur de servlet (tomcat) pour l'exécution du portail. Le déploiement du portail se fera
dans un sous-répertoire nommé uPortal, celui des éventuels portlets dans d'autres sous-répertoires
dédiés.
•tmp : Dossier temporaire utilisé lors de la construction du package
•env.[sh | cmd] : Script d'environnement esup
•start-esup.[sh | cmd] : Script de démarrage
•stop-esup.[sh | cmd] : Script d'arrêt
•esup-portail.keystore : keystore esup (cru)

Document generated by Confluence on Jun 10, 2008 08:53 Page 5
02 - Tâches ANT
This page last changed on May 29, 2008 by jmarchal.
Liste des tâche ant du package :
Error formatting macro: toc: java.lang.NullPointerException
Nom de la tâche Description Exemple
init Lance un initialisation du portail
(copie les updates, les customs,
etc)
ant.sh init
getcomponents Va chercher les distributions
(compressé) des package
dépendants (uPortal, Ant, etc ..)
ant.sh getcomponents
unzip Décompresse les packages
dépendants ant.sh unzip
deploy Déploie le portail dans le webapps ant.sh deploy
db.test Teste la connexion à la base de
données ant.sh db.test
db.init Vide et remplie la base de données
avec les informations esup-uportal
(demande une confirmation)
ant.sh db.test
db.unload Décharge une table de la base de
données ant.sh db.unload - Dtablename=up_channel
-Dxmlfile=properties/db/
up_channel_backup.xml
db.unloadall Décharge la totalité de la base de
données ant.sh db.unloadall - Dxmlfile=properties/db/
backup.xml
clean Nettoie le répertoire de build du
package ant.sh clean
undeploy Supprime l'ancien déploiement
uPortal
Demande de confirmation
ant.sh undeploy
hsql.start Démarre le serveur Hsql intégré
dans les package esup-uportal
(uniquement disponible dans
esupdev)
Ctrl + C pour arrêter
ant.sh hsql.start