featureManager 命令

可使用 featureManager 命令来安装功能部件以及获取有关已安装的所有功能部件的详细信息。

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

可通过代理服务器使用 featureManager 命令来访问 Liberty 存储库有关更多信息,请参阅 在 Liberty 中配置代理服务器对 featureManager 命令的支持

要点: 除了在您安装 .esa 文件时之外,featureManager findinstalluninstall 操作已稳定。

使用 installUtility 命令而不是 featureManager 命令。通过 installUtility 命令,可管理更多资产类型及从多个存储库安装、查找或下载资产。有关更多信息,请参阅使用 installUtility 命令安装资产

语法

命令语法如下所示:

featureManager action [options]
其中 action 可以采用下列其中一个值:
install
稳定的功能: 此操作已稳定。除非您安装 .esa 文件,否则使用 installUtility install 命令。使用 featureManager 命令来安装 .esa 文件。
将功能部件或企业子系统归档 (ESA) 文件安装到运行时环境。
featureManager 命令可以从 Liberty 存储库 下载资产。有关更多信息,请参阅安装 Liberty 存储库 资产
uninstall
稳定的功能: 此操作已稳定。请改为使用 installUtility uninstall 命令。
使用功能部件短名称或功能部件符号名称卸载功能部件。
注:
  • 卸载功能部件前,确保所有服务器进程已停止。
  • uninstall 操作无法卸载用户功能部件;例如:webCacheMonitor-1.0
featureList
生成一个包含报告的 XML 文件,此报告详细说明了已安装的所有功能部件。
find
稳定的功能: 此操作已稳定。请改为使用 installUtility find 命令。
生成 Liberty 存储库 中所有资产的列表,在 Liberty 存储库 中查找适用于您的配置的资产,或查看详细信息。
classpath
通过功能部件列表生成 JAR 文件,此文件可添加至编译器类路径以使用 API。此操作允许您针对产品中包含的 API JAR 编译构建脚本而不引用特定 JAR 名称,应用修订包时,这些名称可能更改。输出 JAR 包含指向产品中的 API JAR 的相对路径。因此,不得将输出 JAR 移至另一目录。
注: 必须对此操作指定 --features 选项。
help
显示有关所指定操作的帮助信息。

选项

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

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

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

下列选项可用于 featureManager uninstall 命令:
--noPrompts
卸载功能部件而不需要任何用户交互或确认消息。
--verbose
使用此选项以在操作运行时显示所有可用附加信息。
name
指定一个或多个要卸载的功能部件(以空格或逗号分隔各个名称)。可指定以下选项:
  • 子系统归档(ESA 文件)的短名称,例如,adminCenter-1.0
  • 子系统归档(ESA 文件)的符号名称,例如,com.ibm.websphere.appserver.adminCenter-1.0
下列选项可用于 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 报告文件的名称。
--verbose
使用此选项以在操作运行时显示所有可用附加信息。
下列选项可用于 featureManager find 命令:
--viewInfo
显示详细信息。
--verbose
使用此选项以在操作运行时显示所有可用附加信息。
searchString
生成适用于您的配置的 Liberty 存储库 资产的列表。
下列选项可用于 featureManager classpath 命令:
--features=feature1,feature2,...
包含 API JAR 文件列表的功能部件的列表。此选项对于类路径操作是必需的。
fileName
所生成 JAR 文件的名称。

用法示例

以下示例将子系统归档 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
以下示例安装功能部件并包括附加信息:
featureManager install extendedPackage-1.0 --verbose
以下示例查找适用于您的配置的资产:
featureManager find searchString
以下示例列示详细信息:
featureManager find searchstring --viewInfo
以下示例查找功能部件并包括附加信息:
featureManager find "adminCenter-1.0" --verbose
以下示例将必需依赖项从 Liberty 存储库 下载至本地目录而不进行安装:
featureManager install feature_shortName --downloadOnly --location=c:\temp\download --acceptLicense
以下示例从 Liberty 存储库 下载所有依赖项:
featureManager install feature_shortName --downloadOnly=all --location=c:\temp\download --acceptLicense
以下示例安装本地目录中的功能部件。如果缺少依赖项,那么将从 Liberty 存储库 进行安装:
featureManager install feature_shortName --location=c:\temp\download --acceptLicense
以下示例从本地目录安装资产而不从 Liberty 存储库 下载缺失依赖项:
featureManager install feature_shortName --location=c:\temp\download --offlineOnly

以下示例创建类路径 JAR 文件并编译使用它的应用程序类:

featureManager classpath --features=servlet-3.0 classpath.jar
javac -cp classpath.jar TestServlet.java
以下示例卸载功能部件:
featureManager uninstall adminCenter-1.0

返回码

表 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 针对当前产品,此功能部件无效。
[17.0.0.3 and later]36 [17.0.0.3 and later]用户功能部件安装对于所指定的扩展 --to=core 而言无效。

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

文件名:rwlp_command_featuremanager.html