Configuration d'un plug-in de serveur Web à l'aide de l'outil pct

La commande WCT appelle un outil de ligne de commande spécifié par le paramètre -tool. Vous pouvez utiliser la commande WCT et spécifier l'outil PCT afin de configurer un serveur Web pour qu'il utilise un serveur d'applications comme serveur hôte.

Procédure

Configurez un serveur Web pour qu'il utilise un serveur d'applications comme serveur hôte.

Emplacement de la commande WCT

Le produit contient le script suivant qui configure l'environnement et appelle la commande WCT.

racine_install_WCT\WCT\wctcmd.bat
racine_install_WCT/WCT/wctcmd.sh

Syntaxe de la commande WCT lors de l'appel de l'outil pct

wctcmd.bat
      -tool pct
      -defLocPathname definition_location_pathname
      -defLocName definition_location_name
      -importDefinitionLocation
      -removeDefinitionLocation definition_location_name
      -listDefinitionLocations
      -createDefinition
      -deleteDefinition webserver_definition_name
      -listDefinitions
      -response response_file

./wctcmd.sh
      -tool pct
      -defLocPathname definition_location_pathname
      -defLocName definition_location_name
      -importDefinitionLocation
      -removeDefinitionLocation definition_location_name
      -listDefinitionLocations
      -createDefinition
      -deleteDefinition webserver_definition_name
      -listDefinitions
      -response response_file

Paramètres de la commande WCT lors de l'appel de l'outil pct

-tool pct

Spécifie le nom de l'outil à lancer tel qu'il est enregistré auprès de la commande WCT

Ce paramètre est obligatoire.

-defLocNom nom_emplacement_définition

Spécifie le nom logique de l'emplacement racine où se trouve l'exécution (runtime) du plug-in

Ce paramètre est obligatoire lorsque vous créez ou supprimez une définition.

-defLocnom_chemin nom_chemin_emplacement_définition

Spécifie le nom de chemin absolu de l'emplacement racine où se trouve l'exécution (runtime) du plug-in

Ce paramètre est obligatoire lorsque vous créez ou supprimez une définition.

-importDefinitionLocation

Indique que vous souhaitez importer un emplacement d'exécution de plug-in de serveur Web dans le registre des outils

Une définition est créée dans le cadre de cette opération.

Exemple d'utilisation :

wctcmd.bat -tool pct -importDefinitionLocation -defLocPathname C:\data\IBM\WebSphere\Plugins -defLocName DefinitionLocationName -response C:\IBM\WebSphere\tools\WCT\responsefile.txt

./wctcmd.sh -tool pct -importDefinitionLocation -defLocPathname /opt/IBM/WebSphere/Plugins -defLocName DefinitionLocationName -response /opt/IBM/WebSphere/tools/WCT/responsefile.txt

-listDefinitionLocations

Indique que vous souhaitez générer une liste de tous les emplacements de définition

Exemple d'utilisation :

wctcmd.bat -tool pct -listDefinitionLocations

./wctcmd.sh -tool pct -listDefinitionLocations

-removeDefinitionLocation

Spécifie que l'outil pct doit supprimer un emplacement de définition

Ce paramètre est utilisé lorsque vous supprimez un emplacement de définition.

Exemple d'utilisation :

wctcmd.bat -tool pct -removeDefinitionLocation -defLocPathname C:\data\IBM\WebSphere\Plugins

./wctcmd.sh -tool pct -removeDefinitionLocation -defLocPathname /opt/IBM/WebSphere/Plugins

wctcmd.bat -tool pct -removeDefinitionLocation -defLocName DefinitionLocationName

./wctcmd.sh -tool pct -removeDefinitionLocation -defLocName DefinitionLocationName

-createDefinition

Spécifie que vous créez une définition de serveur Web

Exemple d'utilisation :

wctcmd.bat -tool pct -createDefinition -defLocName DefinitionLocationName -response C:\IBM\WebSphere\tools\WCT\responsefile.txt

./wctcmd.sh -tool pct -createDefinition -defLocName DefinitionLocationName -response /opt/IBM/WebSphere/tools/WCT/responsefile.txt

-deleteDefinition nom_définition_serveur_web

Spécifie la définition de plug-in du serveur Web unique à supprimer.

Ce paramètre est utilisé lorsque vous supprimez une définition existante.

