GenPluginCfg 指令
GenPluginCfg 指令用來重新產生 WebSphere® Web 伺服器外掛程式配置檔 plugin-cfg.xml。
如需這個指令執行位置的相關資訊,請參閱使用指令工具一文。
注意:
重新產生外掛程式配置,可改寫您想要保留的手動配置變更。執行這項作業之前,請依照實作 Web 伺服器外掛程式中的說明,瞭解其含意。

註: 由於 GenPluginCfg 指令是在其本身的 Java™ 虛擬機器 (JVM) 內執行,而非 WebSphere Application Server JVM,指令可能無法存取其他的類別檔。如果您在執行 GenPluginCfg 指令時遇到這個問題,您可以改為執行 httpPluginManagement.py Script 來產生以應用程式為中心的外掛程式配置。此 Script 使用 wsadmin 來起始產生外掛程式。如需相關資訊,請參閱httpPluginManagement.py Script。
語法
如果要重新產生外掛程式配置,請使用下列方法:
在多重設定檔安裝架構中,您可以使用 -profileName
選項來定義應用程式伺服器程序的設定檔。如果是在單一設定檔環境中執行,則不需要 -profileName 選項。這個選項的預設值是預設設定檔。
在發出 GenPluginCfg 指令時,如果使用 -webserver.name webservrName 選項,wsadmin 會產生 Web 伺服器的外掛程式配置檔。產生的配置檔中的設定是以 Web 伺服器中所部署的應用程式清單為基礎。如果您在發出這個指令時,沒有使用 -webserver.name webservrName 選項,將會根據拓蹼來產生外掛程式配置檔。
參數
GenPluginCfg 指令的可用選項如下:
- -config.root configroot_dir
- 預設值為 CONFIG_ROOT。會呼叫 setupCmdLine 指令,來取得這個環境變數。
-profileName
定義多設定檔安裝架構中之應用程式伺服器程序的設定檔。如果是在單一設定檔環境中執行,則不需要 -profileName 選項。這個選項的預設值是預設設定檔。
- -cell.name cell
- 預設值為 WAS_NODE。會呼叫 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
- 當發出指令以產生 Cell 層面的檔案時,會建立新配置,而不嘗試與現有配置合併。
- -debug yes/no
- 預設值為 no。
- -help
- 列印用法說明。
- -?
- 列印用法說明。
使用實務
針對 Cell 中的所有叢集,產生一項外掛程式配置:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
GenPluginCfg -cell.name NetworkDeploymentCell
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
GenPluginCfg.sh -cell.name NetworkDeploymentCell
針對單一伺服器,產生外掛程式配置:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
GenPluginCfg -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
GenPluginCfg.sh -cell.name BaseApplicationServerCell -node.name appServerNode -server.name appServerName
針對 Web 伺服器,產生外掛程式配置檔:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
GenPluginCfg -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName
![[IBM i]](../images/iseries.gif)
![[z/OS]](../images/ngzos.gif)
GenPluginCfg.sh -cell.name BaseApplicationServerCell -node.name webserverNode -webserver.name webserverName