|
|
||
| Date de création : | 29 janvier 2004 | |
| Dernière modification : | 25 octobre 2004 | |
| Diffusion : | internet | |
Ce document décrit une installation de type 'quick install' dans l'environnement Windows.
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 un portable en Windows XP, 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!!
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 propsé sur ce site.
récupéré à : http://java.sun.com/j2se/1.4.2/download.html
Exécuter ce fichier, next, next, ...
La JVM s'installe par défaut dans C:\j2sdk1.4.2_03.
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 ; je l'ai décompacté
dans c:\uportal
le répertoire d'install est donc : C:\uportal\uPortal_2-2-quick-start
- ant.bat : ajouter les 4 lignes suivantes en tête du fichier :
set JAVA_HOME=C:\j2sdk1.4.2_03 set PATH=%PATH%;%JAVA_HOME%\bin set INSTALL=C:\uportal\uPortal_2-2-quick-start
set ANT_HOME=%INSTALL%\Ant_1-5-3
et commenter la ligne 5 ou 6, qui positionnait la variable ANT_HOME :
rem set ANT_HOME=%CD%\Ant_1-5-3
- créer un fichier de lancement du moteur hsql : hsql.cmd
Il contient une ligne :
ant hsql
- créer un fichier de lancement du tomcat support d'uportal : start.cmd
Il contient une ligne :
ant tomcatstart
- et enfin, le fichier stop.cmd qui contient ant tomcatstop
exécuter le fichier hsql.cmd
Le serveur HSQL s'exécute alors dans une console texte. (Faire Ctrl C pour l'arrêter).
exécuter le fichier uportal.cmd. Ca lance tomcat. Il s'exécute également dans une nouvelle console texte
Premier test : depuis un navigateur, lancer l'URL : http://localhost:8080
On doir arriver sur la bannière de tomcat (version 5.0.16, s'il vous
plait !).
Puis, http://localhost: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 à Tomcat_5-0-16/logs; regarder également le contenu de la console texte de tomcat.
Pour arrêter uportal, lancer le script stop.cmd
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).
| Création :29 janvier 2004 - Vincent Mathieu | |
|
Modifications : |