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

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

開始之前

[16.0.0.4 以及更新版本]註: 「Java SE 6 與 WebSphere Liberty 搭配使用」支援將在 2017 年 9 月結束。在結束支援之後, Liberty 核心會重新編譯,並且再也無法與 SE 6 搭配執行。在過了支援日期之後,如果您繼續在舊有修正套件上使用 Java SE 6,可能使您的環境暴露在安全風險中。

建議使用的 Java SDK 是 Java SE 8,因為它提供最新的特性與安全更新。若要安裝它,您可以將 IBM SDK, Java Technology Edition 第 8 版安裝到含有 WebSphere Liberty 的套件群組中。

依照安裝 Installation Manager 以及準備安裝 Liberty 的說明,準備要在其中安裝 Liberty 的系統。

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

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

關於這項作業

所有產品供應項目(包括 Liberty 產品供應項目、Java SDK 供應項目,以及其他可用的軟體)都是使用相同的 Installation Manager 指令來安裝。如果要安裝不同的供應項目,請遵循這些步驟,但是以該供應項目的 ID 和特性,來取代供應項目 ID 和任何的選用特性。
新建: 在您安裝 Liberty 時,依預設,也會安裝適用於您 Liberty 產品版本的所有 Liberty 特性。或者,您可以安裝不同的一組特性,或是不安裝任何特性。如需相關資訊,請參閱提示區段。

程序

  1. 選擇性的: 如果儲存庫需要使用者名稱和密碼,請建立認證儲存檔和主要密碼檔,以存取這個儲存庫。
    1. 選擇性的: 建立主要密碼檔。

      主要密碼檔是一個包含通行詞組的文字檔,例如 "This text is the master password"。此檔案用來維護您鑑別認證的安全。

      如果您建立主要密碼檔,並在建立認證時使用它,您一律必須指定主要密碼檔。

      提示: 為了保護此檔案,請針對您的作業系統設定適當的許可權,以限制存取此檔案。
    2. 執行 imutilsc saveCredential 指令,建立一個認證儲存檔。
      適用於 Windows 平台
      imutilsc.exe saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url repository_URL_or_path 
      適用於 AIX 平台適用於 HP UNIX 平台適用於 LINUX 平台適用於 Solaris 平台
      ./imutilsc saveCredential 
        -secureStorageFile storage_file
        -userName user_ID -userPassword user_password
        -url repository_URL_or_path 
      提示: 如果 imutilsc 指令找不到您建立認證儲存檔時所指定的 URL,請在儲存庫 URL 位置尾端附加 /repository.config
  2. 登入系統。
  3. 切換至 Installation Manager 安裝目錄中的 eclipse/tools 子目錄。
  4. 驗證供應項目儲存庫是否可用。
    適用於 Windows 平台
    imcl.exe listAvailablePackages -repositories repository_URL_or_path
    適用於 AIX 平台適用於 HP UNIX 平台適用於 LINUX 平台適用於 Solaris 平台
    ./imcl listAvailablePackages -repositories repository_URL_or_path
    您會看到供應項目的一或多個層次。
  5. 利用 imcl 指令來安裝供應項目。
    適用於 Windows 平台
    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
    適用於 AIX 平台適用於 HP UNIX 平台適用於 LINUX 平台適用於 Solaris 平台
    ./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 特性。
      您可以不安裝所有特性,而改為安裝自訂的一組 Liberty 附加程式和特性,作法是如下列範例所示,在 user.addonuser.feature 內容中指定它們。請注意,特性簡稱或符號名稱會以兩個逗點區隔:
      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="" 參數。
    • 第一次利用 Installation Manager 來安裝套件時,您可以指定共用資源目錄。共用資源目錄是安裝構件所在的位置,可供一或多個套件群組使用。 在安裝作業期間,它也用來作為產品有效負載的暫置區。 依預設,會快取這個內容,以便用於進行回復。 請將您最大的磁碟用於這項安裝。 直到解除安裝所有套件之後,才可以變更目錄位置。
    • offering_version 可利用底線附加到供應項目 ID,它是要安裝的供應項目的特定版本(例如 16.0.2.20160503_0200)。
      • 如果指定 offering_version,則將安裝最新版本的供應項目,以及適用於該版本的所有臨時修正程式。
      • 如果指定了 offering_version,則將安裝指定版本的供應項目,但安裝適用於該版本的臨時修正程式。
      對儲存庫執行下列指令時,可發現已使用底線將供應項目版本附加至供應項目 ID 的尾端:
      imcl listAvailablePackages -repositories repository_URL_or_path
    • 還可以指定 nonerecommendedall-installFixes 引數,以指示您要隨供應項目安裝的臨時修正程式。
      • 如果指定供應項目版本,則 -installFixes 選項預設為 all
      • 如果指定了供應項目版本,則 -installFixes 選項預設為 none
    • 如果要安裝內嵌式 EJB 儲存器和 JPA 用戶端,請在供應項目 ID 後面指定選用的 embeddablecontainer 特性,並以逗點區隔。
      註: 從 16.0.0.2 修正套件開始,已針對內嵌式 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 持續性 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 指令的指令行引數表格。

    • 在這個供應項目的安裝映像檔或儲存庫的 lafilesoffering_name/lafiles 子目錄中,授權合約檔提供了相關的條款、注意事項及其他資訊。
    • 程式可能會將重要的後置安裝指示寫在標準輸出中。

    如需使用 imcl 指令來安裝供應項目的相關資訊,請參閱 IBM Installation Manager 產品說明文件


指示主題類型的圖示 作業主題



「時間戳記」圖示 前次更新: 2016 年 11 月 30 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twlp_ins_installation_dist_cl
檔名:twlp_ins_installation_dist_cl.html