Installation du package Esup

Ce paragraphe décrit de manière rapide 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.

Décompresser l'archive

tar -xvzf esup-2.6-esup-2.X.Y

Un répertoire esup-2.6-esup-2.X.Y est créé. On appellera ce répertoire la 'racine' du package. Il correspond au paramètre ${esup.root} du fichier build.properties.

Personnaliser le déploiement du portail

Vous pouvez adapter le fichier build.properties pour personnaliser l'emplacement du kit de développement Java, le mode d'installation (développement ou production), les différents répertoires d'installation, l'emplacement du fichier de configuration du portail.

Il faut au minimum préciser l'emplacement du kit de développement Java (${java_home}).

Le paramètre  ${devel_mode} permet d'indiquer si l'on veut faire une installation en mode de développement (ESUPDEV) ou de production (ESUP). Ceci a un impact sur les packages déployés et les tâches Ant disponibles.

Récupérer les archives des applications tierces

ant getcomponents

Télécharge les archives des applications uPortal (ESUP et ESUPDEV), Tomcat, Ant, HSQL (ESUPDEV uniquement) dans le répertoire ${esup.packages}.

Décompresser les archives des applications tierces

ant unzip

Les archives sont décompactées sous le répertoire ${esup.base}.

Configurer le portail

Vous devez modifier le fichier config.properties. C'est le principal travail à effectuer.

Initialiser le portail

ant init

Cette tâche :

• 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)

Tester la connection à la base de données du portail

ant db.test

Initialiser la base de données du portail

ant db.init

Déployer le portail

ant deploy