您可以使用 Installation Manager 指令行,在 IBM® i 作業系統上安裝所有的 WebSphere® Application Server Liberty 供應項目。
開始之前
重要: WebSphere Liberty 將於 2017 年 9 月終止支援使用 Java™ SE 6。在 17.0.0.3 中,Liberty 核心已重新編譯。從 17.0.0.3 起,Liberty 核心不再與 Java SE 6 搭配執行。在過了支援日期之後,如果您繼續在舊版上使用 Java
SE 6,會讓您的環境暴露在安全風險中。
建議使用的 Java SDK 是 Java SE 8,因為它提供最新的特性與安全更新。除了 Java SE 8,也可以使用任何支援的
Java SDK 版本。
使用本程序之前,請先做好安裝準備。如需相關資訊,請參閱準備作業系統以便安裝在 IBM i 上。
如果您想從本端目錄型儲存庫或「Liberty 資產儲存庫服務」實例,來安裝 Liberty 資產,請配置儲存庫。如需 Liberty 資產儲存庫的相關資訊,請參閱使用 Installation Manager 來安裝資產。
重要: 安裝 Liberty 之前,您必須先閱讀產品檔案隨附的授權合約。請依照這個主題所說明,在指令中指定 -acceptLicense,表示您接受授權合約。
如果尚未安裝 IBM Installation Manager 1.8.5 版或更新版本,請將它安裝在您想安裝產品的系統上:
- 下載 IBM Installation Manager。
有三個基本選項可供您存取 Installation Manager 安裝檔案。
- 針對 Installation Manager 的二進位檔、執行時期資料(代理程式資料)及共用資料的位置,選擇三個不同的位置。
- 利用 Installation Manager 指令行來安裝 Installation Manager。
- 利用具備 *ALLOBJ 和 *SECADM 特殊權限的使用者設定檔來登入 IBM i 系統。
- 在 CL 指令行上,執行 STRQSH 指令,以啟動 Qshell 指令 Shell。
- 確定 umask 已設為 022。
如果要驗證 Umask 設定,請發出下列指令:
umask
如果要將 Umask 設定設為 022,請發出下列指令:
umask 022
- 切換至包含 Installation Manager 安裝檔案的位置,然後執行下列指令:
installc -acceptLicense -log log_file_path_and_name
關於這項作業
所有產品供應項目(包括
Liberty 產品供應項目和其他可用的軟體)
都是使用相同的 Installation Manager 指令來安裝。如果要安裝不同的供應項目,請遵循這些步驟,但是以該供應項目的 ID 和特性,來取代供應項目 ID 和任何的選用特性。
新增功能: 在您安裝
Liberty 時,依預設,也會安裝適用於您
Liberty 產品版本的所有
Liberty 特性。或者,您可以安裝不同的一組特性,或是不安裝任何特性。如需相關資訊,請參閱
提示區段。
程序
- 選擇性的: 如果儲存庫需要使用者名稱和密碼,請建立認證儲存檔和主要密碼檔,以存取這個儲存庫。
- 選擇性的: 建立主要密碼檔。
主要密碼檔是一個包含通行詞組的文字檔,例如 "This text is the
master password"。此檔案用來維護您鑑別認證的安全。
如果您建立主要密碼檔,並在建立認證時使用它,您一律必須指定主要密碼檔。
提示: 為了保護此檔案,請針對您的作業系統設定適當的許可權,以限制存取此檔案。
- 執行 imutilsc saveCredential 指令,建立一個認證儲存檔。

imutilsc.exe saveCredential
-secureStorageFile storage_file
-userName user_ID -userPassword user_password
-url repository_URL_or_path




