Open Libertyで問題判別ハンズオン


はじめに

従来のWebSphere Application Server(以下WAS)時代に、PD職人 というIBMのWikiにWASの問題判別スキルをつけるためのハンズオンがまとまめられています。
今回は上記ハンズオンで使っているサンプルアプリとライブラリをOpen Liberty環境に入れて稼動確認をしたので、その際のメモです。

前提

  • Open Liberty 18.0.0.2
  • Java8
  • MacOS 10.13.6

導入手順

1. Open LibertyとJavaはすでに導入され、server1が構成されているものとします。手順はこちらをご参照ください。
2. 上記のWikiからearファイルとネイティブ・ライブラリを入手します。
3. server1/appsディレクトリにearファイルをコピーします。

4. server1/libsディレクトリをmkdirします。
5. 上記libsディレクトリにネイティブ・ライブラリをコピーします。

6. server.xmlファイルを更新します。

server.xml
<?xml version="1.0" encoding="UTF-8"?>
<server description="new server">

    <!-- Enable features -->
    <featureManager>
        <feature>jsp-2.3</feature>
        <feature>javaee-7.0</feature>
        <feature>monitor-1.0</feature>
        <feature>restConnector-2.0</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"
                  host="*" />

    <!-- Not releavant to this topic, never mind -->
    <basicRegistry id="basic" realm="BasicRealm"> 
        <user password="password" name="jmxuser"/>
    </basicRegistry>

    <!-- Not releavant to this topic, never mind -->
    <administrator-role>
        <user>jmxuser</user>
    </administrator-role>

   <library id="pdProLib">
    <folder dir="${server.config.dir}/libs" />
    <file name="${server.config.dir}/libs/pdpro.native.dll" />
   </library>

   <application location ="pdpro.20110516.ear">
   <classloader commonLibraryRef="pdProLib" />
   </application>

    <!-- Automatically expand WAR files and EAR files -->
    <applicationManager autoExpand="true"/>
</server>

7. server1を開始します。

./server start server1

アプリが開始していることがわかります

messages.log
[8/22/18 15:01:02:519 JST] 00000001 com.ibm.ws.kernel.launch.internal.FrameworkManager           A CWWKE0001I: サーバー server1 が起動されました。
(略)
[8/22/18 15:01:20:733 JST] 0000001e com.ibm.ws.app.manager.AppMessageHelper                      A CWWKZ0001I: アプリケーション pdpro.20110516 が 2.307 秒で開始しました。

稼動確認

1. 以下のようにtopページが確認できます。

2. Hangを試してみます。ここではCall Sleep Servletで10秒スリープさせてみます。

3. 10秒スリープして結果が戻りました。

4. message.logにも出力されています。

messages.log
[8/22/18 15:01:32:548 JST] 0000001d com.ibm.ws.webcontainer.servlet                              I SRVE0242I: [pdpro.20110516] [/hang] [MySleepServlet]: 初期化が成功しました。
[8/22/18 15:01:32:549 JST] 0000001d SystemOut                                                    O > MySleepServet.doTask()
[8/22/18 15:01:32:551 JST] 0000001d SystemOut                                                    O D MySleepServet.doTask() request.getParamter("sleeptime")
[8/22/18 15:01:32:561 JST] 0000001d SystemOut                                                    O D MySleepServet.doTask() looptime is 10000 milliseconds
[8/22/18 15:01:32:565 JST] 0000001d SystemOut                                                    O > MyLoop.doLoop() - sleep 10000 milliseconds
[8/22/18 15:01:42:570 JST] 0000001d SystemOut                                                    O < MyLoop.doLoop()
[8/22/18 15:01:42:572 JST] 0000001d SystemOut                                                    O < MySleepServet.doTask()
[8/22/18 15:16:20:315 JST] 00000331 SystemOut                                                    O > MySleepServet.doTask()
[8/22/18 15:16:20:324 JST] 00000331 SystemOut                                                    O D MySleepServet.doTask() request.getParamter("sleeptime")
[8/22/18 15:16:20:325 JST] 00000331 SystemOut                                                    O D MySleepServet.doTask() looptime is 10000 milliseconds
[8/22/18 15:16:20:326 JST] 00000331 SystemOut                                                    O > MyLoop.doLoop() - sleep 10000 milliseconds
[8/22/18 15:16:30:328 JST] 00000331 SystemOut                                                    O < MyLoop.doLoop()
[8/22/18 15:16:30:332 JST] 00000331 SystemOut                                                    O < MySleepServet.doTask()

まとめ

以上でPD職人で提供されているサンプルアプリを動かし、問題判別ハンズオンの準備を行いました。
なお全てのケースを試しているわけではないことにご注意ください。

追記 2018/8/31

ふとライブラリをよく見たらWindows用のdllでした。。(確認漏れです。。)
なので今回のMac/Linux環境では読み込めないため、Native Libraryを呼び出すCrashケースとNative heapを枯渇させるOutOfMemoeryErrorケースはここでは使えません。Java heapのOOMEやHangやExceptionケースが使えます。Windowsでしたら全ケース可能のはずです。

参考資料