Configuration d'un serveur Web et d'un serveur d'applications sur des machines distinctes (scénario distant)

WebSphere® Application Server fournit un plug-in de serveur Web que vous pouvez configurer pour communiquer avec une marque particulière de serveur Web. Apprenez à installer le serveur Web et son plug-in de serveur Web pour WebSphere Application Server sur une machine et à configurer le serveur d'applications dans le profil par défaut sur une autre machine pour communiquer avec le serveur Web.

A propos de cette tâche

L'installation des plug-in du serveur Web installe le module plug-in. L'outil de configuration des plug-in du serveur Web configure le serveur Web pour qu'il communique avec le serveur d'applications et crée une définition de configuration du serveur Web dans le serveur d'applications, si possible.

Configurations prises en charge: Cet outil est pris en charge uniquement sous AIX®, Linux®et Windows. Au lieu d'utiliser l'outil de configuration de plug-in du serveur Web, vous pouvez vous servir de l'outil de ligne de commande pct avec un fichier de réponses pour configurer un serveur Web. Pour plus d'informations, voir Configuration d'un plug-in de serveur Web à l'aide de l'outil pct .

Cette procédure configure le profil du serveur d'applications qui est celui par défaut sur la machine. Il existe une relation univoque entre le serveur Web et le serveur d'applications.

Cette rubrique décrit comment créer la topologie suivante :

Cette rubrique décrit l'installation d'un serveur Web sur une machine et l'installation d'un serveur d'applications sur une machine distincte. Dans cette situation, l'outil de configuration des plug-in de serveur Web sur une machine ne peut pas créer la définition du serveur Web dans la configuration du serveur d'applications sur l'autre machine.

Dans ce cas, l'outil de configuration des plug-in de serveur Web crée un script sur le serveur Web que vous pouvez copier sur le serveur d'applications. Exécutez le script sur le serveur d'applications pour créer la définition de configuration du serveur Web dans la configuration du serveur d'applications.

Procédez comme suit pour installer le plug-in et configurer le serveur Web ainsi que le serveur d'applications.

1. Installez Installation Manager sur la machine A et sur la machine B.
2. Utilisez Installation Manager pour installer WebSphere Application Server sur la machine A.
3. Créez un serveur d'applications autonome sur la machine A.
4. Facultatif: Créez un alias d'hôte pour l'hôte virtuel par défaut.

   Si vous avez configuré le serveur Web pour qu'il utilise un port autre que le port 80, vous devez ajouter un nouvel alias hôte pour ce port, pour l'hôte par défaut. Par exemple, lors de l'exécution en tant qu'utilisateur non root, IBM HTTP Server est configuré avec une valeur de port par défaut de 8080.

5. Utilisez Installation Manager pour installer les éléments suivants sur l'ordinateur B.
   • Web Server Plug-ins for WebSphere Application Server
   • WebSphere Customization Toolbox
6. Utilisez Installation Manager pour installer IBM HTTP Server sur la machine B ou installez un autre serveur Web pris en charge sur la machine B.
7. Ouvrez WebSphere Customization Toolbox et lancez l'outil de configuration des plug-in de serveur Web sur la machine avec le serveur Web.
8. Sélectionnez un emplacement d'exécution pour le plugin de serveur Web.
   Si vous souhaitez utiliser l'emplacement d'un serveur Web déjà installé et que cet emplacement ne figure pas dans la liste, exécutez les actions suivantes pour l'ajouter à votre ensemble de projets :

   1. Cliquez sur Ajouter.
   2. Entrez un nom pour l'emplacement du plug-in du serveur Web.
   3. Effectuez l'une des actions suivantes :
      • Entrez l'emplacement.
      • Cliquez sur Parcourir, recherchez l'emplacement, puis cliquez sur OK.
