Première installation du package Esup
Ce paragraphe décrit le processus d'installation et de paramétrage ; les paragraphes suivants détaillent les différents paramètres ou options. Les répertoires d'installation sont paramétrables dans le fichier build.properties. Ces paramètres sont indiqués entre accolades.L'installation complète peut (et devrait) se faire depuis un compte utilisateur non root. Il est bien sûr nécessaire que ce compte ait un droit d'écriture dans les différents répertoires utilisés.
Modes d'installation
Deux modes d'installation sont possibles :
...
Les fonctionnalités de ces deux archives sont les mêmes. La version "développement" est une sorte de quick start, préconfigurée avec une installation automatique des application tierces.
Récupération de la distribution :
Les distributions du projet peuvent être téléchargées ici : https://sourcesup.cru.fr/frs/?group_id=173&release_id=1843
Décompression de l'archive
tar -xvzf esup-uPortal-3.2.4-esup-x.y.z
Un répertoire esup-uPortal-3.2.x-esup-x.y.z est créé. On appellera ce répertoire la 'racine' du package. Il correspond au paramètre ${esup.root} du fichier build.properties.
Contenu du répertoire :
TODO : Arborescence
Personnalisation du déploiement du portail
Copiez le fichier build.sample.properties dans build.properties.
...
Voir le détail des options : 01 - build.properties (esup-3)
Récupération des archives des applications tierces
Lancez la commande :
| Bloc de code |
|---|
ant getcomponents |
Cette opération télécharge les archives des applications uPortal (ESUP et ESUPDEV), Tomcat, Ant, HSQL (ESUPDEV uniquement) dans le répertoire ${esup.packages}.
Décompression des archives des applications tierces
Lancez la commande :
| Bloc de code |
|---|
ant unzip |
Les archives sont décompactées sous le répertoire ${esup.base}.
Configuration du portail
Adaptez le fichier config.properties à votre environnement.
...
- tomcat.update : true (mode esupdev par défaut) : L'installation de esup-portail mettra également à jour la configuration de Tomcat
Initialisation du portail
Lancez la commande :
| Bloc de code |
|---|
ant init |
...
- Copie les scripts du répertoire ${esup.resources} /scripts vers la racine,
- copie les pilotes de base de données de ${esup.resources}/drivers vers ${esup.sources}/lib/container-common,
- copie les fichiers de personnalisation Esup dans ${esup.update}/uPortal vers le répertoire de distribution uPortal (${esup.sources}),
- copie vos fichiers de personnalisation dans ${esup.custom}/uPortal vers le répertoire de distribution uPortal (${esup.sources}),
- adapte les fichiers de configuration d'uPortal en fonction des paramètres de config.properties,
- adapte les fichiers de configuration de Tomcat en fonction des paramètres de config.properties (ESUPDEV uniquement)
Déploiement du portail
ant deploy
Compile et copie les fichiers nécessaires vers l'environnement d'exécution du portail (${esup.deploy})
Test de la connection à la base de données du portail
ant db.test
Permet de valider les informations de connection à la base de données du portail, indiquées dans le fichier config.properties (paramètres ${esup.db.xxx}) : url d'accès à la base, nom et mot de passe de l'utilisateur, classe java utilisée.
...
Si le sgbd est MySQL ou PostgreSQL , noter le "Database version" (dans les première lignes du rapport), et mettez cette valeur complète dans la propriété ${esup.db.db-version} du fichier config.properties|../display/ESUPMU/02+-+config.properties||||||\.
Initialisation de la base de données du portail
ant db.init
Cette tâche :
- Supprime les tables du portail indiquées dans le fichier ${esup.sources}/properties/db/esup-tables.xml
- Insère les données indiquées dans le fichier ${esup.sources}/properties/db/esup-data.xml
- Créé dans la base les groupes définis dans le fichier ${esup.sources}/properties/groups/esupGroupLoad.xml
- Publie tous les canaux définis dans le répertoire ${esup.sources}/properties/chanpub (correspond à la tâche ant chan.pub -Dchan.pub=all)
- Publie tous les layouts définis dans le répertoire ${esup.sources}/properties/layout (correspond à la tâche ant layout.import -Dusername=all)
Démarrage du portail
A partir de la racine du package :./start-esup.sh
...
Le portail est accessible via l'url suivante : http://Nom_d'hote:Port/uPortal\\
Modifications et redéploiements
Si vous modifiez le fichier config.properties ou vos personnalisations dans ${esup.custom}/uPortal, relancez les tâches ant init et ant deploy puis redémarrez le portail pour les prendre en compte
...