Le nom_définition est obligatoire. Un des paramètres suivants est également obligatoire :

-defLocName definition_location_name
-defLocPathname definition_location_pathname

Si les deux valeurs de ces paramètres sont spécifiées, la première est utilisée. Si la première valeur fournie échoue au test de validation, la commande échoue avec un message d'erreur.

Exemple d'utilisation :

wctcmd.bat -tool pct -defLocPathname C:\data\IBM\WebSphere\Plugins -defLocName DefinitionLocationName -deleteDefinition WebServerDefinitionName

./wctcmd.sh -tool pct -defLocPathname /opt/IBM/WebSphere/Plugins -defLocName DefinitionLocationName -deleteDefinition WebServerDefinitionName

-listDefinitions

Indique que vous souhaitez générer une liste de toutes les définitions

Exemple d'utilisation :

wctcmd.bat -tool pct -listDefinitions -defLocName DefinitionLocationName

./wctcmd.sh -tool pct -listDefinitions -defLocName DefinitionLocationName

-response fichier_réponses

Spécifie le fichier de réponses contenant les arguments de l'outil

Ce paramètre est obligatoire lorsque vous créez une définition.

Remarques :

Les arguments de ligne de commande respectent la casse.
Si un argument accepte un paramètre contenant des espaces, le paramètre doit être entouré de guillemets ("").

-logLevel valeur_entier

Indique la granularité de la sortie du journal. La valeur d'argument peut être un entier compris entre 1 et 7, où 7 est le niveau de journalisation le plus précis.

Paramètres de l'outil pct

Paramètres généraux

