Child pages
  • 01 - Organisation (esup-3)

Organisation file system de base

C'est l'organisation des dossiers et fichiers suite au décompactage du paquet Esup :

esupdev-3.1.2-esup-X.Y-RCZ
   | contribs
   |    | [...]
   | custom
   |    | uPortal
   |    | Tomcat
   | logs
   |    | [...]
   | packages
   |    | [...]
   | resources
   |    | apache-ant-X.X.X
   |    | [...]
   | 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/uportal-impl/src/main/resources/properties/contexts/personDirectoryContext.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, Maven, Tomcat, HSql...)
  • ressources : Dossier contenant des fichiers nécessaires au fonctionnement du package.
  • ressources/apache-ant-X.X.X : Distribution Ant (uniquement en esupdev)
  • 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 distributions (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


esupdev-3.1.2-esup-X.Y-RCZ
   | contribs
   |    | [...]
   | custom
   |    | uPortal
   |    | Tomcat
   | logs
   |    | [...]
   | packages
   |    | [...]
   | Portail
   |    | apache-maven-X.X.X
   |    | apache-tomcat-X.X.X
   |    | maven-repo
   |    | uPortal_rel-3.X.X
   |    | webapps
   | resources
   |    | apache-ant-X.X.X
   |    | esup-portail.keystore
   |    | [...]
   | temp
   | update
   |    | [...]
   | build.sample.properties
   | config.sample.properties
   | build.xml
   | CHANGELOG
   | ant.[sh |cmd ]
   | env.[sh |cmd ]
   | start-esup.[sh |cmd ]
   | stop-esup.[sh |cmd ]


On retrouve donc de nouveau :

  • Portail/apache-tomcat-X.X.X : Dossier de distribution Tomcat après ant unzip (uniquement dans esupdev)
  • Portail/apache-maven-X.X.X : Dossier de distribution Maven après ant unzip (uniquement dans esupdev)
  • Portail/uPortal_rel-3.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.
  • resources/esup-portail.keystore : keystore esup (CRU + TCS)
  • temp : 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
  • No labels