# Organigrammes d'installation de plug-in de serveur Web pour WebSphere Application Server Network Deployment

Mise en route
Organigrammes d'installation de plug-in :

1. Installation d'un plug-in de serveur Web dans des serveurs d'applications autonomes
2. Installation d'un plug-in de serveur Web dans des environnements distribués

## Installation d'un plug-in de serveur Web dans des serveurs d'applications autonomes

| Scénario d'installation distante | Scénario d'installation locale
## Environnement standard | # Production (recommandé) | # Développement
## Installation et configuration |
Installation du serveur d'applications :
(Machine A)
1. | Installez IBM Installation Manager.
2. | Utilisez Installation Manager pour installer WebSphere Application Server Network Deployment.
3. | Créez un serveur d'applications autonome.
Installation d'un serveur Web et de plug-ins de serveur Web :
(Machine B)
4. | Installez IBM Installation Manager.
5. | Utilisez Installation Manager pour installer IBM HTTP Server ou un autre serveur Web pris en charge.
6. | Utilisez Installation Manager afin d'installer les plug-ins de serveur Web pour WebSphere Application Server.
Configuration du plug-in de serveur Web :
(Machine B)
7. | Utilisez Installation Manager pour installer WebSphere Customization Tools.
8. | Ouvrez WebSphere Customization Tools et lancez l'outil de configuration des plug-ins de serveur Web pour configurer le plug-in de serveur Web. Le script permettant de créer et de configurer le serveur Web est créé dans le répertoire racine_plugins`/bin`.
9. | Copiez le script nom_serveur_Web à coller sur la Machine A. Voir la section de ce document incluant des remarques relatives aux différentes plateformes pour plus d'informations sur l'exécution de scripts de configuration dans les cas suivants : Une machine exécute Windows et l'autre machine exécute Linux ou UNIX. Une machine utilise un différent codage de fichier.
Création de la définition de serveur Web :
(Machine A)
10. | Collez le script `configurenom_serveur_Web` à partir de la Machine B dans le répertoire racine_serveur_app`/bin` sur la Machine A
11. | Démarrez le serveur d'applications sur la machine A.
12. | Exécutez le script sur la machine A.
Vérification :
(Machine A)
13. | Vérifiez que le serveur d'applications est en cours d'exécution.
(Machine B)
14. | Démarrez IBM HTTP Server ou un autre serveur Web pris en charge.
15. | Exécutez le servlet Snoop.
| Pour effectuer une vérification avec votre propre application, effectuez une nouvelle génération puis propagez le fichier `plugin-cfg.xml` après la configuration (installation) de l'application.
Installation du serveur d'applications :
(Machine A)
1. | Installez IBM Installation Manager.
2. | Utilisez Installation Manager pour installer WebSphere Application Server Network Deployment.
3. | Créez un serveur d'applications autonome.
Installation d'un serveur Web et de plug-ins de serveur Web :
(Machine A)
4. | Utilisez Installation Manager pour installer IBM HTTP Server ou un autre serveur Web pris en charge.
5. | Utilisez Installation Manager afin d'installer les plug-ins de serveur Web pour WebSphere Application Server.
Configuration du plug-in de serveur Web et création de la définition de serveur Web :
(Machine A)
6. | Utilisez Installation Manager pour installer WebSphere Customization Tools.
7. | Ouvrez WebSphere Customization Tools et lancez l'outil de configuration des plug-ins de serveur Web pour configurer le plug-in de serveur Web et créer la définition de serveur Web.
8. | Démarrez le serveur d'applications.
Vérification :
(Machine A)
9. | Vérifiez que le serveur d'applications est en cours d'exécution.
10. | Démarrez IBM HTTP Server ou un autre serveur Web pris en charge.
11. | Exécutez le servlet Snoop.
## Régénération du fichier `plugin-cfg.xml` | Lors de la configuration, le fichier `plugin-cfg.xml` est installé sur la machine B dans le répertoire racine_plugins`/config/nom_serveur_Web` . Le service de configuration du plug-in du serveur Web régénère automatiquement le fichier `plugin-cfg.xml`. Afin d'utiliser le fichier réel `plugin-cfg.xml` du serveur d'applications, propagez le fichier `plugin-cfg.xml` comme indiqué à la section suivante. | Le service de configuration du plug-in du serveur Web régénère automatiquement le fichier `plugin-cfg.xml`. Le fichier `plugin-cfg.xml` est généré dans le répertoire racine_profil`/config/cells/nom_cellule/nodes/nom_noeud/servers/nom_serveur_Web` lors de la création de la définition de serveur Web.
## Propagation du fichier `plugin-cfg.xml` | Le service de configuration pour le plug-in de serveur Web propage automatiquement le fichier `plugin-cfg.xml` pour IBM HTTP Server uniquement. Pour activer la propagation automatique, effectuez une configuration unique. Pour tous les autres serveurs Web, propagez le fichier de configuration du plug-in en copiant manuellement le fichier `plugin-cfg.xml` à partir du répertoire racine_profil `/config/cells/nom_cellule/nodes/nom_noeud/servers/ nom_serveur_Web` de la machine A dans le répertoire `racine_plugins/config/nom_serveur_Web` sur la Machine B. | Utilisez l'option propagate pour déplacer le fichier `plugin-cfg.xml` du répertoire racine_profil/config/cells/nom_cellule /nodes/nom_noeud/servers/nom_serveur_Web dans le répertoire racine_plugins/config/nom_serveur_Web.

