![[16.0.0.3 et ultérieur]](../ng_v16003plus.gif)
Commande pluginUtility
Si le serveur Liberty génère le fichier de configuration des plug-ins automatiquement, vous pouvez utiliser la commande pluginUtility pour collecter les fichiers de configuration des plug-ins et les faire fusionner. De plus, vous pouvez utiliser la commande pluginUtility pour générer manuellement le fichier de configuration des plug-ins.
Syntaxe
La syntaxe de la commande est la suivante :
pluginUtility action [options]
- help
- Affiche des informations d'aide pour l'action spécifiée.
Vous pouvez afficher de l'aide pour la commande pluginUtility ou pour des actions spécifiques, comme par exemple l'action merge.
- merge
- Fusionne plusieurs fichiers de configuration des plug-ins du serveur Web en un seul fichier.
![[16.0.0.4 et ultérieur]](../ng_v16004plus.gif)
- generate
- Crée le fichier de configuration des plug-ins à l'aide de cette utilitaire.
Options
--server=id_serveur pour un serveur local ou --server=user:password@host:port pour un serveur distant
Cette option s'applique uniquement à l'action generate et elle est requise lorsque vous codez l'action generate sur la commande pluginUtility.
- Pour un serveur local, l'option de serveur est le nom du serveur.
- Pour un serveur distant, l'option de serveur est user:password@host:port
- Le serveur doit être en cours d'exécution pour un serveur local ou pour un serveur distant.
- user
- Administrateur du serveur cible. L'utilitaire vous invite à entrer une valeur si vous ne la fournissez pas. N'utilisez pas les deux points (:) dans la valeur de user.
- password
- Mot de passe de l'administrateur du serveur cible. L'utilisateur vous invite deux fois en entrer une valeur si vous ne la fournissez pas. Les deux mots de passe entrés doivent être identiques.
Important : Vous pouvez spécifier un utilisateur et un mot de passe sur cette option de sorte que lorsque vous spécifiez ces valeurs sur la ligne de commande, elles fonctionnent. Le serveur cible compare les valeurs que vous spécifiez pour l'utilisateur et le mot de passe aux valeurs que vous spécifiez sur la ligne de commande.Conseil : Pour une demande à distance, vous pouvez coder l'ID utilisateur et le mot de passe dans le fichier server.xml du serveur cible.Exemple :<quickStartSecurity userName="AdminUser" userPassword="AdminPassword" />
- host
- Hôte du serveur cible. N'utilisez pas le symbole @ dans la valeur host. Si vous n'indiquez pas de valeur pour l'hôte, la commande échoue.
- port
- Numéro de port du serveur cible. Une valeur de port manquante entraîne un échec.
Avertissement : Lorsque le serveur spécifié est un serveur distant, l'utilisateur est invité à accepter un certificat SSL pour que la demande puisse être effectuée. Pour accepter les certificats SSL de façon automatique, définissez la propriété JVM de com.ibm.webserver.plugin.utility.autoAcceptCertificates sur true.
![[16.0.0.4 et ultérieur]](../ng_v16004plus.gif)
- --cluster=nom_cluster
- Cette option s'applique uniquement à l'action generate et elle est requise lorsque vous générez un fichier de configuration des plug-ins pour un serveur en cluster à l'aide de cet utilitaire. Spécifiez
le nom du cluster de serveurs.
Lorsque vous spécifiez l'option --cluster, vous devez spécifier le contrôleur de collectivité sur l'option --server.
Pour qu'un serveur du cluster soit inclus dans le fichier de configuration des plug-ins, il doit être en cours d'exécution et doit avoir été ajouté au contrôleur de collectivité.
- --sourcePath=répertoire|liste séparée par des virgules
- Option obligatoire qui s'applique uniquement à l'action merge. Spécifiez l'emplacement du répertoire source contenant tous les fichiers de configuration des plug-ins. Ou bien, pour identifier les fichiers de plug-ins à faire fusionner, spécifiez une liste de noms de fichiers de plug-ins source séparés par des virgules avec le chemin d'accès complet aux fichiers.
- --targetPath=répertoire|nom du chemin complet
Option facultative qui s'applique à l'action merge et à l'action generate.
Pour l'action generate, par défaut, le fichier de configuration des plug-ins est généré dans le répertoire en cours avec le nom nom_cluster-plugin-cfg.xml pour une demande cluster, et plugin-cfg.xml pour une demande non-cluster. Vous pouvez spécifier le nom du répertoire dans lequel le fichier doit être placé, ou spécifier un nom de fichier complet. Le répertoire doit exister. Le nouveau fichier remplace un fichier existant.
Pour l'action merge, par défaut, le fichier de configuration des plug-ins est généré dans le répertoire en cours avec le nom merged-plugin-cfg.xml. Vous pouvez spécifier le nom du répertoire cible du fichier merged-plugin-cfg.xml ou un nom de fichier complet. Le répertoire doit exister. Si un fichier appelé merged-plugin-cfg.xml ou le nom de fichier spécifié existe, le contenu du fichier est écrasé.
Syntaxe
Les exemples suivants montrent la syntaxe correcte :
pluginUtility help
pluginUtility help merge
pluginUtility merge --sourcePath=C:/plugins
pluginUtility merge --sourcePath=C:/plugins/plugin-cfg.xml,C:/plugins/Aplugin-cfg.xml,C:/other/plugin-cfg.xml
pluginUtility merge --sourcePath=C:/plugins --targetPath=C:/targetDir
pluginUtility merge --sourcePath=C:/plugins --targetPath=C:/targetDir/myMergedPluginCfg.xml
![[16.0.0.4 et ultérieur]](../ng_v16004plus.gif)
pluginUtility help generate
pluginUtility generate --server=myController --cluster=myCluster --targetpath=./pluginFile/plugin-cfg.xml
pluginUtility generate -–server=userName:mypassword@myControllerHost:9443 --cluster=myCluster --targetpath=./pluginFiles/plugin-cfg.xml
pluginUtility generate –-server=myServer --targetpath=./pluginFiles/plugin-cfg.xml
pluginUtility generate –-server=userName:mypassword@testHost:9443 --targetpath=./pluginFiles/plugin-cfg.xml
pluginUtility generate --server=userName:@testHost:9443