[AIX Solaris HP-UX Linux Windows][IBM i]

Configuration d'un serveur Web et d'un profil de serveur d'applications sur la même machine

WebSphere Application Server fournit des plug-ins de serveur Web que vous pouvez configurer afin de communiquer avec une marque particulière de serveur Web. Apprenez à installer le serveur Web et le plug-in de serveur Web pour WebSphere Application Server, ainsi que le serveur d'applications, sur la même machine.

Avant de commencer

[IBM i]Lorsqu'il existe plusieurs profils, vous pouvez sélectionner le profil configuré par l'outil de configuration des plug-ins de serveur Web. Pour une description du flux de logique qui détermine comment sélectionner le profil à configurer, voir Configuration des plug-ins.

[AIX Solaris HP-UX Linux Windows]Lorsqu'il existe plusieurs profils, vous pouvez sélectionner le profil configuré par l'outil de configuration des plug-ins de serveur Web. Pour une description du flux de logique qui détermine comment sélectionner le profil à configurer, voir Configuration des plug-ins.

Si la famille de produits WebSphere Application Server prend en charge une marque spécifique de serveur Web tel qu'IBM® HTTP Server ou Microsoft Internet Information Services (IIS), un plug-in binaire est fourni par votre produit WebSphere Application Server pour le serveur Web que vous devez installer.

Si la famille de produits WebSphere Application Server ne fournit pas de plug-in binaire pour une marque spécifique de serveur web, celui-ci ne sera pas pris en charge. L'objectif du plug-in binaire est de fournir le protocole de communication entre le serveur Web et le serveur d'applications.

[AIX Solaris HP-UX Linux Windows]Supposons que vous créez un profil et que vous souhaitez également utiliser un serveur Web. Vous devez installer un nouveau serveur Web pour le nouveau profil, installer les plug-ins du serveur Web et utiliser l'outil de configuration des plug-ins du serveur Web pour configurer le serveur Web ainsi que le serveur d'applications.

Si le serveur Web n'est pas encore installé, vous pouvez installer les plug-ins du serveur Web pour usage ultérieur.

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 un serveur Web et le serveur d'applications.

Toutefois, plusieurs serveurs Web peuvent être définis pour un profil de serveur d'applications autonome et un profil géré, dans une définition de serveur Web distincte.

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

Application Server with optional web server on one machine

Remarque : L'installation du composant de plug-in par un utilisateur non root n'est possible que si le serveur d'applications a également été installé par le même utilisateur non root. Sinon, les scripts de configuration du serveur Web ne peuvent pas être exécutés lors de l'installation du serveur d'applications.

Pourquoi et quand exécuter cette tâche

Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.
L'outil de configuration des plug-ins de serveur Web configure le plug-in du serveur Web pris en charge après avoir rassemblé les informations ci-dessous :
  • Type de serveur Web à configurer
  • Architecture du serveur Web cible installé (64 bits ou 32 bits)
  • Emplacement du fichier ou des fichiers de configuration pour le serveur Web à configurer
  • Port du serveur Web
  • Pour IBM HTTP Server, les informations à collecter sont les suivantes :
    • Numéro de port pour la configuration du serveur d'administration d'IBM HTTP Server facultatif
    • ID utilisateur et mot de passe permettant l'authentification sur le serveur d'administration d'IBM HTTP Server facultatif à partir de la console d'administration
    • [AIX][Linux]Groupe et ID utilisateur système disposant de droits d'accès en écriture sur IBM HTTP Server, le serveur d'administration d'IBM HTTP Server et les fichiers de configuration de plug-in de serveur Web
    • [Windows]ID utilisateur et mot de passe, si vous choisissez d'exécuter le serveur d'administration d'IBM HTTP Server en tant que service Windows
  • Nom de la définition de serveur Web
  • Scénario de configuration à utiliser
    • S'il s'agit d'un scénario distant, l'outil collecte le nom d'hôte ou l'adresse IP du serveur d'applications.
    • S'il s'agit d'un scénario local, l'outil collecte le répertoire racine d'installation du produit WebSphere Application Server.
  • Profil à configurer avec le plug-in de serveur Web

L'outil de configuration des plug-ins de serveur Web modifie le ou les fichiers de configuration d'un serveur Web en créant des directives qui indiquent l'emplacement du module de plug-in binaire et du fichier de configuration de plug-in.

Le nom du module de plug-in binaire varie en fonction du type de serveur Web. Le fichier de configuration de plug-in est toujours le fichier plugin-cfg.xml.

