Installation Manager の応答ファイルを使用して、WebSphere® Application Server
Liberty を新しいバージョンに更新できます。
始める前に
重要: 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 バージョンを使用できます。
ローカル・ディレクトリー・ベースのリポジトリー、または
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 コマンドを実行して確認できます。
手順
- オプション: リポジトリーにユーザー名とパスワードが必要な場合は、このリポジトリーにアクセスするためのクレデンシャル・ストレージ・ファイルを作成します。
ヒント: クレデンシャル・ストレージ・ファイルを作成するときに、指定されたリポジトリーの URL を imutilsc コマンドで検出できない場合には、リポジトリーの URL のロケーションの末尾に /repository.config を追加します。
- *ALLOBJ および *SECADM 特殊権限のあるユーザー・プロファイルを使用して、IBM i システムにサインオンします。
- CL コマンド行で STRQSH コマンドを
実行して、Qshell コマンド・シェルを開始します。
- 応答ファイルを使用して、この製品を更新します。
Installation Manager をインストールしたディレクトリーの
eclipse/tools サブディレクトリーに移動して、製品を更新します。
以下に例を示します。
./imcl -acceptLicense
input $HOME/WASFiles/temp/update_response_file.xml
-log $HOME/WASFiles/temp/update_log.xml
-secureStorageFile $HOME/WASFiles/temp/credential.store -masterPasswordFile $HOME/WASFiles/master_password_file.txt
注: プログラムが重要なポストインストール指示を標準出力に書き込むことがあります。
Installation Manager の使用について詳しくは、 IBM Installation
Manager 製品の資料を参照してください。
例
以下に、
WebSphere Application Server
Liberty を新しいバージョンに更新するための応答ファイルの例を示します。
<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
<server>
<repository location='https://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.ND'/>
</server>
<profile id='WebSphere Liberty' installLocation='/QIBM/ProdData/WebSphere/Liberty/ND'>
<data key='was.install.os400.profile.location' value='/QIBM/UserData/WebSphere/Liberty/ND'/>
</profile>
<install modify='false'>
<offering profile='WebSphere Liberty' id='com.ibm.websphere.liberty.ND'
version='16.0.2.20161025_2108'/>
</install>
<preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='/QIBM/UserData/InstallationManager/IMShared'/>
</agent-input>
ヒント: - プロファイル ID (<profile . . . id='profile_ID'
. . . .> および <offering . . . profile='profile_ID'
. . . .>) は、Installation Manager をインストールしたディレクトリーの eclipse/tools サブディレクトリーから imcl listInstallationDirectories -verbose コマンドを実行すると表示されます。これは、パッケージ・グループの名前と同じです。
- version は、インストールするオファリングの特定のバージョンです (例えば、16.0.2.20161025_2108)。この指定はオプションです。
- version が指定されていない場合、最新バージョンのオファリングとそのバージョンのすべてのインテリム・フィックスがインストールされます。
- version が指定されている場合、指定されたバージョンのオファリングがインストールされ、そのバージョンのインテリム・フィックスはインストールされません。
オファリング・バージョンは、リポジトリーに対して以下のコマンドを実行した場合に、オファリング ID の最後にアンダースコアー付きで追加されています。
./imcl listAvailablePackages -repositories repository_URL_or_path
- どのインテリム・フィックスをオファリングと共にインストールするかを示す -installFixes 引数に、none、recommended、または all を指定することもできます。
- オファリング・バージョンが指定されていない場合、-installFixes オプションは、デフォルトの all に設定されます。
- オファリング・バージョンが指定されている場合、-installFixes オプションは、デフォルトの none に設定されます。
- WebSphere Application Server グループ PTF をインストールすることによってフィックスパックを入手した場合、ローカル・フィックスパック・リポジトリーを使用して、このフィックスパックをインストールできます。
ローカル・フィックスパック・リポジトリーについては、ファイル /QIBM/WAS/WASFixpacks/Readme.html または /QIBM/WAS/WASFixpacks/Readme.txt を参照してください。
New: Liberty を更新する場合、すべてのインストール済み Liberty アドオンとフィーチャーが
更新されます。
応答ファイルに data エレメントを追加して、追加フィーチャーをインストールできます。フィーチャーをインストールするには、user.feature パラメーターでシンボル名またはショート・ネームを指定します。アドオンをインストールするには、data を追加し、user.addon パラメーターでショート・ネームを指定します。
以下の例は、シンボル名を使用してポートレット・コンテナー・フィーチャーを、短い名前を使用してポートレット・サービス・フィーチャーを、そして拡張プログラミング・モデル・アドオンをインストールします。
<data key='user.feature' value='com.ibm.websphere.appserver.portlet-2.0,,portletserving-2.0'/>
<data key='user.addon' value='extendedPackage-1.0'/>
<data key='user.accept.license' value='true'/>
アセットのインストールは、インターネット・アクセスがあってもなくても、
Liberty Asset Repository Service のインスタンスから、またはローカル・ディレクトリー・ベースのリポジトリーから行うことも可能です。
詳しくは、
Installation Manager を使用したアセットのインストールを参照してください。リポジトリー URL、ディレクトリー、またはアーカイブ・パスを
repository エレメントに追加してください。Installation Manager がリポジトリーを認識しない場合は、
repository.config ファイルを直接指し示してください。
アセットをインストールする時、リポジトリーは指定された順序でアクセスされます。
<server>
<repository location="http://www.ibm.com/software/repositorymanager/com.ibm.websphere.liberty.ND.v85" />
<repository location="https://your_onprem_asset_repo_url" />
<repository location="D:¥IBM¥LocalAssetRepo" />
<repository location="D:¥IBM¥LocalAssetRepo2.zip" />
</server>
Liberty リポジトリーへのアクセスを使用可能にするには、
data エレメントで
user.useLibertyRepository パラメーターを
true に設定します。
Liberty リポジトリーは、インストール中にアクセスされるリポジトリーのうち最後のリポジトリーです。
<data key='user.useLibertyRepository' value='true'/>
Liberty リポジトリーと含まれるアセットについて詳しくは、『Liberty リポジトリー』を参照してください。
- オプションの組み込み可能 EJB コンテナーおよび JPA クライアント・フィーチャー (embeddablecontainer) を追加するには、オファリングにそのフィーチャーを追加します。以下に例を示します。
<offering id='com.ibm.websphere.liberty.ND'
profile='WebSphere Liberty'
features='embeddablecontainer' installFixes='none'/>
フィーチャーが既存のインストール済み環境にインストールされている場合は、更新時に応答ファイルにそのフィーチャーが含まれている必要があります。フィーチャーを応答ファイルに追加しなかった場合、Installation Manager によってそのフィーチャーは削除されます。