利用指令行在分散式作業系統上安裝 Liberty
您可以利用 Installation Manager 指令行來安裝 WebSphere® Application Server Liberty Core。
開始之前
請依照安裝 Installation Manager 以及準備安裝 Liberty中的說明,將 WebSphere Application Server Liberty Core 要安裝到其中的系統備妥。
關於這項作業
如果要安裝 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 版說明文件。
- 登入系統。
- 切換至 Installation Manager 安裝目錄中的 eclipse/tools 子目錄。
- 驗證供應項目儲存庫是否可用。
imcl.exe listAvailablePackages -repositories source_repository
您會看到供應項目的一或多個層次。./imcl listAvailablePackages -repositories source_repository
- 利用 imcl 指令來安裝供應項目。
imcl.exe 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
./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 或 offering_name/lafiles 子目錄中,授權合約檔提供了相關的條款、注意事項及其他資訊。
- 第一次利用 Installation Manager 來安裝套件時,您可以指定共用資源目錄。共用資源目錄是安裝構件所在的位置,可供一或多個套件群組使用。 在安裝作業期間,它也用來作為產品有效負載的暫置區。 依預設,會快取這個內容,以便用於進行回復。 請將您最大的磁碟用於這項安裝。 直到解除安裝所有套件之後,才可以變更目錄位置。
- 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。
- 您可以新增以逗點區隔的特性清單:
- 內嵌式 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)。
從 8.5.5.4 版起,不再提供 extprogmodels 特性。請改為安裝 extendedPackage-1.0 附加程式,或是從 Liberty 儲存庫安裝您需要的個別特性。如需相關資訊,請參閱下列主題:
- 如果系統無法存取網際網路,為了確保能完成該系統的安裝程序,請在 Installation Manager 指令行上指定 -properties user.feature="" 參數。如果您沒有指定這個參數,安裝程序會嘗試存取網際網路,因而發生錯誤。
請驗證防火牆已配置成容許 Installation Manager 存取網際網路,或是可以存取 Installation Manager 儲存庫。如果問題持續存在,可能是儲存庫伺服器無法使用。如果要繼續安裝,但不安裝其他資產,請指定 user.feature="" 和 user.addon="" 參數。錯誤:無法連接 IBM WebSphere Liberty 儲存庫或本端 Installation Manager 儲存庫。
當您套用 WebSphere Application Server Liberty 設定檔修正套件 8.5.5.5 版時,可能收到 NullPointerException。當您下載 WebSphere Application Server Liberty 設定檔修正套件壓縮檔,並在所下載的目錄位置中使用它們,以便安裝或更新 Liberty 設定檔時,可能發生錯誤。若要暫行解決這個 8.5.5.5 版錯誤狀況,請採取下列步驟:
- 將 WebSphere Application Server Liberty 設定檔修正套件壓縮檔解壓縮到暫存目錄。
- 使用暫存目錄作為 Installation Manager 儲存庫,來安裝或更新 Liberty 設定檔。
unzip 8.5.5-WS-LIBERTYPROFILE-OS390-FP0000005.zip to /tmp/fp8555 # ./imcl install com.ibm.websphere.liberty.v85_8.5.5005.20150305_2214 -installationDirectory /SERVICE/usr/lpp/zWebSphere/Liberty/V8R5 -repositories /tmp/fp8555 -acceptLicense
- 內嵌式 EJB 儲存器和 JPA 用戶端 (embeddablecontainer)
您可以指定要從「Liberty 儲存庫」安裝的其他資產。如需「Liberty 儲存庫」資產清單,請參閱 WASdev.net 的「下載」頁面。如果您想安裝其他資產,請在指令行中指定下列內容。您可以指定簡稱或符號名稱。在下列範例中,請注意,FeatureA 之類的特性簡稱是用兩個逗點區隔:
-properties user.feature=FeatureA,,FeatureB,,FeatureC,user.accept.license=true
若為 8.5.5.5 版及更新版本,不需要 user.accept.license=true。
下列範例會安裝 user.addon 參數中的「延伸程式設計模型」,以及安裝 user.feature 參數中的「Portlet 儲存器」特性。
imcl install com.ibm.websphere.liberty.ND.v85 -properties user.accept.license=true,user.addon=extendedPackage-1.0,user.feature=portlet-2.0 -installationDirectory D:\IBM\Liberty -acceptLicense -repositories D:\IBM\LibertyRepo -sharedResourcesDirectory D:\IBM\IMShared -showProgress
您也可以從「Liberty 資產儲存庫服務」實例或本端目錄型儲存庫,來安裝資產。如需這些資產儲存庫的相關資訊,請參閱使用 Installation Manager 來安裝資產。在 -repositories 參數中新增儲存庫 URL 或目錄。會依照儲存庫的指定順序來存取。依預設,「Liberty 儲存庫」會是安裝期間所存取的最後一個儲存庫。如果要停用對「Liberty 儲存庫」的存取權,請在 -properties 參數中,將 user.useLibertyRepository 選項設為 false。下列範例會先從 Liberty 資產儲存庫服務實例 https://your_onprem_asset_repo_url,來安裝資產。如果資產無法使用,就會從 D:\IBM\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 D:\IBM\Liberty -acceptLicense -repositories D:\IBM\LibertyProductRepo,https://your_onprem_asset_repo_url,D:\IBM\LocalAssetRepo -sharedResourcesDirectory D:\IBM\IMShared -showProgress
如果要進一步瞭解「Liberty 儲存庫」及其包含的資產,請參閱 Liberty 儲存庫。
- Installation Manager 可以將舊版的套件儲存起來,以便稍後發生問題時,進行回復。當 Installation Manager 將套件回復為先前的版本時,會將檔案的現行版本解除安裝,再重新安裝舊版。如果您選擇不要儲存檔案來進行回復,您可以在指令指定內容中使用下列喜好,以防止儲存檔案:
-preference com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=False
如需設定 Installation Manager 喜好設定的相關資訊,請參閱 IBM Installation Manager 說明文件。
提示: 即使您選擇不在本端儲存檔案來進行回復,您仍可以存取適當的供應項目儲存庫來回復到任何先前安裝的層次。 - 您可以利用 cic.selector.arch 內容索引鍵及相關的值來指定要安裝的架構,32 位元或 64 位元。
以下是指定 32 位元架構的範例:
-properties cic.selector.arch=x86
如果您對這個索引鍵沒有任何指定,您會取得系統的正確相符項。 如果是 64 位元系統,安裝會預設為 64 位元安裝。
您在這裡的選擇會套用到套件群組中所安裝的所有套件。 如需 cic.selector.key 索引鍵支援值的相關資訊,請參閱「Installation Manager 說明文件」中的 cic.selector.key 值表格。
- 程式可能會將重要的後置安裝指示寫在標準輸出中。
如需利用 imcl 指令來安裝供應項目的相關資訊,請參閱 IBM Installation Manager 說明文件。