L'outil de configuration des plug-ins de serveur Web crée une définition de serveur Web dans la configuration du serveur d'applications sauf s'il existe déjà une définition.

Vous pouvez utiliser la console d'administration pour gérer la configuration de serveur Web. Par exemple, lorsque vous installez une application sur le serveur d'applications, vous pouvez également choisir de l'installer sur la définition de serveur Web. Si c'est le cas, le fichier plugin-cfg.xml mis à jour indique que la nouvelle application est disponible. Lorsque le serveur Web lit le fichier de configuration de plug-in mis à jour, il prend connaissance de la présence de la nouvelle application dont il donne l'accès aux clients Web.

Si vous choisissez de ne pas installer la nouvelle application sur la définition de serveur Web, l'application n'est pas ajoutée au fichier de configuration de plug-in. Le serveur Web ne détecte pas la présence de l'application et ne peut en donner l'accès aux clients Web.

Configurations prises en charge Configurations prises en charge: Cet outil est pris en charge uniquement sous AIX, Linux et Windows. Au lieu d'utiliser l'outil de configuration des plug-ins de 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.sptcfg

Utilisez la procédure ci-après pour installer le plug-in de serveur Web, configurer le serveur Web et créer une définition de serveur Web dans le profil du serveur d'applications par défaut.

Procédure

