Déploiement du portail

Le déploiement complet du portail n'est pas trivial, mais n'est pas très compliqué non plus. Il se découpe en plusieurs étapes.

Configuration de Tomcat et Apache

La configuration de Apache et de Tomcat pour le portail a été faite sur la machine cdsPortal. Pour installer un autre serveur équivalent, le plus simple est de reprendre la configuration de cette machine.

Les fichiers spécifiques aux portails sont :

• /etc/apache2/conf.d/portal
• /etc/apache2/sites-available/portal
• /etc/apache2/sites-enabled/portal pointe sur le fichier précédent

• /etc/tomcat5.5/policy.d/50portal.policy

et

• /etc/tomcat5.5/policy.d/50cdslogin.policy pour le service CDSLogin

Déploiement de la servlet "CDSLogin"

• Création du WAR dans éclipse : dans le projet CDSLogin, créer le WAR en lançant ant sur build.xml
• Aller dans le manager de Tomcat : dans un navigateur, ouvrir l'URL http://cdsportal:8180/manager/html et s'identifier.
• Supprimer l'ancienne version de la servlet "CDSLogin", Pour la ligne "/CDSLogin", "CDS login service", cliquer sur "Undeploy" et confirmer.
• Installation de la nouvelle version : sur la même page, aller dans la partie "WAR file to deploy", sélectionner le fichier "CDSLogin.war" qui a été créé précédemment, et cliquer sur "Deploy".

• On peut vérifier le bon fonctionnement du service en pointant sur http://cdsportal.u-strasbg.fr/CDSLogin/login par exemple

Déploiement de la servlet "services"

• Création du WAR dans éclipse : pour le projet CDSPortal, faire un export, choisir "WAR file", choisir le fichier "services.war", cocher "Optimize for a specific server runtime" et choisir "Apache Tomcat v5.5", puis Finish.
• Aller dans le manager de Tomcat : dans un navigateur, ouvrir l'URL http://cdsportal:8180/manager/html et s'identifier.
• Supprimer l'ancienne version de la servlet "services". Pour la ligne "/services", "CDS services", cliquer sur "Undeploy" et confirmer.
• Installation de la nouvelle version : sur la même page, aller dans la partie "WAR file to deploy", sélectionner le fichier "services.war" qui a été créé précédemment, et cliquer sur "Deploy".
• Se loguer sur cdsportal, aller dans /var/lib/tomcat5.5/webapps/services/ , éditer iRods.properties : s/cdsPortalDev/cdsPortal/g , et redémarrer tomcat
• Dans le même répertoire, remplacer plotter.properties par plotter.properties.cdsportal

• On peut vérifier le bon fonctionnement du service en pointant sur http://cdsportal.u-strasbg.fr/services/aladin?target=m1&command=images par exemple
• Remarque : cette servlet est utilisée par la version "mobile" du portail

Déploiement du JAR services pour la servlet "portal" (anciennement servlet "client")

Comme la servlet cliente utilise directement le code de "services", il faut qu'elle est accès à ce code via un fichier jar. Voici comment c'est fait :

• Création du JAR dans éclipse : pour le projet CDSPortal, faire un export, choisir "JAR file", décocher toutes les ressources (dans le panneau de gauche), ouvrir CDSPortal et cocher "src", choisir le nom du jar "cdsServices.jar", puis Finish.
• Copier ce jar sur le serveur cdsPortal dans le répertoire "/var/lib/tomcat5.5/webapps/portal/WEB-INF/lib"
• Redémarrer Tomcat sur cdsPortal : en tant que root lancer la commande "/etc/init.d/tomcat5.5 restart"

• Si on utilise de nouvelles librairies (JAR), il faut les copier à la main dans "/var/lib/tomcat5.5/webapps/portal/WEB-INF/lib/"

Déploiement du JAR pour la servlet "portal" (pour GWT-RPC)

La servlet pour la partie cliente est installée. S'il faut l'installer sur une autre machine, le mieux est de reprendre tout le répertoire "/var/lib/tomcat5.5/webapps/portal". Le déploiement concerne essentiellement en la mise à jour du fichier "GWTPortal.jar".

La procédure est identique à celle décrite dans le paragraphe précédent.

• Création du JAR dans éclipse : pour le projet GWTPortal, faire un export, choisir "JAR file", décocher toutes les ressources (dans le panneau de gauche), ouvrir GWTPortal et cocher "src", choisir le nom du jar "GWTPortal.jar", puis Finish.
• Copier ce jar sur le serveur cdsPortal dans le répertoire "/var/lib/tomcat5.5/webapps/portal/WEB-INF/lib"
• Redémarrer Tomcat sur cdsPortal : en tant que root lancer la commande "/etc/init.d/tomcat5.5 restart"

Déploiement de la partie cliente

• Compiler l'application depuis Eclipse : click droit sur le projet, puis Google --> GWT Compile
• Créer le fichier TAR : aller dans le répertoire workspace/GWTPortal/war/ et exécuter la commande "tar cf portal.tar *"
• Copier le fichier TAR sur la machine cdsPortal
• Se logger sur le compte 'portal'
• Effacer l'ancienne version du portail sur cdsPortal : cd ~portal/httpd/html; rm -rf *
• Décompresser la nouvelle version sur cdsPortal : cp portal.tar ~portal/httpd/html; tar xf portal.tar; rm portal.tar
• Redémarrer Apache sur cdsPortal : en tant que root lancer la commande "/etc/init.d/apache2 restart"

Déploiement de la version mobile

• Il suffit de copier le répertoire workspace/GWTPortal/mobile dans ~portal/httpd/html/

Déploiement de nouveaux fichiers de configuration

Il s'agit de fichiers ".properties" ou bien "web.xml".

Pour la servlet "services", les fichiers du projet Eclipse sont déployés en utilisant la procédure ci-dessous. Ce sont les mêmes fichiers qui sont utilisés en environnement de développement. Avant le déploiement, il faut donc faire attention à ne pas déployer une version "dev" de ces fichiers. Cela concerne essentiellement "iRods.properties", qui doit pointer sur "cdsPortal" et pas sur "cdsPortalDev".

Pour la servlet client "portal", il y a 2 exemplaires de chaque fichier ".properties". Ceux qui se trouvent dans le répertoire "tomcat/webapps/ROOT" ne sont utilisés que en développement. Ceux qui se trouvent à la racine du projet sont une copie de ceux qui sont utilisés en test/exploitation. Mais si ces fichiers sont modifiés, il faut les copier à la main sur le serveur, dans le répertoire "/var/lib/tomcat5.5/webapps/portal" et redémarrer Tomcat. Il en est de même du fichier "web.xml", qui est inutilisé en développement, et qu'il faut déployer à la main si on a fait des modifs dans les communications RPC.

Si mise à jour de la version de gxt : copier le nouveau JAR dans /var/lib/tomcat5.5/webapps/portal/WEB-INF/lib

-- PascalWassong - 02 Dec 2008 -- ThomasBoch - 05 Oct 2010