Liberty:configUtility 指令
configUtility 指令可讓您從 IBM WebSphere Liberty Repository 下載配置 Snippet。這個指令也可讓您以您的輸入值取代配置 Snippet 變數。Liberty 儲存庫的配置 Snippet 是特定作業的 Liberty 伺服器配置範例。
如需存取和使用 Liberty 儲存庫的相關資訊,請參閱 Liberty:Liberty Repository。
語法
指令語法如下:
configUtility action | configUtility configSnippet [options]
其中 action 可以是下列值之一:
- find
- 顯示儲存庫中的所有配置 Snippet 清單。
指定字串,來過濾在說明中具有指定字串的配置 Snippet 清單。請用雙引號來括住含有空格的字串。
- help
- 顯示指定動作的說明資訊。
- install
- 從儲存庫下載配置 Snippet,或是使用本端配置 Snippet 來替代變數。
configSnippet 變數是配置 Snippet 的名稱。執行 configUtility find 指令時,會取得儲存庫中的配置 Snippet 名稱。
選項
configUtility install configSnippet 指令的可用選項如下:
- --info
- 列出配置 Snippet 中的所有變數選項。如果配置 Snippet 沒有變數可替代,會傳回空清單。
- --v[variable]=value
- 以您的輸入值,取代 --info 選項找到的配置 Snippet 變數。公用程式會使用 --v[variable] 來識別這些變數。請勿在指令中使用方括弧 ([])。
- --createConfigFile=path
- 選用。公用程式會將程式碼 Snippet 寫入至 path 指定的檔案,而不是寫入至主控台畫面。請將提供的程式碼 Snippet 新增至 server.xml 配置,以包含指定的檔案。
- --encoding=[xor|aes]
- 選用。指定金鑰儲存庫密碼編碼。支援的編碼是 xor 和 aes。預設編碼為 xor。
- --key=key
- 選用。指定使用 AES 編碼時要使用的金鑰。這個字串進行雜湊,會產生用來將密碼加密和解密的加密金鑰。您可以選擇性地將 wlp.password.encryption.key 變數值定義為該金鑰,以提供金鑰給伺服器。如果沒有提供這個選項,會使用預設金鑰。
- --useLocalFile=file
- 使用本端檔案系統中的配置 Snippet。必須指定檔案路徑。這個選項會取代指定配置 Snippet 名稱。
用法
下列範例示範正確的語法:
configUtility find
configUtility find filter_string
configUtility find "filter string"
configUtility help
configUtility install configSnippet
configUtility install configSnippet --info
configUtility install configSnippet --vvariable=value
configUtility install configSnippet --createConfigFile=C:/wlp/usr/servers/server1/snippet-include.xml
configUtility install configSnippet --encoding=aes --key=myAESkey
configUtility install --useLocalFile=C:/wlp_temp/mySnippet.xml
提示: 如果您的選項值有空格,必須為它括上雙引號 (")。舉例來說,如果 --createConfigFile 選項的檔案路徑是 C:\Program
Files\mySnipets\snippet-include.xml,請在指令中指定 --createConfigFile="C:/Program
Files/mySnipets/snippet-include.xml"。
注意:
不同的作業系統可能以不同方式來看待某些字元。若為 Windows 環境,如果您的輸入字串中有 !,必須使用 ^ 字元讓它跳出。例如,
D:\Liberty\images\855\Liberty855\wlp\bin>configUtility createConfigFile="a^!"