configUtility 命令

configUtility 命令允许您从 Liberty 存储库 下载配置片段。此命令还允许您将配置片段变量替换为您的输入值。Liberty 存储库 配置片段是用于特定任务的 Liberty 服务器配置样本。

有关访问和使用 Liberty 存储库 的信息,请参阅 Liberty 存储库

语法

命令语法如下所示:

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]
可选。指定密钥库密码编码。受支持的编码为 xoraes。缺省编码是 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^!" 

用于指示主题类型的图标 参考主题

文件名:rwlp_command_configutil.html