Configurez un serveur d'applications autonome.
  1. Ouvrez une session sur le système d'exploitation.

    Si vous effectuez une installation en tant qu'utilisateur autre que root ou administrateur, certaines limitations s'appliquent.

    [AIX][Linux]De plus, sélectionnez un umask permettant au propriétaire d'accéder aux fichiers en lecture/écriture, et permettant aux autres utilisateurs d'y accéder conformément à la stratégie système en vigueur. Pour un utilisateur root, un umask de 022 est recommandé. Pour les utilisateurs autres que root, utilisez un umask de 002 ou de 022, selon que les utilisateurs partagent ou non le groupe. Pour tester le paramètre umask, exécutez la commande suivante :
    umask
    Pour définir le paramètre umask à 022, exécutez la commande suivante :
    umask 022
    [Windows]Lors de l'installation d'un utilisateur administratif sur un système d'exploitation Windows, un service Windows est automatiquement créé pour démarrer automatiquement le serveur d'applications. Le compte d'utilisateur d'installation doit avoir les droits d'utilisateur suivants :
    • Agir en tant que partie du système d'exploitation
    • Se connecter en tant que service
    Par exemple, sur certains systèmes d'exploitation Windows, cliquez sur Panneau de configuration > Outils d'administration > Stratégie de sécurité locale > Stratégies locales > Attribution des droits utilisateur pour définir les options avancées. Pour plus d'informations, voir la documentation de votre système d'exploitation Windows.

    [Windows]Si vous prévoyez d'exécuter le serveur d'applications en tant que service Windows, ne l'installez pas à partir d'un ID utilisateur contenant des espaces. Un ID utilisateur comportant des espaces ne peut pas être validé. Vous ne pouvez pas continuer l'installation avec l'ID utilisateur mentionné ci-dessus. Pour éviter cette restriction, employez un ID utilisateur ne contenant pas d'espace pour l'installation.

  2. Installez Installation Manager.
  3. Installation Manager permet d'installer les éléments suivants :
    • WebSphere Application Server
    • Plug-ins du serveur Web pour WebSphere Application Server
    • WebSphere Customization Toolbox
  4. Utilisez Installation Manager pour installer IBM HTTP Server, ou pour installer un autre serveur Web pris en charge.
  5. Ouvrez WebSphere Customization Toolbox et lancez l'outil de configuration des plug-ins de serveur Web.
  6. Sélectionnez un emplacement d'exécution pour les plug-ins de serveur Web.
    Si vous souhaitez utiliser l'emplacement d'un plug-in de 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 de serveur Web.
    3. Effectuez l'une des actions suivantes :
      • Entrez l'emplacement.
      • Cliquez sur Parcourir, recherchez l'emplacement, puis cliquez sur OK.
  7. Cliquez sur Créer.
  8. Sélectionnez le type de serveur Web que vous configurez, puis cliquez sur Suivant.
  9. Sélectionnez l'architecture de votre serveur Web cible installé (64 bits ou 32 bits) et cliquez sur Suivant si le système vous y invite.
  10. Cliquez sur Parcourir pour sélectionner le ou les fichiers de configuration de votre serveur Web et vérifier que le port du serveur Web est correct, puis cliquez sur Suivant après avoir 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 :
    Apache HTTP Server
    racine_apache/config/httpd.conf
    Domino Web Server
    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-ins de serveur Web vérifie que les fichiers existent mais ne valide aucun de ces fichiers.

    IBM HTTP Server
    [AIX Solaris HP-UX Linux Windows]racine_IHS/conf/httpd.conf
    [IBM i]racine_profil_IHS/conf/httpd.conf
    Microsoft Internet Information Services (IIS)
    L'outil de configuration des plug-ins de serveur Web peut déterminer les fichiers à modifier.
    Sun Java™ System Web Server (anciennement Sun ONE Web Server et iPlanet Web Server) version 6.0 ou ultérieure
    obj.conf et magnus.conf
  11. Si vous configurez un plug-in de serveur Web IBM HTTP, exécutez les actions ci-après.
    1. Le cas échéant, installez la configuration du serveur d'administration pour administrer le serveur Web.
      Avertissement : Lorsque l'outil de configuration des plug-ins de serveur Web est utilisé pour configurer le serveur d'administration IBM HTTP Server, les outils de personnalisation WebSphere doivent être exécutés comme compte "local" avec des privilèges administrateur/superutilisateur.
      1. Sélectionnez Configurer IBM HTTP Server Administration Server.
      2. Spécifiez un numéro de port via lequel le serveur d'administration d'IBM HTTP pourra communiquer.
      3. Le cas échéant, sélectionnez Créer un ID utilisateur pour l'authentification auprès du serveur d'administration IBM HTTP Server et entrez un ID utilisateur et un mot de passe pour vous authentifier sur le serveur d'administration d'IBM HTTP Server à partir de la console d'administration.
    2. Cliquez sur Next.
    3. [AIX][Linux]Spécifiez le groupe et l'ID utilisateur système disposant de droits d'accès en écriture sur IBM HTTP Server, le serveur d'administration d'IBM HTTP Server et les fichiers de configuration de plug-in de serveur Web.

      Sélectionnez Créer un ID utilisateur système et un groupe uniques avec les données d'identification, si nécessaire.

      [AIX]Restriction : La configuration peut échouer si vous spécifiez un nouvel ID utilisateur ou un nom de groupe dépassant la limite de la plateforme, laquelle est généralement de 8 caractères et parfois configurable.
    4. [Windows]Le cas échéant, configurez le serveur d'administration d'IBM HTTP Server à exécuter en tant que service Windows.
      1. Sélectionnez Exécuter le serveur d'administration IBM HTTP Server en tant que service Windows.
      2. Effectuez l'une des actions suivantes :
        • Sélectionnez Se connecter en tant que compte système local.
        • Sélectionnez Se connecter en tant que compte utilisateur spécifié 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 Next.
  12. Spécifiez un nom unique pour la définition de serveur Web et cliquez sur Suivant.
  13. Sélectionnez le scénario de configuration.
    1. Choisissez le scénario local.
    2. Effectuez l'une des actions suivantes :
      • Entrez l'emplacement d'installation de WebSphere Application Server (racine_serveur_app).
      • Cliquez sur Parcourir, recherchez l'emplacement d'installation de WebSphere Application Server (racine_serveur_app), puis cliquez sur OK.
    3. Cliquez sur Suivant.
  14. Sélectionnez le profil à configurer avec le plug-in de serveur Web en cours, puis cliquez sur Suivant.
  15. Examinez le panneau récapitulatif et cliquez sur Configurer pour commencer la configuration du serveur Web, du plug-in de serveur Web et du profil de serveur d'applications.
  16. Dans le panneau récapitulatif, assurez-vous que l'installation a abouti et 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.

  17. Pour un serveur Web Domino uniquement : Définissez la variable d'environnement WAS_PLUGIN_CONFIG_FILE.

    Sur les plateformes, telles que AIX ou Linux, sourcer 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 sourçage 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-ins.
    3. Exécutez la commande appropriée pour le script racine_plug-ins/bin/setupPluginCfg.sh :
      • [AIX]. racine_plug-ins/bin/setupPluginCfg.sh (Notez l'espace entre le point et le répertoire racine d'installation.)
      • [Linux]source racine_plug-ins/bin/setupPluginCfg.sh

    Le script se trouve également dans le répertoire lotus_root/notesdata sur des systèmes d'exploitation, tels que AIX ou Linux.

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

  18. 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 :
      • [AIX][Linux]./startServer.sh server1
      • [Windows]startServer server1
      • [IBM i]startServer server1
    2. Lancez le serveur IBM HTTP Server ou le serveur Web que vous utilisez.

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

      [AIX Solaris HP-UX Linux Windows]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) :

      [AIX Solaris HP-UX Linux Windows]Pour démarrer IBM HTTP Server à partir de la ligne de commande :

      [AIX Solaris HP-UX Linux Windows]Accédez aux commandes apache et apachectl dans le répertoire IBMHttpServer/bin.
      • [AIX][Linux]./apachectl start
      • [Windows]apache
    3. Indiquez l'adresse http://localhost:9080/snoop dans votre navigateur pour tester le transport HTTP interne fourni par le serveur d'applications. Indiquez http://Nom_hôte_serveur_Web/snoop dans le navigateur pour tester le plug-in du 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.

      Conseil : Si une vérification échoue et génère le code d'erreur HTTP 500, accédez à Gestionnaire IIS > Site Web par défaut > sePlugins. Right-click, and choose to edit permissions. Cliquez sur l'onglet de partage et choisissez de partager avec tous les utilisateurs (niveau de droit : lecture/écriture).
    5. IBM HTTP Server distant uniquement :
      [AIX Solaris HP-UX Linux Windows]Vérifiez que la fonction de propagation automatique peut fonctionner sur un serveur 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\ihs80\bin\htpasswd -cb c:\ws\ihs80\conf\admin.passwd adminUser adminPassword
      2. Utilisez la console d'administration du serveur d'applications pour saisir les informations d'ID utilisateur et de mot de passe que vous avez créées 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. Consultez le fichierracine_IHS /logs/admin_ERROR. LOG pour plus d'informations.
      Pour que le fichier de configuration du plug-in soit 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 de WebSphere Application Server, l'erreur suivante peut s'afficher :
      "Could not connect to IHS Administration server error"
      Pour corriger l'erreur, procédez comme suit :
      1. Vérifiez que le serveur d'administration IBM HTTP Server est actif.
      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 de WebSphere Application Server.
      4. Vérifiez que le mot de passe et l'ID utilisateur indiqués dans la console d'administration de 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 auto-signés.
      6. Si vous rencontrez encore des erreurs, consultez le fichier IBM HTTP Server admin_ERROR. LOG et les journaux WebSphere Application Server (fichier trace.log) pour déterminer la cause du problème.

