GenPluginCfg 指令

GenPluginCfg 指令用來重新產生 WebSphere® Web 伺服器外掛程式配置檔 plugin-cfg.xml。

如需這個指令執行位置的相關資訊,請參閱使用指令工具一文。

注意:
重新產生外掛程式配置,可改寫您想要保留的手動配置變更。執行這項作業之前,請依照實作 Web 伺服器外掛程式中的說明,瞭解其含意。
避免困難 避免困難: 以拓蹼為中心(或廣域)的外掛程式配置已淘汰。請依照實作 Web 伺服器外掛程式中的說明,改用以應用程式為中心的配置。對於任何現有以拓蹼為中心的配置,您可以使用管理主控台,或針對 Cell 中的所有叢集,執行 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 Script 來產生以應用程式為中心的外掛程式配置。此 Script 使用 wsadmin 來起始產生外掛程式。如需相關資訊,請參閱httpPluginManagement.py Script

語法

如果要重新產生外掛程式配置,請使用下列方法:
  • [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 檔,這是適合在分散式環境中執行的格式。
    [IBM i]
    app_server_root/bin/GenPluginCfg
    這種用來重新產生外掛程式配置的方法,會建立 ASCII 格式的 plugin-cfg.xml 檔,這是適合在 IBM i 環境中執行的格式。
    [z/OS]
    app_server_root/bin/GenPluginCfg.sh
    這種用來重新產生外掛程式配置的方法,會建立 AUTF-8 格式的 plugin-cfg.xml 檔,這是適合在 z/OS® 環境中執行的格式。

[AIX Solaris HP-UX Linux Windows][IBM i]在多重設定檔安裝架構中,您可以使用 -profileName 選項來定義應用程式伺服器程序的設定檔。如果是在單一設定檔環境中執行,則不需要 -profileName 選項。這個選項的預設值是預設設定檔。

在發出 GenPluginCfg 指令時,如果使用 -webserver.name webservrName 選項,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 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]
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