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.
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.gotchaSyntaxe
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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]](../images/dist.gif)
-profileName![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
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]](../images/dist.gif)
GenPluginCfg -cell.name NetworkDeploymentCell
![[IBM i]](../images/iseries.gif)
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]](../images/dist.gif)
GenPluginCfg -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName
![[IBM i]](../images/iseries.gif)
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]](../images/dist.gif)
GenPluginCfg -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName
![[IBM i]](../images/iseries.gif)
GenPluginCfg.sh -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName
Rubrique de référence