01 - Organisation

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 dans lequel vous pouvez mettre vos personnalisations du portail (fichiers de configuration, sources, feuilles de transformation, feuilles de styles, etc.) Pour ce faire vous devez créer un dossier uPortal et reproduire les arborescences des fichiers que vous avez modifiés (le dossier Tomcat n'est utilisable que dans le package esupdev). Ces fichiers remplaceront ceux d'uPortal et du répertoire update lors du déploiement.
• logs : dossiers des logs par défaut
• packages : dossier ou vont être stockés les distributions (compressées)  des produits tiers téléchargées 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 (server.home) 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
• config.sample.properties : fichier d'exemple de configuration des distribution (uPortal)
• build.xml : fichier servant à ant
• CHANGELOG : fichier qui recense toute les changements dans le package

• ant.[sh | cmd] fichier de lancement des commande ant.

Organisation file system après une première utilisation

esup-2.6-esup-2.X.Y
   | contribs
   |    | [...]
   | custom
   |    | uPortal
   |    | 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 : trace du dernier init fait
• logs/last-ant-deploy-call.txt : trace du dernier deploy fait
• Portail/Ant-X.X.X : distribution de Ant
• Portail/Hsqldb-X.X.X.X : distribution Hsql (uniquement dans esupdev)
• Portail/Tomcat-X.X.X : distribution Tomcat (uniquement dans esupdev)
• Portail/uPortal_rel-X.X.X : distribution uPortal
• Portail/webapps : dossier webapps conteant le portail compilé
• 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)