featureManager 命令

可使用 featureManager 命令查找、安装、卸载功能部件或获取相关详细信息。

必须将您想要安装的功能部件打包为子系统归档(ESA 文件)。

[8.5.5.5 或更高版本]可使用 featureManager 命令通过代理服务器访问 Liberty Repository;有关更多信息,请参阅在 Liberty 概要文件中配置代理服务器对 featureManager 命令的支持

[8.5.5.6 或更高版本]要管理更多资产类型并从多个存储库中安装、查找或下载资产,请使用 installUtility 命令而不是 featureManager 命令。有关更多信息,请参阅使用 installUtility 命令安装资产

语法

命令语法如下所示:

featureManager action [options]
其中 action 可以采用下列其中一个值:
[8.5.5.4 或更高版本]classpath
通过功能部件列表生成 JAR 文件,此文件可添加至编译器类路径以使用 API。此操作允许您针对产品中包含的 API JAR 编译构建脚本而不引用特定 JAR 名称,应用修订包时,这些名称可能更改。输出 JAR 包含指向产品中的 API JAR 的相对路径。因此,不得将输出 JAR 移至另一目录。
注: 必须对此操作指定 --features 选项。
install
通过企业子系统归档 (ESA) 文件、ESA 文件的 URL、功能部件短名称或功能部件符号名称来安装功能部件。

如果指定功能部件短名称或符号名称,那么将从 IBM 托管的在线存储库下载该功能部件。

install 操作使用 ESA 文件中的 OSGI-INF/SUBSYSTEM.MF 文件作为新的功能部件清单,该清单可复制到要根据子系统的符号名称重命名的 ${wlp.user.dir}/extensions/lib/features 目录(或产品扩展目录,如果对 --to 属性指定了值)。子系统的所有捆绑软件将抽取到 ${wlp.user.dir}/extensions/lib 目录并重命名为 {bundle symbolic name}_{bundle version}.jar。许可证文件、校验和文件、本地化文件及其他子系统内容也会被抽取到子系统清单中定义的位置。

Liberty Repository[8.5.5.2 或更高版本]featureManager 命令可用于从 Liberty Repository 下载资产;有关更多信息,请参阅安装 Liberty Repository 资产
featureList
生成一个包含报告的 XML 文件,此报告详细说明了已安装的所有功能部件。
Liberty Repository[8.5.5.4 或更高版本]find
在 Liberty Repository 中查找适用于配置的资产。
help
显示有关所指定操作的帮助信息。
[8.5.5.5 或更高版本]uninstall
[8.5.5.5 或更高版本]使用功能部件短名称或功能部件符号名称卸载功能部件。
注:
  • 卸载功能部件前,确保所有服务器进程已停止。
  • uninstall 命令无法卸载用户功能部件;例如:webCacheMonitor-1.0

选项

[8.5.5.4 或更高版本]下列选项可用于 featureManager classpath 命令:
--features=feature1,feature2,...
包含 API JAR 文件列表的功能部件的列表。此选项对于类路径操作是必需的。
下列选项可用于 featureManager install 命令:
--acceptLicense
自动地指示接受许可条款和条件。
Liberty Repository[8.5.5.4 或更高版本]--downloadOnly=[all | required* | none]
将所请求功能部件下载至本地目录而不安装该功能部件。可配置此选项以下载所有从属功能部件、此运行时所需的从属功能部件或不下载任何从属功能部件。缺省操作是下载必需从属功能部件。使用 --location 选项指定目录。
注: 如果使用文件名或 URL 指定子系统归档位置,那么不能使用此选项。
Liberty Repository[8.5.5.4 或更高版本]--location=directoryPath
指定您要安装的子系统归档的位置。与 --downloadOnly 选项配合使用时,此选项指定已下载功能部件的目标目录。使用 --downloadOnly--offlineOnly 选项时,此选项是必需的。
注: 如果使用文件名或 URL 指定子系统归档位置,那么不能使用此选项。
Liberty Repository[8.5.5.4 或更高版本]--offlineOnly
如果不想连接至 Liberty Repository,请使用此选项。此命令改为仅从本地目录安装功能部件。本地目录是使用 --location 选项指定的。
注: 如果使用文件名或 URL 指定子系统归档位置,那么不能使用此选项。
--to=install_option
其中 install_option 可以采用下列其中一个值:
  • usr:功能部件作为用户功能部件来安装。这是缺省值。
  • extension:您想要将该功能部件安装到的位置。可以将该功能部件安装到所配置的任何产品扩展位置。
--viewLicenseAgreement
查看许可协议。
--viewLicenseInfo
查看许可证信息。
--when-file-exists=exist_option
指定在要安装的文件已存在时要执行的操作。exist_option 可以采用下列其中一个值:
  • fail:取消安装。
  • ignore:继续安装并忽略已存在的文件。
  • replace:覆盖现有文件。
subsystem_archive
指定您要安装的子系统归档的位置。可采用下列方式指定位置:
  • 文件名;例如:my_feature.esa
  • URL,例如:
    http://myhost.ibm.com/liberty/assets/my_feature.esa
  • Liberty Repository[8.5.5.2 或更高版本]子系统归档(ESA 文件)的短名称,例如,adminCenter-1.0
  • Liberty Repository[8.5.5.2 或更高版本]子系统归档(ESA 文件)的符号名称,例如,com.ibm.websphere.appserver.adminCenter-1.0

