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.
Deux modes d'installation sont possibles :
Selon le mode d'installation choisi, vous téléchargerez une archive portant le nom esup-uPortal-3.2.x-esupdev-x.y.z (développement) ou esup-uPortal-3.2.x-esup-x.y.z (production)
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.
Les distributions du projet peuvent être téléchargées ici : https://sourcesup.renater.fr/frs/?group_id=173
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.
TODO : Arborescence
Copiez le fichier build.sample.properties dans build.properties.
Copiez le fichier config.sample.properties dans config.properties
Copiez le fichier ant.sample.sh dans ant.sh
Adaptez le fichier ant.sh à votre environnement.
Adaptez le fichier build.properties à votre environnement :
Voir le détail des options : 01 - build.properties (esup-3)
Si vous n'utilisez pas le mode de développement, vous devez préciser l'emplacement su serveur d'application Tomcat :
Si vous n'utilisez pas le mode de développement ou que vous avez déjà un client Maven sur votre machine, précisez :
Vous pouvez également personnaliser les différents répertoires d'installation, l'emplacement du fichier de configuration du portail. La suite de cette documentation de l'installation fera référence aux valeurs par défaut de ces paramètres.
Lancez la commande :
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}.
Lancez la commande :
ant unzip |
Les archives sont décompactées sous le répertoire Portail.
Adaptez le fichier config.properties à votre environnement.
Voir le détail des options : 02 - config.properties (esup-3)
Lancez la commande :
ant init |
Cette tâche :
ant deploy |
Compile et copie les fichiers nécessaires vers l'environnement d'exécution du portail : Portail/webapps
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...) : url d'accès à la base, nom et mot de passe de l'utilisateur, classe java utilisée.
S'il s'agit d'une installation sur une nouvelle base de données, la base doit préalablement être créée et l'utilisateur indiqué dans le fichier config.properties doit avoir des droits suffisants sur les objets.
Cette tâche affiche diverses informations sur la base de données. Si elle s'exécute avec succès (affichage de "BUILD SUCCESSFUL"), vous pouvez passer à la suite. Sinon, vérifiez et corrigez les paramètres de la base.
ant db.init |
Cette tâche :
Le répertoire mini contient les données du paquet "Esup" (données de uPortal adaptées et traduites).
Pour information, le répertoire entities contient les données d'origine de uPortal. Il n'est pas utilisé par la tâche db.init
Détail des types d'objets et des répertoires : dans le chapitre "Personnalisation"