Paramètre	Valeurs
configType Indique le type de configuration.	local_standalone WebSphere® Application Server et serveur Web sur la même machine distant WebSphere Application Server et serveur Web sur des machines distinctes local_distributed Le profil sur WebSphere Application Server est fédéré à un gestionnaire de déploiement
wasExistingLocation Indique l'emplacement du répertoire de base d'installation de WebSphere Application Server Cette option est valide uniquement pour un type de configuration local.	Emplacement du répertoire de base d'installation de WebSphere Application Server
webServerSelected Définit le serveur Web à configurer. Ne spécifiez qu'un seul serveur Web à configurer.	apache22 Apache Web Server Version 2.2 Configuration 64 bits non prise en charge sous Windows apache24 Apache Web Server Version 2.4 Configuration 64 bits non prise en charge sous Windows domino Serveur Web Lotus® Domino® Non pris en charge sur HP-UX ou Solaris x64 (x86_64) ihs IBM® HTTP Server Configuration 64 bits non prise en charge sous Windows iis8 Microsoft Internet Information Services version 8 Pris en charge sous Windows sunone Oracle iPlanet Web Server (Sun Microsystems Sun ONE) Pris en charge uniquement sur HP-UX et Solaris
ihsAdminPort Indique le numéro de port d'administration HTTP. Indiquez cette valeur uniquement lors de la configuration d'IHS.	Numéro de port d'administration HTTP
ihsAdminUserID Spécifie l'ID utilisateur d'administrateur IHS pour le serveur d'administration IHS Indiquez cette valeur uniquement lors de la configuration d'IHS.	ID utilisateur administrateur IHS pour le serveur d'administration IHS
webServerConfigFile1 Définit le premier fichier de configuration du serveur Web. Le fichier spécifié doit exister.	apache httpd.conf Restriction: Pour configurer correctement le serveur, le nom du fichier de configuration doit être conservé en tant que httpd.conf. domino notes.jar ihs httpd.conf Restriction: Pour configurer correctement le serveur, le nom du fichier de configuration doit être conservé en tant que httpd.conf. sunone magnus.conf
webServerConfigFile2 Définit le second fichier de configuration du serveur Web. Le fichier spécifié doit exister.	domino names.jar sunone obj.conf
webServerPortNumber Indique le port du serveur Web à configurer.	Port du serveur Web à configurer
dominoUserID Indique l'ID utilisateur Domino	ID utilisateur Domino
webServerDefinition Définit le nom de définition du serveur Web. Les espaces ne sont pas autorisés dans les noms de définition de serveur Web.	Nom de la définition de serveur Web sans espaces
wasMachineHostName Indique le nom d'hôte de la machine WebSphere Application Server Cette spécification peut être omise pour un type d'installation local_standalone.	Pour un type d'installation distante : "`nom_hôte`" L'installation utilise le nom d'hôte `nom_hôte` sur la machine. Pour un type d'installation locale : "" Le nom d'hôte de la machine d'installation cible sera utilisé. Attention: Si vous utilisez la commande WCT pour créer plusieurs serveurs Web et exécuter WCT sur les machines de serveur Web selon les besoins, le nom d'hôte de chaque serveur Web est un nom d'hôte dérivé -basé sur le même type que celui pour lequel vous demandez le nom d'hôte sur le système d'exploitation. Une telle exécution de WCT peut générer la création de deux fichiers script avec le même nom d'hôte que celui utilisé pour la création du noeud et du fichier serverIndex.xml. Avec deux serveurs Web sur la même machine, vous avez deux adresses IP réseau pour lesquelles vous pouvez souhaiter avoir des noms d'hôte uniques. Etant donné que le nom d'hôte a été dérivé et que vous n'avez reçu aucune invite pour le nom d'hôte du serveur Web, l'outil WCT et le script `configurewebserverx.bat/sh` associé créent un noeud et un fichier serverIndex.xml avec le même nom d'hôte. Pour que les deux serveurs Web que vous avez créés sur la même machine aient deux adresses IP réseau distinctes, accédez à la console d'administration et procédez comme suit : Serveurs > Serveurs Web > webserverName Cliquez sur Ports. Pour un noeud géré, cliquez sur WEBSERVER_ADDRESS. Pour un noeud non géré, cliquez sur WEBSERVER_ADMIN_ADDRESS. Changez les adresses IP (nom d'hôte). Cliquez sur OK et sur Sauvegarder.

Paramètres avancés (disponibles uniquement dans les installations en mode silencieux)

Paramètre	Valeurs
mapWebserverToApplications Indique s'il convient de mapper toutes les applications déployées existantes au serveur web. Si aucune option valide n'est attribuée à ce paramètre, le programme d'installation lui attribue la valeur true et poursuit l'installation.	true La définition de serveur Web est mappée comme cible pour les applications déployées existantes telles que snoop et hit count. (Recommandé) False Aucune application n'est mappée à la définition du serveur Web.
webServerHostName Dans les scénarios avancés où un utilisateur a plusieurs noms d'hôte de serveur Web sur une machine, spécifie le nom d'hôte du serveur Web utilisé pour la configuration	"" L'installation utilise le nom d'hôte détecté sur la machine. (Recommandé) "`nom_hôte`" L'installation utilise le nom d'hôte `nom_hôte` sur la machine.
webServerInstallArch Définit l'architecture de l'installation du serveur Web.	"32" Valide pour les installations de serveur Web 32 bits "64" Valide pour les installations de serveur Web 64 bits Pour Apache Web Server et IBM HTTP Server, la configuration 64 bits n'est pas prise en charge sous Windows. "" L'architecture de la machine du serveur Web est utilisée
profileName Indique le nom du profil WebSphere Application Server à configurer	"`nom_profil`" Vous devez entrer le nom d'un profil WebSphere Application Server existant. Si vous laissez la chaîne vide, le programme d'installation utilise le profil par défaut. Cette option est valide uniquement dans les scénarios d'installation locale.
ihsAdminPassword Spécifie le mot de passe de l'utilisateur sur le serveur d'administration IHS à configurer Indiquez cette valeur uniquement lors de la configuration d'IHS.	"`mot_de_passe_admin_IHS`" Vous devez entrer le mot de passe de l'utilisateur qui va être utilisé pour configurer le serveur d'administration IHS.
enableAdminServerSupport Spécifie si le serveur d'administration IHS doit être configuré. Indiquez cette valeur uniquement lors de la configuration d'IHS.	true Le support est activé et le serveur d'administration IHS va être configuré. False Le support n'est pas activé et le serveur d'administration IHS ne sera pas configuré.
enableUserAndPass Spécifie si le support doit être activé pour configurer le serveur d'administration IHS avec un ID utilisateur et un mot de passe en tant que données d'identification. Indiquez cette valeur uniquement lors de la configuration d'IHS.	true Le support est activé pour configurer le serveur d'administration IHS avec un ID utilisateur et un mot de passe. Les données d'identification appropriées supplémentaires doivent être fournies. False Le support n'est pas activé pour configurer le serveur d'administration IHS avec un ID utilisateur et un mot de passe. Aucune valeur supplémentaire n'est requise.
webServerType Définit le type de serveur Web à configurer. Ne spécifiez qu'un seul serveur Web à configurer.	APACHE Apache Web Server Version 2.2 ou Version 2.4 Configuration 64 bits non prise en charge sous Windows DOMINO Lotus Domino Web Server Non pris en charge sur HP-UX ou Solaris x64 (x86_64) IHS IBM HTTP Server Configuration 64 bits non prise en charge sous Windows IIS Microsoft Internet Information Services version 8 Pris en charge sous Windows SUNJAVASYSTEM Oracle iPlanet Web Server (Sun Microsystems Sun ONE) Pris en charge uniquement sur HP-UX et Solaris
ihsWindowsStartupType Spécifie le type de démarrage du service administratif IHS qui va être créé sous Windows Indiquez cette valeur uniquement lors de la configuration d'IHS. A utiliser uniquement avec les systèmes d'exploitation Windows.	auto Le service démarre automatiquement lorsque le système est initialisé. demand Le service démarre uniquement sur demande.
ihsAdminWinUserID Spécifie l'ID de l'utilisateur qui sera utilisé pour configurer le serveur d'administration IHS sous Windows Indiquez cette valeur uniquement lors de la configuration d'IHS. A utiliser uniquement avec les systèmes d'exploitation Windows.	"`ID_utilisateur_admin_IHS`" Vous devez entrer le nom qui va être utilisé pour configurer le serveur d'administration IHS.
ihsAdminWinPassword Spécifie le mot de passe de l'utilisateur qui sera utilisé pour configurer le serveur d'administration IHS sous Windows Indiquez cette valeur uniquement lors de la configuration d'IHS. A utiliser uniquement avec les systèmes d'exploitation Windows.	"`mot_de_passe_admin_IHS`" Vous devez entrer le mot de passe de l'utilisateur qui va être utilisé pour configurer le serveur d'administration IHS.
ihsAdminCreateUserAndGroup Indique s'il est nécessaire d'utiliser un ID utilisateur UNIX existant ou de créer un nouvel ID utilisateur et un groupe. Cette valeur est requise uniquement si le paramètre `ihsAdminPort` est défini et s'il est utilisé conjointement avec les paramètres `ihsAdminUnixUserID` et `ihsAdminUnixUserGroup`.	true Crée un nouvel utilisateur UNIX et un groupe, qui ont été définis avec les paramètres `ihsAdminUnixUserID` et `ihsAdminUnixUserGroup`. False Utilise un nouvel utilisateur UNIX et un groupe, qui ont été définis avec les paramètres `ihsAdminUnixUserID` et `ihsAdminUnixUserGroup`. Vérifiez que les valeurs d'utilisateur et de groupe sont valides.
ihsAdminUnixUserID Spécifie l'ID utilisateur à utiliser avec le serveur d'administration IHS sur UNIX. Cette valeur est requise uniquement si le paramètre `ihsAdminPort` est défini et s'il est utilisé conjointement avec les paramètres `ihsAdminUnixUserGroup` et `ihsAdminCreateUserAndGroup`.	ID utilisateur à utiliser avec le serveur d'administration IHS.
ihsAdminUnixUserGroup Spécifie le nom du groupe d'utilisateurs UNIX à utiliser lors de la configuration du serveur d'administration IHS. Cette valeur est requise uniquement si le paramètre `ihsAdminPort` est défini et s'il est utilisé conjointement avec les paramètres `ihsAdminUnixUserID` et `ihsAdminCreateUserAndGroup`.	Groupe UNIX de l'ID utilisateur UNIX à utiliser avec le serveur d'administration IHS
enableWinService Indique s'il faut ou non configurer le serveur d'administration IHS pour qu'il s'exécute en tant que service Windows Indiquez cette valeur uniquement lors de la configuration d'IHS. A utiliser uniquement avec les systèmes d'exploitation Windows.	true La prise en charge de la configuration du serveur d'administration IHS en tant que service Windows sera activée False La prise en charge de la configuration du serveur d'administration IHS en tant que service Windows ne sera pas activée.

Remarque: Après avoir exécuté la commande WCT, le serveur Web est configuré pour utiliser un serveur d'applications comme serveur d'hébergement. La commande WCT crée également un nouveau fichier de réponses dans le répertoire qui contient les fichiers de configuration. Ce fichier de réponses peut contenir deux entrées non documentées, defLocPathname et profilePath, qui ne sont pas fonctionnellement prises en charge par le produit. Le nouveau fichier de réponses contient les informations utilisées pour créer la configuration de serveur Web.

Exemple d'utilisation de l'outil PCT pour configurer un serveur Web IHS de sorte qu'il utilise un serveur d'applications comme serveur hôte :

wctcmd.bat -tool pct -defLocPathname C:\data\IBM\WebSphere\Plugins -defLocName someDefinitionLocationName -createDefinition -response C:\IBM\WebSphere\tools\WCT\responsefile.txt
./wctcmd.sh -tool pct -defLocPathname /opt/IBM/WebSphere/Plugins -defLocName someDefinitionLocationName -createDefinition -response /opt/IBM/WebSphere/tools/WCT/responsefile.txt

L'exemple suivant présente le contenu d'un fichier de réponses pour la configuration de plug-in local IHS. Les valeurs admises pour le paramètre webServerOS , qui est utilisé pour spécifier le système d'exploitation du serveur Web, sont Windows, Linux®, Solaris, AIX®, HPUX, OS390et OS400.

configType=local_standalone
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=false
ihsAdminCreateUserAndGroup=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUnixUserGroup=grp101
ihsAdminUnixUserID=user1
mapWebServerToApplications=true
profileName=AppSrv01
wasExistingLocation=/opt/IBM/WebSphere/AppServer
webServerConfigFile1=/opt/IBM/HTTPServer/conf/httpd.conf
webServerDefinition=webserver1
webServerHostName=local.ibm.com
webServerOS=operating_system_value
webServerPortNumber=80
webServerSelected=ihs

configType=local_standalone
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUserID=admin1
ihsWindowsPassword=******
ihsWindowsStartupType=auto
ihsWindowsUserID=user1
mapWebServerToApplications=true
profileName=AppSrv01
wasExistingLocation=D:\\IBM\\WebSphere\\AppServer
webServerConfigFile1=D:\\IBM\\HTTPServer\\conf\\httpd.conf
webServerDefinition=webserver1
webServerHostName=local.ibm.com
webServerInstallArch=32
webServerPortNumber=80
webServerSelected=ihs

L'exemple suivant présente le contenu d'un fichier de réponses pour une configuration de plug-in distant IHS. Les valeurs admises pour le paramètre webServerOS , qui est utilisé pour spécifier le système d'exploitation du serveur Web, sont Windows, Linux, Solaris, AIX, HPUX, OS390et OS400.

configType=remote
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=false
ihsAdminCreateUserAndGroup=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUnixUserGroup=grp101
ihsAdminUnixUserID=user1
mapWebServerToApplications=true
wasMachineHostname=192.168.1.2
webServerConfigFile1=/opt/IBM/HTTPServer/conf/httpd.conf
webServerDefinition=webserver1
webServerHostName=remote.ibm.com
webServerOS=operating_system_value
webServerPortNumber=80
webServerSelected=ihs

configType=remote
enableAdminServerSupport=true
enableUserAndPass=true
enableWinService=true
ihsAdminPassword=******
ihsAdminPort=8008
ihsAdminUserID=admin1
ihsWindowsPassword=******
ihsWindowsStartupType=auto
ihsWindowsUserID=user1
mapWebServerToApplications=true
wasMachineHostname=192.168.1.2
webServerConfigFile1=D:\IBM\HTTPServer\conf\httpd.conf
webServerDefinition=webserver1
webServerHostName=remote.ibm.com
webServerInstallArch=32
webServerOS=windows
webServerPortNumber=80
webServerSelected=ihs

Etape suivante

Vous pouvez utiliser l'outil pct si votre machine possède plusieurs noms d'hôte et adresses IP. Toutefois, le nom d'hôte doit être défini après la configuration du serveur Web via l'interface utilisateur graphique PCT en procédant comme suit :

Cliquez sur Ports.
Cliquez sur WEBSERVER_ADDRESS. Pour un noeud non géré, cliquez sur WEBSERVER_ADMIN_ADDRESS.
Changez le nom d'hôte.
Cliquez sur OK pour sauvegarder.