製品フィックスパックには、WebSphere® Application Server
Liberty Core を新しい製品レベルに上げるためのバンドル済みサービスが含まれています。インテリム・フィックスでは、特定の既知の問題に対する修正サービスを提供します。
IBM® Installation Manager のコマンド行機能を使用して、WebSphere Application Server
Liberty Core インストール済み環境のご使用のサービス・レベルで利用できるフィックスで、本製品を更新することができます。
始める前に
重要: WebSphere Liberty での Java™ SE 6 の使用に対するサポートは、2017 年 9 月に終了しました。Liberty カーネルは 17.0.0.3 で再コンパイルされました。17.0.0.3 以降、Java SE 6 を使用して Liberty カーネルを実行することはできなくなりました。サポート終了日より後に、旧リリースで Java SE 6 を使用し続けると、環境がセキュリティー・リスクにさらされる可能性があります。
Java SE 8 は、最新の機能とセキュリティー更新を備えているため、これが推奨 Java SDK となります。Java SE 8 の代わりに、サポートされている任意の Java SDK バージョンを使用できます。
WebSphere Application Server for IBM i の更新については、IBM ソフトウェア・サポート・センターにお問い合わせください。
最新の情報は、IBM ソフトウェア・サポート・センターおよび Fix Central から入手できます。
IBM Installation Manager バージョン 1.8.5 以降を使用して、WebSphere Application Server for IBM i に対する製品保守を適用します。
ローカル・ディレクトリー・ベースのリポジトリー、または
Liberty Asset Repository Service のインスタンスから Liberty アセットをインストールする場合は、リポジトリーを構成します。
Liberty アセット・リポジトリーについて詳しくは、『Installation Manager を使用したアセットのインストール』を参照してください。
ヒント: Installation Manager では、この項目で説明する手順を実行する代わりに、応答ファイルまたはコマンド行で updateAll コマンドを実行して、すべてのインストール済みパッケージを検索したり更新したりできます。このコマンドは、どのフィックスをどのターゲット・リポジトリーに入れるかに関する完全な管理権限を持つ場合にのみ使用してください。
インストールしたい特定のフィックスだけが含まれた 1 組みのカスタム・リポジトリーを作成してこれを指示する場合に、このコマンドを確実に使用できる必要があります。
サービス・リポジトリーの検索を使用可能に設定している場合、または別のライブ Web ベース・リポジトリーから直接フィックスをインストールする場合は、このオプションは選択しないことをお勧めします。オプションを選択しないと、コマンド行から install コマンドの -installFixes オプションを使用してインストールするフィックスか、または応答ファイルの installFixes 属性を使用してインストールするフィックスのみが選択可能になります。
このタスクについて
システムに新規フィックスパックを適用するときには、必ず以下の手順を使用してください。
New: フィックスパック 16.0.0.2 は 8.5.5.9 後の次の Liberty フィックスパックです。Liberty フィックスパックの番号付けおよび配布の変更点について詳しくは、『Liberty のこのリリースでの新機能』を参照してください。
フィックスパックをインストールすると、インストール済みのインテリム・フィックスが、更新されたフィックスパック・レベルに適用される場合、Installation Manager はそれらを自動的に再適用します。更新されたフィックスパックにフィックスが含まれている場合など、適用されないインテリム・フィックスはアンインストールされます。場合によっては、Installation Manager は、ユーザーが手動で再適用する必要があるインテリム・フィックスをアンインストールしなければならないことがあります。例えば、フィックスを含んでおらず、更新されたインテリム・フィックス・レベルを必要とするフィックスパックに更新する場合があります。手動で再適用する必要があるインテリム・フィックスがある場合、Installation Manager はユーザーに通知します。どのインテリム・フィックスがインストールされているかは、productInfo version --ifixes コマンドを実行して確認できます。
手順
- WebSphere Application Server
Liberty Core インストール済み環境で利用できるフィックスのリスト、および各フィックス固有の情報を入手するには、以下の操作を実行します。
- Fix
Central にアクセスします。
- 「製品の検索 (Find product)」をクリックします。
- 製品グループとして「WebSphere Liberty」を選択します。
- 更新する製品のバージョンを選択します。
- プラットフォームとして「IBM i」を選択し、「次へ進む」をクリックします。
- 「フィックスの参照」を選択して、「次へ進む」をクリックします。
- フィックス・タイプとして「フィックスパック」を選択し、「サブミット」をクリックします。
- 各フィックスの下の「詳細情報」をクリックすると、フィックスに関する情報が表示されます。
- 推奨: インストールするフィックスパックの名前のメモを作成します。
- 以下のいずれかの手順を使用して、WebSphere Application Server
Liberty Core インストール済み環境をフィックスパックで更新します。
- フィックスパックが含まれたライブ・サービス・リポジトリーにアクセスして、Web ベースの更新を使用します。
ローカル・システムで Installation Manager を使用して、ライブ Web ベース・サービス・リポジトリーからのインテリム・フィックスで
WebSphere Application Server
Liberty Core を更新します。
- ライブ・サービス・リポジトリーの場合、インストール時に一般出荷可能な製品オファリング・リポジトリー用に使用される URL と同じものを使用します。
これらの URLは、Liberty オファリング用のオンライン製品リポジトリーでリストされています。
- これらのロケーションには、Web ブラウザーを使用してアクセスできる Web ページはありません。
これらは、Installation Manager で製品を保守できるように、これに指定する Web ベースのリモート・リポジトリーのロケーションです。
サービス・リポジトリーからフィックスをインストールするには、以下の操作を実行します。
- IBM ソフトウェアのユーザー ID とパスワードが含まれる Installation Manager のクレデンシャル・ストレージ・ファイルとマスター・パスワード・ファイルがまだない場合は、これらのファイルを作成します。これらのファイルを作成すると、リポジトリーにアクセスできるようになります。
注: これらは、保護された IBM ソフトウェア Web サイトにアクセスするために使用するクレデンシャルです。
Installation Manager 用のクレデンシャル・ストレージ・ファイルおよびマスター・パスワード・ファイルの作成については、IBM Installation Manager の製品資料を参照してください。ヒント: クレデンシャル・ストレージ・ファイルを作成するときに、指定されたリポジトリーの URL を imutilsc コマンドで検出できない場合には、リポジトリーの URL のロケーションの末尾に /repository.config を追加します。
- *ALLOBJ および *SECADM 特殊権限のあるユーザー・プロファイルを使用して、IBM i システムにサインオンします。
- 更新対象の WebSphere Application Server
Liberty Core インストール済み環境で、すべてのサーバーおよびアプリケーションを停止します。
- CL コマンド行で STRQSH コマンドを実行して、Qshell コマンド・シェルを開始します。
- umask が 022 に設定されていることを確認します。
umask 設定を確認するには、以下のコマンドを実行します。
umask
umask 設定を 022 に設定するには、以下のコマンドを実行します。
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 repository_URL_or_path
-installationDirectory offering_installation_location
-secureStorageFile storage_file -masterPasswordFile master_password_file
-acceptLicense
ヒント: New: Liberty を更新する場合、すべてのインストール済み Liberty アドオンとフィーチャーが
更新されます。
追加のアドオンとフィーチャーは、以下の例で示されるように、
user.addon および user.feature プロパティーに指定することでインストールできます。フィーチャーの短い名前またはシンボリック名は、次のように 2 個のコンマで区切られることに注意してください。./imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer
-properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
-installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore -acceptLicense
-repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo,/QIBM/LocalAssetRepo2.zip
-sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
-showProgress
アセットのインストールは、インターネット・アクセスがあってもなくても、Liberty Asset Repository Service のインスタンスから、またはローカル・ディレクトリー・ベースのリポジトリーから行うことも可能です。リポジトリー URL、ディレクトリー・パス、またはアーカイブ・ファイル・パスを -repositories パラメーターに追加してください。リポジトリーは、指定された順序でアクセスされます。これらのアセット・リポジトリーについて詳しくは、『Installation Manager を使用したアセットのインストール』を参照してください。IBM WebSphere Liberty Repository からアセットをインストールするには、インターネットへのアクセスが必要です。Liberty Repository へのアクセスを有効にするには、-properties パラメーターで user.useLibertyRepository オプションを true に設定します。
Liberty Repository は、インストール中にアクセスされるリポジトリーのうち最後のリポジトリーです。
- offering_ID は、サポートされるオペレーティング・システム用の Liberty 製品オファリングにリストされているオファリング ID です。
- オファリング ID にアンダースコアー付きで追加可能な (オプション) offering_version は、インストール対象のオファリングの特定のバージョンを表します。(例えば、16.0.2.20160503_0200 など)。
- offering_version が指定されていない場合、最新バージョンのオファリングとそのバージョンのすべてのインテリム・フィックスがインストールされます。
- offering_version が指定されている場合、指定されたバージョンのオファリングがインストールされ、そのバージョンのインテリム・フィックスはインストールされません。
オファリング・バージョンは、リポジトリーに対して以下のコマンドを実行した場合に、オファリング ID の最後にアンダースコアー付きで追加されています。
./imcl listAvailablePackages -repositories repository_URL_or_path
- どのインテリム・フィックスをオファリングと共にインストールするかを示す -installFixes 引数に、none、recommended、または all を指定することもできます。
- オファリング・バージョンが指定されていない場合、-installFixes オプションは、デフォルトの all に設定されます。
- オファリング・バージョンが指定されている場合、-installFixes オプションは、デフォルトの none に設定されます。
- 組み込み可能 EJB コンテナーおよび JPA クライアントをインストールするには、オファリング ID の後に、任意の
embeddablecontainer フィーチャーをコンマで区切って指定します。
組み込み可能 EJB コンテナーは、
スタンドアロンの Java Platform, Standard Edition
(SE) 環境でエンタープライズ Bean を実行するのに使用できる Java Archive (JAR) ファイルです。この組み込み可能コンテナーを使用して、アプリケーション・サーバーの外部でエンタープライズ Bean を実行できます。組み込み可能 EJB コンテナーは、EJB 3.1 仕様の一部であり、主に単体テストのエンタープライズ Bean のビジネス・ロジックに使用されます。
組み込み可能 EJB コンテナーと共に JPA クライアントを使用すると、Java SE 環境で Java Persistence API 機能を使用できるようになります。
- WebSphere Application Server グループ PTF をインストールすることによってフィックスパックを入手した場合、ローカル・フィックスパック・リポジトリーを使用して、このフィックスパックをインストールできます。
ローカル・フィックスパック・リポジトリーについては、ファイル /QIBM/WAS/WASFixpacks/Readme.html または /QIBM/WAS/WASFixpacks/Readme.txt を参照してください。
- オプション: 以下により、すべてのインストール済みパッケージをリストしてインストールを確認します。
./imcl listInstalledPackages -long
- Fix Central からフィックスパックが含まれたファイルをダウンロードして、ローカル更新を使用します。
Fix Central からフィックスパックが含まれた圧縮ファイルをダウンロードできます。
圧縮された個々のフィックス・ファイルには、フィックスパック用の Installation Manager リポジトリーが含まれており、通常 .zip の拡張子が付いています。
フィックス・ファイルをダウンロードすると、Installation Manager を使用して
WebSphere Application Server
Liberty Core をこのフィックスパックで更新することができます。
- フィックスパックをダウンロードするには、以下の操作を実行します。
- Fix
Central にアクセスします。
- 「製品の検索 (Find product)」をクリックします。
- 製品グループとして「WebSphere Liberty」を選択します。
- インストールされているバージョンを選択します。
- プラットフォームで、使用するオペレーティング・システムを選択し、「次へ進む」をクリックします。
- 「フィックスの参照」を選択して、「次へ進む」をクリックします。
- ダウンロードするフィックスパックを選択して、「次へ進む」をクリックします。
- ダウンロード・オプションを選択して、「次へ進む」をクリックします。
- ご使用条件に同意する場合は、「同意します」をクリックします。
- 「今すぐダウンロード」をクリックして、フィックスパックをダウンロードします。
- 圧縮されたフィックス・ファイルを、それをインストールする各 IBM i システムにバイナリー形式で転送します。
- 圧縮されたリポジトリー・ファイルをシステム上の任意のディレクトリーに解凍します。
- ダウンロードしたファイルからフィックスパックをインストールするには、以下の操作を実行します。
- *ALLOBJ および *SECADM 特殊権限のあるユーザー・プロファイルを使用して、IBM i システムにサインオンします。
- 更新対象の WebSphere Application Server
Liberty Core インストール済み環境で、すべてのサーバーおよびアプリケーションを停止します。
- CL コマンド行で STRQSH コマンドを実行して、Qshell コマンド・シェルを開始します。
- umask が 022 に設定されていることを確認します。
umask 設定を確認するには、以下のコマンドを実行します。
umask
umask 設定を 022 に設定するには、以下のコマンドを実行します。
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
ヒント: New: Liberty を更新する場合、すべてのインストール済み Liberty アドオンとフィーチャーが
更新されます。
追加のアドオンとフィーチャーは、以下の例で示されるように、
user.addon および user.feature プロパティーに指定することでインストールできます。フィーチャーの短い名前またはシンボリック名は、次のように 2 個のコンマで区切られることに注意してください。./imcl install com.ibm.websphere.liberty.CORE.ND,embeddablecontainer
-properties user.addon=extendedPackage-1.0,user.feature=portlet-2.0,,portletserving-2.0
-installationDirectory /QIBM/ProdData/WebSphere/Liberty/LibertyCore -acceptLicense
-repositories /QIBM/LibertyProductRepo,https://your_onprem_asset_repo_url,/QIBM/LocalAssetRepo,/QIBM/LocalAssetRepo2.zip
-sharedResourcesDirectory /QIBM/UserData/InstallationManager/IMShared
-showProgress
アセットのインストールは、インターネット・アクセスがあってもなくても、Liberty Asset Repository Service のインスタンスから、またはローカル・ディレクトリー・ベースのリポジトリーから行うことも可能です。リポジトリー URL、ディレクトリー・パス、またはアーカイブ・ファイル・パスを -repositories パラメーターに追加してください。リポジトリーは、指定された順序でアクセスされます。これらのアセット・リポジトリーについて詳しくは、『Installation Manager を使用したアセットのインストール』を参照してください。IBM WebSphere Liberty Repository からアセットをインストールするには、インターネットへのアクセスが必要です。Liberty Repository へのアクセスを有効にするには、-properties パラメーターで user.useLibertyRepository オプションを true に設定します。
Liberty Repository は、インストール中にアクセスされるリポジトリーのうち最後のリポジトリーです。
- offering_ID は、サポートされるオペレーティング・システム用の Liberty 製品オファリングにリストされているオファリング ID です。
- オファリング ID にアンダースコアー付きで追加可能な (オプション) offering_version は、インストール対象のオファリングの特定のバージョンを表します。(例えば、16.0.2.20160503_0200 など)。
- offering_version が指定されていない場合、最新バージョンのオファリングとそのバージョンのすべてのインテリム・フィックスがインストールされます。
- offering_version が指定されている場合、指定されたバージョンのオファリングがインストールされ、そのバージョンのインテリム・フィックスはインストールされません。
オファリング・バージョンは、リポジトリーに対して以下のコマンドを実行した場合に、オファリング ID の最後にアンダースコアー付きで追加されています。
./imcl listAvailablePackages -repositories repository_URL_or_path
- どのインテリム・フィックスをオファリングと共にインストールするかを示す -installFixes 引数に、none、recommended、または all を指定することもできます。
- オファリング・バージョンが指定されていない場合、-installFixes オプションは、デフォルトの all に設定されます。
- オファリング・バージョンが指定されている場合、-installFixes オプションは、デフォルトの none に設定されます。
- 組み込み可能 EJB コンテナーおよび JPA クライアントをインストールするには、オファリング ID の後に、任意の
embeddablecontainer フィーチャーをコンマで区切って指定します。
組み込み可能 EJB コンテナーは、
スタンドアロンの Java Platform, Standard Edition
(SE) 環境でエンタープライズ Bean を実行するのに使用できる Java Archive (JAR) ファイルです。この組み込み可能コンテナーを使用して、アプリケーション・サーバーの外部でエンタープライズ Bean を実行できます。組み込み可能 EJB コンテナーは、EJB 3.1 仕様の一部であり、主に単体テストのエンタープライズ Bean のビジネス・ロジックに使用されます。
組み込み可能 EJB コンテナーと共に JPA クライアントを使用すると、Java SE 環境で Java Persistence API 機能を使用できるようになります。
- WebSphere Application Server グループ PTF をインストールすることによってフィックスパックを入手した場合、ローカル・フィックスパック・リポジトリーを使用して、このフィックスパックをインストールできます。
ローカル・フィックスパック・リポジトリーについては、ファイル /QIBM/WAS/WASFixpacks/Readme.html または /QIBM/WAS/WASFixpacks/Readme.txt を参照してください。
- オプション: 以下により、すべてのインストール済みパッケージをリストしてインストールを確認します。
./imcl listInstalledPackages -long