featureManager 命令
可使用 featureManager 命令查找、安装、卸载功能部件或获取相关详细信息。
必须将您想要安装的功能部件打包为子系统归档(ESA 文件)。
可使用 featureManager
命令通过代理服务器访问 Liberty Repository;有关更多信息,请参阅在 Liberty 概要文件中配置代理服务器对 featureManager 命令的支持。
要管理更多资产类型并从多个存储库中安装、查找或下载资产,请使用
installUtility 命令而不是 featureManager 命令。有关更多信息,请参阅使用 installUtility 命令安装资产。
语法
命令语法如下所示:
featureManager action [options]
其中 action 可以采用下列其中一个值:
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。许可证文件、校验和文件、本地化文件及其他子系统内容也会被抽取到子系统清单中定义的位置。
featureManager 命令可用于从 Liberty Repository 下载资产;有关更多信息,请参阅安装 Liberty Repository 资产。
- featureList
- 生成一个包含报告的 XML 文件,此报告详细说明了已安装的所有功能部件。
find
- 在 Liberty Repository 中查找适用于配置的资产。
- help
- 显示有关所指定操作的帮助信息。
uninstall
使用功能部件短名称或功能部件符号名称卸载功能部件。
注:- 卸载功能部件前,确保所有服务器进程已停止。
- uninstall 命令无法卸载用户功能部件;例如:webCacheMonitor-1.0。
选项
![[8.5.5.4 或更高版本]](../ng_v8554.gif)
- --features=feature1,feature2,...
- 包含 API JAR 文件列表的功能部件的列表。此选项对于类路径操作是必需的。
下列选项可用于 featureManager install 命令:
- --acceptLicense
- 自动地指示接受许可条款和条件。
--downloadOnly=[all | required* | none]
- 将所请求功能部件下载至本地目录而不安装该功能部件。可配置此选项以下载所有从属功能部件、此运行时所需的从属功能部件或不下载任何从属功能部件。缺省操作是下载必需从属功能部件。使用 --location
选项指定目录。注: 如果使用文件名或 URL 指定子系统归档位置,那么不能使用此选项。
--location=directoryPath
- 指定您要安装的子系统归档的位置。与 --downloadOnly 选项配合使用时,此选项指定已下载功能部件的目标目录。使用
--downloadOnly 和 --offlineOnly 选项时,此选项是必需的。注: 如果使用文件名或 URL 指定子系统归档位置,那么不能使用此选项。
--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
子系统归档(ESA 文件)的短名称,例如,adminCenter-1.0
子系统归档(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 命令:
searchString
- 使用 searchstring 选项从 IBM WebSphere Liberty Repository 中查找适用功能部件
--viewInfo
- 查看详细信息。
![[8.5.5.5 或更高版本]](../ng_v8555.gif)
- 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

![[8.5.5.4 或更高版本]](../ng_v8554.gif)
featureManager find searchString

![[8.5.5.4 或更高版本]](../ng_v8554.gif)
featureManager find searchString --viewInfo

![[8.5.5.4 或更高版本]](../ng_v8554.gif)
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense
注: 如果使用 URL 指定子系统归档位置,那么不能使用此选项。

![[8.5.5.4 或更高版本]](../ng_v8554.gif)
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense
注: 如果使用 URL 指定子系统归档位置,那么不能使用此选项。

![[8.5.5.4 或更高版本]](../ng_v8554.gif)
featureManager install feature_shortName --location=c:\temp\download --acceptLicense
注: 如果使用 URL 指定子系统归档位置,那么不能使用此选项。

![[8.5.5.4 或更高版本]](../ng_v8554.gif)
featureManager install feature_shortName --location=c:\temp\download --offlineOnly
注: 如果使用 URL 指定子系统归档位置,那么不能使用此选项。

![[8.5.5.4 或更高版本]](../ng_v8554.gif)
featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java

![[8.5.5.5 或更高版本]](../ng_v8555.gif)
featureManager uninstall adminCenter-1.0
![[2014 年 5 月更新 ]](../delta.gif)
返回码
返回码 | 说明 |
---|---|
0 | 此命令成功完成请求的操作。 |
20 | 一个或多个自变量无效。 |
21 | 由于下列一种或多种情况而发生了运行时异常:
|
22 | 要安装的功能部件已存在。 |
23 | 由于以下一个或多个原因,功能部件定义无效:
|
24 | .esa 子系统归档文件缺少内容。 |
25 | 要安装的文件已存在,且指定了 when-file-exists=fail 选项。 |
26 | 该产品不是核心产品,且找不到产品扩展文件。 |
27 | 该产品不是核心产品,且未在 ${wlp.install.dir}/etc/extensions/extension_name.properties 文件中定义产品扩展。 |
28 | 找不到产品扩展中功能部件的清单文件。 |
29 | 针对当前产品,此功能部件无效。 |
![[2014 年 5 月更新 ]](../deltaend.gif)