13.2 コマンド実行時の異常

コマンド実行時の以下のトラブルについて対処方法を説明します。

エラーメッセージの出力

コマンド実行時に異常が発生した場合、コマンドを実行したターミナルへエラーメッセージが出力されます。「第12章 Jakarta EEのメッセージ」を参照して対処してください。

例外メッセージの出力

コマンド実行時に例外メッセージが出力された場合は、以下を参照して対処してください。

java.lang.OutOfMemoryError

メモリ不足が発生している可能性があります。環境変数VMARGSに-Xmxオプションを指定し、Javaヒープをチューニングしてください。

下記はJavaヒープのサイズを256MBに指定する場合の、環境変数の設定例です。

VMARGS=-Xmx256m

java.lang.OutOfMemoryErrorの出力例を以下に示します。

Exception in thread "main" Exception in thread "Thread-1" java.lang.OutOfMemoryError: Metaspace
        at java.lang.ClassLoader.defineClass1(Native Method)
        at java.lang.ClassLoader.defineClass(ClassLoader.java:763)
        at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:142)
        at java.net.URLClassLoader.defineClass(URLClassLoader.java:467)
        at java.net.URLClassLoader.access$100(URLClassLoader.java:73)
        at java.net.URLClassLoader$1.run(URLClassLoader.java:368)
        at java.net.URLClassLoader$1.run(URLClassLoader.java:362)
        at java.security.AccessController.doPrivileged(Native Method)
        at java.net.URLClassLoader.findClass(URLClassLoader.java:361)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
        at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:331)
        at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
        at org.glassfish.hk2.utilities.DescriptorImpl.readObject(DescriptorImpl.java:878)
        at com.sun.enterprise.admin.cli.CLIContainer.parseInHk2LocatorOrig(CLIContainer.java:150)
        at com.sun.enterprise.admin.cli.CLIContainer.parseHk2Locators(CLIContainer.java:192)
        at com.sun.enterprise.admin.cli.CLIContainer.<init>(CLIContainer.java:126)
        at com.sun.enterprise.admin.cli.AdminMain.doMain(AdminMain.java:279)
        at org.glassfish.admin.cli.AsadminMain.main(AsadminMain.java:56)
The memory was exhausted on Metaspace. : requested 488 bytes
  Java heap size / max Java heap size = 3411168 / 132120576
  Java metaspace size / max Java metaspace size = 4539360 / 5242880

java.net.SocketTimeoutException: 高負荷によりDASとの通信が失敗した可能性があります。
システムの負荷状況を確認し、システムリソースに空きができたら再度コマンドを実行してください。

java.lang.NoClassDefFoundError: wsimportコマンドを実行時にjavax.xml.stream.XMLStreamExceptionクラスについて本例外が出力された場合、製品のjavaコマンドが利用できていない場合があります。環境変数 PATHなどを確認してください。

java.io.FileNotFoundException: 実行権限のないユーザーによってコマンドが実行された可能性があります。該当している場合は、実行権限のあるユーザーで再実行してください。

コマンド復帰の遅延

処理開始から長時間経過してコマンドが異常復帰する場合、複数の操作が同時に実行されたことでDASに接続できない状態となっている可能性があります。
この場合、コマンドの実行はエラーとなりますが、定義・運用には影響はありません。同時に他の操作が行われていないことを確認し、再度コマンドを実行してください。

定義項目の更新時、意図しない値が保存される

他のユーザーが以下により同時に操作をしたため、指定値が上書きされた可能性があります。

asadminコマンド

同時に操作をしているユーザーがいないか確認し、必要に応じて操作を再度実行してください。

起動操作と停止操作連続実行時の異常

asadminコマンドはDAS、およびGlassFish Serverインスタンスの操作完了を待たずに復帰します。このため、起動操作（start-domain/start-cluster/start-local-instance）と停止操作（stop-domain/stop-cluster/stop-local-instance）を連続実行した場合、以下のエラーでasadminコマンドが失敗する場合があります。

Failed to start process named <GlassFish Serverインスタンス名>. PCMI Error Code=301.

以下の対処をしてください。

起動操作をする場合: pcmilistprocessesコマンドで操作対象のGlassFish Serverインスタンス（DAS）が表示されていないことを確認した後、起動操作をしてください。

停止操作をする場合: pcmilistprocessesコマンドで操作対象のGlassFish Serverインスタンス（DAS）のstatusが"monitoring"となっていることを確認した後、停止操作をしてください。