### Topologie distante | ### Topologie locale

# Installation du plug-in de serveur Web pour les environnements distribués (cellules)
| Scénario d'installation répartie distante | Scénario d'installation répartie locale
## Environnement standard | # Production (recommandé) | # Développement
## Installation et configuration |
Installation du gestionnaire de déploiement :
(Machine A)
1. | Installez IBM Installation Manager.
2. | Utilisez Installation Manager pour installer WebSphere Application Server Network Deployment.
3. | Créez un profil de gestionnaire de déploiement.
4. | Vérifiez que le gestionnaire de déploiement est en cours d'exécution afin que les noeuds puissent être synchronisés pour les fichiers de configuration modifiés.
Installation du serveur d'applications :
(Machine B)
5. | Installez IBM Installation Manager.
6. | Utilisez Installation Manager pour installer WebSphere Application Server Network Deployment.
7. | Créez un serveur d'applications autonome.
8. | Ajoutez le noeud dans la cellule de gestionnaire de déploiement pour démarrer le processus d'agent de noeud. Démarrez l'agent de noeud sur un noeud géré existant. Le gestionnaire de déploiement et l'agent de noeud doivent être en cours d'exécution afin que les noeuds puissent être synchronisés pour les fichiers de configuration modifiés.
Installation d'un serveur Web et de plug-ins de serveur Web :
(Machine C)
9. | Installez IBM Installation Manager.
10. | Utilisez Installation Manager pour installer IBM HTTP Server ou un autre serveur Web pris en charge.
11. | Utilisez Installation Manager pour installer les plug-ins de serveur Web pour WebSphere Application Server.
Configuration du plug-in de serveur Web :
(Machine C)
12. | Utilisez Installation Manager pour installer WebSphere Customization Tools.
13. | Ouvrez WebSphere Customization Tools et lancez l'outil de configuration des plug-ins de serveur Web pour configurer le plug-in de serveur Web. Le script permettant de créer et de configurer le serveur Web est créé dans le répertoire racine_plugins`/bin`.
14. | Copiez le script nom_serveur_Web à coller sur la Machine A. Voir la section de ce document incluant des remarques relatives aux différentes plateformes pour plus d'informations sur l'exécution de scripts de configuration dans les cas suivants : Une machine exécute Windows et l'autre machine exécute Linux ou UNIX. Une machine utilise un différent codage de fichier.
Création de la définition de serveur Web :
(Machine A)
15. | Collez le script configurenom_serveur_Web à partir de la machine C dans le répertoire racine_serveur_app`/bin` sur la Machine A.
16. | Exécutez le script depuis une ligne de commande. Pour cela, le gestionnaire de déploiement et l'agent de noeud doivent être en cours d'exécution. Si vous avez activé la sécurité ou changé le type de connecteur JMX par défaut, éditez le script et incluez les paramètres appropriés.
Vérification :
(Machines A et B)
17. | Pour démarrer le serveur d'applications sur la machine B, utilisez la console d'administration du gestionnaire de déploiement de la machine A.
(Machine C)
18. | Démarrez IBM HTTP Server ou un autre serveur Web pris en charge.
19. | Exécutez le servlet Snoop.
Remarque : La procédure suivante décrit l'installation des plug-ins sur deux machines. Néanmoins, vous pouvez appliquer cette procédure pour une seule machine.
Installation du gestionnaire de déploiement :
(Machine A)
1. | Installez IBM Installation Manager.
2. | Utilisez Installation Manager pour installer WebSphere Application Server Network Deployment.
3. | Créez un profil de gestionnaire de déploiement.
4. | Vérifiez que le gestionnaire de déploiement est en cours d'exécution afin que les noeuds puissent être synchronisés pour les fichiers de configuration modifiés.
Installation du serveur d'applications :
(Machine B)
5. | Installez IBM Installation Manager.
6. | Utilisez Installation Manager pour installer WebSphere Application Server Network Deployment.
7. | Créez un serveur d'applications autonome.
8. | Ajoutez le noeud dans la cellule de gestionnaire de déploiement pour démarrer le processus d'agent de noeud. Démarrez l'agent de noeud sur un noeud géré existant. Le gestionnaire de déploiement et l'agent de noeud doivent être en cours d'exécution afin que les noeuds puissent être synchronisés pour les fichiers de configuration modifiés.
Installation d'un serveur Web et de plug-ins de serveur Web :
(Machine B)
9. | Utilisez Installation Manager pour installer IBM HTTP Server ou un autre serveur Web pris en charge.
10. | Utilisez Installation Manager pour installer les plug-ins de serveur Web pour WebSphere Application Server.
Configuration du plug-in de serveur Web :
(Machine B)
11. | Utilisez Installation Manager pour installer WebSphere Customization Tools.
12. | Ouvrez WebSphere Customization Tools et lancez l'outil de configuration des plug-ins de serveur Web pour configurer le plug-in de serveur Web et créer la définition de serveur Web. Le script permettant de créer et de configurer le serveur Web est placé dans le répertoire racine_plugins`/bin`.
13. | Copiez le script nom_serveur_Web à coller sur la Machine A. Voir la section de ce document incluant des remarques relatives aux différentes plateformes pour plus d'informations sur l'exécution de scripts de configuration dans les cas suivants : Une machine exécute Windows et l'autre machine exécute Linux ou UNIX. Une machine exécute un différent codage de fichier.
Création de la définition de serveur Web :
(Machine A)
14. | Collez le script configurenom_serveur_Web à partir de la Machine B dans le répertoire racine_serveur_app`/bin` sur la Machine A.
15. | Exécutez le script depuis une ligne de commande. Pour cela, le gestionnaire de déploiement et l'agent de noeud doivent être en cours d'exécution. Si vous avez activé la sécurité ou changé le type de connecteur JMX par défaut, éditez le script et incluez les paramètres appropriés.
Vérification :
(Machines A et B)
16. | Pour démarrer le serveur d'applications sur la machine B, utilisez la console d'administration du gestionnaire de déploiement de la machine A.
17. | Démarrez IBM HTTP Server ou un autre serveur Web pris en charge. Avant de démarrer le serveur Web Domino sur un système Linux ou UNIX, recherchez le script racine_plug-ins`/setupPluginCfg.sh`.
18. | Exécutez le servlet Snoop.
## Régénération du fichier `plugin-cfg.xml` | Lors de la configuration, un fichier `plugin-cfg.xml` est installé sur la machine C dans le répertoire racine_plugins`/config/nom_serveur_Web` . Le service de configuration du plug-in de serveur Web régénère automatiquement le fichier `plugin-cfg.xml`. Afin d'utiliser le fichier réel `plugin-cfg.xml` à partir du serveur d'applications, propagez le fichier `plugin-cfg.xml` comme indiqué à la section suivante. | Le fichier `plugin-cfg.xml` est généré dans le répertoire racine_profil`/config/cells/nom_cellule /nodes/nom_noeud/servers/nom_serveur_Web` dans lequel la définition de serveur Web est créée. Régénérez le fichier `plugin-cfg.xml` dans la définition de serveur Web du serveur d'applications lors de la modification de la configuration. Le serveur Web a immédiatement accès au fichier lorsqu'il est régénéré. Lorsque le service de configuration pour le plug-in de serveur Web (service d'administration) est activé sur la Machine A, le fichier `plugin-cfg.xml` est automatiquement généré pour tous les serveurs Web.
## Propagation du fichier `plugin-cfg.xml` | Le service de configuration pour le plug-in de serveur Web propage automatiquement le fichier `plugin-cfg.xml` pour IBM HTTP Server uniquement. Pour activer la propagation automatique, effectuez une configuration unique, décrite dans la dernière section de l'organigramme. Pour tous les autres serveurs Web, propagez le fichier de configuration de plug-in, en copiant manuellement le fichier `plugin-cfg.xml` à partir du répertoire racine_profil `/config/cells/nom_cellule/nodes/nom_noeud/servers/ nom_serveur_Web` sur la machine A dans le répertoire racine_plugins `/config/nom_serveur_Web` sur la Machine C. | Utilisez l'option propagate pour déplacer le fichier `plugin-cfg.xml` du répertoire racine_profil/config/cells/nom_cellule/nodes/nom_noeud/servers/nom_serveur_Web dans le répertoire racine_plugins/config/nom_serveur_web.

