[16.0.0.3 以及更新版本]

pluginUtility 指令

如果 Liberty 伺服器會自動產生外掛程式配置檔,您可以使用 pluginUtility 指令,來收集外掛程式配置檔,並加以合併。此外,您可以使用 pluginUtility 指令,來手動產生外掛程式配置檔。

語法

指令語法如下:

pluginUtility action [options]
action 動作可以採用下列其中一值:
help
顯示指定動作的說明資訊。

您可以顯示 pluginUtility 指令的說明,或顯示特定動作(例如:merge 動作)的說明。

merge
將多個 Web 伺服器外掛程式配置檔合併成單一檔案。
[16.0.0.4 以及更新版本]
generate
利用這個公用程式來建立外掛程式配置。

選項

pluginUtility merge 指令的可用選項如下:
[16.0.0.4 以及更新版本]--server=serverid(若為本端伺服器)或 --server=user:password@host:port(若為遠端伺服器)
[16.0.0.4 以及更新版本]只適用於 generate 動作,當您在 pluginUtility 指令上撰寫 generate 動作的程式碼時,需要指定此項。
  • 若為本端伺服器,server 選項是伺服器名稱。
  • 若為遠端伺服器,server 選項是 user:password@host:port
  • 無論是本端伺服器或遠端伺服器,伺服器必須正在執行。
    user
    目標伺服器的管理者。公用程式會提示您提供一值(如果尚未提供的話)。請勿在 user 內使用冒號 (:)。
    password
    目標伺服器之管理者使用者的密碼。公用程式會提示您提供一值兩次(如果尚未提供的話)。密碼項目必須相符。
    重要: 您是在這個選項上指定 user 和 password,因此當您在指令行上指定這些值時,這些值就會起作用。目標伺服器會對照您在指令行上指定的值,來檢查您指定的 user 和 password 值。
    提示: 若為遠端要求,您可以在目標伺服器的 server.xml 檔中,撰寫使用者 ID 與密碼的程式碼。
    範例:
    <quickStartSecurity
    userName="AdminUser"
    userPassword="AdminPassword" />
    host
    目標伺服器的主機。請勿在 host 值中使用 @ 符號。如果遺漏 host 值,會導致失敗。
    port
    目標伺服器的埠號。如果遺漏 port 值,會導致失敗。
    小心: 當指定的伺服器是遠端伺服器時,會要求使用者接受 SSL 憑證,才會完成要求。如果要自動接受 SSL 憑證,請將 JVM 內容 com.ibm.webserver.plugin.utility.autoAcceptCertificates 設為 true
[16.0.0.4 以及更新版本]
--cluster=cluster_name
只適用於 generate 動作,當您使用這個公用程式,來產生叢集伺服器的外掛程式配置檔時,需要指定此項。請指定伺服器叢集的名稱。

當您指定 --cluster 選項時,必須在 --server 選項上指定群體控制器。

為了將叢集中的伺服器包含在外掛程式配置檔中,該伺服器必須正在執行,並且已加入群體控制器中。

--sourcePath=directory|comma-separated list
只適用於 merge 動作的必要選項。請指定含有所有外掛程式配置檔的來源目錄位置。或者,如果要識別要合併的外掛程式檔案,請指定一份來源外掛程式檔名清單(以逗點區隔),含有完整檔案路徑。
--targetPath=directory|full path name
[16.0.0.4 以及更新版本]適用於 merge 動作和 generate 動作的選用選項。

在 generate 動作方面,依預設,會在現行目錄中產生外掛程式配置檔,並命名為 cluster_name-plugin-cfg.xml(若為叢集要求)和 plugin-cfg.xml(若為非叢集要求)。您可以指定檔案必須位在其中的目錄名稱,或指定完整的檔名。該目錄必須存在。新檔案會取代現有的檔案。

在 merge 動作方面,依預設,會在現行目錄中產生合併後的外掛程式配置檔,並命名為 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 以及更新版本]
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"

指示主題類型的圖示 參照主題

檔名:rwlp_pluginutility_cmd.html