featureManager 指令
您可以使用 featureManager 指令,來尋找、安裝、解除安裝或取得特性的詳細資料。
您想要安裝的特性必須包裝成子系統保存檔(ESA 檔)。
您可以使用 featureManager 指令,透過 Proxy 伺服器來存取「Liberty 儲存庫」;如需相關資訊,請參閱在 Liberty 設定檔中為 featureManager 指令配置 Proxy 伺服器支援。
如果要管理更多的資產類型,並安裝、尋找或下載多個儲存庫中的資產,請使用 installUtility 指令而不是 featureManager 指令。如需相關資訊,請參閱使用 installUtility 指令來安裝資產。
語法
指令語法如下:
featureManager action [options]
其中 action 可以是下列值之一:
classpath
- 產生可新增至編譯器類別路徑,以便從特性清單使用 API 的 JAR 檔。這個動作可讓您針對產品所包含的 API JAR,編譯建置 Script,而不需參照特定的 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 儲存庫」下載資產;如需相關資訊,請參閱安裝「Liberty 儲存庫」資產。
- featureList
- 產生一個 XML 檔,其包含一份報告,詳述所有已安裝的特性。
find
- 在「Liberty 儲存庫」中尋找適用於您配置的資產。
- help
- 顯示指定動作的說明資訊。
解除安裝
使用特性的簡稱或符號名稱,來解除安裝特性。
註:- 在您解除安裝特性之前,請確定所有伺服器程序都已停止。
- uninstall 指令無法解除安裝使用者特性;例如 webCacheMonitor-1.0。
選項
![[8.5.5.4 或更新版本]](../ng_v8554.gif)
- --features=feature1,feature2,...
- 包含 API JAR 檔清單的特性清單。這是 classpath 動作的必要選項。
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:改寫現有檔案。
- 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 的「下載」頁面。
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 儲存庫」尋找適用的特性。
--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)