利用指令行在分散式作業系統上安裝 Liberty

您可以使用 Installation Manager 指令行來安裝所有 WebSphere® Application Server Liberty 供應項目。

開始之前

重要事項：

Java™ SE 17 是建議的 Java SDK ，因為它提供最新的特性和安全更新項目。除了安裝 Java SE 17 ，您也可以安裝另一個支援的 Java SDK 版本。 Liberty 在 Open Liberty 網站上支援的 Java 版本表格的 Java SE 版本 直欄中列出的任何 Java SE 版本上執行。

Java SE 8 的 Liberty 結束支援日期是 2026 年 10 月，修正套件 26.0.0.10。
Java SE 11 的 Liberty 支援結束日期是 2026 年 10 月，修正套件 26.0.0.10。
Java SE 17 的 Liberty 結束支援日期是 2027 年 10 月，修正套件 27.0.0.10。
Java SE 21 的 Liberty 支援結束日期是 2029 年 10 月，修正套件 29.0.0.10。

如需相關資訊，請參閱移除注意事項。

依照安裝 Installation Manager 和準備安裝 Liberty中的說明，準備您要安裝 Liberty 的系統。

如果您想從本端目錄型儲存庫或「Liberty 資產儲存庫服務」實例，來安裝 Liberty 資產，請配置儲存庫。如需 Liberty 資產儲存庫的相關資訊，請參閱使用 Installation Manager 安裝資產。

重要事項: 在安裝 Liberty 供應項目之前，您必須先閱讀隨產品檔案一起找到的授權合約。請依照這個主題所說明，在指令中指定 -acceptLicense，表示您接受授權合約。

關於這項作業

所有產品供應項目 (包括 Liberty 產品供應項目、Java SDK 供應項目及其他可用的軟體) 都是使用相同的 Installation Manager 指令來安裝。如果要安裝不同的供應項目，請遵循這些步驟，但是以該供應項目的 ID 和特性，來取代供應項目 ID 和任何的選用特性。

新增: 當您安裝 Liberty時，依預設，也會安裝適用於您 Liberty 產品版本的所有 Liberty 特性。或者，您可以安裝不同的一組特性，或是不安裝任何特性。如需相關資訊，請參閱提示一節。

程序

選用: 如果儲存庫需要使用者名稱和密碼，請建立認證儲存檔和主要密碼檔來存取這個儲存庫。
1. 選用項目: 建立主要密碼檔。
  
  主要密碼檔是一個包含通行詞組的文字檔，例如 This text is the main password。此檔案用來維護您鑑別認證的安全。
  
  如果您建立主要密碼檔，並在建立認證時使用它，您一律必須指定主要密碼檔。
  
  提示: 若要保護此檔案的安全，請針對您的作業系統設定許可權，以限制對此檔案的存取權。
2. 執行 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 。
登入系統。
切換至 Installation Manager安裝目錄中的 eclipse/tools 子目錄。

驗證供應項目儲存庫是否可用。

imcl.exe listAvailablePackages -repositories repository_URL_or_path

./imcl listAvailablePackages -repositories repository_URL_or_path

您會看到供應項目的一或多個層次。

使用 imcl 指令來安裝供應項目。
```
imcl.exe install com.ibm.websphere.liberty.BASE_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
```
```
./imcl install com.ibm.websphere.liberty.BASE_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 特性。
  您可以在 user.addon 和 user.feature 內容上指定一組自訂的 Liberty 附加程式和特性，而不安裝所有特性，如下列範例所示。請注意，特性簡稱或符號名稱會以兩個逗點區隔：
  imcl.exe install com.ibm.websphere.liberty.BASE,embeddablecontainer -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0 -installationDirectory "C:\Program Files\IBM\WebSphere\Liberty" -acceptLicense -repositories D:\IBM\LibertyRepo,https://your_onprem_asset_repo_url,D:\IBM\LocalAssetRepo,D:\IBM\LocalAssetRepo2.zip -sharedResourcesDirectory D:\IBM\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="" 參數。
  如需相關資訊，請參閱下列主題：
  
  安裝 Liberty Repository 資產
  
  Liberty 特性
  
  Liberty 儲存庫
- 第一次利用 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 特性，並以逗點區隔。
  附註: 從 16.0.0.2 修正套件開始，已針對內嵌式 EJB 儲存器和 JPA 用戶端特性發出移除注意事項，因此該特性適合未來移除。如需相關資訊，請參閱移除注意事項。
  
  內嵌式 EJB 儲存器是一個 Java 保存檔 (JAR) ，可用來在獨立式 Java Platform Standard Edition (SE) 環境中執行 Enterprise Bean。您可以在應用程式伺服器之外，利用這個內嵌式儲存器來執行 Enterprise Bean。內嵌式 EJB 儲存器是 EJB 3.1 規格的一部分，主要用於對 Enterprise Bean 商業邏輯進行單元測試。
  
  JPA 用戶端可以與可內嵌的 EJB 儲存器搭配使用，在 Java SE 環境中提供「Java 持續性 API」功能。
- Installation Manager 可以將舊版的套件儲存起來，以便稍後發生問題時，進行回復。當 Installation Manager 將套件回復為先前的版本時，會將檔案的現行版本解除安裝，再重新安裝舊版。如果您選擇不要儲存檔案來進行回復，您可以在指令指定內容中使用下列喜好，以防止儲存檔案：
```
-preference com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts=False
```
  改為：
  提示: 即使您選擇不在本端保留檔案以進行回復，仍可以透過存取適當的供應項目儲存庫來回復至任何先前安裝的層次。
- Installation Manager 會根據您的作業系統架構，自動選擇安裝套件的架構。在 64 位元系統上，您可以針對您的作業系統，將下列喜好設定設為 32 位元架構值，來指定 32 位元安裝架構：
```
-properties cic.selector.arch=x86
```
  如需 cic.selector.arch的架構值清單，請參閱 Installation Manager 產品說明文件中的 imcl 指令的指令行引數表格。
- 在這個供應項目的安裝映像檔或儲存庫的 lafiles 或 offering_name/lafiles 子目錄中，授權合約檔提供了相關的條款、注意事項及其他資訊。
- 程式可能會將重要的後置安裝指示寫在標準輸出中。
如需使用 imcl 指令來安裝供應項目的相關資訊，請參閱 IBM Installation Manager 產品說明文件。