| Sommaire | ||||
|---|---|---|---|---|
|
Les librairies
uPortal est packagé avec un certain nombre de librairies (fichiers .jar) nécessaires à son bon fonctionnement ; esup-portail ajoute un certain nombre de librairies communes à notre environnement.
...
- custom/uPortal/properties : On devrait y trouver au moins les fichiers suivants
- 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 sur le wiki uportal.
- groups/PAGSGroupStoreConfig.xml : définition des groupes dynamiques uPortal. Voir ce document 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 ant uportal.pubchan), ceci afin de les rejouer ultérieur.
- dlm.xml : les fragments poussés pour cette instance d'esup-portail.
- layouts/XXXX.xml : fichier cml répresentation des environnements utilisateurs modèle pour des popuplations
- 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' :
- ant -buildfile /home/esup/src/esup-package/build.xml getcomponents
- ant -buildfile /home/esup/src/esup-package/build.xml unzip
- ant -buildfile /home/esup/src/esup-package/build.xml init
- ant -buildfile /home/esup/src/esup-package/build.xml db.test
- ant -buildfile /home/esup/src/esup-package/build.xml db.init
- ant -buildfile /home/esup/src/esup-package/build.xml deploy
- /home/esup/src/esup-package/start-esup.sh
Installation d'une nouvelle version du package
Ce paragraphe décrit l'installation une version mineure, qui n'impacte pas la base esup-portail.
Grace aux différents liens symboliques utilisés, on s'assure d'un retour en arrière facile.
On suppose ici qu'on installe la version esup-2.6-esup-2.0.2.
Les liens symbolique
On déporte les différents liens symboliques vers les nouveaux répertoires :
- /home/esup/src/esup-package vers src/esup-2.6-esup-2.0.2.
- /home/esup/src/esup-sources vers src/uPortal_rel-2.6.2-GA
- /home/esup/webapps vers webapps-2.6-esup-2.0.2
Décompresser le package dans /home/esup/src donc vers src/esup-2.6-esup-2.0.2
Pour vos custom
D'une manière générale, commencer par lire le fichier CHANGELOG de la nouvelle version du package.
Les modifications qui sont fortement susceptibles de nécessiter des modifications de paramètres sont préfixés de 5 étoiles "*****".
Properties
cp src/esup-2.6-esup-2.0.1/custom.properties src/esup-2.6-esup-2.0.2/
Installation
Comme l'installation originale, sans l'installation de la base :
- ant -buildfile /home/esup/src/esup-package/build.xml getcomponents
- ant -buildfile /home/esup/src/esup-package/build.xml unzip
- ant -buildfile /home/esup/src/esup-package/build.xml init
- ant -buildfile /home/esup/src/esup-package/build.xml deploy
Redéployer vos canaux.
Arrêt - Relance du portail
D'une manière générale, il est préconisé de faire un redémarrage du portail à intervalle régulier, toutes les nuits par exemple.