![[16.0.0.3 and later]](../ng_v16003plus.gif)
pluginUtility 命令
如果 Liberty 服务器自动生成插件配置文件,那么可使用 pluginUtility 命令收集插件配置文件并将其合并。此外,可使用 pluginUtility 命令手动生成插件配置文件。
语法
命令语法如下所示:
pluginUtility action [options]
操作 action 可以采用下列其中一个值:![[16.0.0.4 and later]](../ng_v16004plus.gif)
- help
- 显示有关所指定操作的帮助信息。
可以显示 pluginUtility 命令的帮助或诸如合并操作的特定操作的帮助。
- merge
- 将多个 Web 服务器插件配置文件合并到单个文件中。
![[16.0.0.4 and later]](../ng_v16004plus.gif)
- generate
- 通过使用此实用程序创建插件配置文件。
选项
下列选项可用于 pluginUtility 命令:![[16.0.0.4 and later]](../ng_v16004plus.gif)
--server=serverid(对于本地服务器)或 --server=user:password@host:port(对于远程服务器)
仅适用于生成操作,使用 pluginUtility 命令对生成操作编码时需要此选项。
- 对于本地服务器,server 选项为服务器名称。
- 对于远程服务器,server 选项为 user:password@host:port
- 服务器必须正在运行,不管是本地服务器还是远程服务器都是如此。
- user
- 目标服务器的管理员。如果未提供值,那么实用程序会提示需提供。请勿将冒号 (:) 用作 user 的一部分。
- password
- 目标服务器的管理员用户的密码。如果未提供值,那么实用程序会提示您两次。所输入的密码必须匹配。
要点: 在此选项上指定用户和密码,以便在命令行上指定这些值时,值可以生效。目标服务器根据您在命令行上指定的值检查为用户和密码指定的值。提示: 对于远程请求,可以在目标服务器的 server.xml 文件中对用户标识和密码进行编码。示例:<quickStartSecurity userName="AdminUser" userPassword="AdminPassword" />
- 主机
- 目标服务器的主机。请勿在主机值中使用 @ 符号。缺少主机值会导致失败。
- port
- 目标服务器的端口号。缺少端口值会导致失败。
注意: 指定的服务器为远程服务器时,会要求用户接受 SSL 证书以完成请求。要自动接受 SSL 证书,请将 com.ibm.webserver.plugin.utility.autoAcceptCertificates 的 JVM 属性设置为 true。
![[16.0.0.4 and later]](../ng_v16004plus.gif)
- --cluster=cluster_name
- 仅适用于生成操作,使用此实用程序为集群服务器生成插件配置文件时需要此选项。指定服务器集群的名称。
指定 --cluster 选项时,必须针对 --server 选项指定集合体控制器。
要将集群中服务器包含在插件配置文件中,此服务器必须正在运行并加入集合体控制器。
- --sourcePath=directory|comma-separated list
- 仅适用于合并操作的所需选项。指定包含所有插件配置文件的源目录的位置。或者,如果确定要合并的插件文件,请指定具有完整文件路径的源插件文件名的逗号分隔列表。
- --targetPath=directory|full path name
适用于合并操作和生成操作的可选选项。
对于生成操作,缺省情况下,会在当前目录中生成插件配置文件,对于集群请求,此文件名为 cluster_name-plugin-cfg.xml,而对于非集群请求,此文件名为 plugin-cfg.xml。您可以指定必须将文件放置到的目录的名称,或指定标准文件名。此目录必须存在。 新文件替换现有文件。
对于合并操作,缺省情况下,合并后的插件配置文件将在当前目录中生成,且名为 merged-plugin-cfg.xml。您可以为 merged-plugin-cfg.xml 文件指定目标目录名称,或指定标准文件名。此目录必须存在。 如果名为 merged-plugin-cfg.xml 的文件或者指定的文件名已存在,那么将覆盖该文件的内容。
用法
以下示例说明了正确的语法:
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 and later]](../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
注: 对于 pluginUtility generate --server=userName:@testHost:9443 命令,会提示用户提供密码。
提示: 如果选项值有空格,那么必须将文件路径括在双引号 (") 中。例如,如果 --sourcePath 选项的文件路径为 C:\Program Files\myFiles\plugin-cfg.xml,请在命令中指定 --sourcePath="C:/Program Files/myFiles/plugin-cfg.xml"。