利用指令行在 IBM i 作業系統上安裝 Liberty

您可以使用 Installation Manager 指令行,在 IBM® i 作業系統上安裝所有的 WebSphere® Application Server Liberty 供應項目。

開始之前

[17.0.0.3 以及更新版本]重要: 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 版或更新版本,請將它安裝在您想安裝產品的系統上:

  1. 下載 IBM Installation Manager。
    有三個基本選項可供您存取 Installation Manager 安裝檔案。
    • IBMInstallation Manager 下載網站,下載 Installation Manager 最新版本。
    • 從媒體上的產品儲存庫,來安裝 Installation Manager。
    • 從 Passport Advantage® 網站下載檔案,並且採用本端安裝

      具有 Passport Advantage ID 和密碼的授權客戶,可以從 Passport Advantage 網站下載必要的產品儲存庫。

  2. 針對 Installation Manager 的二進位檔、執行時期資料(代理程式資料)及共用資料的位置,選擇三個不同的位置。
  3. 利用 Installation Manager 指令行來安裝 Installation Manager。
    1. 利用具備 *ALLOBJ 和 *SECADM 特殊權限的使用者設定檔來登入 IBM i 系統。
    2. 在 CL 指令行上,執行 STRQSH 指令,以啟動 Qshell 指令 Shell。
    3. 確定 umask 已設為 022。
      如果要驗證 Umask 設定,請發出下列指令:
      umask
      如果要將 Umask 設定設為 022,請發出下列指令:
      umask 022
    4. 切換至包含 Installation Manager 安裝檔案的位置,然後執行下列指令:
      installc -acceptLicense -log log_file_path_and_name
      附註:

關於這項作業

所有產品供應項目(包括 Liberty 產品供應項目和其他可用的軟體) 都是使用相同的 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. 利用具備 *ALLOBJ 和 *SECADM 特殊權限的使用者設定檔來登入 IBM i 系統。
  3. 在 CL 指令行上,執行 STRQSH 指令,以啟動 Qshell 指令 Shell。
  4. 確定 umask 已設為 022。
    如果要驗證 Umask 設定,請發出下列指令:
    umask
    如果要將 Umask 設定設為 022,請發出下列指令:
    umask 022
  5. 切換至 Installation Manager 安裝目錄中的 eclipse/tools 子目錄。
  6. 使用 imcl 指令來安裝產品。
    ./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 install com.ibm.websphere.liberty.BASE,embeddablecontainer             
      -properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
      -installationDirectory /QIBM/ProdData/WebSphere/Liberty/Base -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="" 參數。
      如需相關資訊,請參閱下列主題:
    • 在這個供應項目的安裝映像檔或儲存庫的 lafilesoffering_name/lafiles 子目錄中,授權合約檔提供了相關的條款、注意事項及其他資訊。
    • 第一次利用 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 特性,並以逗點區隔:
      imcl install com.ibm.websphere.liberty.BASE,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 Liberty
./imcl install com.ibm.websphere.liberty.BASE
  -repositories https://downloads.mycorp.com:8080/WAS_Liberty_repository
  -installationDirectory /QIBM/ProdData/WebSphere/Liberty/Base
  -properties was.install.os400.profile.location=/QIBM/UserData/WebSphere/Liberty/Base
  -sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
  -secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/IM/master_password_file.txt
  -acceptLicense

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

檔名:twlp_ins_installation_is_cl.html