概要
検証のため、AIX 7.2 環境に WebSphere Application Server Liberty を CLI で構築した時の覚えがき
はじめに
この記事内で使用する略称について記載します。
| 略称 | 名称 |
|---|---|
| IIM | IBM Installation Manager |
| WAS Liberty | IBM WebSphere Application Server Liberty |
| IHS | IBM HTTP Server |
| Plugin | Web Server Plug-ins for WebSphere Application Server |
| IBM Docs | IBM Documentation (製品オンラインマニュアル) |
| FP | Fix Pack |
| FC | Fix Central |
この記事は下記 IBM Docs の手順を参考にインストールを行っています。
参考サイト:
- サポートされるオペレーティング・システム用の Liberty 製品オファリング
- Installation Manager のインストールおよび Liberty のインストールの準備
- コマンド行を使用した分散オペレーティング・システムでの Liberty のインストール
- IBM SDK, Java Technology Edition のインストール、更新、およびアンインストール
- Liberty Java ランタイム環境または Software Development Kit の更新
- Liberty のセットアップ
- plugin-cfg.xml ファイルの自動生成
おおまかな流れ:
- 前提条件の確認
1-1 . システム要件の確認
1-2 . インストールイメージの準備 - IIMのインストール
- Liberty インストール
- IBM Semeru Runtime Certified Edition インストール
- IHSのインストール
- Pluginのインストール
- サーバー作成
- Pluginの構成
- 動作確認
1. 前提条件の確認
1-1 . システム要件の確認
AIX 上で Liberty を使う際のシステム要件については、以下のサイトで確認することが出来ます。
WebSphere Application Server Detailed System Requirements (短縮URL)
この記事では、Liberty 23.0.0.9 を使用するため、下記の手順で確認を行いました。
1.IBM Software Product Compatibility Reports (SPCR) をクリックします。
2.SPCR画面が表示されるので、手順に沿って確認したい条件を選択します。
① Full or partial product name: の入力フィールドに、WebSphere Application Server とに入力します。
② 右の虫まねボタンを押します。
③ グレイアウトしていた Serach results: に検索した結果がプルダウンリストで表示されので、下矢印を選択し WebSphere Application Server Liberty をクリックします。
④ Version: のプルダウンリストが Select one: と変わるので、Show fix Packs のチェックボックスにチェックをつけます。下矢印を選択し 23.0.0.9 クリックします。
⑤ +Operating system platformsの+を選択して展開します。デフォルトは All platforms なのでチェックを外します。AIX のみ再度チェックを付けます。
以下のセクションも必要に応じでチェックを外します。
詳しくない場合はそのままデフォルトでも問題ないと思います。この記事ではそのままです。
+Product components
+Product Containers
+Capabilities
⑥ Submit ボタンを押します。
3. AIX に関する条件は、Operating Systems タブを確認します。AIX 7.2 は 23.0.0.9 でサポートされており、Notes列には AIX が稼働しているハードウェアごとに Java などの条件があるため、IBM WebSphere Application Server support on POWER hardware へのリンクが記載されています。使用するマシンの前提条件をこの文書で確認する必要があります。
4 . IHS および JDK に関する条件について Supported Software タブのWeb ServersとJava SDKを確認します。どちらも Notes 列に記載があるので内容を確認します。
5 . 今回、Java SDKは Semeru Runtimes を使用するので、以下のページのAIX systems セクションの内容も確認します。「Important: IBM Semeru Runtimes, Version 17 on AIX require the 16.1.0.7 or later, XL C++ Runtime」と記載されているため、条件を満たしているかの確認をする必要があります。
1-3 . インストールイメージの準備
1. 製品をインストールために必要なIIMをダウンロードする
1 . 以下のサイトにアクセスします。
Installation Manager and Packaging Utility download documents(短縮URL)
2 . 2023年9月29日現在、最新のIIM 1.9.2.5 の「Download document」をクリックします。
脆弱性の観点からその時点での最新を使用
3 .「Installation Manager 1.9.2.5」ページが表示されます。各プラットフォーム毎にリンクがあるので、この記事では AIX の行にある「FC」をクリックします。
4 . 2つ表示されていますが、１つ目はAIX版、２つ目はマルチプラットフォーム更新版です。この記事ではAIX版をダウンロードします。チェックを付けて「次へ進む」をクリックします。
5 . ここでIBM IDを求める画面が表示される場合があります。使用しているIBM IDを入力後「次へ」をクリックしログインします。
6 .「ダウンロード・オプションの選択」画面が表示された場合は、デフォルトでラジオボタンが「Download Director を使用したダウンロード」についていますが、この記事では「ブラウザー(HTTPS)を使用したダウンロードを選択し、「次へ進む」をクリックします。
7 .「agent.installer.aix.gtk.ppc_1.9.2005.20230718_1844.zip (203.97 MB)」のリンクをクリックしてファイルをダウンロードします。
2. 製品イメージをダウンロードする。
1 . 以下のサイトにアクセスします。
V9.0.5: Download WebSphere Application Server Version 9.0.5 from Passport Advantage Online(短縮URL)
2 . 製品のパーツ番号を確認します。この記事ではLiberty BASE版をインストールするため、表から「CC3NYML」であることがわかります。
3 . 以下のサイトにあるPAオンラインサイン・インの「サイン・インする」から WAS の有効な契約が紐づいているIBM IDを使ってPAオンラインに入ります。
IBM パスポート・アドバンテージ・オンライン（PA オンライン） - Japan PAO landing page customer and resellers
4 . ログオン後は2.で確認したパーツ番号「CC3NYML」で検索を行い、ヒットした製品イメージをダウンロードします。
PAオンラインの使用方法が不明な方は、上記画面イメージの一番下にある「ダウンロード & メディアの手引き (598KB)」をクリックし手引きをご参照ください。
この手順で、Liberty BASE製品イメージの was.repo.19009.liberty.base.zip がダウンロード出来ます。
3. 最新のFPをダウンロードする。
1 . 以下のサイトにアクセスします。
Recommended updates for WebSphere Application Server (短縮URL]
9.0.5.17: WebSphere Application Server traditional Version 9.0.5.17(短縮URL)
2 . 上記リンクにある以下のFPイメージをダウンロードします。FCからのダウンロード手順はほぼIIMのFCからのダウンロードと同じため、手順は省略します。
上記 9.0.5-WS-IHSPLG-FP017.zip をダンロードします。また IHS/Pluginをインストールする際に必要なIBM Java 8 を上記 IBM SDKリンク先からダウンロードします。
3 . 上記 IBM SDKのリンクを押下すると、以下のサイトが表示されます。
IBM SDK Java Technology Edition Version 8.0 for WebSphere Application Server V9 and WebSphere Liberty using Installation Manager (短縮URL)
2023年9月29日現在、8.0.8.10が最新Java 8のためこの記事ではこちらをダウンロードします。AIX 64-bit,pSeries のリンクをクリックし、ダウンロードします。FCからの手順は IIM,FPと同じため省略します。
この手順で、ibm-java-sdk-8.0-8.10-aix-ppc64-installmgr.zip がダウンロード出来ます。
4. IBM Semeru Runtime Certified Edition をダウンロードする。
1 . 以下のサイトにアクセスします。
IBM Semeru Runtime Certified Edition Version 17 for WebSphere Liberty using Installation Manager(短縮URL)
2 . 以下のAIX用 17.0.8.0-IBM-Semeru-Runtime-Certified-SDK-ppc64-aix-repo をダウンロードします。
FCからのダウンロード手順はほぼIIMのFCからのダウンロードと同じため、ここでも手順は省略します。
この手順で、ibm-semeru-certified-jdk_ppc64_aix_17.0.8.0-installmgr.zip がダウンロード出来ます。ダウンロード後は、左上の赤丸ボタンで閉じます。
2. IIMのインストール
2-1 . パッケージの展開
root@myhost /tmp/work/IIM # unzip ../agent.installer.aix.gtk.ppc_1.9.2005.20230718_1844.zip
Archive: ../agent.installer.aix.gtk.ppc_1.9.2005.20230718_1844.zip
inflating: META-INF/MANIFEST.MF
inflating: META-INF/PRD00008.SF
inflating: META-INF/PRD00008.RSA
creating: Offerings/
(省略)
inflating: readme.html
inflating: repository.config
inflating: repository.xml
inflating: silent-install.ini
inflating: tools/imcl
inflating: tools/imcl.ini
inflating: tools/imutilsc
inflating: tools/imutilsc.ini
inflating: user-silent-install.ini
inflating: userinst
inflating: userinst.ini
inflating: userinstc
inflating: userinstc.ini
root@myhost /tmp/work/IIM #
2-2 . インストール
root@myhost /tmp/work/IIM # ./installc -acceptLicense
Installed com.ibm.cic.agent_1.9.2005.20230718_1844 to the /opt/IBM/InstallationManager/eclipse directory.
3. Liberty インストール
3-1 . パッケージの確認
3-1-1 . GA版のパッケージを確認
IIM版でLibertyをインストールする場合は、GAのパッケージが必要になります。
root@myhost /opt/IBM/InstallationManager/eclipse/tools # ./imcl listAvailablePackages -repositories /tmp/work/was.repo.19009.liberty.base.zip
com.ibm.websphere.liberty.BASE_19.0.9.20190905_0148
3-1-2 . FP 23.0.0.9のパッケージを確認
root@myhost /opt/IBM/InstallationManager/eclipse/tools # ./imcl listAvailablePackages -repositories /tmp/work/23.0.0.9-WS-LIBERTY-BASE-FP.zip
com.ibm.websphere.liberty.BASE_23.0.9.20230904_1159
com.ibm.websphere.liberty.BASE.v85_8.5.230009.20230904_1159
com.ibm.websphere.liberty.BASETRIAL.v85_8.5.230009.20230904_1159
3-2 . インストール
以下のようなEOSに関するWARNINGメッセージが表示されるが、この記事ではJava SE 17を使用するため無視することが出来ます。
root@myhost /opt/IBM/InstallationManager/eclipse/tools # ./imcl install com.ibm.websphere.liberty.BASE -repositories /tmp/work/was.repo.19009.liberty.base.zip,/tmp/work/23.0.0.9-WS-LIBERTY-BASE-FP.zip -acceptLicense -showProgress
25% 50% 75% 100%
------------------|------------------|------------------|------------------|
............................................................................
Installed com.ibm.websphere.liberty.BASE_23.0.9.20230904_1159 to the /usr/IBM/WebSphere/Liberty directory.
WARNING: Support for using Java SE 7 and Java SE 7.1 with WebSphere Liberty ended. The Liberty kernel can no longer run with Java SE 7 or Java SE 7.1.
4. IBM Semeru Runtime Certified Edition インストール
4-1 . パッケージの確認
root@myhost /opt/IBM/InstallationManager/eclipse/tools # ./imcl listAvailablePackages -repositories /tmp/work/ibm-semeru-certified-jdk_ppc64_aix_17.0.8.0-installmgr.zip
com.ibm.java.jdk.v17_17.0.8000.20230822_1151
4-2 . インストール
root@myhost /opt/IBM/InstallationManager/eclipse/tools # ./imcl install com.ibm.java.jdk.v17 -repositories /tmp/work/ibm-semeru-certified-jdk_ppc64_aix_17.0.8.0-installmgr.zip -installationDirectory /usr/IBM/WebSphere/Liberty -acceptLicense -showProgress
25% 50% 75% 100%
------------------|------------------|------------------|------------------|
............................................................................
Installed com.ibm.java.jdk.v17_17.0.8000.20230822_1151 to the /usr/IBM/WebSphere/Liberty directory.
4-3 . バージョンの確認(java -version)
java -version が abort で異常終了します。
root@myhost /usr/IBM/WebSphere/Liberty/java/17.0/bin # ./java -version
failed to open </usr/IBM/WebSphere/Liberty/java/17.0/lib/default/libjvm.so> - reason: < 0509-022 Cannot load module /usr/IBM/WebSphere/Liberty/java/17.0/lib/default/libjvm.so.
0509-150 Dependent module libc++.a(shr_64.o) could not be loaded.
0509-022 Cannot load module libc++.a(shr_64.o).
0509-026 System error: A file or directory in the path name does not exist.
0509-022 Cannot load module /usr/IBM/WebSphere/Liberty/java/17.0/lib/default/libjvm.so.
0509-150 Dependent module /usr/IBM/WebSphere/Liberty/java/17.0/lib/default/libjvm.so could not be loaded.>
Failed to find VM - aborting
前提条件の IBM XL C++ Runtime のレベルを確認します。
root@myhost /tmp/work/XLC # lslpp -l | grep xlC
xlC.adt.include 12.1.0.1 COMMITTED C Set ++ Application
xlC.aix61.rte 16.1.0.8 COMMITTED IBM XL C++ Runtime for AIX 6.1
xlC.cpp 9.0.0.0 COMMITTED C for AIX Preprocessor
xlC.msg.en_US.cpp 9.0.0.0 COMMITTED C for AIX Preprocessor
xlC.msg.en_US.rte 16.1.0.8 COMMITTED IBM XL C++ Runtime
xlC.rte 16.1.0.8 COMMITTED IBM XL C++ Runtime for AIX
xlC.sup.aix50.rte 9.0.0.1 COMMITTED XL C/C++ Runtime for AIX 5.2
lslppの出力で確認すると 16.1.0.8 となっており、前提条件の 16.1.0.7 以降のため条件を満たしていますが、Fix list for XL C/C++ Runtime for AIXを確認すると 16.1.0.8 に「Note: V16.1.0.8 C++ Runtime Fix Pack contains updates to the XLSMP runtime filesets only. The C++ Runtime filesets are still at V16.1.0.7.」と記載されており、16.1.0.9 に IJ39692: Moving C++ Runtime for AIX VRMF to 16.1.0.9 という修正が含まれているようです。
16.1.0.9 を Fix list for XL C/C++ Runtime for AIX からダウンロードします。
適用手順については デフォルトのインストールの更新 - IBM Docs などを参照します。
適用後に再度IBM XL C++ Runtime のレベルを確認します。
root@myhost /tmp/work/XLC # lslpp -l | grep xlC
xlC.adt.include 12.1.0.1 COMMITTED C Set ++ Application
xlC.aix61.rte 16.1.0.9 COMMITTED IBM XL C++ Runtime for AIX 6.1
xlC.cpp 9.0.0.0 COMMITTED C for AIX Preprocessor
xlC.msg.en_US.cpp 9.0.0.0 COMMITTED C for AIX Preprocessor
xlC.msg.en_US.rte 16.1.0.9 COMMITTED IBM XL C++ Runtime
xlC.rte 16.1.0.9 COMMITTED IBM XL C++ Runtime for AIX
xlC.sup.aix50.rte 9.0.0.1 COMMITTED XL C/C++ Runtime for AIX 5.2
再度 java -version を実行し問題が解消されることを確認します。
root@myhost /usr/IBM/WebSphere/Liberty/java/17.0/bin # ./java -version
java version "17.0.8" 2023-07-18
IBM Semeru Runtime Certified Edition 17.0.8.0 (build 17.0.8+7)
Eclipse OpenJ9 VM 17.0.8.0 (build openj9-0.40.0, JRE 17 AIX ppc64-64-Bit Compressed References 20230718_461 (JIT enabled, AOT enabled)
OpenJ9 - d12d10c9e
OMR - e80bff83b
JCL - 30f808c1763 based on jdk-17.0.8+7)
5. IHSのインストール
5-1. パッケージの確認
root@myhost /opt/IBM/InstallationManager/eclipse/tools # ./imcl listAvailablePackages -repositories /tmp/work/9.0.5-WS-IHSPLG-FP017.zip
com.ibm.websphere.IHS.v90_9.0.5017.20230818_1035
com.ibm.websphere.PLG.v90_9.0.5017.20230818_1035
root@myhost /opt/IBM/InstallationManager/eclipse/tools # ./imcl listAvailablePackages -repositories /tmp/work/ibm-java-sdk-8.0-8.10-aix-ppc64-installmgr.zip
com.ibm.java.jdk.v8_8.0.8010.20230721_1038
5-2. インストール実行
root@myhost /opt/IBM/InstallationManager/eclipse/tools # ./imcl install com.ibm.websphere.IHS.v90 com.ibm.java.jdk.v8 -repositories /tmp/work/9.0.5-WS-IHSPLG-FP017.zip,/tmp/work/ibm-java-sdk-8.0-8.10-aix-ppc64-installmgr.zip -acceptLicense -showProgress
25% 50% 75 % 100%
------------------|------------------|------------------|------------------|
............................................................................
Installed com.ibm.websphere.IHS.v90_9.0.5016.20230609_0954 to the /usr/IBM/HTTPServer directory.
Installed com.ibm.java.jdk.v8_8.0.8010.20230721_1038 to the /usr/IBM/HTTPServer directory.
5-3. バージョンの確認(versionInfoコマンド)
root@myhost /usr/IBM/HTTPServer/bin # ./versionInfo.sh
WVER0010I: Copyright (c) IBM Corporation 2002, 2012; All rights reserved.
WVER0012I: VersionInfo reporter version 1.15.1.48, dated 2/8/12
--------------------------------------------------------------------------------
IBM WebSphere Product Installation Status Report
--------------------------------------------------------------------------------
Report at date and time February 26, 1970 10:46:41 AM CST
Installation
--------------------------------------------------------------------------------
Product Directory /usr/IBM/HTTPServer
Version Directory /usr/IBM/HTTPServer/properties/version
DTD Directory /usr/IBM/HTTPServer/properties/version/dtd
Log Directory /var/ibm/InstallationManager/logs
Product List
--------------------------------------------------------------------------------
IHS installed
JAVA8 installed
Installed Product
--------------------------------------------------------------------------------
Name IBM HTTP Server for WebSphere Application Server
Version 9.0.5.17
ID IHS
Build Level f5172333.01
Build Date 8/18/23
Package com.ibm.websphere.IHS.v90_9.0.5017.20230818_1035
Architecture PPC64
Installed Features Core runtime
Installed Product
--------------------------------------------------------------------------------
Name IBM SDK, Java Technology Edition, Version 8
Version 8.0.8.10
ID JAVA8
Build Level pap6480sr8fp10-20230703_02
Build Date 07/03/23
Architecture PPC64
--------------------------------------------------------------------------------
End Installation Status Report
--------------------------------------------------------------------------------
6. Pluginのインストール
6-1. パッケージの確認
IHSとPluginは同じパッケージを使うため省略します。5-1. パッケージの確認 を参照して下さい。
6-2. インストール
ここで APAR番号 PH48747 に関する WARNING メッセージが表示されます。この記事では今回SSLの構成は行いませんので、証明書のホスト名のチェックによるIHSが起動できなくなる問題については省略します。
SSL通信する場合は、必ず証明書のホスト名には正しいホスト名が設定されるように構成を行なってください。
root@myhost /opt/IBM/InstallationManager/eclipse/tools # ./imcl install com.ibm.websphere.PLG.v90 com.ibm.java.jdk.v8 -repositories /tmp/work/9.0.5-WS-IHSPLG-FP017.zip,/tmp/work/ibm-java-sdk-8.0-8.10-aix-ppc64-installmgr.zip -acceptLicense -showProgress
25% 50% 75% 100%
------------------|------------------|------------------|------------------|
............................................................................
Installed com.ibm.websphere.PLG.v90_9.0.5017.20230818_1035 to the /usr/IBM/WebSphere/Plugins directory.
Installed com.ibm.java.jdk.v8_8.0.8010.20230721_1038 to the /usr/IBM/WebSphere/Plugins directory.
WARNING: Review the known side effects in 8.5.5.24/9.0.5.16 and later pertaining to: "PH48747: WebSphere web server plug-in changes to certificate hostname validation" (https://www.ibm.com/support/pages/node/6982543)
6-3. バージョンの確認
root@myhost /usr/IBM/WebSphere/Plugins/bin # ./versionInfo.sh
WVER0010I: Copyright (c) IBM Corporation 2002, 2012; All rights reserved.
WVER0012I: VersionInfo reporter version 1.15.1.48, dated 2/8/12
--------------------------------------------------------------------------------
IBM WebSphere Product Installation Status Report
--------------------------------------------------------------------------------
Report at date and time February 26, 1970 10:47:37 AM CST
Installation
--------------------------------------------------------------------------------
Product Directory /usr/IBM/WebSphere/Plugins
Version Directory /usr/IBM/WebSphere/Plugins/properties/version
DTD Directory /usr/IBM/WebSphere/Plugins/properties/version/dtd
Log Directory /var/ibm/InstallationManager/logs
Product List
--------------------------------------------------------------------------------
JAVA8 installed
PLG installed
Installed Product
--------------------------------------------------------------------------------
Name IBM SDK, Java Technology Edition, Version 8
Version 8.0.8.10
ID JAVA8
Build Level pap6480sr8fp10-20230703_02
Build Date 07/03/23
Architecture PPC64
Installed Product
--------------------------------------------------------------------------------
Name Web Server Plug-ins for IBM WebSphere Application Server
Version 9.0.5.17
ID PLG
Build Level f5172333.01
Build Date 8/18/23
Package com.ibm.websphere.PLG.v90_9.0.5017.20230818_1035
Architecture PPC64
Installed Features Core runtime
--------------------------------------------------------------------------------
End Installation Status Report
--------------------------------------------------------------------------------
7. サーバー作成(server createコマンド)
サーバー名を省略した場合は、defaultServer というサーバー名で作成されます。
root@myhost /usr/IBM/WebSphere/Liberty/bin # ./server create
Server defaultServer created.
作成されたサーバーの構成ファイルを確認
root@myhost /usr/IBM/WebSphere/Liberty/bin # cat ../usr/servers/defaultServer/server.xml
<?xml version="1.0" encoding="UTF-8"?>
<server description="new server">
<!-- Enable features -->
<featureManager>
<feature>jsp-2.3</feature>
</featureManager>
<!-- To access this server from a remote client add a host attribute to the following element, e.g. host="*" -->
<httpEndpoint id="defaultHttpEndpoint"
httpPort="9080"
httpsPort="9443" />
<!-- Automatically expand WAR files and EAR files -->
<applicationManager autoExpand="true"/>
</server>
8. Pluginの構成
8-1 . simplepct.sh の実行
httpd.conf にPluginの構成をするため、simplepct.shを実行します。
パラメーターにはPluginのインストール・ディレクトリーを指定します。
root@myhost /usr/IBM/HTTPServer/bin # ./simplepct.sh /usr/IBM/WebSphere/Plugins
To continue, configure your server.xml with <pluginConfiguration pluginInstallRoot="/usr/IBM/WebSphere/Plugins" />,
then transfer your usr/servers/server-name/logs/state/plugin-cfg.xml to
'/usr/IBM/WebSphere/Plugins/config/webserver1/plugin-cfg.xml'
8-2. httpd.confを確認
以下の設定が追加されるとを確認します。
LoadModule was_ap24_module /usr/IBM/WebSphere/Plugins/bin/64bits/mod_was_ap24_http.so
WebSpherePluginConfig /usr/IBM/WebSphere/Plugins/config/webserver1/plugin-cfg.xml
8-3. server.xml の更新
8-1.でコマンドの出力結果に表示された <pluginConfiguration .../ > を server.xml に追加設定します。
なお、SSL構成は今回しないため webserverSecurePort="-1" も追加し、httpsPortsも"-1"で無効化します。コメントあるようにリモートからも接続できるようにするため host="*" も追加しています。
root@myhost /usr/IBM/WebSphere/Liberty/bin # cat ../usr/servers/defaultServer/server.xml
<?xml version="1.0" encoding="UTF-8"?>
<server description="new server">
<!-- Enable features -->
<featureManager>
<feature>jsp-2.3</feature>
</featureManager>
<!-- To access this server from a remote client add a host attribute to the following element, e.g. host="*" -->
<httpEndpoint id="defaultHttpEndpoint"
host="*"
httpPort="9080"
httpsPort="-1" />
<!-- Automatically expand WAR files and EAR files -->
<applicationManager autoExpand="true"/>
<pluginConfiguration pluginInstallRoot="/usr/IBM/WebSphere/Plugins" webserverSecurePort="-1" />
</server>
8-4. plugin-cfg.xml をコピー
plugin-cfg.xmlはデフォルトでは以下ページに記載されている条件で、plugin-cfg.xmlは自動生成されています。8-1.で表示されたメッセージにあるように自動生成された plugin-cfg.xml をコピーします。
[plugin-cfg.xml ファイルの自動生成 - IBM Documentation]
( https://www.ibm.com/docs/ja/was-liberty/base?topic=file-automatic-generation-plugin-cfgxml )
# cp /usr/IBM/WebSphere/Liberty/usr/servers/defaultServer/logs/state/plugin-cfg.xml /usr/IBM/WebSphere/Plugins/config/webserver1/plugin-cfg.xml
9. 動作確認
IHSおよびLiberty起動後に、ブラウザーからhttpでアクセスできることを確認します。