有关更多信息,请参阅 WASdev.net 上的 Downloads 页面

下列选项可用于 featureManager featureList 命令:
--encoding=charset
其中 charset 是创建 XML 报告文件时要使用的字符集。
--locale=language
其中 language 指定在创建 XML 报告文件时要使用的语言。这由 ISO-639 两字母小写语言代码(还可以选择后面跟着下划线)和 ISO-3166 大写两字母国家或地区代码组成。
--productExtension=name
其中,name 是要列出其功能部件的产品扩展名称。如果已在缺省用户位置安装产品扩展,请使用关键字:usr如果未指定此选项,那么将在 WebSphere Application Server Liberty Core 上执行该操作。
XML_report_file_name
指定您想要创建的 XML 报告文件的名称。
下列选项可用于 featureManager find 命令:
Liberty Repository[8.5.5.4 或更高版本]searchString
使用 searchstring 选项从 IBM WebSphere Liberty Repository 中查找适用功能部件
Liberty Repository[8.5.5.4 或更高版本]--viewInfo
查看详细信息。
[8.5.5.5 或更高版本]下列选项可用于 featureManager uninstall 命令:
name
指定要卸载的功能部件。可指定以下选项:
  • 子系统归档(ESA 文件)的短名称,例如,adminCenter-1.0
  • 子系统归档(ESA 文件)的符号名称,例如,com.ibm.websphere.appserver.adminCenter-1.0
--noPrompts
卸载功能部件而不需要任何用户交互或确认消息。

用法示例

以下示例将子系统归档 my_feature.esa 作为用户功能部件进行安装:
featureManager install my_feature.esa --to=usr
以下示例将子系统归档 my_feature.esa 安装到产品扩展位置 my_extension
featureManager install my_feature.esa --to=my_extension
以下示例将为所有已安装功能部件生成报告;已使用巴西葡萄牙语将此报告写入 my_feature_report.xml 文件:
featureManager featureList my_feature_report.xml --locale=pt_BR
以下示例生成一个报告,内含产品扩展中所定义的所有已安装的功能部件,该扩展安装在缺省用户位置 wlp/usr/extension(运行时环境中称之为 usr 产品扩展)。报告将写入文件 my_feature_report.xml
featureManager featureList --productExtension=usr my_feature_report.xml
以下示例生成一个报告,内含产品扩展中定义的所有功能部件,该扩展安装在产品安装 etc/extensions 目录中 productExtensionName.properties 文件的内容所指向的位置。报告将写入文件 my_feature_report.xml
featureManager featureList --productExtension=productExtensionName my_feature_report.xml
以下示例将显示有关安装操作的帮助信息:
featureManager help install
Liberty Repository[8.5.5.4 或更高版本]以下示例从 Liberty Repository 中查找适用资产:
featureManager find searchString
Liberty Repository[8.5.5.4 或更高版本]以下示例列示详细信息:
featureManager find searchString --viewInfo
Liberty Repository[8.5.5.4 或更高版本]以下示例将必需从属项从 Liberty Repository 下载至本地目录而不进行安装:
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense
注: 如果使用 URL 指定子系统归档位置,那么不能使用此选项。
Liberty Repository[8.5.5.4 或更高版本]以下示例将所有从属项从 Liberty Repository 下载至本地目录而不进行安装:
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense
注: 如果使用 URL 指定子系统归档位置,那么不能使用此选项。
Liberty Repository[8.5.5.4 或更高版本]以下示例安装本地目录中的功能部件。如果缺少从属项,那么将从在线存储库进行安装。
featureManager install feature_shortName --location=c:\temp\download --acceptLicense
注: 如果使用 URL 指定子系统归档位置,那么不能使用此选项。
Liberty Repository[8.5.5.4 或更高版本]以下示例从本地目录安装资产而不从 Liberty Repository 下载缺失从属项:
featureManager install feature_shortName --location=c:\temp\download --offlineOnly
注: 如果使用 URL 指定子系统归档位置,那么不能使用此选项。
Liberty Repository[8.5.5.4 或更高版本]以下示例创建类路径 JAR 文件并编译使用它的应用程序类:
featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java
Liberty Repository[8.5.5.5 或更高版本]以下示例卸载功能部件:
featureManager uninstall adminCenter-1.0
[2014 年 5 月更新 ]

返回码

表 1. 返回码和说明
返回码 说明
0 此命令成功完成请求的操作。
20 一个或多个自变量无效。
21 由于下列一种或多种情况而发生了运行时异常:
  • 安装 .esa 子系统归档文件时发生了运行时异常。
  • 许可证未接受或未被认可。
  • .esa 子系统归档文件未正确解压。
22 要安装的功能部件已存在。
23 由于以下一个或多个原因,功能部件定义无效:
  • 功能部件不具有有效清单文件。
  • 在此 Liberty 环境中,不支持功能部件的该版本。
  • 包含功能部件文件的 .zip 或 .jar 文件不存在。
24 .esa 子系统归档文件缺少内容。
25 要安装的文件已存在,且指定了 when-file-exists=fail 选项。
26 该产品不是核心产品,且找不到产品扩展文件。
27 该产品不是核心产品,且未在 ${wlp.install.dir}/etc/extensions/extension_name.properties 文件中定义产品扩展。
28 找不到产品扩展中功能部件的清单文件。
29 针对当前产品,此功能部件无效。
[2014 年 5 月更新 ]

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

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


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