wiki:EsupDep

Deploiement du Socle Esup sur un serveur Tomcat Existant

TOC?

Prérequis : un serveur Tomcat, un serveur CAS sécurisé par SSL, un SGBD (Mysql pour cet exemple), un clavier, une console

Testé sous Unix, faires les adaptations nécessaires pour windows...

Dézippage de l'archive

  • Dézippez l'archive :
tar -xvzf uPortal-2.5.x-esup-y.tar.gz 
  • vous obtenez un répertoire uPortal-2.5-esup-2.1.01 qui va servir à l'installation, ne pas l'effacer même après l'installation, c'est à partir de répertoire qu'il faudra opérer après d'éventuelles modifications du fichier de properties après la mise en service.

Configuration de l'installation

  • Ouvrir le fichier esup.properties avec votre éditeur préféré. Je vous conseille de tout paramétrer même ce qui a des valeurs par défaut qui vous convient.

Section chemins file systeme

  • esup.root : a changer si vous etes sur windows, mettre le chemin complet du répertoire que vous venez de dézippez.
  • java_home : indiquez le chemin complet de la jvm, pour moi c'est (sur ubuntu) : java_home=/usr/lib/jvm/java-1.5.0-sun/
  • esup.distrib : emplacement distribution esup-portail finale (sources et environnement de compilation), pour moi ce sera /home/esup/uPortal (sur unix assurez vous d'avoir les droits pour créer et écrire dans ce répertoire...).
  • esup.deploy : emplace de votre dossier webapps de Tomcat, pour moi c'est /home/tomcat/webapps
  • server.home : mettre le chemin de notre Tomcat, meme si nous n'utilisons pas le serveur Tomcat fournit avec le socle. Pour moi c'est /home/tomcat

Vous pouvez éventuellement changer l'emplacement des fichiers de logs, les autres paramètres de la section ne sont pas à modifier.

Section parametres de noms de hosts, ports, urls pour le serveur esup-portail

  • la section consacrée à Tomcat ne nous intéresse puisque nous n'utiliserons pas le serveur tomcat fourni avec le socle.
  • esup.public.host : adresse connue du public pour le serveur, super important, puisque c'est là que serons renvoyé les clients après authentification sur le serveur CAS. Dans un premier temps, on peut éventuellement mettre localhost. Pour moi ce sera nb888.
  • esup.public.proto : protocole utilise pour les accès publics au portail, vu que notre tomcat fonctionne en ssl, autant utiliser https.(mais il est peut être préférable d'utiliser http pour éviter de surcharger le serveur)
  • esup.public.port : mettre le port qui correspond au proto utilisé précedemment, pour moi c'est :8443 -> ne pas oublier le ":" !
  • esup.public.uri : répertoire dans lequel est situé le portail dans webapps, on peut laisser la valeur par défaut. (/uPortal)
  • Rubrique host reel : rien à faire, c'est pour faire du load balencing.

Section paramètres LDAP

  • esup.ldap.host : adresse du serveur ldap, pour moi c'est localhost
  • esup.ldap.port : port du serveur ldap, pour moi c'est 389
  • esup.ldap.baseDN : base du serveur ldap, pour moi c'est ou=people,dc=enib,dc=fr

Section paramètres CAS

  • esup.cas.host : nom du dns du serveur CAS, pour moi c'est nb888.
  • esup.cas.port.https : port https du serveur CAS, le serveur doit absolument fonctionner en SSL, pour moi c'est :8443 -> ne pas oublier le ":" !
  • esup.cas.uri : répertoire du serveur ou se situe le serveur CAS (pour moi c'est /cas)

  • Le reste n'est normalement pas à modifier.

Section acces db pour la base uPortal

  • esup.db.auth : si vous n'avez pas encore configuré de serveur LDAP comme moi pour le moment, laissez à true, c'est le seul moyen de s'identifier sur le portail. Si vous avez configuré le serveur LDAP, il vaut mieux utiliser un compte admin de LDAP et donc mettre cette valeur à false. Donc pour moi c'est true pour le moment.
  • esup.db.persondirs.use : mettre a true ou false de la meme façon que précedemment, pour moi c'est donc true.
  • esup.db.username & esup.db.password : username & mot de passe pour la base sql.
  • esup.db.url : url de la base de donnée avec le nom de la base à la fin; pour moi avec la base de donnée mysql uportal sur localhost, ça donne : jdbc:mysql://localhost/uportal
  • esup.db.jdbcDriverJar : mettre mysql-connector-java-3.0.15-ga-bin.jar pour une base mysql,ou le nom du driver qui correspond au type de base sinon.
  • esup.db.className : classe java du driver : com.mysql.jdbc.Driver pour sql
  • esup.db.db-version : version du serveur SQL, à modifier plus tard.

Vous pouvez passer directement à la section divers, les autres ne nous intéressent pas

Section parametres divers

  • esup.multiservers : a mettre a false, on utilise pas de load balancing ici.
  • esup.upload-maxsize : taille maxi autorisee pour les upload de fichiers, en byte
  • esup.render.columns : le mettre à false pour pouvoir avoir des colonnes.
  • server.deploy : le mettre à false pour que ne soit pas deployé le serveur Tomcat du Socle !!
  • esup.title.main : Titre du Portail

Vous pouvez eventuellement changer d'autre paramètres mais nous avons changé là l'essentiel

Installation

  • Ouvrir une petite console, allez dans le répertoire de esup et tapez :

Remplacez la valeur de JAVA_HOME par le chemin de votre JVM

nb888@nb888:/home/uPortal-2.5-esup-2.1.01$ export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun
nb888@nb888:/home/uPortal-2.5-esup-2.1.01$ ant esup.unzip
  • Ensuite, pour appliquer les personnalisations :
    ant esup.init
    
  • Pour compiler:
    ant uportal.compile
    
  • Pour tester l'accès à la db :
    ant uportal.dbtest
    
  • Pour initialiser l'accès à la bd :
    ant esup.db.init
    
  • Pour deploy esup vers le serveur :
    ant esup.deploy
    
  • il faut maintenant modifier la config de Tomcat. Ouvrez le fichier conf/server.xml et rechercher la balise host correspondant au host de Esup et rajoutez ces balises en adaptant les chemins :
    <Context path="/uPortal" docBase="/home/tomcat/webapps/uPortal" crossContext="true" reloadable="false">
    
        <!-- Maximum number of dB connections in pool. Set to 0 for no limit.-->
        <!-- Maximum number of idle dB connections to retain in pool. Set to 0 for no limit.-->
        <!-- Maximum time to wait for a dB connection to become available in ms, in this example 10 seconds. An Exception is thrown if this timeout is exceeded.  Set to -1 to wait indefinitely. -->
      <Resource name="jdbc/PortalDb" auth="Container" type="javax.sql.DataSource"
        username="uportal" password="uportal"
        driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost/uportal"
        maxActive="100" maxIdle="30" maxWait="10000"/>
    
      <Resource name="jdbc/PersonDb" auth="Container" type="javax.sql.DataSource"
        username="uportal" password="uportal"
        driverClassName="com.mysql.jdbc.Driver" url="jdbc:mysql://localhost/uportal"
        maxActive="100" maxIdle="30" maxWait="10000"/>
    
        <!-- Disables restart persistence of sessions -->
        <Manager pathname=""/>
    
    </Context>
    
  • il ne reste plus qu'à vérifier que le driver sql est présent dans tomcat (pour mysql, il doit y avoir /home/tomcat/common/lib/mysql-connector-java-3.0.15-ga-bin.jar ), si il n'est pas là, il faut le prendre dans le répertoire de esup et le copier (uPortal-2.5-esup-2.1.01/UpdateEsup/drivers).

  • Copier les librairies pluto-1.0.1-rc2.jar portlet-api-1.0.jar dans tomcat/shared/lib.
  • démarrez votre serveur Tomcat et enjoy !

Utilisation de Pages statiques

Mettre vos pages dans le dossier /home/ent/uPortal-2.5-esup-2.1.03/Custom/uPortal/webpages/static . Ensuite creez un canal de Type Frame avec pour url  http://ent.enib.fr/static/nondelapage

Sur le web

Attachments