Date de création : | 30 janvier 2004 | |
Dernière modification : | 25 octobre 2004 | |
Diffusion : | internet |
Ce document décrit une installation de type 'quick install' dans l'environnement Linux.
Il est devenu un peu obsolète, certaines procédures ayant changées à parir des releases 2.3 d'uportal.
L'objectif est de permettre à quiconque de faire une installation 'stand alone' très rapide d'uPortal afin d'en faire une évaluation, pour pour une plate forme de développement.
L'install a été réalisée sur une distribution redhat 7.3, avec un uPortal 2.2 et une JVM 1.4.2
La version quick-install installe ant, tomcat, un serveur SQL java (HSQL) pré installé, et uPortal.
Cette installation prend moins de 10 mn, temps de download non compris!!
Enfin, un chapitre est dédié à un exemple de compilation et d'installation d'un canal simple, CHelloWorld, comme tutoriel
Une doc de personnalisation après installation est également disponible.
Et enfin, un 'package' reprenant l'installation quick-install d'uPortal et ajoutant les personnalisations esup-portail est proposé sur ce site.
récupéré à : http://java.sun.com/j2se/1.4.2/download.html
depuis le site de download uportal :http://mis105.mis.udel.edu/ja-sig/uportal/download.html
choisir 2.2 Quick-start
Le fichier s'appelle uPortal_2-2-quick-start.zip
- ant.sh : ajouter les 2 lignes suivantes en tête du fichier :
JAVA_HOME=/usr/java/j2sdk1.4.2_03
ANT_HOME=/home/cri/vmathieu/uPortal/Ant
- créer un fichier de lancement du moteur hsql : hsql.sh
Il contient ceci:
!#/bin/sh cd uPortal ../ant.sh hsql
- créer un fichier de lancement du tomcat support d'uportal : start.sh
Il contient ceci :
#!/bin/sh JAVA_HOME=/usr/java/j2sdk1.4.2_03;export JAVA_HOME CATALINA_HOME=/home/cri/vmathieu/uPortal/Tomcat;export CATALINA_HOME CATALINA_BASE=$CATALINA_HOME;export CATALINA_BASE $CATALINA_HOME/bin/catalina.sh start
- créer un fichier d'arrêt du tomcat : stop.sh
#!/bin/sh JAVA_HOME=/usr/java/j2sdk1.4.2_03;export JAVA_HOME CATALINA_HOME=/home/cri/vmathieu/uPortal/Tomcat;export CATALINA_HOME CATALINA_BASE=$CATALINA_HOME;export CATALINA_BASE $CATALINA_HOME/bin/shutdown.sh
exécuter le fichier hsql.sh
Le serveur HSQL s'exécute alors dans la console courante. (Faire Ctrl C pour l'arrêter).
exécuter le fichier start.sh. Ca lance tomcat. Attendre quelques secondes.
Premier test : depuis un navigateur, lancer l'URL : http://server.fr:8080
On doir arriver sur la bannière de tomcat (version 5.0.16, s'il vous
plait !).
Puis, http://server.fr:8080/uPortal/ pour accéder à uPortal.
Plusieurs comptes sont dispos :
admin admin , student student, demo demo, ...
Si soucis :
La log d'uportal est uportal.log, et les logs de tomcat sont dispos dans le répertoire logs.
Pour arrêter uportal, lancer le script stop.sh
Remarque :
pour le fun, si vous voulez recompiler et déployer uPortal :
C'est un exemple de développement et d'intégration d'un canal très simple : CHelloWorld
Il est directement issu de la documentation 'Channel
Development Information' de l'université de Virginie.
Les documents xsl et ssl sont les mêmes mais le source Java a été
modifié afin de respecter les conventions de codage ESUP.
Donc, première étape, lire cette documentation. Tout le contenu du canal y est décrit.
Si vous n'avez pas le temps de tout suivre et d'intégrer par vous-même les indications de cette doc, un package d'installation de ce canal est fourni.
Ce package est juste destiné aux impatients, car il perd une partie de l'aspect didactique de la chose.
La suite de ce paragraphe concerne l'utilisation du package. Une bonne méthode pourrait être d'apporter des modifications aux sources, de recompiler, et de retenter d'autres mises à jour.
Le package fourni les fichiers build.xml et build.properties qui seront utilisés par ant pour les différentes opérations (compilation, déploiement, nettoyage, ...), un dossier 'source' qui contient le source java (en suivant une arborescence liée au package) et un dossier 'webpages' qui contient les feuilles xsl et le document ssl, toujours en suivant l'arborecence.
Vous devrez adapter le fichier build.properties à votre environnement.
Maintenant, les différents fichiers utiles au canal sont déployés dans l'environnement d'exécution 'uportal', et prêts à être utilisés.
Il reste à le publier, puis à l'instancier comme les autres canaux. Les paragraphes qui suivent montrent la démarche globale d'une manière très générale.
Ceci se fait depuis le portail, avec un compte utilisateur ayant les droits de publier des canaux
Et voila, le canal est publié avec certains paramètres et certains droits.
Le vérifier en se loguant à nouveau avec le compte admin, en cliquant sur 'Channel Manager', puis en choisissant 'modify a current published channel' ; le canal publié doit apparaitre dans la liste.
Se déloguer à nouveau
Ici, on se met à la place d'un utilisateur de ce canal. Il faut bien sûr qu'il ait le droit de s'attribuer ce canal (Everyone désigne tout utilisateur, donc tout va bien).