9. Cliquez sur Créer.
10. Sélectionnez le type de serveur Web que vous configurez, puis cliquez sur Suivant.
11. Sélectionnez l'architecture de votre serveur Web cible installé (64 bits ou 32 bits) et cliquez sur Suivant si vous y êtes invité.
12. Cliquez sur Parcourir pour sélectionner le ou les fichiers de configuration de votre serveur Web, vérifiez que le port du serveur Web est correct, puis cliquez sur Suivant lorsque vous avez terminé.

    Sélectionnez le fichier et pas seulement son répertoire. Certains serveurs Web sont dotés de deux fichiers de configuration et exigent que vous recherchiez chaque fichier.

    La liste suivante affiche les fichiers de configuration pour les serveurs Web pris en charge :

    Serveur Web Apache

    racine_apache_root/config/httpd.conf

    Serveur Web Domino ®

    names.nsf et Notes.jar

    L'assistant vous invite à indiquer le fichier notes.jar. Le nom réel est Notes.jar.

    L'outil de configuration des plug-in du serveur Web vérifie que les fichiers existent mais ne valide aucun de ces fichiers.

    IBM HTTP Server

    racine_IHS/conf/httpd.conf

    racine_profil_IHS/conf/httpd.conf

    Microsoft IIS (Internet Information Services)

    L'outil de configuration des plug-in du serveur Web peut déterminer les fichiers à modifier.

    Oracle iPlanet Web Server

    obj.conf et magnus.conf

13. Si vous configurez un plug-in de serveur Web IBM HTTP , effectuez les actions suivantes.
    1. Le cas échéant, installez la configuration du serveur d'administration pour administrer le serveur Web.
       Attention: Lorsque vous utilisez l'outil de configuration des plug-in de serveur Web pour configurer le serveur d'administration IBM HTTP Server , Websphere Customization Toolbox doit être exécuté en tant que compte système local avec des privilèges administrateur / superutilisateur .
       1. Sélectionnez Configurer le serveur d'administration IBM HTTP Server.
       2. Indiquez un numéro de port sur lequel le serveur d'administration IBM HTTP doit communiquer.
       3. Si vous le souhaitez, sélectionnez Créer un ID utilisateur pour l' IBM Server et entrez un ID utilisateur et un mot de passe pour l'authentification auprès du serveur d'administration IBM HTTP Server à partir de la console d'administration.
    2. Cliquez sur Suivant.
    3. Indiquez l'ID utilisateur système et le groupe devant disposer des droits d'accès en écriture à IBM HTTP Server, au serveur d'administration IBM HTTP Server et aux fichiers de configuration du plug-in de serveur Web.

       Sélectionnez Create a new unique system user ID and group using the credentials, le cas échéant.

       Restriction: La configuration peut échouer si vous spécifiez un nouvel ID utilisateur ou un nouveau nom de groupe qui dépasse la limite de la plateforme, qui est généralement de 8 caractères et qui est parfois configurable.
    4. Si vous le souhaitez, configurez le serveur d'administration IBM HTTP Server pour qu'il s'exécute en tant que service Windows.
       1. Sélectionnez Exécuter IBM HTTP Server Administration Server en tant que service Windows.
       2. Effectuez l'une des actions suivantes :
          • Sélectionnez Log on as a local system account.
          • Sélectionnez Log on as a specified user account et entrez l'ID utilisateur et le mot de passe de ce compte.
            L'ID utilisateur requiert les droits utilisateur avancés suivants :

            • Agir en tant que partie du système d'exploitation
            • Se connecter en tant que service
       3. Choisissez le type de démarrage (automatique ou manuel).
    5. Cliquez sur Suivant.
14. Indiquez un nom unique pour la définition de serveur Web, puis cliquez sur Suivant.
15. Sélectionnez le scénario de configuration.
    1. Choisissez le scénario distant.
    2. Identifiez le nom d'hôte ou l'adresse IP de la machine A, laquelle est la machine du serveur d'applications.
    3. Cliquez sur Suivant.
16. Sélectionnez le profil à configurer avec le plug-in de serveur Web en cours, puis cliquez sur Suivant.

    Ce panneau ne s'affiche pas si vous avez sélectionné le scénario distant à l'étape précédente.

