【備忘録】WebSphere Application Server Liberty 環境を構築する

# 概要
検証のため、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 製品オファリング]( https://www.ibm.com/docs/ja/was-liberty/base?topic=manager-liberty-product-offerings-supported-operating-systems )
+ [Installation Manager のインストールおよび Liberty のインストールの準備]( https://www.ibm.com/docs/ja/was-liberty/base?topic=systems-installing-installation-manager-preparing-install-liberty )
+ [コマンド行を使用した分散オペレーティング・システムでの Liberty のインストール]( https://www.ibm.com/docs/ja/was-liberty/base?topic=iuldos-installing-liberty-distributed-operating-systems-using-command-line )
+ [IBM SDK, Java Technology Edition のインストール、更新、およびアンインストール]( https://www.ibm.com/docs/ja/was-liberty/base?topic=systems-installing-updating-uninstalling-sdk-java-technology-edition )
+ [Liberty Java ランタイム環境または Software Development Kit の更新]( https://www.ibm.com/docs/ja/was-liberty/base?topic=liberty-updating-jre-java-sdk )
+ [Liberty のセットアップ]( https://www.ibm.com/docs/ja/was-liberty/base?topic=setting-up-liberty )
+ [plugin-cfg.xml ファイルの自動生成]( https://www.ibm.com/docs/ja/was-liberty/base?topic=file-automatic-generation-plugin-cfgxml )


# おおまかな流れ:
1. 前提条件の確認
1-1 . システム要件の確認
1-2 . インストールイメージの準備
2. IIMのインストール
3. Liberty インストール
4. IBM Semeru Runtime Certified Edition インストール
5. IHSのインストール
6. Pluginのインストール
7. サーバー作成
8. Pluginの構成
9. 動作確認

# 1. 前提条件の確認
## 1-1 . システム要件の確認

AIX 上で Liberty を使う際のシステム要件については、以下のサイトで確認することが出来ます。

[WebSphere Application Server Detailed System Requirements]( https://www.ibm.com/support/pages/node/318365 ) ([短縮URL]( https://www.ibm.com/support/pages/node/318365 ))


この記事では、Liberty 23.0.0.9 を使用するため、下記の手順で確認を行いました。

1.[IBM Software Product Compatibility Reports (SPCR)](https://www.ibm.com/software/reports/compatibility/clarity/softwareReqsForProduct.html) をクリックします。

![スクリーンショット 2023-09-30 8.15.14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/49696a10-6f53-d5a4-53e4-cb30e8384081.png)

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 ボタンを押します。

![スクリーンショット 2023-09-30 8.16.24.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/15a618d2-9609-16d1-f7a0-98f092065583.png)

3.　AIX に関する条件は、Operating Systems タブを確認します。AIX 7.2 は 23.0.0.9 でサポートされており、Notes列には AIX が稼働しているハードウェアごとに Java などの条件があるため、[IBM WebSphere Application Server support on POWER hardware]( https://www.ibm.com/support/pages/node/252231 ) へのリンクが記載されています。使用するマシンの前提条件をこの文書で確認する必要があります。

![スクリーンショット 2023-09-30 8.16.57.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/9086350e-031a-5e1e-cafe-2677bc0aed8a.png)


4 . IHS および JDK に関する条件について　Supported Software タブのWeb ServersとJava SDKを確認します。どちらも Notes 列に記載があるので内容を確認します。

![スクリーンショット 2023-09-30 12.49.43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/e576b395-98e4-f581-8d04-28dd9d76b6f7.png)
![スクリーンショット 2023-09-30 12.50.12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/d32815e9-1822-dbfb-e7a8-606c0fb48955.png)

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]( https://www.ibm.com/support/pages/node/612497 )」と記載されているため、条件を満たしているかの確認をする必要があります。

[Semeru Runtimes support]( https://www.ibm.com/support/pages/node/6451203#platforms_version_17 )

## 1-3 . インストールイメージの準備

### 1. 製品をインストールために必要なIIMをダウンロードする

1 . 以下のサイトにアクセスします。
[Installation Manager and Packaging Utility download documents](https://www.ibm.com/support/pages/installation-manager-and-packaging-utility-download-documents)[(短縮URL)](https://www.ibm.com/support/pages/node/609575 )

2 . 2023年9月29日現在、最新のIIM 1.9.2.5 の「Download document」をクリックします。
![スクリーンショット 2023-09-26 23.32.48.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/e60293f3-7a23-b0c6-c311-07d94eed99ce.png)

:::note info
脆弱性の観点からその時点での最新を使用
:::


3 .「Installation Manager 1.9.2.5」ページが表示されます。各プラットフォーム毎にリンクがあるので、この記事では AIX の行にある「FC」をクリックします。
![スクリーンショット 2023-09-26 23.35.31.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/7dfb3cce-d9ca-9900-2a34-db9a5302f5a9.png)

4 . 2つ表示されていますが、１つ目はAIX版、２つ目はマルチプラットフォーム更新版です。この記事ではAIX版をダウンロードします。チェックを付けて「次へ進む」をクリックします。

![スクリーンショット 2023-09-26 23.37.26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/c936e50a-7c32-1c3e-5047-a8a2a512e085.png)


5 . ここでIBM IDを求める画面が表示される場合があります。使用しているIBM IDを入力後「次へ」をクリックしログインします。

![スクリーンショット 2023-09-26 23.40.50.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/785d004f-e45a-ffef-e2f3-0acf5ad51cee.png)

6 .「ダウンロード・オプションの選択」画面が表示された場合は、デフォルトでラジオボタンが「Download Director を使用したダウンロード」についていますが、この記事では「ブラウザー(HTTPS)を使用したダウンロードを選択し、「次へ進む」をクリックします。

7 .「agent.installer.aix.gtk.ppc_1.9.2005.20230718_1844.zip (203.97 MB)」のリンクをクリックしてファイルをダウンロードします。

![スクリーンショット 2023-09-27 9.03.59.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/50f96fb4-864a-2024-309d-51de159bd0cd.png)

## 2. 製品イメージをダウンロードする。

1 . 以下のサイトにアクセスします。
[V9.0.5: Download WebSphere Application Server Version 9.0.5 from Passport Advantage Online]( https://www.ibm.com/support/pages/node/886233 )([短縮URL]( https://www.ibm.com/support/pages/node/886233 ))


2 . 製品のパーツ番号を確認します。この記事ではLiberty BASE版をインストールするため、表から「CC3NYML」であることがわかります。

![スクリーンショット 2023-09-30 20.08.16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/f3577d41-5b9f-11f3-ade0-ee33acbd3f29.png)


3 . 以下のサイトにあるPAオンラインサイン・インの「[サイン・インする](https://www.ibm.com/software/howtobuy/passportadvantage/paocustomer)」から WAS の有効な契約が紐づいているIBM IDを使ってPAオンラインに入ります。

[IBM パスポート・アドバンテージ・オンライン（PA オンライン） - Japan PAO landing page customer and resellers]( https://www.ibm.com/software/jp/passportadvantage/pao.html)

4 . ログオン後は2.で確認したパーツ番号「CC3NYML」で検索を行い、ヒットした製品イメージをダウンロードします。

:::note info
PAオンラインの使用方法が不明な方は、上記画面イメージの一番下にある「[ダウンロード & メディアの手引き (598KB)](https://www.ibm.com/downloads/cas/XOW48WA2)」をクリックし手引きをご参照ください。 
:::

この手順で、Liberty BASE製品イメージの was.repo.19009.liberty.base.zip がダウンロード出来ます。

## 3. 最新のFPをダウンロードする。

1 . 以下のサイトにアクセスします。

[Recommended updates for WebSphere Application Server]( https://www.ibm.com/support/pages/recommended-updates-websphere-application-server ) ([短縮URL]( https://www.ibm.com/support/pages/node/715553 )]


[9.0.5.17: WebSphere Application Server traditional Version 9.0.5.17]( https://www.ibm.com/support/pages/90517-websphere-application-server-traditional-version-90517 )([短縮URL]( https://www.ibm.com/support/pages/node/7031700 ))

2 . 上記リンクにある以下のFPイメージをダウンロードします。FCからのダウンロード手順はほぼIIMのFCからのダウンロードと同じため、手順は省略します。

![スクリーンショット 2023-09-30 14.13.52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/edddca5f-82f6-d5a4-aaee-557b582481ac.png)

上記 9.0.5-WS-IHSPLG-FP017.zip をダンロードします。また IHS/Pluginをインストールする際に必要なIBM Java 8 を上記 [IBM SDK]( https://www.ibm.com/support/pages/ibm-sdk-java-technology-edition-version-80-websphere-application-server-v9-and-websphere-liberty-using-installation-manager )リンク先からダウンロードします。

3 . 上記 IBM SDKのリンクを押下すると、以下のサイトが表示されます。
[IBM SDK Java Technology Edition Version 8.0 for WebSphere Application Server V9 and WebSphere Liberty using Installation Manager]( https://www.ibm.com/support/pages/ibm-sdk-java-technology-edition-version-80-websphere-application-server-v9-and-websphere-liberty-using-installation-manager#80810 ) ([短縮URL]( https://www.ibm.com/support/pages/node/587245 ))

2023年9月29日現在、8.0.8.10が最新Java 8のためこの記事ではこちらをダウンロードします。AIX 64-bit,pSeries のリンクをクリックし、ダウンロードします。FCからの手順は IIM,FPと同じため省略します。

![スクリーンショット 2023-09-30 20.26.32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/4394079e-d391-3560-d3cf-12756b84c708.png)

この手順で、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](https://www.ibm.com/support/pages/ibm-semeru-runtime-certified-edition-version-17-websphere-liberty-using-installation-manager)([短縮URL]( https://www.ibm.com/support/pages/node/6593921 ))

2 . 以下のAIX用 17.0.8.0-IBM-Semeru-Runtime-Certified-SDK-ppc64-aix-repo をダウンロードします。
FCからのダウンロード手順はほぼIIMのFCからのダウンロードと同じため、ここでも手順は省略します。

![スクリーンショット 2023-09-30 21.06.47.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/2516673/0230c774-6714-125b-b205-d45040aeee5a.png)

この手順で、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]( https://www.ibm.com/support/pages/node/612497 )を確認すると 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]( https://www.ibm.com/support/pages/node/6576345 ) という修正が含まれているようです。

16.1.0.9 を  [Fix list for XL C/C++ Runtime for AIX]( https://www.ibm.com/support/pages/node/612497 ) からダウンロードします。
適用手順については　[デフォルトのインストールの更新 - IBM Docs]( https://www.ibm.com/docs/ja/xl-c-and-cpp-aix/16.1?topic=pack-updating-default-installation ) などを参照します。


適用後に再度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でアクセスできることを確認します。