Commande GenPluginCfg

La commande GenPluginCfg permet de régénérer le fichier de configuration de plug-in du serveur Web WebSphere (plugin-cfg.xml).

Pour plus d'informations sur l'exécution de cette commande, voir Utilisation des outils de ligne de commande.

ATTENTION :
Le fait de régénérer la configuration du plug-in peut remplacer les modifications manuelles que vous avez apportées à la configuration et que vous souhaitez peut-être conserver. Before performing this task, understand its implications as described in Implémentation d'un plug-in de serveur Web.
Eviter les incidents Eviter les incidents: La configuration de plug-in centrée sur la topologie, ou globale, est obsolète. Utilisez à la place la configuration centrée sur l'application, comme indiqué dans Implémentation d'un plug-in de serveur Web. Pour toute configuration existante qui est centrée sur la topologie, vous pouvez mettre à jour le fichier plugin-cfg.xml globale à l'aide de la console d'administration ou de la commande GenPluginCfg pour tous les clusters d'une cellule. Cependant, vous devez supprimer le fichier config/cells/plugin-cfg.xml avant de mettre à jour le fichier plugin-cfg.xml global. Si vous ne supprimez pas le fichier config/cells/plugin-cfg.xml, seules les nouvelles propriétés et les valeurs correspondantes sont ajoutées au fichier plugin-cfg.xml global. Aucune des mises à jour apportées à des valeurs de propriété de plug-in existantes n'est ajoutée au fichier plugin-cfg.xml global.gotcha
Remarque : Etant donné que la commande GenPluginCfg s'exécute dans sa propre machine virtuelle Java™ et non dans la machine virtuelle Java WebSphere Application Server, il se peut que la commande ne puisse pas accéder à d'autres fichiers de classes. Si vous rencontrez ce problème lorsque vous exécutez la commande GenPluginCfg, vous pouvez exécuter plutôt le script httpPluginManagement.py pour générer une configuration de plug-in axée sur une application. Ce script utilise wsadmin pour initier la génération de plug-in. Pour plus d'informations, voir httpPluginManagement.py script.

Syntaxe

Pour regénérer la configuration du plug-in, utilisez l'une des méthodes suivantes :
  • [AIX Solaris HP-UX Linux Windows]Cliquez sur Serveurs > Types de serveurs > Serveurs Web dans la console d'administration, sélectionnez un serveur Web, puis cliquez sur Générer un plug-in.
  • Exécutez la commande suivante :
    [AIX Solaris HP-UX Linux Windows]
    racine_serveur_applis/bin/GenPluginCfg.sh|bat
    Les deux techniques de régénération de la configuration du plug-in créent un fichier plugin-cfg.xml au format ASCII, qui est le format adapté à l'exécution dans un environnement réparti.
    [IBM i]
    racine_serveur_applis/bin/GenPluginCfg
    Cette méthode de régénération de la configuration du plug-in crée un fichier plugin-cfg.xml au format ASCII, qui est le format adapté à l'exécution dans un environnement IBM i.
    [z/OS]
    racine_serveur_applis/bin/GenPluginCfg.sh
    Cette méthode de régénération de la configuration du plug-in crée un fichier plugin-cfg.xml au format UTF-8, qui est le format adapté à l'exécution dans un environnement z/OS.

[AIX Solaris HP-UX Linux Windows][IBM i]Vous pouvez utiliser l'option -profileName pour définir le profil du processus de serveur d'applications dans une installation multiprofils. L'option -profileName n'est pas requise dans un environnement contenant un seul profil. La valeur par défaut pour cette option correspond au profil par défaut.

Lorsque la commande GenPluginCfg est exécutée avec l'option -webserver.name webservrName, wsadmin génère un fichier de configuration de plug-in pour le serveur Web. Les paramètres figurant dans le fichier de configuration généré sont fondés sur la liste des applications déployées sur le serveur Web. Lorsque cette commande est exécutée dans l'option -webserver.name webservrName, le fichier de configuration du plug-in est généré en fonction de la topologie.

Paramètres

Les options ci-après sont disponibles pour la commande GenPluginCfg :

-config.root configroot_dir
Valeur par défaut : CONFIG_ROOT. La commande setupCmdLine est appelée pour obtenir cette variable d'environnement.
[AIX Solaris HP-UX Linux Windows][IBM i]-profileName
[AIX Solaris HP-UX Linux Windows][IBM i]Définit le profil d'un processus de serveur d'applications dans une installation avec plusieurs profils. L'option -profileName n'est pas requise dans un environnement contenant un seul profil. La valeur par défaut pour cette option correspond au profil par défaut.
-cell.name cell
Valeur par défaut : WAS_CELL. La commande setupCmdLine est appelée pour obtenir cette variable d'environnement.
-node.name node
Valeur par défaut : WAS_NODE. La commande setupCmdLine est appelée pour obtenir cette variable d'environnement.
-webserver.name webserver1
Obligatoire pour la création d'un fichier de configuration de plug-in pour un serveur Web donné.
-propagate yes/no
Applicable only when the webserver.name option is specified and the web server is local or on a remote unmanaged node. Sinon, vous devez copier manuellement le fichier plugin-cfg.xml situé dans racine_serveur_app/profiles/nom_profil/config/cells/nom_cellule/nodes/nom_noeud/servers/nom_serveur_web et le placer dans racine_plugins/config/nom_serveur_web, dans le répertoire de plug-ins du serveur Web distant. La valeur par défaut est no.
-propagateKeyring yes/no
Applicable uniquement lorsque l'option webserver.name est définie et que le serveur Web est local. La valeur par défaut est no.
-cluster.name cluster1,cluster2 | ALL
Liste facultative de clusters. Ignorée lorsque l'option webserver.name est définie.
-server.name server1,server2
Liste facultative de serveurs. Obligatoire en cas de génération d'un plug-in de serveur unique. Ignorée lorsque l'option webserver.name est définie.
-output.file.name file_name
La valeur par défaut est le fichier configroot_dir/plugin-cfg.xml. Ignorée lorsque l'option webserver.name est définie.
-destination.root root
Racine d'installation de la machine sur laquelle la configuration est utilisée. Ignorée lorsque l'option webserver.name est définie.
-destination.operating.system windows/unix
Système d'exploitation de la machine sur laquelle la configuration est utilisée. Ignorée lorsque l'option webserver.name est définie.
-force yes
Crée une nouvelle configuration au lieu de tenter de fusionner avec une configuration existante lorsque la commande est émise pour une génération de fichiers au niveau de la cellule.
-debug yes/no
La valeur par défaut est no.
-help
Imprime une syntaxe.
-?
Imprime une syntaxe.

Scénario d'utilisation

Pour générer une configuration de plug-in pour tous les clusters d'une cellule, utilisez la commande suivante :

[AIX Solaris HP-UX Linux Windows]
GenPluginCfg -cell.name NetworkDeploymentCell
[IBM i][z/OS]
GenPluginCfg.sh -cell.name NetworkDeploymentCell

Pour générer une configuration de plug-in pour un seul serveur, utilisez la commande suivante :

[AIX Solaris HP-UX Linux Windows]
GenPluginCfg -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName
[IBM i][z/OS]
GenPluginCfg.sh -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName

Pour générer un fichier de configuration de plug-in pour un serveur Web, utilisez la commande suivante :

[AIX Solaris HP-UX Linux Windows]
GenPluginCfg -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName
[IBM i][z/OS]
GenPluginCfg.sh -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName

Icône indiquant le type de rubrique Rubrique de référence



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=rxml_genplugincfg1
Nom du fichier : rxml_genplugincfg1.html