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 :
- Développement : pour faire une installation rapide, des tests, découvrir le produit. Ce mode permet d'installer également des applications tierces nécessaires au fonctionnement du portail : Tomcat, Ant, et un moteur de base HSQL. L'installation rapide minimale est décrite ici : 02 - Installation rapide du paquet de développement.
- Production. Ce mode installe uPortal et l'adaptation Esup. Les applications tierces sont considérées déjà installées et configurées (voir prérequis).
...
Les distributions du projet peuvent être téléchargées ici : https://sourcesup.crurenater.fr/frs/?group_id=173&release_id=1843
Décompression de l'archive
| Bloc de code |
|---|
tar -xvzf esup-uPortal-3.2.4-esup-x.y.z
|
...
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}.
...
Lancez la commande :
| Bloc de code |
|---|
ant unzip
|
Les archives sont décompactées sous le répertoire Portail.
Configuration du portail
Adaptez le fichier config.properties à votre environnement.
...
Lancez la commande :
| Bloc de code |
|---|
ant init
|
Cette tâche :
- Copie les scripts du répertoire resources/scripts vers la racine,
- copie les fichiers de personnalisation Esup de update/uPortal/* vers le répertoire des sources uPortal Portail/uPortal-rel-3.2.4,
- copie vos fichiers de personnalisation (voir parties modifications et personnalisations) de custom/uPortal/* vers le répertoire des sources uPortal Portail/uPortal-rel-3.2.4,
- adapte les fichiers de configuration d'uPortal en fonction des paramètres de config.properties,
- copie les fichiers de personnalisation Esup pour Tomcat de update/Tomcat/* vers le répertoire de Tomcat Portail/apache-tomcat-6.0.29 (tomcat.update=true uniquement)
- adapte les fichiers de configuration de Tomcat en fonction des paramètres de config.properties (tomcat.update=true uniquement)
Déploiement du portail
| Bloc de code |
|---|
ant deploy
|
Compile et copie les fichiers nécessaires vers l'environnement d'exécution du portail : Portail/webapps
Test de la connection à la base de données du portail
| Bloc de code |
|---|
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.
Initialisation de la base de données du portail
| Bloc de code |
|---|
ant db.init
|
Cette tâche :
- Supprime les objets de la base de données du portail et les recréé
- Initialise la base de donnée à partir des fichiers (au format d'import uPortal) présents dans les répertoires :
- Portail/uPortal_rel-3.2.4/uportal-impl/src/main/resources/properties/db/base_entities
...
Détail des types d'objets et des répertoires : dans le chapitre "Personnalisation"