[8.5.5.6 或更高版本]

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

返回码

表 1. 返回码和说明
返回码 说明
0 此命令成功完成请求的操作。
20 一个或多个自变量无效。
21 由于下列一种或多种情况而发生了运行时异常:
  • 安装 .esa 子系统归档文件时发生了运行时异常。
  • 许可证未接受或未被认可。
  • .esa 子系统归档文件未正确解压。
22 要安装的功能部件已存在。
23 由于以下一个或多个原因,功能部件定义无效:
  • 功能部件不具有有效清单文件。
  • 在此 Liberty 环境中,不支持功能部件的该版本。
  • 包含功能部件文件的 .zip 或 .jar 文件不存在。
24 .esa 子系统归档文件缺少内容。
25 要安装的文件已存在。
26 该产品不是核心产品,且找不到产品扩展文件。
27 该产品不是核心产品,且未在 ${wlp.install.dir}/etc/extensions/extension_name.properties 文件中定义产品扩展。
28 找不到产品扩展中功能部件的清单文件。
29 针对当前产品,此功能部件无效。
33 与存储库的连接失败。
34 未找到该存储库名称。所提供存储库名称在配置文件中不存在。
35 用户已取消此操作。

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

信息中心的条款和条件 | 反馈


时间戳记图标 最近一次更新时间: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=rwlp_command_installutility
文件名:rwlp_command_installutility.html