#はじめに
さて、唐突ですが、 WebSphere Application Server ND Edge Component の導入です。
Edge Component は WebSphere Application Server (WAS) の ND版に付属の
ソフトウェアロードバランサーです。
ロードバランサーといえば、 Big-IP が （私の中では）有名ですが
この Edge Component、 WAS ND を買えばそのライセンスに含まれる、ということで
場合によってはお安くご利用いただけます。
なぜ今導入するのか？ と言うと、 一つ目の理由は「たまたま」です。
二つ目は IPv4 向け Load Blancer が 2019年9月30日にサポート終了するためです。
IPv4 向け Load Balancer がサポート終了なら、
今後は IPv6 のみか！ と思うかもしれませんが、
IPv4 and IPv6 Load Balancer というのが継続して存在しますので
IPv4 の方ご心配なく。名前、紛らわしいですね。。。
なお、 IPv4 向けを LLB (Legacy Load Balancer), IPv4 and IPv6 向けを ULB (User-mode Load Balancer) というようです。
重要なお知らせ - 2019年9月30日をもって、IPv4向けLoad Balancerのサポートが終了します
https://www-01.ibm.com/support/docview.wss?uid=ibm10733183
今回、 この Edge Component の基本的な機能 ( Load Balancer , Dispatcher ) を
コマンドだけで入れてしまう、という作業の説明です。
たまたま GUI がつかえない環境だったため、 コマンドで入れる方法を調べたのですが
意外と早くできるので、次にやるときのためにまとめておきます。
#環境
関連する SW のバージョンは以下のとおりです。
- AIX 7.2 TL02 SP02
- WebSphere ND Edge Component v9.0 FP9
#導入の流れ
導入の大まかなステップは以下のとおりです。
- メディアの準備
- ファイルシステムの作成
- IBM Installation Manager (IIM) の導入
- Edge + Java8 の導入
- FixPack の適用
FixPack 適用後、 設定等に入るのですが、 今日は 導入・FP適用までで一旦終了です。
#メディアの準備
Edge Component 自体は、IBM の Passport Advantage (PA) サイトからダウンロードします。
では、何をダウンロードすればよい？ という話がやや面倒ですね。
いつも、 結局何をダウンロードするんだっけ？ という話になることが多いです。
WAS に関しては、 以下のサイトで 各種コンポーネントの Part Number が記載されていますので
それを参考に PA サイトからダウンロードしてください。
今回は Edge Component の中でも基本的な Load Balancer を入れますので、
以下の２つになります。
- IBM WebSphere Edge Components: Load Balancer for IPv4 and IPv6 (for WebSphere Application Server Network Deployment V9.0.0) ( Part Number : CND1SML )
- IBM SDK, Java™ Technology Edition, Version 8 for AIX ( Part Number : CND16ML)
次に、 FixPack のダウンロードです。
FixPack は IBM の Fix Central からダウンロード可能です。
ただ、WAS の場合、以下のページにエディションごと、バージョンごとに整理されていますので
そこからたどるのが良いと思います。
Recommended updates for WebSphere Application Server
今回ダウンロードするのは、FixPack 9 、以下のものになります。
IBM WebSphere Edge Load Balancer for IPv4 and IPv6 : 9.0.0-WS-EDGEULB-FP009.zip
また、 同じ場所から Java8 SDK のFix もダウンロードできますのであわせてダウンロードしておきましょう
ダウンロードしたものを、サーバー上に upload し、 zip を展開しておきます。
（余談ですが、もう 「解凍」 とは言わないみたいですね。。。）
以下の例では、 NFS サーバー上に配置、展開し、導入先サーバーの /mnt にマウントした状態で作業を進めています。
#ファイルシステムの作成
ファイルシステムに関しては、 やや好みの問題、という側面がありますね。
導入できればいいや！ であれば /usr, /opt の容量があれば良いです。
厳密には System Requirements で調べる必要がありますが、 まぁ 2～3GB ぐらい？
今回は、 AIX 上でファイルシステムを作成し、そこに導入しました。
ファイルシステムの作成も、 AIX の smit メニューからやってもよいのですが
コマンドで実行です。
| マウントポイント | LV 名 | サイズ | PP数 | 備考 |
|---|---|---|---|---|
| /opt/IBM/InstallationManager | IIM_LV | 512MB | 16 | IIM用 |
| /usr/IBM/IMShared | IMShared_LV | 2GB | 64 | WAS 共通コンポーネント用 |
| /opt/IBM/WebSphere/Edge | Edge_LV | 512MB | 16 | Edge Component 用 |
PP数は、 該当ファイルシステムのサイズと、そのファイルシステムが所属する VG の PP size から算出できます。PP size は lsvg -l VG名 で確認できます。
ファイルシステムの作成は、 LV 作成 → ファイルシステム作成 → マウント の順で対応します。
mklv -y IMShared_LV -t jfs2 rootvg 64
crfs -v jfs2 -d IMShared_LV -m /usr/IBM/IMShared -A yes
mount /usr/IBM/IMShared
マウントポイントに関しては、 製品のデフォルトです。
（なお、 ３番目のファイルシステムは v9 から場所が変わっていますかね。。？）
#IBM Installation Manager (IIM) の導入
IIM について記載を忘れていましたね。
Edge Component だけではなく、 IBM のさまざまなソフトウェアを導入する際に使う
導入・更新の管理ソフトです。
IIM の入手はこちら
Installation Manager and Packaging Utility download documents
これも、他のメディア同様、展開しておきます。
展開したディレクトリを /mnt/IIM189/IIM189 とします。
そこから、コマンドでインストールします。
# cd /mnt/IIM189/IIM189
# ls
Offerings groupinstc installc.ini readme.html userinst
con-disk-set-inst.sh groupinstc.ini jre_7.0.100030.20181001_1448 repository.config userinst.ini
configuration install license repository.xml userinstc
documentation install.ini native silent-install.ini userinstc.ini
groupinst install.xml p2 tools
groupinst.ini installc plugins user-silent-install.ini
# ./installc -acceptLicense -log /mnt/IIM189/iim_inst.log
/opt/IBM/InstallationManager/eclipse ディレクトリーに com.ibm.cic.agent_1.8.9002.20181015_1517 がインストールされました。
。。。あっさりですね。
#Edge + Java8 の導入
Edge, Java8 に関しては、 同時に入れる必要があります。（Edge内でJava を使うため）
導入自体は IIM を使って行います。
IIM は 通常は GUI のツールとして使いますが、 今回は GUI がつかえない環境だったため
コマンドライン (CLI) で導入しました。
まず、作成したファイルシステム /usr/IBM/IMShared と /opt/IBM/WebSphere/Edge 内の
lost+found ディレクトリを削除します。
インストール時にご丁寧に中が空か確認するようです。
IIM のコマンドから導入を行うにあたり、 いくつか確認等を行う必要がありますが、
それも IIM のコマンドですべて行います。
■ 導入可能なパッケージの確認
# cd /opt/IBM/InstallationManager/eclipse/tools
# ./imcl listAvailablePackages -repositories /mnt/Edge90/edge9000,/mnt/Edge90FP9/EdgeULB90_FP9,/mnt/Java8/java8_8030
com.ibm.websphere.EDGELBIPV4IPV6.v90_9.0.0.20160526_1939
com.ibm.websphere.EDGELBIPV4IPV6.v90_9.0.9.20180906_1032
com.ibm.java.jdk.v8_8.0.3000.20160526_1317
imcl が IIM のコマンドラインツールです。
listAvailablePackage オプションで導入可能なパッケージをリストします。
その際、 -repositories オプションで、ダウンロードしたメディア（リポジトリ）のディレクトリを コンマ区切りで指定します。
「メディア（リポジトリ）のディレクトリ」というのは正確には、 展開したディレクトリ内の repository.xml があるディレクトリです。
この例では、 以下の３つのリポジトリを指定しています。
| ディレクトリ | メディア |
|---|---|
| /mnt/Edge90/edge9000 | Edge v9 ディレクトリ |
| /mnt/Edge90FP9/EdgeULB90_FP9 | Edge v9 FP9 ディレクトリ |
| /mnt/Java8/java8_8030 | Java8 ディレクトリ |
以下の例では、 レスポンスファイルを作成して導入していますが、
imcl で直接インストールも可能です。 その際、Package 名を指定する必要があるため、上記コマンドで確認しておきます。
■レスポンスファイル作成
別のサーバーにも同じ形で導入する場合、レスポンスファイルという導入指示のためのファイルを
作成しておくと便利なケースがあります。 （今回はそうでもないですが）
# ./imcl generateResponseFile -repositories /mnt/Edge90/edge9000,/mnt/Edge90FP9/EdgeULB90_FP9,/mnt/Java8/java8_8030 -output /mnt/Edge90/response_files/response.xml
応答ファイル /mnt/Edge90/response_files/response.xml を生成しました
-output オプションでファイルの出力先を指定します。
内容は以下のような内容です。
<agent-input>
<variables>
<variable name='sharedLocation' value=''>
<if name='platform:os' equals='win32' value='${specialFolder:PROGRAM_FILES}\IBM\IMShared'/>
<if name='platform:os' equals='win32_vista' value='${specialFolder:PROGRAM_FILES}\IBM\IMShared'/>
<if name='platform:os' equals='linux' value='/opt/IBM/IMShared'/>
<if name='platform:os' equals='solaris' value='/opt/IBM/IMShared'/>
<if name='platform:os' equals='aix' value='/usr/IBM/IMShared'/> <!-- AIX の場合 /usr/IBM/IMShared が指定されています -->
<if name='platform:os' equals='hpux' value='/opt/IBM/IMShared'/>
</variable>
<!-- フィーチャーの対応するセットをインストールするには、features を「required」、「default」、または「all」に設定します。 -->
<variable name='features' value='default'/>
<!-- インストール・ロケーション: -->
<!-- IBM WebSphere Edge Components: Load Balancer for IPV4 and IPV6 -->
<!-- IBM SDK, Java Technology Edition, Version 8 -->
<variable name='installLocation' value=''>
<if name='platform:os' equals='win32' value='${specialFolder:PROGRAM_FILES}\IBM\WebSphere\Edge\ULB'/>
<if name='platform:os' equals='win32_vista' value='${specialFolder:PROGRAM_FILES}\IBM\WebSphere\Edge\ULB'/>
<if name='platform:os' equals='linux' value='/opt/IBM/WebSphere/Edge/ULB'/>
<if name='platform:os' equals='solaris' value='/opt/IBM/WebSphere/Edge/ULB'/>
<if name='platform:os' equals='aix' value='/opt/IBM/WebSphere/Edge/ULB'/>
<if name='platform:os' equals='hpux' value='/opt/IBM/WebSphere/Edge/ULB'/>
</variable>
<!-- IBM WebSphere Edge Components: Load Balancer for IPV4 and IPV6 のフィーチャー -->
<variable name='features.com.ibm.websphere.EDGELBIPV4IPV6.v90'>
<!--
必須フィーチャー:
LoadBalancer: Load Balancer
-->
<if name='features' equals='required' value='LoadBalancer'/>
<!--
デフォルト・フィーチャー:
Dipatcher: Dispatcher
-->
<if name='features' equals='default' value='LoadBalancer,Dipatcher'/>
<!--
デフォルト以外のフィーチャー:
MetricServer: Metric Server
SiteSelector: Site Selector
-->
<if name='features' equals='all' value='LoadBalancer,Dipatcher,MetricServer,SiteSelector'/>
</variable>
<!-- IBM SDK, Java Technology Edition, Version 8 のフィーチャー -->
<variable name='features.com.ibm.java.jdk.v8'>
<!--
必須フィーチャー:
com.ibm.sdk.8: IBM SDK, Java Technology Edition, Version 8
-->
<if name='features' equals='required' value='com.ibm.sdk.8'/>
<!-- デフォルト・フィーチャー: -->
<if name='features' equals='default' value='com.ibm.sdk.8'/>
<!-- デフォルト以外のフィーチャー: -->
<if name='features' equals='all' value='com.ibm.sdk.8'/>
</variable>
</variables>
<server>
<repository location='file:/mnt/Edge90/edge9000/'/>
<repository location='file:/mnt/Java8/java8_8030/'/>
</server>
<preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='${sharedLocation}'/>
<profile id='Load Balancer for IPV4 and IPV6' installLocation='${installLocation}'/>
<install>
<!-- IBM WebSphere Edge Components: Load Balancer for IPV4 and IPV6 9.0.0.0 -->
<offering profile='Load Balancer for IPV4 and IPV6' id='com.ibm.websphere.EDGELBIPV4IPV6.v90' version='9.0.0.20160526_1939' features='${features.com.ibm.websphere.EDGELBIPV4IPV6.v90}'/>
<!-- IBM SDK, Java Technology Edition, Version 8 8.0.3.0 -->
<offering profile='Load Balancer for IPV4 and IPV6' id='com.ibm.java.jdk.v8' version='8.0.3000.20160526_1317' features='${features.com.ibm.java.jdk.v8}'/>
</install>
</agent-input>
細かく見ると、 AIX の場合は Shared File などは /usr/IBM/IMShared に導入される、とか
デフォルトで導入されるパッケージ名などが記載されていることが分かります。
場合によっては、これを編集する、ということもあるかもしれません。
■ Edge Component の導入
作成したレスポンスファイルを用いて導入です。
# ./imcl input /mnt/Edge90/response_files/response.xml -log /tmp/edge_inst.log -acceptLicense
/opt/IBM/WebSphere/Edge/ULB ディレクトリーに com.ibm.websphere.EDGELBIPV4IPV6.v90_9.0.0.20160526_1939 がインストールされました。
/opt/IBM/WebSphere/Edge/ULB ディレクトリーに com.ibm.java.jdk.v8_8.0.3000.20160526_1317 がインストールされました。
なお、ここではレスポンスファイルを用いましたが、
レスポンスファイルを作らずに、直接インストールすることも出来ます。
コマンドの書式は以下のとおりです。（詳細は末尾リンク先のマニュアル参照）
imcl install packageID[_version][,featureID]
-repositories source_repository
-acceptLicense
■ バージョンの確認
以下のコマンドで、バージョンの確認を行います。
# ./imcl listInstalledPackages
com.ibm.cic.agent_1.8.9002.20181015_1517
com.ibm.java.jdk.v8_8.0.3000.20160526_1317
com.ibm.websphere.EDGELBIPV4IPV6.v90_9.0.0.20160526_1939
Edge IPv4 and IPv6 の 9.0.0 が導入されていることが （なんとか）分かります。
#FixPack の導入
FixPack に関しても、基本的には導入のときとほぼ同じ感じです。
ただ、レスポンスファイルは使わず、 imcl updateAll でアップデートします。
# ./imcl updateAll -repositories /mnt/Edge90FP9/EdgeULB90_FP9 -acceptLicense
/opt/IBM/WebSphere/Edge/ULB ディレクトリー内で com.ibm.websphere.EDGELBIPV4IPV6.v90_9.0.9.20180906_1032 に更新されました。
同様にバージョンを確認します。
# ./imcl listInstalledPackages
com.ibm.cic.agent_1.8.9002.20181015_1517
com.ibm.java.jdk.v8_8.0.3000.20160526_1317
com.ibm.websphere.EDGELBIPV4IPV6.v90_9.0.9.20180906_1032
かろうじて v9.0.9 になっているのが分かります。
Java8 についても同様にアップデートしますが、やり方は同じですので割愛します。
以上で、 Edge Component をコマンドで入れる方法のまとめはおしまいです。
どこかの誰かが少しでも助かれば幸いです！
#参考
■Passport Advantage (PA)
https://www.ibm.com/software/jp/passportadvantage/pao.html
■V9.0: Download WebSphere Application Server Network Deployment Version 9 from Passport Advantage Online
https://www-01.ibm.com/support/docview.wss?uid=swg27048323
■Recommended updates for WebSphere Application Server
https://www-01.ibm.com/support/docview.wss?uid=swg27004980
■Installing Edge Components with IBM Installation Manager
https://www.ibm.com/support/knowledgecenter/SSAW57_9.0.0/com.ibm.websphere.edge.doc/concepts/installing.html
■imcl コマンドを使用して応答ファイルを生成
https://www.ibm.com/support/knowledgecenter/ja/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_imcl_generate_response_file.html
■imcl コマンドのコマンド行引数
https://www.ibm.com/support/knowledgecenter/ja/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/r_tools_imcl.html
■imcl コマンドの使用によるパッケージのインストール
https://www.ibm.com/support/knowledgecenter/ja/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_imcl_install.html
■Installation Managerのimclコマンドを使用してインストール可能なパッケージやiFixを確認する方法
https://www-01.ibm.com/support/docview.wss?uid=swg21684638
■imcl コマンドを使用した、すべてのインストール済みパッケージの更新
https://www.ibm.com/support/knowledgecenter/ja/SSDV2W_1.8.0/com.ibm.cic.commandline.doc/topics/t_imcl_updateall.html