Résultats

L'installation des plug-ins de serveur Web génère la création du répertoire Plugins ainsi que celle de plusieurs sous-répertoires. Par exemple, les répertoires suivants font partie des répertoires créés sur un système Linux :
  • plugins_root/bin/32bits or plugins_root/bin/64bits contient les plug-in binaires de tous les serveurs Web pris en charge.
  • Le répertoire racine_plug-ins/logs contient des fichiers journaux.
  • Le répertoire racine_plug-ins/properties contient les informations relatives à la version.

L'outil de configuration des plug-ins de serveur Web crée une définition de serveur Web dans le profil du serveur d'applications sauf s'il existe déjà une définition.

L'outil de configuration des plug-ins de serveur Web configure le serveur Web pour qu'il utilise le fichier racine_profil/plugin-cfg.xml.

Le serveur d'applications régénère le fichier de configuration de plug-in du serveur Web, plugin-cfg.xml, lorsque un événement se produit et affecte le fichier. Ces événements incluent l'ajout ou la suppression d'une application, d'un serveur ou d'un hôte virtuel. Le serveur d'applications autonome régénère le fichier à l'emplacement suivant :
racine_profil
   /config/cells/nom_cellule/nodes/
   nom_serveur_web_noeud/servers/
   nom_serveur_web/plugin-cfg.xml

Que faire ensuite

Vous pouvez lancer un serveur d'applications autonome ainsi que le serveur Web immédiatement après avoir configuré le plug-in du serveur Web local. Après avoir lancé le serveur et sauvegardé la nouvelle configuration, ouvrez la console d'administration du serveur d'applications.

See Selecting a web server topology diagram and roadmap for an overview of the installation procedure.

Pour obtenir des informations sur l'emplacement du fichier de configuration de plug-in, voir Configuration des plug-ins.

Pour plus d'informations sur les fichiers impliqués dans la configuration d'un serveur Web, voir Configuration du serveur Web.

Pour plus d'informations sur la façon dont l'outil de configuration des plug-ins de serveur Web configure les serveurs Web pris en charge, voir Edition des fichiers de configuration de serveur Web.

Pour plus d'informations sur les autres scénarios d'installation relatifs à l'installation des plug-ins de serveur Web, voir Configuration des plug-ins de serveur Web.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=tins_webplugins_local
Nom du fichier : tins_webplugins_local.html