利用指令行在 IBM i 作業系統上安裝 Liberty 修正套件
產品修正套件包含將 WebSphere® Application Server Liberty Core 升級至新產品層次的組合服務。 臨時修正程式提供特定已知問題的更正服務。 您可以利用 IBM® Installation Manager 指令行功能,以您的 WebSphere Application Server Liberty Core 安裝架構服務水準所能使用的修正程式來更新產品。
開始之前
請聯絡 IBM 軟體支援中心,取得適用於 WebSphere Application Server for IBM i 之更新項目的相關資訊。最新資訊可以從 IBM 軟體支援中心及修正程式中心取得。
如果您想從本端目錄型儲存庫或「Liberty 資產儲存庫服務」實例,來安裝 Liberty 資產,請配置儲存庫。如需 Liberty 資產儲存庫的相關資訊,請參閱使用 Installation Manager 來安裝資產。
關於這項作業
- 您也可以利用回應檔來搭配 Installation Manager,以安裝修正套件。 如需建立及使用回應檔的相關資訊,請參閱利用回應檔在 IBM i 作業系統上安裝 Liberty 修正套件和 IBM Installation Manager 資訊中心。
- 您無法利用 iRemoteInstall 指令來安裝修正套件。
如果要安裝 Liberty 設定檔 8.5.5.4 版及更新版本,您必須具有 IBM Installation Manager 1.6.2 版或更新的版本。
程序
- 如需 WebSphere Application Server Liberty Core 安裝架構所能使用的修正程式清單,以及各修正程式具體的相關資訊,請執行下列動作。
- 前往修正程式中心。
- 選取 WebSphere 作為產品群組。
- 選取 WebSphere Application Server 作為產品。
- 選取已安裝的版本。
- 選取您的作業系統作為平台,然後按一下繼續。
- 選取瀏覽並找出修正程式,然後按一下繼續。
- 按一下每一個修正程式下面的相關資訊,以檢視該修正程式的相關資訊。
- 建議:列出您想要安裝的修正程式名稱。
- 利用下列其中一個程序,以修正套件來更新 WebSphere Application Server Liberty Core 安裝架構。
- 存取包含修正套件的現用服務儲存庫,然後使用 Web 型更新。
請利用本端系統上的 Installation Manager,以現用 Web 型服務儲存庫中的臨時修正程式來更新 WebSphere Application Server Liberty Core。
- 對於現用服務儲存庫,請使用安裝期間通用的產品供應項目儲存庫所用的相同 URL。
這些 URL 的型樣基礎如下:
其中 offering_ID 是您在支援的作業系統適用的 WebSphere Application Server 產品供應項目中找到的供應項目 ID。http://www.ibm.com/software/repositorymanager/offering_ID
- 這些位置不包含您可以利用 Web 瀏覽器來存取的網頁。 它們是您指定給 Installation Manager 的遠端 Web 型儲存庫位置,讓它能夠維護產品。
如果要從服務儲存庫安裝修正程式,請執行下列動作:- 如果還沒有包含 IBM 軟體使用者 ID 和密碼的 Installation Manager 認證儲存檔和主要密碼檔,請建立可讓您存取儲存庫的檔案。
註: 這些是您用來存取受保護的 IBM 軟體網站的認證。如需建立 Installation Manager 的認證儲存檔和主要密碼檔的相關資訊,請參閱 IBM Installation Manager 資訊中心。提示: 當建立認證儲存檔時,如果 imutilsc 指令找不到所指定的 URL,請在儲存庫 URL 位置尾端附加 /repository.config。
- 利用具備 *ALLOBJ 和 *SECADM 特殊權限的使用者設定檔來登入 IBM i 系統。
- 停止更新中的 WebSphere Application Server Liberty Core 安裝架構上的所有伺服器和應用程式。
- 在 CL 指令行上,執行 STRQSH 指令,以啟動 Qshell 指令 Shell。
- 確定 umask 已設為 022。如果要驗證 umask 設定,請發出下列指令:
如果要將 Umask 設定設為 022,請發出下列指令:umask
umask 022
- 切換至 Installation_Manager_binaries/eclipse/tools 目錄,其中 Installation_Manager_binaries 是 Installation Manager 的安裝根目錄。
在 IBM i 系統上,Installation Manager 的根目錄是 /QIBM/ProdData/InstallationManager。
- 安裝修正套件。
./imcl install offering_ID_offering_version,optional_feature_ID -repositories source_repository -installationDirectory offering_installation_location -secureStorageFile storage_file -masterPasswordFile master_password_file -acceptLicense
註: 當使用 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 版資訊中心。提示:- offering_ID 是支援的作業系統適用的 WebSphere Application Server 產品供應項目中所列出的供應項目 ID。
- 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。
- 您可以新增以逗點區隔的特性清單。
您可以指定要從「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
- 如果您透過安裝 WebSphere Application Server 群組 PTF 來取得修正套件,您可以利用本端修正套件儲存庫來安裝修正套件。
如需本端修正套件儲存庫的相關資訊,請參閱 /QIBM/WAS/WASFixpacks/ReadmeV85.html 或 /QIBM/WAS/WASFixpacks/ReadmeV85.txt 檔。
- 選用項目: 列出已安裝的所有套件,以驗證安裝:
./imcl listInstalledPackages -long
- 對於現用服務儲存庫,請使用安裝期間通用的產品供應項目儲存庫所用的相同 URL。
這些 URL 的型樣基礎如下:
- 從「修正程式中心」下載包含修正套件的檔案,然後使用本端更新。
您可以從「修正程式中心」下載包含修正套件的壓縮檔。每個壓縮的修正程式檔都包含一個修正套件的 Installation Manager 儲存庫,副檔名通常是 .zip。 下載修正程式檔案之後,您可以利用 Installation Manager,以修正套件來更新 WebSphere Application Server Liberty Core。
- 如果要下載修正套件,請執行下列動作:
- 前往修正程式中心。
- 選取 WebSphere 作為產品群組。
- 選取 WebSphere Application Server 作為產品。
- 選取已安裝的版本。
- 選取您的作業系統作為平台,然後按一下繼續。
- 選取瀏覽並找出修正程式,然後按一下繼續。
- 選取您要下載的修正套件,然後按一下繼續。
- 選取下載選項,然後按一下繼續。
- 按一下我同意以同意條款。
- 按一下立即下載以下載修正套件。
- 以二進位格式,將壓縮的修正程式檔傳送到它們將安裝在其中的 IBM i 系統。
- 將壓縮的儲存庫檔案解壓縮到系統上的某個目錄中。
- 如果要從已下載的檔案安裝修正套件,請執行下列動作:
- 利用具備 *ALLOBJ 和 *SECADM 特殊權限的使用者設定檔來登入 IBM i 系統。
- 停止更新中的 WebSphere Application Server Liberty Core 安裝架構上的所有伺服器和應用程式。
- 在 CL 指令行上,執行 STRQSH 指令,以啟動 Qshell 指令 Shell。
- 確定 umask 已設為 022。如果要驗證 umask 設定,請發出下列指令:
如果要將 Umask 設定設為 022,請發出下列指令:umask
umask 022
- 切換至 Installation_Manager_binaries/eclipse/tools 目錄,其中 Installation_Manager_binaries 是 Installation Manager 的安裝根目錄。
在 IBM i 系統上,Installation Manager 的根目錄是 /QIBM/ProdData/InstallationManager。
- 安裝修正套件。
./imcl install offering_ID_offering_version,optional_feature_ID -repositories location_of_expanded_files -installationDirectory offering_installation_location -acceptLicense
提示:- offering_ID 是支援的作業系統適用的 WebSphere Application Server 產品供應項目中所列出的供應項目 ID。
- 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。
- 您可以新增以逗點區隔的特性清單。
- 您可以指定要從「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
若為 8.5.5.5 版及更新版本,不需要 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,來安裝資產。如果資產無法使用,就會從 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
- 如果您透過安裝 WebSphere Application Server 群組 PTF 來取得修正套件,您可以利用本端修正套件儲存庫來安裝修正套件。
如需本端修正套件儲存庫的相關資訊,請參閱 /QIBM/WAS/WASFixpacks/ReadmeV85.html 或 /QIBM/WAS/WASFixpacks/ReadmeV85.txt 檔。
- 選用項目: 列出已安裝的所有套件,以驗證安裝:
./imcl listInstalledPackages -long
- 如果要下載修正套件,請執行下列動作:
- 存取包含修正套件的現用服務儲存庫,然後使用 Web 型更新。