./imutilsc saveCredential
-secureStorageFile storage_file
-userName user_ID -userPassword user_password
-url repository_URL_or_path
提示: 如果 imutilsc 指令找不到您建立認證儲存檔時所指定的 URL,請在儲存庫 URL 位置尾端附加
/repository.config。
- 利用具備 *ALLOBJ 和 *SECADM 特殊權限的使用者設定檔來登入 IBM i 系統。
- 在 CL 指令行上,執行 STRQSH 指令,以啟動 Qshell 指令 Shell。
- 確定 umask 已設為 022。
如果要驗證 Umask 設定,請發出下列指令:
umask
如果要將 Umask 設定設為 022,請發出下列指令:
umask 022
- 切換至 Installation Manager 安裝目錄中的 eclipse/tools 子目錄。
- 使用 imcl 指令來安裝產品。
./imcl install com.ibm.websphere.liberty.CORE.ND_offering_version,optional_feature_ID
-repositories repository_URL_or_path
-installationDirectory installation_directory
-sharedResourcesDirectory shared_directory
-preferences preference_key=value
-properties property_key=value
-secureStorageFile storage_file -masterPasswordFile master_password_file
-acceptLicense
提示: 新增功能: 在您安裝 Liberty 時,依預設,也會安裝適用於您 Liberty 產品版本的所有 Liberty 特性。
您可以不安裝所有特性,而改為安裝自訂的一組 Liberty 附加程式和特性,作法是如下列範例所示,在 user.addon 和 user.feature
內容中指定它們。請注意,特性簡稱或符號名稱會以兩個逗點區隔:./imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer
-properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
-installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore -acceptLicense
-repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo,/QIBM/LocalAssetRepo2.zip
-sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
-showProgress
無論是否能夠存取網際網路,您可以從「Liberty 資產儲存庫服務」實例或本端目錄型儲存庫,來安裝資產。請在
-repositories 參數中新增儲存庫 URL、目錄路徑或保存檔路徑。會依照這些儲存庫的指定順序來存取。如需這些資產儲存庫的相關資訊,請參閱使用 Installation Manager 來安裝資產。如果要從
IBM
WebSphere Liberty Repository 來安裝資產,您必須能夠存取網際網路。如果要啟用對 Liberty Repository 的存取權,請在 -properties 參數中,將 user.useLibertyRepository 選項設為 true。Liberty Repository 是在安裝期間所存取的最後一個儲存庫。
重要: 如果您不想安裝 Liberty 附加程式或特性,請指定 -properties user.addon=""
user.feature="" 參數。
- 在這個供應項目的安裝映像檔或儲存庫的 lafiles 或 offering_name/lafiles 子目錄中,授權合約檔提供了相關的條款、注意事項及其他資訊。
- 第一次利用 Installation Manager 來安裝套件時,您可以指定共用資源目錄。共用資源目錄是安裝構件所在的位置,可供一或多個套件群組使用。
在安裝作業期間,它也用來作為產品有效負載的暫置區。
依預設,會快取這個內容,以便用於進行回復。
請將您最大的磁碟用於這項安裝。
直到解除安裝所有套件之後,才可以變更目錄位置。
- offering_version 可利用底線附加到供應項目 ID,它是要安裝的供應項目的特定版本(例如 16.0.2.20160503_0200)。
- 如果未指定 offering_version,則將安裝最新版本的供應項目,以及適用於該版本的所有臨時修正程式。
- 如果指定了 offering_version,則將安裝指定版本的供應項目,但不安裝適用於該版本的臨時修正程式。
對儲存庫執行下列指令時,可發現已使用底線將供應項目版本附加至供應項目 ID 的尾端:
imcl listAvailablePackages -repositories repository_URL_or_path
- 還可以指定 none、recommended 或 all 與 -installFixes 引數,以指示您要隨供應項目安裝的臨時修正程式。
- 如果未指定供應項目版本,則 -installFixes 選項預設為 all。
- 如果指定了供應項目版本,則 -installFixes 選項預設為 none。
- 如果要安裝內嵌式 EJB 儲存器和 JPA 用戶端,請在供應項目 ID 後面指定選用的
embeddablecontainer 特性,並以逗點區隔:
imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer
內嵌式 EJB 儲存器是可以用來在獨立式 Java Platform Standard Edition (SE) 環境中執行 Enterprise Bean 的 Java 保存檔 (JAR)。您可以在應用程式伺服器之外,利用這個內嵌式儲存器來執行 Enterprise Bean。內嵌式 EJB 儲存器是 EJB 3.1 規格的一部分,主要用於對 Enterprise Bean 商業邏輯進行單元測試。
JPA 用戶端可以搭配內嵌式 EJB 儲存器,在 Java SE 環境中提供 Java 持續性 API 功能。
- 如果是初次安裝,指定 user_data_root 是一個好的作法;否則,會使用 user_data_root 的預設值 /QIBM/UserData/WebSphere/Liberty/EDITION。
請利用 was.install.os400.profile.location 內容來指定 user_data_root。
- 程式可能會將重要的後置安裝指示寫在標準輸出中。
如需使用 imcl 指令來安裝產品的相關資訊,請參閱 IBM Installation
Manager 產品說明文件。
範例
下列範例顯示使用
imcl 指令來安裝
WebSphere Application Server LibertyCore:
./imcl install com.ibm.websphere.liberty.CORE.ND
-repositories https://downloads.mycorp.com:8080/WAS_Liberty_repository
-installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore
-properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/Liberty/LibertyCore
-sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
-secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/IM/master_password_file.txt
-acceptLicense