GenPluginCfg 命令

GenPluginCfg 命令用于重新生成 WebSphere® Web 服务器插件配置文件 plugin-cfg.xml。

有关在何处运行此命令的更多信息,请参阅使用命令工具一文。

警告:
重新生成插件配置可覆盖您可能要保留的手动配置更改。执行此任务之前,了解实现 Web 服务器插件中描述的该任务的限制。
避免故障 避免故障: 不推荐使用以拓扑为中心或全局插件配置。而是按实现 Web 服务器插件中所述使用以应用程序为中心的配置。针对任何以拓扑为中心的现有配置,可以使用管理控制台或运行 GenPluginCfg 命令,更新单元中所有集群的全局 plugin-cfg.xml 文件。 然而,在更新全局 plugin-cfg.xml 文件之前,必须删除 config/cells/plugin-cfg.xml 文件。如果未删除 config/cells/plugin-cfg.xml 文件,那么只会将新属性及其值添加到全局 plugin-cfg.xml 文件。不会将对现有插件属性值的任何更新添加到全局 plugin-cfg.xml 文件。gotcha
注: 因为 GenPluginCfg 命令在其自己的 Java™ 虚拟机 (JVM) 而不是 WebSphere Application Server JVM 中运行,所以此命令可能无法访问其他类文件。如果在运行 GenPluginCfg 命令时遇到此问题,那么可改为运行 httpPluginManagement.py 脚本以生成以应用程序为中心的插件配置。此脚本使用 wsadmin 启动插件生成。有关更多信息,请参阅httpPluginManagement.py 脚本

语法

要重新生成插件配置,请使用下列方法:
  • [AIX Solaris HP-UX Linux Windows]在管理控制台中,单击服务器 > 服务器类型 > Web 服务器,选择 Web 服务器,然后单击生成插件
  • 发出以下命令:
    [AIX Solaris HP-UX Linux Windows]
    app_server_root/bin/GenPluginCfg.sh|bat
    重新生成插件配置的两个方法都以 ASCII 格式创建 plugin-cfg.xml 文件,ASCII 格式是分布式环境中的正确执行格式。
    [IBM i]
    app_server_root/bin/GenPluginCfg
    这种重新生成插件配置的方法会以 ASCII 格式创建 plugin-cfg.xml 文件,ASCII 格式是 IBM i 环境中的正确执行格式。
    [z/OS]
    app_server_root/bin/GenPluginCfg.sh
    这种重新生成插件配置的方法会以 UTF-8 格式创建 plugin-cfg.xml 文件,UTF-8 格式是 z/OS® 环境中的正确执行格式。

[AIX Solaris HP-UX Linux Windows][IBM i]可以使用 -profileName 选项在多概要文件安装中定义应用程序服务器进程的概要文件。在单概要文件环境中运行不需要 -profileName 选项。此选项的缺省值为缺省概要文件。

发出带有选项 -webserver.name webservrNameGenPluginCfg 命令时,wsadmin 将为 Web 服务器生成插件配置文件。生成的配置文件中的设置基于部署在 Web 服务器上的应用程序的列表。当在不用 -webserver.name webservrName 选项的情况下发出此命令时,根据拓扑生成插件配置文件。

参数

下列选项可用于 GenPluginCfg 命令:

-config.root configroot_dir
缺省值为 CONFIG_ROOT。调用 setupCmdLine 命令以获取此环境变量。
[AIX Solaris HP-UX Linux Windows][IBM i]-profileName
[AIX Solaris HP-UX Linux Windows][IBM i]在多概要文件安装中定义应用程序服务器进程的概要文件。在单概要文件环境中运行不需要 -profileName 选项。此选项的缺省值为缺省概要文件。
-cell.name 单元
缺省值为 WAS_CELL。调用 setupCmdLine 命令以获取此环境变量。
-node.name node
缺省值为 WAS_NODE。调用 setupCmdLine 命令以获取此环境变量。
-webserver.name webserver1
为给定 Web 服务器创建插件配置文件时,此参数是必需的。
-propagate yes/no
仅当指定了 webserver.name 选项并且 Web 服务器在本地或在远程非受管节点上时,此选项才适用。否则,必须手动将 plugin-cfg.xml 文件从 app_server_root/profiles/profile_name/config/cells/cell_name/nodes/node_name/servers/web_server_name 复制到远程 Web 服务器插件目录中的 plugins_root/config/web_server_name。缺省值为 no。
-propagateKeyring yes/no
仅当指定了选项 webserver.name 且 Web 服务器在本地时,此选项才适用。缺省值为 no。
-cluster.name cluster1,cluster2 | ALL
可选的集群列表。当指定了 webserver.name 选项时,此选项被忽略。
-server.name server1,server2
可选的服务器列表。单个服务器插件生成需要此列表。当指定了 webserver.name 选项时,此选项被忽略。
-output.file.name file_name
缺省为 configroot_dir/plugin-cfg.xml 文件。当指定了 webserver.name 选项时,此选项被忽略。
-destination.root root
在其上使用配置的机器的安装根目录。当指定了 webserver.name 选项时,此选项被忽略。
-destination.operating.system windows/unix
在其上使用机器配置的操作系统。当指定了 webserver.name 选项时,此选项被忽略。
-force yes
发出该命令以进行单元范围的文件生成时,创建新配置而不是尝试与现有配置进行合并。
-debug yes/no
缺省值为 no。
-help
显示用法说明。
-?
显示用法说明。

使用方案

要为单元中的所有集群生成插件配置:

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

要为单个服务器生成插件配置:

[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

要为 Web 服务器生成插件配置文件,请执行以下命令:

[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

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_genplugincfg1
文件名:rxml_genplugincfg1.html