...

• /ur/java/jdk1.5 est un lien symbolique vers la JVM 1.5 courante.
• /home/esup/BUILD/uPortal-package est un lien symbolique vers le répertoire de décompactage du package, ici BUILD/uPortal-2.5-esup-1.
• /home/esup/BUILD/uPortal-sources est un lien vers le répertoire BUILD/uPortal-2.5-esup-1-sources (à créer avant

  Balise Wiki{span:class=command}ant

  Span
  class command
  ant esup.unzip

  {span}
  
  ).
• /home/esup/PROD/webapps est un lien symbolique vers PROD/webapps-2.5-esup-1
• /home/esup/PROD/Tomcat est un lien symbolique vers PROD/Tomcat_5-5-9
  On crée également le répertoire /home/esup/BUILD/canaux, qui sera la racine de désarchivage des différents canaux installés.

...

• uPortal55.xml : C'est un fichier qui permet de définir les pools Tomcat de connexion aux différents bases de données.
• personDirectory.xml : ce fichier permet de faire un 'mapping' entre des attributs LDAP (ou issus d'une base SQL) avec des attributs uPortal. Voir [ce
  document|http://www.ja-sig.org/wiki/display/UPC/PersonDirectory] sur le wiki uportal.
• groups/PAGSGroupStoreConfig.xml : définition des groupes dynamiques uPortal. Voir [ce
  document|http://www.ja-sig.org/wiki/display/GAP/uPortal+PAGS+documentation] sur le wiki uportal.
• chanpub/XXXXX.xml : les fichiers de publication des différents canaux. Même s'il est possible de déclarer / modifier dynamiquement dans uPortal les canaux, nous préconisons de le faire par la publication de ces fichiers de description (utilisés par la commande

  Balise Wiki

  Span
  class command
  ant uportal.pubchan

  {span:class=command}ant uportal.pubchan{span}
  
  ), ceci afin de les rejouer ultérieur.
• al/xx-fragments.xml : les fragments poussés pour cette instance d'esup-portail.

  Custom/uPortal/lib

  
  Comme indiqué dans un pragraphe suivant, ce répertoire contiendra les librairies (fichiers .jar) nécessiare à l'exécution de certains canaux.

  Custom/uPortal/webpages

  
  Ca contenir les éventuels skins de l'établissement.

  Première installation du portail

  
  On utilise la procédure 'normale' :

• Span
  class command
  ant -buildfile

  Balise Wiki{span:class=command}ant -buildfile

  /home/esup/BUILD/uPortal-package/build.xml

  esup.unzip

  {

• Span

  }

  class command
  ant -buildfile /home/

  Balise Wiki{span:class=command}ant -buildfile /home/

  esup/BUILD/uPortal-package/build.xml

  esup.init

  {

• Span

  }

  class command
  ant -buildfile

  Balise Wiki{span:class=command}ant -buildfile

  /home/esup/BUILD/uPortal-package/build.xml

  esup.deploy{span} Balise Wiki{span:class=command}ant -buildfile

  esup.deploy

• Span
  class command
  ant -buildfile /home/esup/BUILD/uPortal-package/build.xml

  esup.db.init

  {span}

Installation des canaux

Comme indiqué prédédemment, un répertoire dédié aux canaux a été créé.

Chaque canal à la norme esup contient à sa racine un fichier

...

#Repertoire d'installation de Tomcat
tomcat.home  = /home/esup/PROD/Tomcat

#Repertoire d'installation d'uPortal
uportal.home = /home/esup/BUILD/uPortal-sources

#Repertoire de deploiement
deploy.home  = /home/esup/PROD/webapps/uPortal

A la racine du répertoire /home/esup/BUILD/canaux, un script shell est créé, afin de pouvoir compiler/déployer facilement l'ensemble des canaux, et de pouvoir rejouer cette installation (le terme déploiement ici ne comprend pas la déclaration des canaux dans la base esup-portail, mais la compilation et la recopie des classes java et des fichiers annexes aux canaux dans l'environnement de production).

...

Il est déconseillé de les ajouter directement dans ce répertoire ; nous conseillons de les ajouter dans BUILD/Custom/uPortal/lib, puis de lancer ensuite un

...

...

Ceci permet de suivre plus facilement les librairies liées aux canaux. En particulier, avant de recopier une nouvelle librairie dans ce répertoire, il faut s'assurer qu'un autre librairie de même nom n'y est pas présente, afin d'éviter les conflits.

...

Les modifications qui sont fortement susceptibles de nécessiter des modifications de paramètres sont préfixés de 5 étoiles "*****".

esup.properties

Vérifier que les paramètres sont toujours corrects. Voir CHANGELOG. Si modification nécessaire, penser à sauvegarder l'ancien fichier.

...

Comme l'installation originale, sans l'installation de la base : *

• Span

...

• class command
  ant -buildfile

  Balise Wiki{span:class=command}ant -buildfile

  /home/esup/BUILD/uPortal-package/build.xml

  esup.deploy

  {span}

Puis, nouveau déploiement des canaux :

Si problème

Il est possible de revenir en arrière très rapidement, en remodifiant les 3 liens symboliques liés à la version du package esup-portail.

...

Ensuite, il suffit de déployer l'environnement de production vers les serveurs 'esclaves'. En pratique, ceci peut se faire chaque nuit, depuis un script exécuté sur les esclaves, qui réalise les opérations suivantes :

• arrêt du portail

• Span
  class command
  rsync

  Balise Wiki{span:class=command}rsync{span}
  
  du répertoire /home/esup/PROD
• adaptation des quelques fichiers liés au serveur réel :
  • Logger.properties
  • portal.properties (logicalname)
  • web.xml (call back CAS)
  • ...

...