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

Configuration d'un serveur Web et d'un profil personnalisé sur la même machine

Cette procédure décrit l'installation d'un serveur Web et de son plug-in sur une machine où le profil par défaut est un profil personnalisé.

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.

Installation distribuée locale

Cette procédure configure le profil personnalisé sur la machine B. Elle implique que l'installation d'un gestionnaire de déploiement sur la machine A a déjà été effectuée.

Le noeud WebSphere Application Server sur la machine B est le noeud personnalisé que vous créez dans cette procédure. Cette procédure démarre le gestionnaire de déploiement et fédère le noeud personnalisé avant d'installer les plug-ins de serveur Web.

Démarrez le gestionnaire de déploiement. Le gestionnaire de déploiement doit être en cours d'exécution afin de réussir la fédération et la configuration du noeud personnalisé.

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.

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 personnalisé (noeud personnalisé).

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

Procédure

  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][HP-UX][Linux][Solaris]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. Utilisez Installation Manager pour installer les éléments suivants sur l'ordinateur B.
    • WebSphere Application Server Network Deployment
    • Plug-ins du serveur Web pour WebSphere Application Server
    • WebSphere Customization Toolbox
  3. Utilisez Installation Manager pour installer IBM HTTP Server sur l'ordinateur B, ou pour installer un autre serveur Web pris en charge sur l'ordinateur B.
  4. Créez un profil personnalisé comme premier profil sur la machine B et fédérez le noeud pendant que vous le créez.
  5. Facultatif : Utilisez la console d'administration du gestionnaire de déploiement pour créer un serveur d'applications sur le noeud personnalisé.

    Cliquez sur Serveurs > Serveurs d'applications > Nouveau et suivez les instructions relatives à la création d'un serveur. Un serveur n'est pas nécessaire pour l'installation des plug-ins, mais il vous permet de vérifier la fonctionnalité du serveur Web.

  6. Facultatif : Dans la console d'administration du gestionnaire de déploiement, installez l'application par défaut sur le nouveau serveur.

    L'application par défaut comprend le servlet Snoop. L'étape de vérification utilise le servlet Snoop.

  7. Ouvrez WebSphere Customization Toolbox et lancez l'outil de configuration des plug-ins de serveur Web sur l'ordinateur B.
  8. Sélectionnez un emplacement d'exécution pour le plug-in 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.
  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 le système vous y invite.
  12. 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
  13. 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 Web Server Plug-ins Configuration Tool est utilisé pour configurer le serveur d'administration IBM HTTP Server, l'outil de personnalisation WebSphere Customization Toolbox doit être exécuté en tant que 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.
  14. Spécifiez un nom unique pour la définition de serveur Web et cliquez sur Suivant.
  15. 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.
  16. Sélectionnez le profil à configurer avec le plug-in de serveur Web en cours, puis cliquez sur Next.
  17. Examinez le panneau récapitulatif et cliquez sur Configure pour commencer la configuration du serveur Web, du plug-in de serveur Web et du profil.
  18. Dans le panneau récapitulatif, assurez-vous que l'installation a abouti et cliquez sur Finish.

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

  19. Créez la définition de serveur Web sur l'ordinateur A.

    Vous pouvez utiliser la console d'administration du gestionnaire de déploiement pour créer la définition de serveur Web sur un noeud fédéré ; ou, vous pouvez exécuter le script de configuration créé par l'outil de configuration des plug-ins de serveur Web.

    Le script contient déjà toutes les informations à rassembler lors de l'utilisation de l'option de la console d'administration.
    • Utilisation de la console d'administration

      Cliquez sur Serveurs > Serveurs Web > Nouveau et utilisez l'assistant de création d'une entrée de serveur Web pour créer la définition du serveur Web.

    • Exécution du script de configuration
      1. Collez le script configurenom_serveur_web de la machine B dans le répertoire racine_serveur_app/bin sur la machine A.
      2. Exécutez la commande appropriée à partir d'une fenêtre de commande :
        • [AIX][Linux]./racine_plug-in/bin/configurenom_serveur_web.sh
        • [Windows]racine_plug-in\bin\configurenom_serveur_web.bat
        • [IBM i]./racine_plug-in/bin/configurenom_serveur_web

      Si vous avez activé la sécurité ou modifié le type de connecteur JMX par défaut, éditez le script et incluez les paramètres appropriés sur la commande wsadmin.

  20. [AIX Solaris HP-UX Linux Windows]Serveur Web Domino Web 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][HP-UX][Solaris]. 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.

  21. 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. Dans un environnement Network Deployment, le servlet Snoop est disponible dans la cellule uniquement si vous avez inclus l'application par défaut lors de l'ajout du serveur d'applications à la cellule. L'option -includeapps de la commande addNode permet de migrer l'application par défaut dans la cellule. Si vous ne disposez pas de cette application, ignorez cette étape.
      Modifiez les répertoires en fonction du répertoire racine_profil/bin et exécutez la commande startServer :
      • [AIX][HP-UX][Linux][Solaris]./startServer.sh server1
      • [Windows]startServer server1
      • [IBM i]startServer server1
    2. Lancez le serveur IBM HTTP 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][HP-UX][Linux][Solaris]./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.

    5. Serveur 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\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd adminUser adminPassword
      2. Utilisez la console d'administration du gestionnaire de déploiement ou le 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.
  22. Si l'application par défaut n'est pas installée sur le gestionnaire de déploiement, vous pouvez tester la fonctionnalité du serveur Web et du noeud personnalisé en utilisant l'une de vos applications.
  23. A partir de la console d'administration du gestionnaire de déploiement, cliquez sur Administration du système > Sauvegarde des modifications dans le référentiel maître > Synchroniser les modifications avec les noeuds > Sauvegarder.
  24. Pour créer plusieurs définitions de serveur Web concernant le noeud géré, utilisez l'outil de configuration des plug-ins de serveur Web afin de configurer chaque serveur Web.

    Identifiez le même noeud géré à chaque fois. Donnez un alias différent à chaque serveur Web.

Résultats

Cette procédure a permis d'installer des plug-ins de serveur Web pour WebSphere Application Server sur une machine de serveur web. L'outil de configuration des plug-ins de serveur Web crée une définition de serveur Web dans le noeud géré.

L'outil de configuration des plug-ins de serveur Web configure le serveur Web pour qu'il utilise le fichier plugin-cfg.xml se trouvant dans le noeud personnalisé géré.

Le gestionnaire de déploiement régénère le fichier de configuration de plug-in de serveur Web, plugin-cfg.xml, lorsqu'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.

La création ou suppression des clusters et des membres de cluster provoque également la régénération de fichier. La propagation automatique à travers la synchronisation de noeud effectue une copie du fichier après chaque régénération dans l'emplacement ci-dessous sur la machine de noeud personnalisé :
racine_profil
   /config/cells/nom_cellule/nodes/
   nom_noeud_du_profil_personnalisé/servers/
   nom_serveur_web/plugin-cfg.xml
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.

Que faire ensuite

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 obtenir des informations sur d'autres scénarios d'installation concernant 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-nd-mp&topic=tins_webplugins_localr
Nom du fichier : tins_webplugins_localr.html