![[8.5.5.5 或更高版本]](../ng_v8555.gif)
configUtility 命令
configUtility 命令允许您从 IBM WebSphere Liberty Repository 下载配置片段。此命令还允许您将配置片段变量替换为您的输入值。Liberty Repository 配置片段是用于特定任务的 Liberty 服务器配置样本。
有关访问和使用 Liberty Repository 的信息,请参阅Liberty Repository。
语法
命令语法如下所示:
configUtility action | configUtility configSnippet [options]
其中 action 可以采用下列其中一个值:
- find
- 显示存储库中的所有配置片段的列表。
指定字符串以将列表过滤为与指定字符串相关的配置片段。请将包含空格的字符串括在双引号中。
- help
- 显示有关所指定操作的帮助信息。
- install
- 从存储库中下载配置片段,或使用本地配置片段来替换变量。
configSnippet 变量是配置片段的名称。运行 configUtility find 命令以获取存储库中配置片段的名称。
选项
下列选项可用于 configUtility install configSnippet 命令:
- --info
- 列示配置片段中的所有变量选项。如果配置片段没有用于替换的变量,那么此命令会返回空列表。
- --v[variable]=value
- 将 --info 选项发现的配置片段变量替换为您的输入值。此实用程序使用 --v[variable] 标识这些变量。不要在命令中使用方括号 ([])。
- --createConfigFile=path
- 可选。此实用程序将代码片段写至 path 指定的文件而不是控制台屏幕。将所提供代码片段添加至 server.xml 配置以包含所指定文件。
- --encoding=[xor|aes]
- 可选。指定密钥库密码编码。受支持的编码为 xor 和 aes。缺省编码是 xor。
- --key=key
- 可选。指定使用 AES 进行编码时要使用的密钥。系统对此字符串执行散列算法,以产生用来对密码进行加密和解密的加密密钥。(可选)通过定义其值为密钥的变量 wlp.password.encryption.key 来对服务器提供密钥。如果未提供此选项,那么将使用缺省密钥。
- --useLocalFile=file
- 使用本地文件系统中的配置片段。必须指定文件路径。此选项替换指定配置片段名称的操作。
用法
以下示例说明了正确的语法:
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^!"