17. Examinez le panneau récapitulatif et cliquez sur Configurer pour commencer la configuration.

    Le panneau vous informe que vous devez exécuter des opérations manuelles afin de compléter l'installation et la configuration.

    L'outil de configuration des plug-in de serveur Web crée le script configureweb_server_name dans le répertoire racine_plug-in/bin/ sur la machine B (machine avec le serveur Web).

    L'outil de configuration des plug-in de serveur Web crée également le fichier plugin-cfg.xml dans le répertoire racine_plug-in/config/web_server_name .

    Le serveur Web lit le fichier plugin-cfg.xml pour déterminer quelles applications le serveur d'applications de la machine A peut servir au serveur Web de la machine B. Lorsque la configuration change, le serveur d'applications régénère le fichier. Quand la régénération se produit, propagez ou copiez le fichier plugin-cfg.xml du serveur d'applications dans le serveur Web. Vous pouvez propager le fichier automatiquement vers le produit IBM HTTP Server.

18. Vérifiez la réussite de l'installation dans le panneau récapitulatif, puis cliquez sur Terminer.

    Si un incident se produit et que l'installation n'aboutit pas, examinez les journaux dans le répertoire racine_plug-in/logs. Corrigez les erreurs éventuelles et relancez la configuration.

19. Copiez le script configureweb_server_name de la machine B (la machine avec le serveur Web) dans le répertoire racine_serveur_app /bin de la machine A (la machine du serveur d'applications).

    nom_serveur_Web correspond au pseudonyme du serveur Web indiqué. nom_serveur_Web n'est pas un nom de fournisseur, comme IIS ou Apache.

    Sur un système d'exploitation tel que AIX ou Linux, le fichier est configureweb_server_name.sh. Sur un système Windows, le fichier est configureweb_server_name.bat. Par exemple, sur un système Linux avec un serveur IBM HTTP Server nommé web_server_1 à l'emplacement par défaut, copiez racine_plug-in/bin/configureweb_server_1.sh de la machine B (la machine sur laquelle se trouve le serveur Web) vers le répertoire racine_serveur_app/bin sur la machine A (la machine du serveur d'applications).

    Par exemple, sur un système IBM i avec un serveur IBM HTTP Server nommé web_server_1 à l'emplacement par défaut, copiez racine_plug-in/bin/configureweb_server_1 de la machine B (la machine sur laquelle se trouve le serveur Web) vers le répertoire racine_serveur_app/bin sur la machine A (la machine du serveur d'applications).

    Si une plateforme est un système tel que AIX ou Linux et que l'autre est une plateforme Windows, copiez le script depuis le répertoire crossPlatformScripts . Par exemple :

    • racine_plug-in/bin/configureweb_server_name.sh
    • racine_plug-in/bin/crossPlatformScripts/windows/configureweb_server_name.bat
    • racine_plug-in/bin/configureweb_server_name
20. Compensez les différences d'encodage des fichiers afin que l'exécution du script n'échoue pas.

    Le contenu du script configureweb_server_name.bat ou du script configureweb_server_name.sh peut être endommagé si le codage de fichier par défaut des deux machines est différent. Ce scénario peut se produire si une machine est configurée pour un environnement local DBCS (Double-Byte Character Set) et l'autre non.

    Le contenu du script configureweb_server_name peut être endommagé si le codage de fichier par défaut des deux machines est différent. Ce scénario peut se produire si une machine est configurée pour un environnement local DBCS (Double-Byte Character Set) et l'autre non.

    Déterminez l'encodage des fichiers et suivez l'une des procédures ci-dessous afin d'éviter l'échec. Pour déterminer le codage de fichiers par défaut, exécutez la commande appropriée.

    

    • Exécutez la commande locale charmap sur un système tel que AIX ou Linux.
    • Exécutez la commande CHCP sur une machine Windows.

    Le résultat obtenu après l'exécution de la commande sur chaque machine doit être défini comme valeur pour les variables web_server_machine_encoding et application_server_machine_encoding dans l'une des procédures suivantes.

    Procédures permettant de compenser les différences d'encodage

    • Le serveur Web exécuté sous AIX ou Linux
      Supposons que le serveur Web s'exécute sur une machine Linux et que le serveur d'applications s'exécute sur une machine Windows. Avant d'envoyer par FTP le script de configuration de définition de serveur Web à la machine Windows en mode binaire, exécutez la commande suivante sur le système pour coder le fichier:

      iconv -f web_server_machine_encoding \
         -t application_server_machine_encoding \
         configureweb_server_name.bat 

      Important : Le nom du serveur Web (alias) est utilisé dans le nom du fichier script. Ce nom peut contenir des caractères DBCS (Double-Byte Character Set) si vous souhaitez configurer IBM HTTP Server pour la propagation automatique.
    • Serveur Web exécuté sur un système Windows
      Supposons que le serveur Web s'exécute sur une machine Windows et que le serveur d'applications s'exécute sur une machine avec un système tel que AIX ou Linux. Vous devez d'abord télécharger l'utilitaire iconv à partir d'un tiers car la commande n'est pas incluse par défaut sur les systèmes Windows. Avant de transférer par FTP le script de configuration de définition de serveur Web en mode binaire sur un système tel que AIX ou Linux, exécutez la commande suivante sur la machine pour coder le fichier:

      iconv -f web_server_machine_encoding \
         -t application_server_machine_encoding \
         configureweb_server_name.sh 

      Par exemple, si la machine cible est z/OS®, vous pouvez utiliser cette commande pour convertir le fichier ASCII en EBCDIC, en traitant correctement les caractères de fin de ligne:

      iconv -f ISO8859-1 -t IBM-1047 configureweb_server_name.sh > new_script_name.sh

    Ne tapez pas les caractères de continuation (\) si vous entrez la commande sur une seule ligne.

    Si le mappage de la conversion n'est pas pris en charge par la commande iconv sur le système, copiez le contenu du script de configuration du serveur Web dans le presse-papiers et collez-le sur la machine sur laquelle le serveur d'applications est exécuté.

    Remarque: Si vous copiez un fichier .sh sur un système d'exploitation UNIX après une configuration à distance sur un système d'exploitation Windows, vous devez exécuter la commande chmod 755.
21. Démarrez le serveur d'applications sur la machine A.
    Utilisez la commande startServer, par exemple :

    • profile_root/bin/startServer.sh server1
    • profile_root\bin\startServer server1
    • profile_root/bin/startServer server1
22. Démarrez le serveur d'administration IBM HTTP Server.

    Le serveur d'administration doit être démarré pour que le script configureweb_server_name.bat/.sh puisse générer et propager le fichier plugin-cfg.xml . Pour plus d'informations, voir Démarrage et arrêt du serveur d'administration IBM HTTP Server.

    Si vous ne démarrez pas le serveur d'administration, le script peut configurer le serveur Web, mais le plug-in n'est pas propagé etPLGC0063E,PLGC0049EetPLGC0053Edes erreurs se produisent.

23. Ouvrez une fenêtre de commande et accédez au répertoire du profil où doit être affecté le serveur Web. Exécutez le script que vous avez copié sur la machine A (la machine du serveur d'applications).
    Vous avez besoin des paramètres suivants :

    • Nom du profil
    • (Facultatif) ID administrateur
    • (Facultatif) Mot de passe de l'administrateur
    Par exemple, vous pouvez entrer ce qui suit :

    configurewebserver1.sh AppSrv01 my_user_ID my_Password

    Le serveur Web sera configuré via wsadmin.

    Le contenu du script configurewebserver1.sh est similaire à celui-ci :

    wsadmin.bat -profileName AppSrv01 -user my_user_ID -password my_Password
       -f "%WAS_HOME%\bin\configureWebserverDefinition.jacl" webserver1 IHS..

24. Serveur Web Domino uniquement: Définissez la variable d'environnement WAS_PLUGIN_CONFIG_FILE.

    Sur les plateformes de type AIX ou Linux, configurer le script vers le shell parent permet aux processus enfant d'hériter des variables exportées. Sur les systèmes Windows, exécutez le script comme vous l'auriez fait pour une autre commande. L'action de configurer est automatique sur les systèmes Windows.

    1. Ouvrez une fenêtre de commande.
    2. Accédez au répertoire racine de l'installation des plug-in.
    3. Exécutez la commande appropriée pour le script plugins_root/bin/setupPluginCfg.sh :
       • . plugins_root/bin/setupPluginCfg.sh (Notez l'espace entre le point et le répertoire racine d'installation.)
       • source plugins_root/bin/setupPluginCfg.sh

    Le script se trouve également dans le répertoire racine_lotus/notesdata sur des systèmes tels qu'AIX ou Linux.

    Exécutez la commande appropriée pour le script avant de démarrer Domino Web Server.

25. Régénérez le fichier plugin-cfg.xml sur la machine A (la machine du serveur d'applications) à l'aide de la console d'administration. Cliquez sur Serveurs > Types de serveur > Serveurs Web. Sélectionnez le serveur Web, puis cliquez sur Générer un plug-in.

    Lors de l'installation des plug-in, le fichier plugin-cfg.xml par défaut est installé sur la machine B (la machine avec le serveur Web) dans le répertoire racine_plug-in/config/web_server_name . Le service de configuration de plug-in du serveur Web régénère automatiquement le fichier plugin-cfg.xml. Pour utiliser le fichier plugin-cfg.xml actuel du serveur d'applications, propagez le fichier plugin-cfg.xml comme décrit dans l'étape suivante.

    Cette étape explique comment régénérer le fichier plugin-cfg.xml. Les produits WebSphere Application Server sont configurés afin de régénérer automatiquement le fichier à chaque fois qu'un événement majeur se produit. Par exemple, l'installation d'applications sur le serveur d'applications et sur le serveur Web. La création d'un hôte virtuel est aussi un événement majeur.

26. Propagez le fichier plugin-cfg.xml du serveur d'applications au serveur Web à l'aide de la console d'administration. Cliquez sur Serveurs > Serveur Web. Sélectionnez le serveur Web, puis cliquez sur Propager un plug-in. Les serveurs Web autres que IBM HTTP Server requièrent une propagation manuelle.

    Le service de configuration pour le plug-in de serveur Web propage automatiquement le fichier plugin-cfg.xml pour IBM HTTP Server uniquement. Pour tous les autres serveurs Web, propagez le fichier de configuration de plug-in en copiant manuellement le fichier plugin-cfg.xml du répertoire racine_profil/config/cells/nom_cellule/nodes/nom_noeud/servers/nom_serveur_Web sur la machine A (du serveur d'applications) dans le répertoire racine_plug-in/config/nom_serveur_Web sur la machine B (dotée du serveur Web).

27. Lancez le servlet Snoop afin de tester la capacité du serveur Web à extraire une application du serveur d'applications.

    Testez votre environnement en lançant votre serveur d'applications ainsi que votre serveur Web et en utilisant le servlet Snoop ayant une adresse IP.

    1. Démarrez le serveur d'applications.
       Modifiez les répertoires en fonction du répertoire racine_profil/bin et exécutez la commande startServer :

       • ./startServer.sh server1
       • startServer server1
       • startServer server1
    2. Lancez le serveur IBM HTTP Server ou le serveur Web que vous utilisez.

       Utilisez la page 2001 ou la commande STRTCPSVR SERVER(*HTTP) HTTPSVR(instance_name ) pour démarrer IBM HTTP Server.

       Utilisez une fenêtre de commande pour accéder au répertoire de l'image d'IBM HTTP Server installée, ou l'image installée du serveur Web. Exécutez la commande appropriée pour lancer le serveur Web (commandes pour IBM HTTP Server, par exemple) :

       Pour démarrer IBM HTTP Server à partir de la ligne de commande:

       Accédez aux commandes apache et apachectl dans le répertoire IBMHttpServer/bin .

       • ./apachectl start
       • apache
    3. pointez votre navigateur sur http://localhost:9080/snoop pour tester le transport HTTP interne fourni par le serveur d'applications. Pointez votre navigateur sur http://Host_name_of_Web_server_machine/snoop pour tester le plug-in de serveur Web.

       La valeur par défaut du port de transport HTTP est 9080 et doit être unique pour chaque profil. Ce port est associé à un hôte virtuel nommé default_host, qui est configuré pour héberger l'application installée par défaut. Le servlet Snoop fait partie de l'application par défaut. Modifiez le port pour qu'il corresponde au port de transport HTTP.

    4. Vérifiez que Snoop est en cours d'exécution.

       L'une des adresses Web doit afficher la page Servlet Snoop - Informations de demande/client.

    5. Serveur IBM HTTP Server uniquement:
       vérifiez que la fonction de propagation automatique peut fonctionner sur un IBM HTTP Server distant en suivant les étapes ci-après. Cette procédure ne s'applique pas aux serveurs Web locaux.

       1. Créez user=adminUser, password=adminPassword dans le fichier racine_IHS /conf/admin.passwd. Par exemple :c:\ws\ihs90\bin\htpasswd -cb c:\ws\ihs90\conf\admin.passwd adminUser adminPassword
       2. Utilisez la console d'administration du serveur d'applications pour entrer l'ID utilisateur et le mot de passe que vous avez créés pour l'administrateur d' IBM HTTP Server. Accédez à Serveurs > Serveur Web > définition_serveur_Web > Administration du serveur Web distant. Définissez les valeurs suivantes : admin Port=8008, User Id=adminUser, Password=adminPassword.
       3. Définissez les droits d'accès en lecture/écriture corrects aux fichiers httpd.conf et plugin-cfg.xml. Pour plus d'informations, voir le fichier IHS_root /logs/admin_ERROR. LOG .

       Pour que le fichier de configuration du plug-in puisse être propagé automatiquement, le serveur d'administration IBM HTTP doit être actif. Si vous gérez un serveur IBM HTTP Server à l'aide de la console d'administration WebSphere Application Server, l'erreur suivante peut s'afficher :

       Connexion impossible au serveur d'administration IHS

       Pour corriger l'erreur, procédez comme suit :

       1. Vérifiez que le serveur d'administration IBM HTTP Server est en cours d'exécution.
       2. Vérifiez que le nom d'hôte et le port du serveur Web définis dans la console d'administration WebSphere Application Server correspondent au nom d'hôte et au port du serveur d'administration IBM HTTP Server.
       3. Assurez-vous que le pare-feu ne vous empêche pas d'avoir accès au serveur d'administration IBM HTTP Server à partir de la console d'administration WebSphere Application Server.
       4. Vérifiez que le mot de passe et l'ID utilisateur indiqués dans la console d'administration WebSphere Application Server, gérée à distance, sont créés dans le fichier admin.passwd, à l'aide de la commande htpasswd.
       5. Lors d'une tentative de connexion sécurisée, veillez à exporter le certificat personnel keydb du serveur d'administration IBM HTTP Server dans la base de données de clés de WebSphere Application Server en tant que certificat de signataire. Cette base de données de clés est spécifiée par la directive com.ibm.ssl.trustStore dans le fichier sas.client.props du profil dans lequel la console d'administration est exécutée. Cet élément s'applique essentiellement aux certificats autosignés.
       6. Si vous rencontrez toujours des problèmes, consultez le fichier admin_ERROR. LOG d' IBM HTTP Server et les journaux de WebSphere Application Server (fichiertrace.log ) pour déterminer la cause du problème.