利用指令行在 IBM i 作業系統上安裝 Liberty
您可以利用 Installation Manager 指令行,將 WebSphere® Application Server Liberty Core 安裝在 IBM® i 作業系統上。
開始之前
使用本程序之前,請先做好安裝準備。如需相關資訊,請參閱 IBM i 作業系統安裝準備。
如果您想從本端目錄型儲存庫或「Liberty 資產儲存庫服務」實例,來安裝 Liberty 資產,請配置儲存庫。如需 Liberty 資產儲存庫的相關資訊,請參閱使用 Installation Manager 來安裝資產。
- 如果您想要使用隨附在這個產品中的 Installation Manager,請執行下列動作:
- 取得必要的檔案。
有三個基本選項可供您取得及安裝 Installation Manager 和產品。
- 存取實體媒體,使用本端安裝
您可以存取媒體上的產品儲存庫。
- 在系統上安裝 Installation Manager。
您可以使用媒體、從 Passport Advantage® 網站取得的檔案,或 IBM Installation Manager 下載網站中包含最新版 Installation Manager 的檔案,來安裝 Installation Manager。
- 請利用 Installation Manager,從媒體上的產品儲存庫安裝產品。
- 在系統上安裝 Installation Manager。
- 從 Passport Advantage 網站下載檔案,然後使用本端安裝
具有 Passport Advantage ID 和密碼的授權客戶,可以從 Passport Advantage 網站下載必要的產品儲存庫。
- 從 Passport Advantage 網站下載檔案。
- 在系統上安裝 Installation Manager。
您可以使用媒體、從 Passport Advantage 網站取得的檔案,或 IBM Installation Manager 下載網站中包含最新版 Installation Manager 的檔案,來安裝 Installation Manager。
- 利用 Installation Manager,從下載的儲存庫安裝產品。
- 存取現用儲存庫,使用 Web 型安裝
如果您有 Passport Advantage ID 和密碼,您可以從 Web 型儲存庫安裝產品。
- 在系統上安裝 Installation Manager。
您可以使用媒體、從 Passport Advantage 網站取得的檔案,或 IBM Installation Manager 下載網站中包含最新版 Installation Manager 的檔案,來安裝 Installation Manager。
- 利用 Installation Manager,從下列位置的 Web 型儲存庫安裝產品:
http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85
註: 這個位置未包含可利用 Web 瀏覽器來存取的網頁。 這是您必須在 -repositories 參數值中指定的遠端 Web 型儲存庫位置,以便 imcl 指令能夠存取這個儲存庫中的檔案來安裝產品。
您應該儘可能使用遠端 Web 型儲存庫,以便存取最新的安裝檔案。
- 在系統上安裝 Installation Manager。
註: 如果您沒有 Passport Advantage ID 和密碼,您必須從媒體中的產品儲存庫或本端儲存庫安裝產品。 - 存取實體媒體,使用本端安裝
- 針對 Installation Manager 的二進位檔、執行時期資料(代理程式資料)及共用資料的位置,選擇三個不同的位置。
- 利用 Installation Manager 指令行來安裝 Installation Manager。
- 利用具備 *ALLOBJ 和 *SECADM 特殊權限的使用者設定檔來登入 IBM i 系統。
- 在 CL 指令行上,執行 STRQSH 指令,以啟動 Qshell 指令 Shell。
- 確定 umask 已設為 022。如果要驗證 Umask 設定,請發出下列指令:
如果要將 Umask 設定設為 022,請發出下列指令:umask
umask 022
- 切換至包含 Installation Manager 安裝檔案的位置,然後執行下列指令:
installc -acceptLicense -log log_file_path_and_name
附註:- 如需安裝 Installation Manager 的相關資訊,請參閱 IBM Installation Manager 資訊中心。
- 只利用 installc 指令來安裝 Installation Manager。
- 取得必要的檔案。
- 如果您的系統已安裝了 Installation Manager 的某個版本,且您想要利用它來安裝及維護產品,請取得必要的產品檔案。
產品有三個基本安裝選項。
- 存取實體媒體,使用本端安裝
您可以存取媒體上的產品儲存庫。請利用 Installation Manager,從媒體上的產品儲存庫安裝產品。
- 從 Passport Advantage 網站下載檔案,然後使用本端安裝
具有 Passport Advantage ID 和密碼的授權客戶,可以從 Passport Advantage 網站下載必要的產品儲存庫。
- 從 Passport Advantage 網站下載產品儲存庫。
- 利用 Installation Manager,從下載的儲存庫安裝產品。
- 存取現用儲存庫,使用 Web 型安裝
如果您有 Passport Advantage ID 和密碼,您可以利用 Installation Manager,從 Web 型儲存庫來安裝產品。 利用 Installation Manager,從下列位置的 Web 型儲存庫安裝產品:
http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.v85
註: 這個位置未包含可利用 Web 瀏覽器來存取的網頁。 這是您必須在 -repositories 參數值中指定的遠端 Web 型儲存庫位置,以便 imcl 指令能夠存取這個儲存庫中的檔案來安裝產品。您應該儘可能使用遠端 Web 型儲存庫,以便存取最新的安裝檔案。
註: 如果您沒有 Passport Advantage ID 和密碼,您必須從媒體中的產品儲存庫或本端儲存庫安裝產品。 - 存取實體媒體,使用本端安裝
關於這項作業
如果要安裝 Liberty 設定檔 8.5.5.4 版及更新版本,您必須具有 IBM Installation Manager 1.6.2 版或更新的版本。
程序
- 選擇性的: 如果儲存庫需要使用者名稱和密碼,請建立一個認證儲存檔來存取這個儲存庫。 提示: 當建立認證儲存檔時,如果 imutilsc 指令找不到所指定的 URL,請在儲存庫 URL 位置尾端附加 /repository.config。註: 當使用 Installation Manager 1.6.2 版及更新的版本時,您應該利用 -secureStorageFile 和 -masterPasswordFile 選項,將認證儲存在認證儲存檔中。 在 1.6.2 版之前的 Installation Manager 版本中,-keyring 和 -password 選項是用來存取金鑰環檔案中的認證。 在 1.6.2 版中,這些選項已淘汰。 因檔案結構的差異,並無金鑰環檔案至儲存檔的移轉路徑。 如需利用 -secureStorageFile 和 -masterPasswordFile 選項將認證儲存在認證儲存檔的相關資訊,請參閱 Installation Manager 1.6 版資訊中心。 如需利用 -keyring 和 -password 選項將認證儲存在金鑰環檔案的相關資訊,請參閱 Installation Manager 1.5 版資訊中心。
- 針對產品的二進位檔、執行時期資料(代理程式資料)及共用資料的位置,選擇三個不同的位置
- 利用具備 *ALLOBJ 和 *SECADM 特殊權限的使用者設定檔來登入 IBM i 系統。
- 在 CL 指令行上,執行 STRQSH 指令,以啟動 Qshell 指令 Shell。
- 確定 umask 已設為 022。 如果要驗證 Umask 設定,請發出下列指令:
如果要將 Umask 設定設為 022,請發出下列指令:umask
umask 022
- 切換至 Installation Manager 安裝目錄中的 eclipse/tools 子目錄。
- 使用 imcl 指令來安裝產品。
./imcl install com.ibm.websphere.liberty.v85_offering_version,optional_feature_ID -repositories source_repository -installationDirectory installation_directory -sharedResourcesDirectory shared_directory -preferences preference_key=value -properties property_key=value -secureStorageFile storage_file -masterPasswordFile master_password_file -acceptLicense
提示:- 在這個供應項目的安裝映像檔或儲存庫的 lafiles 或 product_name/lafiles 子目錄中,授權合約檔提供了相關的條款、注意事項及其他資訊。
- 您可以安裝以逗點區隔的特性清單。
- 內嵌式 EJB 儲存器和 JPA 用戶端 (embeddablecontainer)
這個選項會安裝內嵌式 EJB 儲存器和 JPA 用戶端。
內嵌式 EJB 儲存器是可以用來在獨立式 Java™ Platform Standard Edition (SE) 環境中執行 Enterprise Bean 的 Java 保存檔 (JAR)。 您可以在應用程式伺服器之外,利用這個內嵌式儲存器來執行 Enterprise Bean。 內嵌式 EJB 儲存器是 EJB 3.1 規格的一部分,主要用於對 Enterprise Bean 商業邏輯進行單元測試。
JPA 用戶端可以搭配內嵌式 EJB 儲存器,在 Java SE 環境中提供 Java Persistence API 功能。
附註:- 如果沒有指定任何特性,就會安裝預設特性 (embeddablecontainer)。
- 內嵌式 EJB 儲存器和 JPA 用戶端 (embeddablecontainer)
您可以指定要從「Liberty 儲存庫」安裝的其他資產。如需「Liberty 儲存庫」資產清單,請參閱 WASdev.net 的「下載」頁面。
如果要安裝「IBM WebSphere Liberty 儲存庫」中的資產,您必須能夠存取網際網路,並且具備 IBM Installation Manager 1.6.2 版或更新的版本。
如果您想安裝「Liberty 儲存庫」特性,請在 -properties 參數的 user.feature 選項中,指定簡稱或符號名稱。若有多個特性名稱,請用兩個逗點區隔。 下列範例是安裝「Portlet 儲存器」和「Portlet 服務」特性:-properties user.feature=portlet-2.0,,portletserving-2.0,user.accept.license=true
若為 8.5.5.5 版及更新版本,不需要 user.accept.license=true。
從 8.5.5.4 版起,不再提供 extprogmodels 特性。請改為安裝 extendedPackage-1.0 附加程式,或是從 Liberty 儲存庫安裝您需要的個別特性。如需相關資訊,請參閱下列主題:
您可以指定 user.addon 選項,來安裝整組「延伸程式設計模型」特性:-properties user.addon=extendedPackage-1.0,user.accept.license=true
如果您要升級 WebSphere Application Server Liberty 設定檔 8.5.5.3 版或含有 extprogmodels 特性的舊版,Installation Manager 會自動安裝 extendedPackage-1.0 附加程式。您必須指定 user.accept.license 選項:-properties user.accept.license=true
如果要進一步瞭解「Liberty 儲存庫」及其包含的資產,請參閱 Liberty 儲存庫。您也可以從「Liberty 資產儲存庫服務」實例或本端目錄型儲存庫,來安裝資產。如需這些資產儲存庫的相關資訊,請參閱使用 Installation Manager 來安裝資產。在 -repositories 參數中新增儲存庫 URL 或目錄。會依照儲存庫的指定順序來存取。依預設,「Liberty 儲存庫」會是安裝期間所存取的最後一個儲存庫。如果要停用對「Liberty 儲存庫」的存取權,請在 -properties 參數中,將 user.useLibertyRepository 選項設為 false。 下列範例會先從 Liberty 資產儲存庫服務實例 https://your_onprem_asset_repo_url,來安裝資產。如果資產無法使用,就會從 /QIBM/LocalAssetRepo 本端目錄型儲存庫來安裝。會停用「IBM WebSphere Liberty 儲存庫」的存取權:
./imcl install com.ibm.websphere.liberty.v85 -properties user.useLibertyRepository=false,user.addon=extendedPackage-1.0,user.feature=portlet-2.0 -installationDirectory /QIBM/ProdData/Liberty -acceptLicense -repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared -showProgress
- offering_version 可利用底線選擇性地附加到供應項目 ID,它是要安裝的供應項目的特定版本(例如 8.5.5.20110503_0200)。
- 如果未指定 offering_version,則將安裝最新版本的供應項目,以及適用於該版本的所有臨時修正程式。
- 如果指定了 offering_version,則將安裝指定版本的供應項目,但不安裝適用於該版本的臨時修正程式。
對儲存庫執行下列指令時,可發現已使用底線將供應項目版本附加至供應項目 ID 的尾端:./imcl listAvailablePackages -repositories source_repository
- 還可以指定 none、recommended 或 all 與 -installFixes 引數,以指示您要隨供應項目安裝的臨時修正程式。
- 如果未指定供應項目版本,則 -installFixes 選項預設為 all。
- 如果指定了供應項目版本,則 -installFixes 選項預設為 none。
- 如果是起始安裝,指定 user_data_root 是一個好的作法;否則,會使用 user_data_root 的預設值 /QIBM/UserData/WebSphere/AppServer/V85/LibertyCore。 請利用 was.install.os400.profile.location 內容來指定 user_data_root。 比方說,如果 user_data_root 將會是 /QIBM/UserData/WebSphere/AppServer/V85/Liberty,請在 imcl 安裝指令中指定 -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V85/Liberty。
- 程式可能會將重要的後置安裝指示寫在標準輸出中。
如需利用 imcl 指令來安裝產品的相關資訊,請參閱 IBM Installation Manager 資訊中心。
範例
./imcl install com.ibm.websphere.liberty.v85
-repositories https://downloads.mycorp.com:8080/WAS_85_repository
-installationDirectory /QIBM/ProdData/WebSphere/AppServer/V85/LibertyCore
-properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/AppServer/V85/LibertyCore
-sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
-secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/IM/master_password_file.txt
-acceptLicense