![[8.5.5.6 或更高版本]](../ng_v8556.gif)
installUtility 命令
使用 installUtility 命令以查找本地存储库、远程存储库或 IBM® WebSphere® Liberty Repository 中的资产、获取相关信息及安装这些资产。
语法
命令语法如下所示:
installUtility action [options]
action 可以采用下列其中一个值:
- download
- 从存储库下载资产。
- find
- 在适用于您的配置的存储库中查找资产或查看有关资产的详细信息。
- help
- 显示有关所指定操作的帮助信息。
- install
- 将资产或企业子系统归档 (ESA) 文件安装至运行时,或部署服务器软件包并安装该软件包的必需功能部件。
- testConnection
- 测试存储库连接。
- uninstall
- 通过指定功能部件短名称或功能部件符号名称来卸载功能部件。可指定多个功能部件,多项之间以空格分隔。
- 注: 卸载功能部件前,确保所有服务器进程已停止。
- viewSettings
- 查看 installUtility 命令的存储库和代理设置。
使用这些操作时,installUtility 命令可访问以下存储库中的资产:
- IBM WebSphere Liberty Repository,它是可通过互联网访问的 IMB 托管的公共存储库。有关更多信息,请参阅 Liberty Repository。
- Liberty Asset Repository Service,它是一个开放式源代码服务,您可使用它创建可在企业防火墙后远程访问的预置存储库;请参阅 GitHub 上的 WASdev/tool.lars 存储库。
- 基于本地目录的存储库,这些存储库是使用 installUtility download 操作创建的。有关更多信息,请参阅使用 installUtility 命令下载资产。
选项
以下选项对 installUtility install 命令可用:
- --acceptLicense
- 指示是否接受许可条款和条件。
- --to=install_option
- install_option 选项可采用下列其中一个值:
- user:此功能部件作为用户功能部件安装。此值是缺省值。
- extension:要安装功能部件的位置。可以将该功能部件安装到所配置的任何产品扩展位置。
- --viewLicenseAgreement
- 查看许可协议。
- --viewLicenseInfo
- 查看许可证信息。
- --verbose
- 使用此选项以在操作运行时显示所有可用附加信息。
- name
- 指定您要安装的资产。可采用下列方式指定资产:
- 资产标识
- 可指定资产标识来安装下列其中一个或多个资产:
- 功能部件
- 附加组件
- 开放式源代码集成
- 样本
- 服务器名称
- 可使用服务器名称对现有服务器安装任何缺失功能部件。server.xml 文件中定义的必需功能部件是从存储库安装的。
- 服务器软件包
- 可使用 server package --include=usr 命令指定您创建的服务器软件包。服务器软件包部署及 server.xml 文件中定义的必需功能部件是从存储库安装的。
- .esa 文件
- 通过本地文件系统上的 .esa 文件安装功能部件。此操作使用 .esa 文件中的 OSGI-INF/SUBSYTEM.MF 清单文件作为新的功能部件清单。此清单文件指定功能部件的名称、内容和依赖项。如果指定 --to 选项,那么 installUtility 会将清单文件复制到 ${wlp.user.dir}/extensions/lib/features 目录或产品扩展目录。子系统的所有捆绑软件将解压至 ${wlp.user.dir}/extensions/lib 目录并重命名为 {bundle symbolic name}_{bundle version}.jar。许可证文件、校验和文件、本地化文件及其他子系统内容将解压至子系统清单中定义的位置。
以下选项对 installUtility
find 命令可用:
- --showDescriptions
- 显示通过搜索找到的每个功能部件的描述。
- --type=[feature|sample|opensource|addon|all*]
- 搜索指定类型的资产。
- --name
- 搜索资产名称以查找指定 searchString。
- searchString
- 查找适用于您的配置的资产。如果未指定搜索字符串,那么该命令搜索所有适用资产。
以下选项对 installUtility download 命令可用:
- --acceptLicense
- 接受许可协议。
- --viewLicenseAgreement
- 查看许可协议。
- --viewLicenseInfo
- 查看许可协议。
- --location=directoryPath
- 对所下载资产指定目标目录。此选项是必需的。
- --overwrite
- 使用此选项以在下载至本地目录时覆盖现有文件。未指定此选项的缺省行为是忽略全部现有文件。
- --verbose
- 使用此选项以在下载期间显示附加信息。
- name
- 指定资产标识以下载下列其中一个或多个资产:
- 功能部件
- 附加组件
- 开放式源代码集成
- 样本
以下选项对 installUtility
testConnection 命令可用:
- repoName
- 指定要测试的存储库的名称。如果未指定,那么将测试 repositories.properties 文件中指定的所有存储库。
以下选项对 installUtility
uninstall 命令可用:
- --noPrompts
- 卸载功能部件而不提示。缺省值为 false。
- --verbose
- 使用此选项以在卸载期间显示附加信息。
- name
- 指定要卸载的功能部件。可指定以下选项:
- 子系统归档(ESA 文件)的短名称,例如,adminCenter-1.0。
- 子系统归档(ESA 文件)的符号名称,例如,com.ibm.websphere.appserver.adminCenter-1.0。
用法示例
使用以下示例以显示 install 操作的帮助信息:
installUtility help install
使用以下示例来安装用户功能部件:
installUtility install my_feature --to=usr
使用以下示例将用户功能部件安装至
my_extension 产品扩展位置:
installUtility install my_feature --to=my_extension
使用以下示例来安装多个功能部件:
installUtility install feature1 feature2 feature3
使用以下示例来安装样本:
installUtility install mongoDBSample
使用以下示例来安装服务器:
installUtility install myServer
使用以下示例来安装服务器软件包压缩 .jar 文件:
installUtility install c:\temp\myServer.jar
使用以下示例来安装本地 .esa 文件:
installUtility install c:\temp\myFeature.esa
使用以下示例来安装服务器软件包压缩文件:
installUtility install c:\temp\myServer.zip
使用以下示例查找适用于您的配置的资产:
installUtility find searchString
使用以下示例查找适合于您的配置的样本:
installUtility find searchstring --type=sample
使用以下示例查找适用于您的配置的特定功能部件:
installUtility find webCacheMonitor-1.0 --name --type=feature
使用以下示例列示详细信息:
installUtility find searchstring --showDescriptions
使用以下示例将存储库中的必需依赖项下载至本地目录:
installUtility download feature_shortName --location=c:\temp\download --acceptLicense
使用以下示例测试与
Liberty Repository 的连接:
installUtility testConnection default
使用以下示例卸载功能部件:
installUtility uninstall adminCenter-1.0
使用以下示例卸载多个功能部件:
installUtility uninstall feature1 feature2 feature3
使用以下示例卸载多个功能部件而不提示:
installUtility uninstall --noPrompts feature1 feature2 feature3
返回码
返回码 | 说明 |
---|---|
0 | 此命令成功完成请求的操作。 |
20 | 一个或多个自变量无效。 |
21 | 由于下列一种或多种情况而发生了运行时异常:
|
22 | 要安装的功能部件已存在。 |
23 | 由于以下一个或多个原因,功能部件定义无效:
|
24 | .esa 子系统归档文件缺少内容。 |
25 | 要安装的文件已存在。 |
26 | 该产品不是核心产品,且找不到产品扩展文件。 |
27 | 该产品不是核心产品,且未在 ${wlp.install.dir}/etc/extensions/extension_name.properties 文件中定义产品扩展。 |
28 | 找不到产品扩展中功能部件的清单文件。 |
29 | 针对当前产品,此功能部件无效。 |
33 | 与存储库的连接失败。 |
34 | 未找到该存储库名称。所提供存储库名称在配置文件中不存在。 |
35 | 用户已取消此操作。 |