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.
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 en bas de chapitreici : 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).
...
Selon le mode d'
...
Unix, Linux. L'installation en mode de développement peut être faite sur un système Windows.
Base de données
Fonctionne avec un SGBD acceptant du SQL standard et les transactions, et proposant un drivers JDBC natif.
Testé avec MySQL (version 4 ou supérieure), PostgreSQL, Oracle. Les pilotes pour MySQL et PostgreSQL sont fournis dans le package.
Si vous utilisez un autre système, placez le pilote dans le répertoire ${esup.custom}/uPortal/lib/container-common avant l'initialisation du portail (voir plus bas)
Environnement JAVA
Un JDK 1.5 doit être préalablement installé sur le (ou les) serveur supportant le portail.
La variable JAVA_HOME doit être valuée, et le chemin $JAVA_HOME/bin rajouté au PATH
ANT
Le logiciel ANT doit être installé, avec une version égale ou supérieure à 1.6.5.
La variable ANT_HOME doit être valuée, et le chemin $ANT_HOME/bin rajouté au PATH
Authentification
En environnement de production, un serveur CAS doit être opérationnel au sein de l'établissement.
Annuaire LDAP
L'établissement doit disposer d'un annuaire LDAP exhaustif et compatible Supann.
Tomcat
Dans le cadre d'une installation de production (non esupdev) Tomcat n'est pas distribué par esup et doit donc être installé manuellement.
...
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.
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.6x-esup-2x.Xy.Yz est créé. On appellera ce répertoire la 'racine' du package. Il correspond au paramètre ${esup.root} du fichier build.properties.
...
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ération des archives des applications tierces
ant getcomponents
...
Vous devez adapter le fichier config.properties\. C'est le principal travail à effectuer.
...
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\.
Initialisation de la base de données du portail
ant db.init
...
Balise Wiki Modifier le fichier \[tomcat\]/conf/server.xml
- Ajouter le contexte uportal vous pouvez vous baser sur le fichier exemple dans update/uPortal/properties/uPortal55.xml
Balise Wiki remplacer les tags @\[TAG\]@ par les valeur correspondante a vos configurations \\
| Balise Wiki |
|---|
A partir des version esup\[xx\]-2.0.3 vous diposez d'une target \_tomcat.genconf qui vous affiche le contenu correct du contexte a mettre dans votre configuration Tomcat |