Groupe 1A (socle)

Date de création : 30 janvier 2004
Dernière modification : 25 octobre 2004
Diffusion : internet

Installation uPortal quick install Linux

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.

Installation de la JVM

récupéré à : http://java.sun.com/j2se/1.4.2/download.html

Installation uPortal

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

Quelques adaptations

- 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

Lancement

HSQL

exécuter le fichier hsql.sh

Le serveur HSQL s'exécute alors dans la console courante. (Faire Ctrl C pour l'arrêter).

tomcat - uPortal

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 :

Exemple de canal : CHelloWorld

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.

compiler et déployer le canal

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.

publication du canal

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

Utilisation du canal

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