### Topologie distante | ### Topologie locale

# Procédure de configuration et de résolution des incidents pour la propagation automatique Le service de configuration du plug-in de serveur Web propage automatiquement le fichier `plugin-cfg.xml` pour IBM HTTP Server uniquement. Pour activer la propagation automatique, effectuez une configuration unique : Créez une entrée 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 Dans la console d'administration, cliquez sur Serveurs > Serveurs Web > webserver1 > Gestion du serveur Web distant. Définissez les valeurs suivantes : admin Port=8008, User Id=adminUser, Password=adminPassword. Accordez des droits d'accès en lecture/écriture pour les fichiers `httpd.conf` et `plugin-cfg.xml`. Pour plus d'informations, consultez le fichier racine_IHS`/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 :
    "Could not connect to IHS Administration server error"
Suivez la procédure décrite ci-dessous : Vérifiez que le serveur d'administration IBM HTTP Server est en cours d'exécution. 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. 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. 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. 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 s'exécute. Cette remarque s'applique principalement aux certificats auto-signés. Si vous rencontrez encore des erreurs, consultez le fichier `admin_error.log` d'IBM HTTP Server et les journaux de WebSphere Application Server (fichier `trace.log`) pour déterminer la cause de l'incident.

- # Remarques concernant les différentes plateformes pour l'exécution du script de configuration La configuration d'un serveur Web distant peut être différente en fonction des systèmes d'exploitation et des plateformes : Une machine exécute Windows et l'autre machine exécute Linux ou UNIX. Une machine utilise un codage par défaut différent de celui utilisé par l'autre machine. Une machine s'exécute sous Windows et l'autre sous Linux ou UNIX Si une machine s'exécute sous Linux ou UNIX et que l'autre machine s'exécute sous Windows, utilisez le script créé dans le répertoire `racine_plugins /bin/crossPlatformScripts`. Une machine utilise un codage par défaut différent de celui utilisé par l'autre machine Le contenu du script `configurenom_serveur_Web.bat` ou du script `configure nom_serveur_Web.sh` peut être corrompu si le codage de fichier par défaut est différent sur les deux machines. 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 le codage de fichier pour chaque machine et suivez une des procédures décrites ci-dessous pour éviter le problème. Pour déterminer le codage des fichiers par défaut, lancez la commande appropriée : Systèmes Windows :
      CHCP
