Application CIELL2 PROCEDURE D INSTALLATION Réf. : S2I-CIELL2-PI-1.0 Version : 1.0 Auteurs : S2I-TOULON
S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 2/23
Installation Serveur Web Liste des différents modules à installer en plus des bases de données et du JDBC associé. Java SDK 1.4 Sun Tomcat v 5.0.x Pour information, les outils de développement utilisés sont : Eclipse 2.11 Plugin Lomboz pour Eclipse 2.11 Installer JDK Installation de la Machine virtuelle Java Pour faire fonctionner Tomcat, il est impératif de disposer d'une machine virtuelle Java. Celle-ci doit être compatible avec le standard Java 2. Pour cela, procurez-vous le Kit de développement Java standard (SDK) version 1.4.2, que vous pouvez télécharger sur le site de Sun à l'url suivante : http://java.sun.com/j2se/1.4.2/download.html Il vous faut charger la Windows Off Line Installation. Une fois téléchargé, double-cliquez sur l'exécutable et exécuter les actions suivante : - Accepter la licence - Au deuxième écran changer le répertoire d'installation en c:\javasdk - Répondre aux questions pour finir l'installation. S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 3/23
Variables d'environnement : Il faut ensuite paramétrer certaines variables d'environnement. Elles seront nécessaires au bon fonctionnement de Tomcat. Pour Windows NT/2000/XP, rendez-vous dans les propriétés du poste de travail (clique-droit sur Poste de Travail, Propriétés), puis cliquez sur l'onglet "Variables d'environnement". Sélectionnez "Path" et cliquez sur "Edit" (ou "Modifier"). Ajoutez au début de la liste le chemin complet vers l'endroit où le JDK a été installé, suivi de "\bin". Dans la fenêtre ci-dessus, le chemin est c:\javasdk\bin; car le JDK a été installé dans c:\javasdk. Validez en cliquant sur "OK". Revenu à la fenêtre précédente, cliquez cette fois sur "New" (ou "Nouveau"). Remplissez cette nouvelle fenêtre comme suit, en spécifiant dans la partie "Variable value" ("Valeur de la variable") le chemin vers l'endroit où le JDK est installé. S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 4/23
Sous Windows 95/98/Me, ajoutez les lignes suivantes dans le fichier AUTOEXEC.BAT : SET PATH=C:\JavaSDK\BIN;%PATH% SET JAVA_HOME=C:\JavaSDK Attention avec la ligne SET PATH, si une ligne similaire existe déjà, ajoutez la ligne décrite précédemment en dessous de toute ligne existante. Tout savoir sur Tomcat5 Si vous souhaitez en connaître un peu plus sur Tomcat5, n hésitez pas à consulter : http://jakarta.apache.org/tomcat/tomcat-5.0-doc/index.html Installer Tomcat5 Tout d'abord, téléchargez la version de Tomcat5 à l'adresse : (Attention si vous êtes protégé par un FIREWALL il faut paramétrer votre navigateur en mode PASSIF.: Internet explorer est par défaut en mode non passif Modifier dans "OUTILS/Option internet /onglet Avancé chapitre Navigation" (presque à la fin) ftp://mir2.ovh.net/ftp.apache.org/dist/jakarta/tomcat-5/v5.0.14-beta/bin/jjava_homeakarta-tomcat-5.0.14.exe Si vous devez télécharger ce fichier à partir d un autre site mirroir, il vous faudra adapter ce chemin. Le fichier est de l ordre de 10,3 Moctets.Il s agit du fichier d installation : Jakarta-tomcat-5.0.14.exe Warning : Il ne faut pas charger le fichier ZIP qui ne propose pas d installer TOMCAT5 en tant que service. Exécuter le programme "Jakarta-tomcat-5.0.14.exe" en spécifiant (quatrième écran)comme répertoire d'installation "C:\JavaSDK\jakarta-tomcat": S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 5/23
Entrez un login et mot de passe administrateur et prenez comme chemin de machine virtuelle c:\javasdk Ce programme installe Tomcat en tant que service mais ne le démarre pas. Créez ensuite une nouvelle variable d'environnement (comme fait précédemment pour le JDK) dénommée CATALINA_HOME et pointant vers le répertoire où l'archive a été décompactée. Celle-ci est nécessaire au fonctionnement de Tomcat et désigne son répertoire de travail. Note de GREG : Je croyais que le chemin indiqué plus haut était c:\jakarta-tomcat Si tomcat n'est pas installé comme un service (déconseillé!!!) Créez un fichiers tomstart.bat et tomstop.bat contenant les instructions suivantes : tomstart.bat @%CATALINA_HOME%\bin\startup tomstop.bat @%CATALINA_HOME%\bin\shutdown Pour démarrer ou arrêter Tomcat, il suffira d'exécuter le script correspondant. Il est préférable que Tomcat soit installé comme service avec démarrage automatique ; en cas de coupure de courant (même avec votre onduleur!), il est important que tout redémarre automatiquement, y compris Tomcat. Service windows : Puisque vous utilisez Windows NT/2000/XP, Tomcat doit être installé comme service. S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 6/23
Pour activer le service, on peut aussi cliquer avec le bouton droit sur l icône de Tomcat qui se trouve dans la barre des taches, puis cocher Auto start comme ci-dessus. Cela ne marche pas Pour démarrer Tomcat, vous pouvez utiliser le gestionnaire de services de Windows ou bien saisir la commande net start tomcat dans une fenêtre DOS. Pour supprimer Tomcat de la liste des services, exécutez les commandes suivantes dans une fenêtre DOS : net stop tomcat "%CATALINA_HOME%\bin\tomcat.exe" -uninstall Tomcat Pour vérifier que Tomcat est convenablement installé, ouvrez votre navigateur et saisissez comme URL http://nomduserveur:8080/ ou http://127.0.0.1:8080/ Vous devriez obtenir le résultat suivant : S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 7/23
En cas de problème, vous pouvez consulter les journaux de Tomcat dans le sous-répertoire logs de Tomcat. Pour tester les exemples (si vous avez choisi de les installer!), il vous faut saisir l URL suivante : http://adresseip de votreserveur:8080/jsp-examples/ ou http://127.0.0.1:8080/jsp-examples/ Pour tester les servlets (si vous avez chois de les installer!), il vous faut saisir l URL suivante : http:// AdresseIP de votreserveur:8080/servlets-examples/ ou http://127.0.0.1:8080/servlets-examples/ Installer IIS IntegrationTomcat/IIS Fichiers concernés : - Isapi Redirector.reg - isapi_redirector2.dll - jk2.properties (mode JNI ou exclusif socket) - workers2.properties (mode JNI ou exclusif socket) S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 8/23
Sauf incompréhension de notre part, seuls les fichiers de type socket sont à utiliser puisque nous installons TOMCAT5 en tant que service qui fonctionne comme processus indépendant de IIS. 1 Installer le fichier isapi_redirector2.dll dans la bibliothèque «c:\javasdk\jakarta-tomcat\bin» 2 Dans «démarrer/programmes/outils d administration/gestionnaire des services internet», créez un nouveau répertoire virtuel en cliquant (bouton droit) sur «Site Web par défaut» dont l alias est «Jakarta» qui pointe sur : «c:\javasdk\jakarta-tomcat\bin» dont les droits d accès sont de lecture et d exécution des scripts (ASP, CGI et ISAPI). Pour vérifier les droits d accès : Il faut ouvrir l explorateur et «cliquer droit sur le répertoire bin de «c:\javasdk\jakarta-tomcat\bin» pour modifier les droits d accés. S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 9/23
3 Supprimer le fichier jk2.properties de la bibliothèque «c:\javasdk\jakarta-tomcat\conf» et le remplacer par le fichier jk2.properties (pour socket) et enfin le renommer en jk2.properties. S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 10/23
4 Recopier le fichier workers2.properties (pour socket) dans la bibliothèque «c:\javasdk\jakarta-tomcat\conf» et le renommer en workers2.properties. Vérifier, en éditant ce fichier, qu il pointe sur la bonne bibliothèque «conf». Vous n aurez à modifier l adresse «host» que si votre serveur Tomcat est différent que le serveur IIS ; en laissant l adresse «127.0.0.1», vous devriez éviter de saturer le réseau externe à votre serveur «Tomcat/IIS». 5 Copier le fichier Isapi-Redirector.reg dans «c:\javasdk\jakarta-tomcat\conf» et l ouvrir pour le modifier par le contenu suivant : Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation] [HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector] [HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\2.0] "serverroot"="c:\\javasdk\\jakarta-tomcat" "extensionuri"="/jakarta/isapi_redirector2.dll" "workersfile"="c:\\javasdk\\jakarta-tomcat\\conf\\workers2.properties" "loglevel"="debug" "logfile"="c:\\javasdk\\jakarta-tomcat\\conf\\iis_redirect.log" 6 Après avoir fermer le fichier Isapi_Redirector.reg, cliquez deux fois sur son icône pour activer la modification des registres. 7 Retournez sur le gestionnaire des services internet pour ajouter ( Click droit sur «site par défaut») un filtre ISAPI qui pointe sur la DLL isapi-redirector.dll de la bibliothèque bin (cf. $1 ). Faites Ajouter, donnez un nom au filtre et faites 'parcourir' pour pointer sur le fichier isapi_redirector2.dll : S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 11/23
8 Arrêter le serveur IIS ( dans «démarrer/ panneau de configuration/outils d administrations/services/service de publication World Wide Web») et le relancer. Si vous retournez sur les filtres ISAPI, vous devez avoir une flèche verte qui vous indique que vos manœuvres se sont bien passées. Installer les drivers JDBC pour SQL Server Il vous faut télécharger le «SQL Server 2000 driver for JDBC service pack 1» (qui semble d ailleurs être le service pack 2!) à l URL suivante : S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 12/23
http://www.microsoft.com/sql/downloads/default.asp Prendre le fichier setup.exe (~2321kb) Après vous être authentifier pour obtenir le.net Passport (obligatoire par server SQL, ce qui explique pourquoi le driver ne peut vous être livré avec l installation de l application), vous pourrez suivre la procédure d installation suivante. S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 13/23
S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 14/23
S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 15/23
Dans le cas de la réinstallation de l un ou l autre de ces modules précédents, il arrive que certains fichiers que vous aviez correctement installés «disparaissent». Si vous avez un disfonctionnement, il vous faut vérifier la présence des trois modules msbase.jar, mssqlserver.jar et msutil.jar dans le répertoire C:\JavaSDK\jakarta-tomcat\common\lib. Sinon les copier du répertoire C:\Program files\microsoft SQL Server 2000 for JDBC\dans le répertoire C:\JavaSDK\jakarta-tomcat\common\lib Installer Apache IntegrationTomcat/Apache IIS S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 16/23
Paramètre de l'application Fichier paramètre WebCiell2.xml de l'application Le fichier WebCiell2.xml livrée avec l'application sera à copier dans le répertoire : C:\JavaSdk\jakartatomcat\conf\Catalina\localhost Il faudra le modifier (avec NotePad) en fonction de votre environnement, principalement les 4 lignes suivantes seront à adapter : <parameter> <name>driverclassname</name> <value>com.microsoft.jdbc.sqlserver.sqlserverdriver</value> </parameter> <parameter> <name>url</name> <value>jdbc:microsoft:sqlserver://nomduserveurbdd:1433</value> </parameter> <parameter> <name>username</name> <value>nomconnecteur</value> </parameter> <parameter> <name>password</name> <value>motdepasse</value> </parameter> Il s'agit de: - nom du driver JDBC pour la base de donnée (ne pas modifier cette valeur si vous utilisez le JDBC SQL Server de Microsoft) - Nom du serveur de base de données et son numéro de port - Nom du connecteur pour le serveur de base de donnée - mot de passe du connecteur Deux autres lignes méritent une très grande attention lors de l installation comme lors des mises à jour. - La valeur entre les «tags» <Value> correspondant à removeabandonedtimeout (ici de 300 en secondes) doit impérativement être cohérente (en secondes!!!) avec la valeur indiquée en minutes dans le fichier Web.XML dans le répertoire C:\JavaSdk\jakarta-tomcat\conf (L expérience a montré que le fichier à modifier est (ausii?) le fichier C:\JavaSdk\jakarta-tomcat\WebCiell2\WEB-INF\Web.xml) :. La partie spécifique est décrite en note 1 de bas de page et sera systématiquement écrasée lors du chargement de chaque mise à jour du WebCiell2.war!!! A vous d aller vérifier le contenu de ce fichier Web.xml après chaque mise à jour! Pour des raisons de développement, cette valeur dans WEB.XML sera positionnée à 1 minute- (comme 60 secondes dans WebCiell2.XML!). - La valeur entre les «tags» <Value> correspondant à maxactive doit correspondre aux capacités techniques et légales de connexions simultanées sur votre serveur de base de données. <!-- Hors temps en seconde avant de considerer une connexion comme non utilisee --> <parameter> <name>removeabandonedtimeout</name> <value>300</value> </parameter> <!-- Nombre maximum de connexions autorisees sur la base de donnees (0 pour pas de limite) --> <parameter> <name>maxactive</name> <value>40</value> </parameter> 1 <!-- ==================== Default Session Configuration ================= --> <!-- You can set the default session timeout (in minutes) for all newly --> <!-- created sessions by modifying the value below. --> <session-config> <session-timeout>5</session-timeout> </session-config> S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 17/23
Driver JDBC & librairies Les librairies et drivers utilisés sont installées dans : C:\JavaSdk\jakarta-tomcat\common\lib Elles sont fournies avec l'application. Lors de notre installation, les fichiers *.jar installés par le driver JDBC de Microsoft ont été aussi copiés dans ce répertoire. ( voir remarque plus haut verifier la présence de ces modules) S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 18/23
Installation de la base de données SRVCIELL Importation de la base de données SQLServer Sur le serveur Ftp un fichier compacté de la base de données est disponible : BaseTestCiell2.zip Décompactez ce fichier sur votre bureau et, dans EntrepriseManager de SqlServer, effectuez une restauration de base de données à partir du fichier décompacté. N'oubliez pas d'indiquer le chemin de destination des fichiers de données (onglet Option). Exécution d'un script Le script de la base de données est fourni sur le serveur ftp. Il suffira donc d'exécuter ce script sur le serveur de base de données. Utilisateurs/Connecteurs Pour la connexion à la base de données le système utilise un login/mot de passe unique : cette connexion est à mettre à jour dans le fichier WebCiell2.xml décrit plus haut. Après avoir créé cet utilisateur il faudra lui indiquer la base de données qui lui est associée par défaut ainsi que les droits d'accès sur chaque table. Vous pouvez utiliser le fichier «GrantSrvCiell.sql» que vous pourrez exécuter en tant que sa (ou équivalent). Déploiement et Mise à jour l application WebCiell2 Pour déployer ou mettre à jour une version de WebCiell2, il suffit de faire glisser le fichier de mise à jour nommé WebCiell2.war dans le répertoire : C:\JavaSdk\jakarta-tomcat\webapps Il n'est pas utile de relancer Tomcat, la mise à jour se faisant 'à chaud', presque immédiatement. Tester le fonctionnement Lancer la page d'accueil et l'actualiser après la mise à jour du fichier war. La fenêtre de commande de TomCat ayant préalablement indiqué, sur le serveur, que la mise à jour s'est bien effectuée. S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 19/23
Questions les plus fréquentes Après deux jours je n'ai pas réussi a faire fonctionner la version ciell-bêta sur IIS et SQL en suivant la doc Tomcat est bien installé j'ai la page ouverture Dois je utiliser Tomcat Administration et Tomcat Manager? avec quels compte et mot de passe? L'installation de Tomcat comme service ne fonctionne pas pas de pb pour install IIs et Driver JDBC Importation de la base pas de pb a part le script qu'il faut modifier pour" groupe" L'un d'entre vous a t-il réussi à faire marcher CIELL2 avec win2k, IIS et SQL? ----- Original Message ----- From: XXXX To: YYY Sent: Tuesday, November 25, 2003 4:08 PM Subject: Re: [ciell-beta] Installation de la version Beta plateforme IIS et SQLServeur Suite aux conseils de ZZZZ j'ai progressé j'obtiens sous le logo de CIELL2 le message suivant : Service indisponible Ce service est actuellement indisponible. Nous vous remerçions de bien vouloir renouveler votre demande ultérieurement j'ai testé ma connection au serveur SQL avec ODBC avec "CandidatCiell2" et "abc123"c'est bon j'ai fait le test avec _testcontext.jsp j'ai bien une trace de type env -> org.apache.naming.namingcontext jdbc -> org.apache.naming.namingcontext Ciell2 -> org.apache.commons.dbcp.basicdatasource J'ai vérifié WebCiell2.xml et je bloque Avez-vous testé la connexion base à l'aide de la page de _testbase.jsp? Voir mon message de la liste Ciell-Beta du 20/11/2003, 15h44. S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 20/23
je tente depuis deux jours d'installer la version BETA de CIELL2 avec IIS comme serveur WEB et SqlServeur comme serveur de base de données. Après avoir pas mal essayé de choses je peux accèder à l'applicatif CIELL2 par l'url TOMCAT http://aravis:8080/webciell2 mais j'obtiens sous le logo de CIELL2 le message suivant : Service indisponible Ce service est actuellement indisponible. Nous vous remerçions de bien vouloir renouveler votre demande ultérieurement. D'après Philippe cela viendrait de ma connexion à la base de données: Bonjour, Ci-joint une page nommée "_testbase.jsp" qu'il faut installer dans le répertoire TOMCAT_HOME/webapps/WebCiell2 après déploiement de la version du serveur à tester. Appelez cette page directement à l'aide de l'url http://aravis:8080/webciell2/_testbase.jsp. Elle doit vous fournir un message précisant si l'accès à la base de données a pu être réalisé avec succès. Si on vous indique que la connexion avec la base n'a pu être établie, utilisez la page _testcontext.jsp (url http://aravis:8080/webciell2/_testcontext.jsp) qui affiche le contenu du contexte courant. Vous devez y retrouver une trace de type... env -> org.apache.naming.namingcontext jdbc -> org.apache.naming.namingcontext Ciell2 -> org.apache.commons.dbcp.basicdatasource Si rien de ce genre ne vous apparaît, vérifier la présence et le contenu du fichier de configuration WebCiell2.xml qui doit être placé dans le répertoire TOMCAT_HOME/conf/Catalina/localhost. Bonne chance. Autre réponse Bonjour, Avez-vous installé les librairies JDBC/SqlServer dans le bon répertoire? Je me permets de rappeler que trois fichiers (msbase.jar, mssqlserver.jar et msutil.jar) sont à copier dans le répertoire TOMCAT_HOME/common/lib. Pas d'autre suggestion pour le moment. S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 21/23
Tomcat5 n est pas installé comme service Que dois-je faire? Vous avez du installer avec le fichier ZIP au lieu du fichier EXE Il faut charger le fichier.exe de ~10 Moctets pour tomcat. Les autres ne semblent pas effectuer le même travail d'installation. Autre réponse La version auto-installable de TOMCAT (executable) est la seule permettant une installation de Tomcat en "service". Si vous avez installé la version "a dézipper" (qui ne modifie rien du tout au niveau du système et qui n'active donc pas le mode "service"), il est difficile de changer... j'ai trouvé sur Internet une seule procédure qui ne fonctionne pas... Si quelqu'un a d'autres infos... ça fonctionne (sans passer par ISS) http://194.167.228.155:8080/webciell2/ et avec ISS http://194.167.228.155 il y a de la friture! Vu les symptômes, le filtre IIS n'est pas actif (flèche verte à côté du filtre "Jakarta" dans la liste des filtres Isapi?) et les pages JSP ne sont pas transmises à Tomcat. Si filtre actif, avez-vous arrêté et relancé le "service de publication World Wide Web" dans votre gestionnaire de service après son installation? S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 22/23
J obtiens cela Il est fort probable que l alias «Jakarta» pointe sur un répertoire dont les droits d accés n ont pas été correctement positionné (cf. le 2 de l intégration Tomcat/IIS). S2I-CIELL2-PI-1.0 mardi 10 juin 2003 Page 23/23