configUtility 命令

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

有关访问和使用 Liberty Repository的信息，请参阅 Liberty Repository。

语法

命令语法如下所示：

configUtility action | configUtility configSnippet [options]

其中 action 可以采用下列其中一个值：

find: 显示存储库中的所有配置片段的列表。
指定字符串以将列表过滤为描述中具有指定字符串的配置片段。请将包含空格的字符串括在双引号中。
帮助: 显示有关所指定操作的帮助信息。
install: 从存储库中下载配置片段，或使用本地配置片段来替换变量。

configSnippet 变量是配置片段的名称。运行 configUtility find 命令以获取存储库中配置片段的名称。

选项

下列选项可用于 configUtility install configSnippet 命令：

--info: 列示配置片段中的所有变量选项。如果配置片段没有用于替换的变量，那么此命令会返回空列表。
--v[变量]=值: 将 --info 选项发现的配置片段变量替换为您的输入值。此实用程序使用 --v[variable] 标识这些变量。不要在命令中使用方括号 ([])。
- -createConfigFile=路径: 可选。此实用程序将代码片段写至 path 指定的文件而不是控制台屏幕。将所提供代码片段添加至 server.xml 配置以包含所指定文件。
--encoding=[xor|aes]: 可选。指定密钥库密码编码。受支持的编码为 xor 和 aes。缺省编码是 xor。
--key = 键: 可选。指定使用 AES 进行编码时要使用的密钥。系统对此字符串执行散列算法，以产生用来对密码进行加密和解密的加密密钥。（可选）通过定义其值为密钥的变量 wlp.password.encryption.key 来对服务器提供密钥。如果未提供此选项，那么将使用缺省密钥。
-- aes配置文件=aesConfigFile: 一个XML或Java属性文件，其中包含名为 wlp.password.encryption.key 或的 wlp.aes.encryption.key 变量，并分别赋予有效值。这两个变量不能在同一个文件中同时指定。如果 --aesConfigFile 指定了， --base64Key 则和 --key 不能被指定。
-- base64密钥=base64密钥: 一个用于加密 base64 和解密密码的编码 AES-256 位密钥。该密钥必须通过定义变量来提供给 wlp.aes.encryption.key服务器。如果 --base64Key 指定了， --aesConfigFile 则和 --key 不能被指定。
- -useLocalFile=文件: 使用本地文件系统中的配置片段。必须指定文件路径。此选项替换指定配置片段名称的操作。

重要提示：从 25.0.0.12 开始，`

configUtility
install

command`命令支持 Base64-encoded 和 AES-256 密码加密。虽然该命令此前通过密码短语（使用 --key 选项）支持AES加密，但现在明确支持使用预生成的 Base64-encoded 密钥。当您指定 --encoding=aes时，可通过使用该键 --base64Key ，或使用 --aesConfigFile 引用定义的配置文件来 wlp.aes.encryption.key提供此键。

使用情况

以下示例说明正确的语法：

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 --base64Key=base64_key --vvariable=value
configUtility install configSnippet --encoding=aes --aesConfigFile=C:/wlp/usr/servers/server1/myAesKey.xml --vvariable=value
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 环境中，默认情况下，若输入字符串中包含感叹号 (!)，则必须使用脱字符 (^) 进行转义。以下示例的值为 a!。编码。

D:\Liberty\images\855\Liberty855\wlp\bin>securityUtility encode "a^!"

对于某些操作系统，可能需要对传递到该工具的自变量使用单引号。

如果使用终端仿真器，请确保会话配置为使用与服务器相同的代码页。

如果您遇到意外结果，请参阅操作系统，命令 shell 和终端仿真器文档以了解特殊字符和代码页。