- Systèmes Linux et UNIX :
      locale
Utilisez le résultat de la commande sur chaque machine en tant que valeur des variables codage_machine_serveur_web et codage_machine_serveur_applications dans une des procédures suivantes. Procédures pour la correction des différences de codage Supposez que le serveur Web est exécuté sur une machine Linux et que Network Deployment est exécuté sur une machine Windows. Serveur Web en cours d'exécution sur une machine Linux Lancez la commande suivante sur le système Linux ou UNIX pour coder le fichier de script qui configure la définition du serveur Web avant d'envoyer le fichier par FTP à la machine Windows en mode binaire :
    iconv -f codage_machine_serveur_Web \
          -t codage_machine_serveur_applications \
             configurenom_serveur_Web.bat
N'indiquez pas les caractères de continuation (\) Linux et UNIX si vous entrez la commande sur une seule ligne. 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. Supposez maintenant que le serveur Web s'exécute sur une machine Windows et que Network Deployment s'exécute sur une machine Linux ou UNIX. Serveur Web en cours d'exécution sur une machine Windows Lancez la commande suivante sur le système Linux ou UNIX pour coder le fichier de script qui configure la définition du serveur Web et envoyez ensuite le fichier par FTP en mode binaire :
    iconv -f codage_machine_serveur_Web \
          -t codage_machine_serveur_applications \
             configurenom_serveur_Web.sh
N'indiquez pas les caractères de continuation (\) Linux et UNIX si vous entrez la commande sur une seule ligne. Si le mappage de conversion n'est pas pris en charge par la commande iconv sur votre système, copiez le contenu du script de configuration du serveur Web dans un presse-papiers puis collez-le sur la machine dans laquelle le serveur d'applications est en cours d'exécution.