本文へスキップ

インストール問題の解決

ファイアウォール設定の確認

WhaTapのデータ収集サーバーにTCPアウトバウンドポリシーを設定しない場合、モニタリング情報を送信できません。 ファイアウォール遮断解除してください。

telnetコマンドを使用して、"Connected to IP"を確認します。

$ telnet 52.193.60.176 6600
Trying 52.193.60.176...
Connected to 52.193.60.176.
Escape character is '^]'.
ノート

収集サーバーの情報は、WhaTapモニタリングサービスからプロジェクトを選択した後、管理 > エージェントインストール メニューから確認できます。

SpringBoot2.2以降、Tomcat JMXのOFF状態

SpringBoot 2.2バージョン以降でEmbedded Tomcatを使用する場合、既定値としてJMX関連の機能が動作しません。この場合、JMX機能を有効してください。関連リンク

application.properties
spring.jmx.enabled=true
server.tomcat.mbeanregistry.enabled=true # tomcat embeddedの場合 #
application.yml
spring:
jmx:
enabled: true
server:
tomcat:
mbeanregistry:
enabled: true #tomcat embeddedの場合

OSGI フレームワーク対応アプリケーション・サーバーの場合

OSGIフレームワーク構造を持つアプリケーション・サーバーの場合は、JVMオプションにエージェント・パッケージプリフィックス(whatap)を登録します。

JBoss EAP6.0以降、 Jboss AS7.0以降、 Wildfly 8.0以降、IBM WebSphere AS 7.0以降が含まれます。

JBoss AS, Wildfly, JBoss EAP6.0以降

次のファイルにプレフィックスを登録します。

$JBOSS_HOME/bin/standalone.conf(domain.conf)
-Djboss.modules.system.pkgs=whatap

JBOSS EAP 7.0

WebSphere

JVM オプションとして、以下を追加します。

-Dcom.ibm.ws.classloader.server.alwaysAllowedPackages=whatap
  • 既定値として '*' で指定されている場合、設定は必要ありません。
  • 設定位置は、WebSphereを参照してください。

security.policy権限を次のように追加してください。

$WEBSPHERE_HOME/properties/server.policy || $WEBSPHERE_PROFILE_HOME/properties/server.policy
grant codeBase "file:$WHATAP_HOME/-"
{
permission java.security.AllPermission;
};

Log Manager関連エラー

JBoss ASバージョン7.0以降、JBoss EAPバージョン6.0以降でLog Manager関連エラーが発生した場合、JVM オプションを追加します。

  • -Djava.util.logging.manager項目にLog Manager package名を設定してください。
  • -Xbootclassloader項目にJoboss Log Manager JAR fileを設定してください。
(JBoss_Path)/bin/standalone.conf(domain.conf)
# Specify the exact Java VM executable to use.
#
if [ "x$JBOSS_MODULES_SYSTEM_PKGS" = "x" ]; then
JBOSS_MODULES_SYSTEM_PKGS="org.jboss.byteman,org.jboss.logmanager,whatap"
fi

...
# Specify options to pass to the Java VM.
#
if [ "x$JAVA_OPTS" = "x" ]; then
JAVA_OPTS="-Xms1303m -Xmx1303m -Djava.net.preferIPv4Stack=true"
JAVA_OPTS="$JAVA_OPTS -Djboss.modules.system.pkgs=$JBOSS_MODULES_SYSTEM_PKGS -Djava.awt.headless=true"
JAVA_OPTS="$JAVA_OPTS -Djava.util.logging.manager=org.jboss.logmanager.LogManager -Xbootclasspath/p:/home/vagrant/EAP-7.0.0/modules/system/layers/base/org/jboss/logmanager/main/jboss-logmanager-2.0.3.Final-redhat-1.jar"
else
echo "JAVA_OPTS already set in environment; overriding default settings with values: $JAVA_OPTS"
fi

MBeanServerBuilderエラーが発生した場合

JBoss5.0以下のバージョンからMBeanServerBuilder関連エラーが出力された場合、JVMオプションを追加してください。

(JBoss_Path)/bin/run.conf
# Specify options to pass to the Java VM.
#
if [ "x$JAVA_OPTS" = "x" ]; then
JAVA_OPTS="-Xms128m -Xmx512m -XX:MaxPermSize=256m -Dorg.jboss.resolver.warning=true -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"
JAVA_OPTS="$JAVA_OPTS -Djboss.platform.mbeanserver"
fi

Permissionエラーが発生した場合

Java Security Policyに関連するエラーが発生すると、_$JAVA_HOME/jre/lib/security/java.policy_ファイルに権限設定を追加してください。

すべての権限を一括で適用するには、次のようにjava.policyファイルに設定を追加します。

$JAVA_HOME/jre/lib/security/java.policy
grant {
permission java.security.AllPermission;
};

java.io.FilePermissionエラーが発生した場合

java.io.FilePermision error

次のようにjava.policyファイルに設定を追加します。

$JAVA_HOME/jre/lib/security/java.policy
grant {
...
permission java.io.FilePermission {エラーメッセージから確認されたパッケージパス}, "read"
};

java.util.PropertyPermissionエラーが発生した場合

次のようにjava.policyファイルに設定を追加します。

$JAVA_HOME/jre/lib/security/java.policy
grant {
...
permission java.util.PropertyPermission {エラーメッセージから確認されたパッケージパス}, "read"
};

Sigar libraryをロードできない場合

$WHATAP_HOME/lib1/*.soファイルに実行権限があることを確認してください。アクセス権限がない場合は、実行するアクセス権限を付与してください。

$ sudo chmod +x *.so

AIX7で*$WHATAP_HOME/lib1以下の階層にlibsigar-ppc64-aix-7.so*ファイルが存在しないエラーが発生した場合は、そのファイルをコピーしてください。

Sigar library error on AIX 7

$ cp libsigar-ppc64-aix-5.so libsigar-ppc64-aix-7.so