付録A よくある質問
- A.1. 全般
- 問: JBoss Operations Network と RHQ の違いは何ですか?
- 問: バグを検索して機能拡張要求を送信するには、公開されている問題トラッカーシステムが存在するか?
- 問: サポートされるデータベース
- 問: JBoss ON を Java 5 で起動できないのはなぜですか?
- 問: ユーザーの設定内容を見つけるにはどうすればよいですか?
- 問: JBoss ON で使用される正規表現の構文
- 問: JBoss ON がリソースの可用性をチェックする頻度
- 問: JBoss ON エージェントは起動時に待機する理由
- 問: How do I install a supported version of PostgreSQL on Red Hat Enterprise Linux?
- 問: JBoss ON コンソールから JBoss ON データベースに SQL コマンドを実行するにはどうすればよいですか?
- 問: VMWare で JBoss ON はサポートされますか?
- 問: メモリー不足の状態をデバッグできるようにするには、メモリー不足または要求に応じてエージェントまたはサーバーがヒープをダンプするにはどうすればよいですか?
- A.2. インストールおよびアップグレードの問題
- 問: サーバーのインストール(またはアップグレード)時にエラーメッセージが表示されます。意味は?
- 問: サーバーをインストールしましたが、接続できません。What's wrong?
- 問: インストーラーは「Relation RHQ_Principal does not exist」で PostgreSQL で失敗します。
- 問: サーバーをアップグレードしましたが、インストーラーページに接続して設定しようとすると、引き続き(以前の) coregui/ モジュールにリダイレクトしようとします。インストーラーにアクセスする方法は?
- 問: ORA-01843 では、Oracle で JBoss ON インストールに失敗します。
- A.3. ユーザーインターフェース
- A.4. server
- 問: サーバーを起動すると、ログにサーブレットエラーが表示されます。What's wrong?
- 問: JBoss ON サーバーからデバッグメッセージを取得する方法
- 問: サーバーの JVM のコマンドラインオプションを指定する方法
- 問: すべてのデータのスキーマをどのようにパージするか?
- 問: JDBC アクセスおよびトレース SQL をデバッグする方法
- 問: サーバーの email/SMTP 設定が正しいことを確認するにはどうすればよいですか?
- 問: サーバーマシンには /var/run という書き込み可能なディレクトリーがありません。rhq-server.sh スクリプトを取得して、その pid ファイルを正常に書き込みするにはどうすればよいですか?
- 問: サーバーを起動しようとすると、「Exception created identity」で例外が発生し、サーバーは起動に失敗します。どうすればよいですか?
- 問: サーバーログに「Have not packet from agent ...」というメッセージが表示されます。ダウンしていると疑われるため、バックフィルが行われます。 意味は?
- 問: サーバーとエージェント間でファイアウォールを設定する際に考慮すべきポートは何ですか?
- 問: サーバーを Windows サービスとしてインストールしましたが、エラーメッセージなしで起動できません。サーバーを Windows サービスとして起動するにはどうすればよいですか?
- 問: Oracle── の使用時に ORA-12519, TNS:no appropriate service handler found error を修正するにはどうすればよいですか?
- 問: サーバーログまたはスタックトレースにこのエラーが表示 されています: WARN [QueryTranslatorImpl] firstResult/maxResults with collection fetch; apply in memory.その意味と原因は何ですか?
- 問: 「同一の論理プラグイン」と「異なるコンテンツ」および「非推奨とみなされる」というメッセージをサーバーが定期的にログに記録しないようにするにはどうしたらよいですか?
- 問: JBoss ON の LDAP ユーザー認証と LDAP グループ承認の違い
- 問: LDAP グループ承認を設定するにはどうすればよいですか?
- A.5. エージェント
- 問: 共有ディスクリソースを持つ複数の仮想マシンをホストする物理マシンがあります。各仮想インスタンスでエージェントを実行する方法
- 問: JBoss ON エージェントからデバッグメッセージを取得する方法
- 問: サーバーへの接続が許可されているエージェントを制限するにはどうすればよいですか?
- 問: root でエージェントを実行する必要がありますか?
- 問: JBoss ON エージェントを新たにインストールしたかのようにクリーンアップするにはどうすればよいですか?
- 問: バックグラウンドの Windows サービスとして実行中のエージェントの「clean config」を実行する方法
- 問: すべてのエージェントでプラグインを更新するにはどうすればよいですか?
- 問: 登録後にエージェント名を変更するにはどうすればよいですか?
- 問: すべてのマシンでエージェントを実行したいが、正常に起動するのは 1 つだけです。残りのアドレスは正しくないアドレスにバインドされるため失敗します。
- 問: Windows サービス経由でエージェントを起動すると、エージェントが起動しなくなり、エージェントラッパーログファイルで「java.lang.IllegalStateException: The name of this agent is not defined - you cannot start the agent」というエラーが表示されます。意味は?
- 問: エージェントのセットアップは適切ですが、エージェントは「Cause: org.jboss.remoting.CannotConnectException: Can not connect http client invoker」というメッセージが表示されます。
- 問: 使用しているエージェントマシンには、という書き込み可能なディレクトリーがありません /var/run。rhq-agent-wrapper.sh スクリプトを取得して、pid ファイルを正常に書き込みするにはどうすればよいですか?
- 問: エージェントがリソースをスキャンする頻度。
- 問: エージェントの永続化設定を表示するにはどうすればよいですか?
- 問: エージェントの JVM プロセスに設定された環境変数と Java システムプロパティーを確認するにはどうすればよいですか?
- 問: 別のマシンで実行しているエージェントからインベントリー情報をダンプするにはどうすればよいですか?
- 問: エージェントマシンの IP アドレスを変更する必要があります。この変更でサーバーとエージェントを最新の状態に維持するにはどうすればよいですか?
- 問: サーバーが稼働状態のままになったときに、サーバーが稼働し続けることをエージェントが停止するにはどうすればよいですか?
- A.6. ログメッセージ
- A.7. サーバーおよびエージェントプラグイン
- A.8. 一般的なリソースに関する質問
- A.9. JBoss リソース
- 問: すべての JNP クレデンシャルがリソースの接続プロパティーで適切に設定されていても、JBoss AS サーバーが緑色の可用性を示し、1 つの JBoss AS サーバーのみが緑色の状態で表示されるのはなぜですか?
- 問: JBoss EAP 5 や Tomcat などのサーバーをインポートする場合、インベントリー内に子 JVM リソースが表示されますが、これは Red(DOWN)になります。なぜですか?
- 問: JBoss EAP インスタンスの監視を試みると、「Connection failure Failed to authenticate principal=null, securityDomain=jmx-console」というエラーが表示されます。
- 問: JBoss AS インスタンスを監視する場合、その下には JVM リソースは表示されません。
- 問: JBoss AS 5.1 を監視できますか?
- 問: エージェントは JBoss サーバーを検出し、接続プロパティーを取得できますが、JNP 接続は失敗します。なぜですか?
- A.10. Postgres リソース
- A.11. Apache リソース
- 問: Apache コネクターはどこで取得できますか?
- 問: Response Time モジュールで Apache をインストルメント化しましたが、VirtualHosts に対して RT メトリックは表示されていません。
- 問: Apache メトリクスの一部はゼロの値を表示します。なぜですか?
- 問: Augeas プラグインとは何ですか?
- 問: 「java.lang.UnsatisfiedLinkError: Unable to load library 'augeas': libaugeas.so: cannot open shared object file: No such file or directory"?
- 問: Apache SNMP モジュールがエラーを出して起動できないのはなぜですか?
- A.12. Tomcat リソース
- A.13. プロビジョニングおよびコンテンツ
- A.14. アラート
- A.15. 監視
- A.16. operations
A.1. 全般
- 問: JBoss Operations Network と RHQ の違いは何ですか?
- 問: バグを検索して機能拡張要求を送信するには、公開されている問題トラッカーシステムが存在するか?
- 問: サポートされるデータベース
- 問: JBoss ON を Java 5 で起動できないのはなぜですか?
- 問: ユーザーの設定内容を見つけるにはどうすればよいですか?
- 問: JBoss ON で使用される正規表現の構文
- 問: JBoss ON がリソースの可用性をチェックする頻度
- 問: JBoss ON エージェントは起動時に待機する理由
- 問: How do I install a supported version of PostgreSQL on Red Hat Enterprise Linux?
- 問: JBoss ON コンソールから JBoss ON データベースに SQL コマンドを実行するにはどうすればよいですか?
- 問: VMWare で JBoss ON はサポートされますか?
- 問: メモリー不足の状態をデバッグできるようにするには、メモリー不足または要求に応じてエージェントまたはサーバーがヒープをダンプするにはどうすればよいですか?
select id, name, string_value from rhq_config_property where configuration_id = (select configuration_id from rhq_subject where name = 'your-user-name')
rhq.agent.plugins.availability-scan.period-secs
設定で定義されます。デフォルトは 30 秒です。パフォーマンス上の理由から、30 秒未満になることはありません。新しい間隔を ADDITIONAL_JAVA_OPTIONS 値のいずれかに設定することで、スキャン間隔を拡張できます。例:
RHQ_AGENT_ADDITIONAL_JAVA_OPTS="-Drhq.agent.plugins.availability-scan.period-secs=45"
サーバーはエージェントの登録要求を拒否しました。
エージェントが起動時にこのメッセージを返すと、エージェントは 1 つの名前でサーバーで認識されているが、起動時に別の名前を送信することを意味します。
Cause: [org.rhq.core.clientapi.server.core.AgentRegistrationException:The agent asking for registration is trying to register the same address/port [172.31.7.7:16163] that is already registered under a different name [example]; if this new agent is actually the same as the original, then re-register with the same name]
エージェントはサーバーに到達できません。
これは、サーバーがダウンしているか、ファイアウォールがトラフィックをブロックしたためにサーバーにアクセスできないエージェントの状態です。サーバーマシンのポート 7080 がエージェントのマシンから到達可能であることを確認します。これは、Web ブラウザーで確認できます。
サーバーはエージェントに接続できません。
サーバーがエージェントのエンドポイントに ping できないことを示すエラーは、エージェントがサーバーと通信できるが、サーバーはエージェントと通信できないことを意味します。これは、エージェントポートがファイアウォールによってブロックされていることを意味します。
The server has rejected the agent registration request. Cause: [org.rhq.core.clientapi.server.core.AgentRegistrationException:Server cannot ping the agent's endpoint. The agent's endpoint is probably invalid or there is a firewall preventing the server from connecting to the agent. Endpoint: socket://172.31.7.3:12345/....
エージェントにはプラグインがありません。ダウンロードするまで待機します。
これは通常、サーバーがエージェントが送信したセキュリティートークンとは異なることを意味します。これにより、異なるエージェントバージョンや仮想マシンでテストするなどして、Java プリファレンスエントリーが mangled になります。
11:40:48,454 WARN [CommandProcessor] {CommandProcessor.failed- authentication}Command failed to be authenticated! This command will be ignored and not processed: Command: type=[remotepojo]; cmd-in-response= [false]; config=[{rhq.security-token=1217855913569-109582636-403140853869881172, rhq.send-throttle=true}]; params= [{targetInterfaceName=org.rhq.core.clientapi.server.core.CoreServerService, invocation=NameBasedInvocation[getLatestPlugins]}]
エージェントの起動は問題ありませんが、ping コマンドは失敗します。
ここでは、エージェントは正常に起動しますが、監視データが送信されないなど、他のエージェント通信の問題が生じる可能性があります。エージェントコマンドラインに ping を試みると、以下のようなエラーが返されます。
sending> ping Pinging... Failed to execute prompt command [ping]. Cause: org.rhq.enterprise.communications.command.server.AuthenticationException:Command failed to be authenticated! This command will be ignored and not processed: Command: type=[remotepojo]; cmd-in-response=[false]; config=[{rhq.security- token=1214208960346-102975580-7334156733284942657, rhq.send-throttle=true}]; params=[{targetInterfaceName=org.rhq.enterprise.communications.Ping, invocation=NameBasedInvocation[ping]}]
高可用性の IP アドレスの正引きおよび後方マッピングは一致しません。
コンピューターの IP アドレスをコンピューター名に逆マッピングでき、この名前が同じ IP アドレスにマッピングされていることを確認します。すべてのホストで true である必要があります。
$ dig -x 172.31.7.7 [...] ;; ANSWER SECTION: 7.7.31.172.in-addr.arpa. 86400 IN PTR example $ $ dig example [...] ;; ANSWER SECTION: example 74030 IN A 172.31.7.7
- RHN/JBoss の認証情報 を使用 して http://rhn.redhat.com にログインします。
- Red Hat Application Stack v2 チャネルを追加します。
- システムを更新します。
sudo yum update
- 具体的には PostgreSQL を更新します
sudo yum install postgresql-server
。data
ディレクトリーがインストールされている/var/lib/pgsql/data
。JBoss ON は、PostgreSQL 8.2.4 以降および 8.2.x バージョンと PostgreSQL 8.3、8.4、および 9.0 のすべてのリリースをサポートします。 - JBoss ON サーバーを通常通りにインストールおよび設定します。
http://server.example.com:7080/coregui/#Test/
RHQ_AGENT_ADDITIONAL_JAVA_OPTS
または RHQ_SERVER_ADDITIONAL_JAVA_OPTS
変数)。
-XX:+HeapDumpOnOutOfMemoryError -XX:+HeapDumpOnCtrlBreak特定の場所にヒープダンプファイルをドロップするには、path:
-XX:HeapDumpPath=location「 SUN JVM Debugging Options 」を参照してください。
A.2. インストールおよびアップグレードの問題
- 問: サーバーのインストール(またはアップグレード)時にエラーメッセージが表示されます。意味は?
- 問: サーバーをインストールしましたが、接続できません。What's wrong?
- 問: インストーラーは「Relation RHQ_Principal does not exist」で PostgreSQL で失敗します。
- 問: サーバーをアップグレードしましたが、インストーラーページに接続して設定しようとすると、引き続き(以前の) coregui/ モジュールにリダイレクトしようとします。インストーラーにアクセスする方法は?
- 問: ORA-01843 では、Oracle で JBoss ON インストールに失敗します。
ERROR [ClientCommandSenderTask] {ClientCommandSenderTask.send-failed}Failed to send command [Command: type=[remotepojo]; cmd-in-response=[false]; config=[{rhq.timeout=1000, rhq.send-throttle=true}]; params=[{targetInterfaceName=org.rhq.enterprise.communications.Ping, invocation=NameBasedInvocation[ping]}]]. Cause: org.jboss.remoting.CannotConnectException:[.....]
rhq-server.properties
ファイル内のサーバーに設定されません。java.rmi.server.hostname
パラメーターは、jboss.bind.address
パラメーターの値に一致するサーバーの実際の IP アドレスに手動で設定する必要があります。rhq-server.properties
ファイルを編集した後にサーバーを再起動して、新しい設定を読み込む。
pg_hba.conf
、パーミッションが有効になっていることを確認します。インストール用の PostgreSQL の設定に関する詳細は、『インストール 『ガイド』』 を参照してください。
http:/server.example.com:7080/installer/start.jsf
- Oracle を別のロケールにします。
- インストーラーを実行する前にサーバーディストリビューションファイルのいずれかを編集します。
- 古いサーバーディレクトリーを削除して、インストールパッケージを再度展開します。
serverRoot/jon-server-3.3.0.GA/jbossas/server/default/rhq-installer.war/WEB-INF/classes
ディレクトリーを開きます。- 編集
db-data-combined.xml
。01-APR-08 形式の日付を、現在のロケールにあるように更新します。 - ファイルを保存します。
- インストーラーを再実行し、データベースの上書きを選択します。
A.3. ユーザーインターフェース
- プラットフォームをインポートし、そのサーバーをオフのままにします。
- プラットフォームが正常にインポートされたら、サーバーを選択し、をクリックし Ignoreます。
java.lang.RuntimeException:[1312480384219] ...
java.lang.NoClassDefFoundError: Could not initialize class org..enterprise.gui.image.chart.ColumnChart
yum install urw-fonts
A.4. server
- 問: サーバーを起動すると、ログにサーブレットエラーが表示されます。What's wrong?
- 問: JBoss ON サーバーからデバッグメッセージを取得する方法
- 問: サーバーの JVM のコマンドラインオプションを指定する方法
- 問: すべてのデータのスキーマをどのようにパージするか?
- 問: JDBC アクセスおよびトレース SQL をデバッグする方法
- 問: サーバーの email/SMTP 設定が正しいことを確認するにはどうすればよいですか?
- 問: サーバーマシンには /var/run という書き込み可能なディレクトリーがありません。rhq-server.sh スクリプトを取得して、その pid ファイルを正常に書き込みするにはどうすればよいですか?
- 問: サーバーを起動しようとすると、「Exception created identity」で例外が発生し、サーバーは起動に失敗します。どうすればよいですか?
- 問: サーバーログに「Have not packet from agent ...」というメッセージが表示されます。ダウンしていると疑われるため、バックフィルが行われます。 意味は?
- 問: サーバーとエージェント間でファイアウォールを設定する際に考慮すべきポートは何ですか?
- 問: サーバーを Windows サービスとしてインストールしましたが、エラーメッセージなしで起動できません。サーバーを Windows サービスとして起動するにはどうすればよいですか?
- 問: Oracle── の使用時に ORA-12519, TNS:no appropriate service handler found error を修正するにはどうすればよいですか?
- 問: サーバーログまたはスタックトレースにこのエラーが表示 されています: WARN [QueryTranslatorImpl] firstResult/maxResults with collection fetch; apply in memory.その意味と原因は何ですか?
- 問: 「同一の論理プラグイン」と「異なるコンテンツ」および「非推奨とみなされる」というメッセージをサーバーが定期的にログに記録しないようにするにはどうしたらよいですか?
- 問: JBoss ON の LDAP ユーザー認証と LDAP グループ承認の違い
- 問: LDAP グループ承認を設定するにはどうすればよいですか?
Servlet.service()
ログに記録されるクラス:
22:55:35,319 ERROR [[ServerInvokerServlet]] Servlet.service() for servlet ServerInvokerServlet threw exception java.lang.reflect.UndeclaredThrowableException at $Proxy421.processRequest(Unknown Source) at org.jboss.remoting.transport.servlet.web.ServerInvokerServlet.processRequest(ServerInvokerServlet.java:128) at org.jboss.remoting.transport.servlet.web.ServerInvokerServlet.doPost(ServerInvokerServlet.java:157) at javax.servlet.http.HttpServlet.service(HttpServlet.java:710) at javax.servlet.http.HttpServlet.service(HttpServlet.java:803) ... more ...
serverRoot/jon-server-3.3.0.GA/jbossas/server/default/conf/jboss-log4j.xml
設定ファイルを編集して、のコメントを解除してデバッグメッセージを有効にすることができます。 org.rhq
カテゴリー。これにより、DEBUG に設定されます。デバッグメッセージは、すべての JBoss ON サブシステムがログファイルに出力されます。デバッグメッセージを JBoss ON サーバー内部の小規模サブセットに対してのみ出力する場合は、コメントを解除して使用するカテゴリーを指定するか、独自のカテゴリーを追加することもできます。
log4j.xml
コメントを含むコメントアウトされたカテゴリーには、特定のカテゴリーから期待されるデバッグメッセージのタイプを簡単に説明します。JBoss/Remoting や Hibernate などのサードパーティーサブシステムのデバッグメッセージを出力することもできます。これらの一部はすでににコメントアウトされてい log4j.xml
ます。
log4j.xml
ファイルを保存し、JBoss ON サーバーを再起動します。
serverRoot/jon-server-3.3.0.GA/bin/rhq-server.sh|bat stop serverRoot/jon-server-3.3.0.GA/bin/rhq-server.sh|bat start
serverRoot/jon-server-3.3.0.GA/logs/server.log
ます。
INFO
.デバッグメッセージがコンソールにも表示されるようにするには、CONSOLE アペンダーのしきい値設定をに変更します。 DEBUG
.
RHQ_SERVER_DEBUG
任意の値を設定します。ランチャーの開始時にこの変数を設定すると、スクリプトはデバッグメッセージを出力します。
RHQ_SERVER_JAVA_OPTS
環境変数。例:
RHQ_SERVER_JAVA_OPTS="-Dapp.name=rhq-server -Xms256M -Xmx1024M -XX:PermSize=128M -XX:MaxPermSize=256M -Djava.net.preferIPv4Stack= true" export RHQ_SERVER_JAVA_OPTS
RHQ_SERVER_ADDITIONAL_JAVA_OPTS
環境変数。例:
RHQ_SERVER_ADDITIONAL_JAVA_OPTS= "-Dfoo= true" export RHQ_SERVER_ADDITIONAL_JAVA_OPTS
wrapper.java.additional.n
行を追加します <server-install-dir>\bin\wrapper\rhq-server-wrapper.inc
(ファイルの作成が必要になる場合があります)。例:
- wrapper.java.additional.12=-verbosegc:file=gc-log.txt
- wrapper.java.additional.13=-XX:+HeapDumpOnOutOfMemoryError
- wrapper.java.additional.14=-XX:HeapDumpPath=heap-dump.txt
- 現在の JBoss ON サーバーディレクトリーを保存します。
mv jon-server-3.3.0.GA/ jon-server-3.3.0.GA.bak/
- 最新の JBoss ON バイナリーを展開します。
unzip jon-server-3.3.0.GA.zip
- 新しいサーバープロセスを開始します。
serverRoot/jon-server-3.3.0.GA/bin/rhqctl.sh start
- JBoss ON GUI を開き、インストール設定を行います。選択可能な場合は、のオプションを選択し Overwrite existing dataます。これにより、サーバーの以前のインストール用のデータがすべて削除されます。
http://server.example.com:7080/coregui/#Test/
RHQ_SERVER_PIDFILE_DIR
pid ファイルを保存するディレクトリーのフルパスを設定します。スクリプトを実行すると、その変数の値がデフォルトの場所を上書きします。2.1 またはそれ以前のスクリプトがある場合は、直接編集して rhq-server.sh
、希望のディレクトリー /var/run
に切り替えます。
Caused by: java.lang.RuntimeException: Exception creating identity: my.host.name.com: my.host.name.com | at org.jboss.remoting.ident.Identity.get(Identity.java:211)
/etc/hosts
)を使用してすべてのサーバーおよびエージェントのマッピングを維持することです。これにより、DNS が失敗しても JBoss ON が正常に機能し続けます。ただし、ホストファイルの使用は、お使いの環境では実用的ではない場合があります。この場合、JBoss ON インストールを開始する前に時間がかかる必要があります。これにより、JBoss ON を実行する予定の各ホストが、nslookup などのツールを使用して計画された環境にある他のすべてのホスト名を適切に解決できることを確認してください。
[org.rhq.enterprise.server.core.AgentManagerBean] Have not heard from agent [agent_name] since [timestamp]. Will be backfilled since we suspect it is down
- エージェントは実際にシャットダウンまたはクラッシュした。
- エージェントがシャットダウンまたはクラッシュしているマシン。
- エージェントとサーバー間のネットワークがダウンし、エージェントがサーバーに接続し、可用性レポートを送信することを禁止していました。
- エージェントが実行しているマシンは偽装されるため、エージェントの速度が遅くなり、エージェントが十分な速度でレポートを送信できないようにします。
RHQ_SERVER_RUN_AS_ME
環境変数がに設定されます。 true
:
rhq-server.bat remove set RHQ_SERVER_RUN_AS_ME=true rhq-server.bat install
ALTER SYSTEM SET PROCESSES=150 SCOPE=SPFILE;。これにより、Oracle── データベースを再起動します。
- LDAP URL の形式で LDAP サーバーに接続する情報。たとえば、ldap://server.example.com:1389 など です。
- サーバーへの接続に使用するユーザー名およびパスワード。このアカウントには、検索対象のサブツリーへの読み取りアクセスが必要です。
- 検索ベース。これは、エントリーを検索するディレクトリーツリー内のポイントです。これには、パフォーマンスを向上させ、不要なアクセスを防ぐのに十分なエントリーを含めて、すべてのエントリーを含めることができるはずです。たとえば、JBoss ON の両方のサブツリーに ou=Web Team,dc=example,dc=com ou=Engineering,dc=example,dc=com およびとある場合、検索ベースをツリー上に設定し dc=example,dc=comます。エンジニアリンググループを JBoss ON が使用する場合のみ使用する場合は、検索ベースをに設定し ou=Engineering,dc=example,dc=comます。
- グループフィルター。これにより、グループエントリーの検索に使用する検索フィルターが作成されます。これは、グループオブジェクトクラスを使用できます。これは、JBoss ON 関連のエントリーにカスタム属性がある場合に特に便利です。また、グループ名、ローカリティー、エントリーの説明にある文字列などの他の要素を参照することもできます。これは、JBoss ON 関連グループを特定するのに有用または意味のあるものです。
- member 属性。グループオブジェクトクラスにはさまざまなタイプがあり、ほとんどの属性を使用してグループメンバーを特定します。たとえば、groupOfUniqueNames オブジェクトクラスは
uniqueMember
属性を持つメンバーを一覧表示します。
A.5. エージェント
- 問: 共有ディスクリソースを持つ複数の仮想マシンをホストする物理マシンがあります。各仮想インスタンスでエージェントを実行する方法
- 問: JBoss ON エージェントからデバッグメッセージを取得する方法
- 問: サーバーへの接続が許可されているエージェントを制限するにはどうすればよいですか?
- 問: root でエージェントを実行する必要がありますか?
- 問: JBoss ON エージェントを新たにインストールしたかのようにクリーンアップするにはどうすればよいですか?
- 問: バックグラウンドの Windows サービスとして実行中のエージェントの「clean config」を実行する方法
- 問: すべてのエージェントでプラグインを更新するにはどうすればよいですか?
- 問: 登録後にエージェント名を変更するにはどうすればよいですか?
- 問: すべてのマシンでエージェントを実行したいが、正常に起動するのは 1 つだけです。残りのアドレスは正しくないアドレスにバインドされるため失敗します。
- 問: Windows サービス経由でエージェントを起動すると、エージェントが起動しなくなり、エージェントラッパーログファイルで「java.lang.IllegalStateException: The name of this agent is not defined - you cannot start the agent」というエラーが表示されます。意味は?
- 問: エージェントのセットアップは適切ですが、エージェントは「Cause: org.jboss.remoting.CannotConnectException: Can not connect http client invoker」というメッセージが表示されます。
- 問: 使用しているエージェントマシンには、という書き込み可能なディレクトリーがありません /var/run。rhq-agent-wrapper.sh スクリプトを取得して、pid ファイルを正常に書き込みするにはどうすればよいですか?
- 問: エージェントがリソースをスキャンする頻度。
- 問: エージェントの永続化設定を表示するにはどうすればよいですか?
- 問: エージェントの JVM プロセスに設定された環境変数と Java システムプロパティーを確認するにはどうすればよいですか?
- 問: 別のマシンで実行しているエージェントからインベントリー情報をダンプするにはどうすればよいですか?
- 問: エージェントマシンの IP アドレスを変更する必要があります。この変更でサーバーとエージェントを最新の状態に維持するにはどうすればよいですか?
- 問: サーバーが稼働状態のままになったときに、サーバーが稼働し続けることをエージェントが停止するにはどうすればよいですか?
RHQ_AGENT_DEBUG
任意の値を設定します。エージェントを起動すると、ランチャースクリプトとエージェント自体の両方がデバッグメッセージを出力します。この環境変数を使用すると、エージェントは内部 log4j
設定ファイルを使用します。
log4j
カテゴリーに DEBUG 優先順位があるかをより詳細に制御するには、conf/log4j.xml
ファイルを編集してエージェントを再起動して変更を読み込みます。未設定 RHQ_AGENT_DEBUG
エージェントが log4j.xml
ファイルを使用し、その環境変数を設定する log4j.xml
と、内部的に設定された log4j
設定でエージェントが上書きされます。
agentRoot/rhq-agent/logs
ディレクトリーにあるログファイルにあります。
RHQ_AGENT_DEBUG
サービスをインストールします。
rhq-agent-wrapper.bat install
- 以下の名前と場所を使用して、制限ルールのファイルを作成します。
vim serverInstallDir/jbossas/server/default/deploy/rhq.ear/jboss-remoting-servlet-invoker-2x.r3040.jon.war/WEB-INF/context.xml
- このコンテンツをファイルに追加します。
<Context> <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="192.168.*,142.104.128.*,10.224.27.182"/> </Context>
allow=
属性は、サーバーへの接続が許可される IP の一覧です。その他の IP はすべてブロックされます。
postgres.conf
ます。PostgreSQL 権限のない root 以外のユーザーとしてエージェントを実行すると、エージェントはファイルの読み取りおよび管理ができません。(また、エージェントログにはこのようなログメッセージがあります)。 iptables や一部の JBoss サーバーなど、同様の特権ファイルを持つ他のリソースがあります。
- JBoss ON サーバーインベントリーから platform エントリーを削除します。プラットフォームエントリーは agent エントリーの代表であるため、実際には JBoss ON トポロジーからエージェントが削除されます。
- エージェントを停止し、--fullcleanconfig (-L) コマンドラインオプションを使用して再起動します。
agentRoot/rhq-agent/bin/rhq-agent.sh --fullcleanconfig
--fullcleanconfig オプションは、エージェントのローカルインベントリーをすべて削除し、agent-configuration.xml
ファイルから新しい設定を再読み込みし、サーバーでエージェントを再登録します。必要に応じて、--config
引数を渡して、ユーザーが指定した設定ファイルで起動できるようにします。それ以外の場合は、デフォルトのconf/agent-configuration.xml
ファイルが使用されます。ディレクトリーが指定されていない場合は、コマンドでエージェントのconf/
ディレクトリー内の設定ファイルを検索します。agentRoot/rhq-agent/bin/rhq-agent.sh --fullcleanconfig -c my-agent-configuration.xml
agent-configuration.xml
ファイルから設定を読み取るように強制できます。エージェントがファイルから設定を再読み込みするよう強制するには、フォアグラウンドで起動できないため、再設定がより困難になります。
rhq-agent-wrapper.conf
ファイルを編集し、行を追加することができます。
wrapper.app.parameter.3=--cleanconfigこれにより、サービスとして起動される
agent-configuration.xml
たびにエージェントの設定を再読み込みします。この場合、エージェントに必要な(およびオプション)の設定をすべて事前に設定し、正しい設定で再起動するように agent-configuration.xml
する必要があります。
resource.resourceType.pluginName = RHQAgent resource.resourceType.typeName = RHQ Agent
FATAL [main] (org.jboss.on.agent.AgentMain)- {AgentMain.startup-error}The agent encountered an error during startup and must abort java.net.BindException: Cannot assign requested address
agent-configuration.xml
手動で変更になりましたか?(例: IP アドレスの変更)。エージェントの設定 XML ファイルは、Java Preferences を使用して永続化されるため、エージェントの設定後に参照され ません。設定を保持すると、設定が失われずにエージェントを更新または再インストールできます。エージェントの設定ファイルを変更し、それらの変更を取得するに -c は、エージェントを再起動して、--config コマンドラインオプション(または短所 --config)を渡します。これにより、エージェントは設定ファイルを再読み込みし、以前永続化した古い設定をオーバーライドするように指示します。
$HOME/.java
を選択することになります。Java 設定はレジストリーに保存されるため、通常は Windows では問題ありません。エージェントをユーザーと同じユーザーとして実行し、ユーザーのホームディレクトリーを共有している場合は、エージェントが異なる Java 設定名を使用します。エージェントの agent-configuration.xml
ファイルを編集し、Java プリファレンスノード名を次のように変更します。 デフォルト
すべてのエージェントで一意となるものにすることができます。例:
<node name="NewName">
--pref
オプションを使用して、エージェントに新しい優先順位を指示します。設定ファイルを変更したら、でエージェントを再起動して設定ファイル -c
を指定します。
agentRoot/rhq-agent/bin/rhq-agent.sh --pref NewName -c agent-configuration.xml
--pref
オプションを使用してエージェントを再起動して、ノード名を渡すようにします。
java.util.prefs.userRoot
別の一意の場所をポイントします。エージェントが起動すると、Java はそのシステムプロパティーの値を Java Preferences を格納する場所として使用します。このシステムプロパティーは、に設定して、エージェントに設定できます。 RHQ_AGENT_ADDITIONAL_JAVA_OPTS
環境変数。その環境変数を設定すると、エージェントの Java 仮想マシンにオプションを渡すと、デフォルトの Java オプションに値が rhq-agent.sh
追加されます。
set RHQ_AGENT_ADDITIONAL_JAVA_OPTS="-Djava.util.prefs.userRoot=/etc/rhq-agent-prefs" agentRoot/rhq-agent/bin/rhq-agent.sh
/var/run
。rhq-agent-wrapper.sh スクリプトを取得して、pid ファイルを正常に書き込みするにはどうすればよいですか?
RHQ_AGENT_PIDFILE_DIR
pid ファイルを保存するディレクトリーのフルパスを設定します。スクリプトを実行すると、その変数の値がデフォルトの場所を上書きします。古いスクリプト(2.1 以前)がある場合は、直接編集して rhq-agent-wrapper.sh
、希望のディレクトリー /var/run
に切り替えます。
agent-configuration.xml
れている値で読み取られ、上書きされます。エージェントを最初に設定した後は、その設定が永続化され、設定をクリアしない限り agent-configuration.xml
、その設定に再び参照されることはありません。
- エージェントが JBoss ON インベントリーにある場合は、エージェントの Configuration タブに移動し、ライブ設定を表示します。これは永続する設定と同じです。
- エージェントがデーモン以外のモードで実行されている場合は(たとえば、コンソールにエージェントプロンプトがある場合は)、getconfig または config prompt コマンドを使用してライブ設定を表示できます。詳細は help getconfig、または help config を入力します。
- エージェントが JBoss ON インベントリーにある場合は、Execute Prompt Command 操作を実行し、getconfig prompt コマンドを実行します。
- エージェント設定は標準の Java Preferences API バッキングストアに保存されるため、Google の Java Preferences Tool などの Java 設定を調べることのできるツールを使用できます。これは、ファイルシステムのような表示を Java 設定に提供できる GUI ツールです。エージェントの設定は、ノード名の User preferences ノードに保存され rhq-agentます。起動時にノード名のエージェントに渡される -p オプションに応じて、実際の構成設定は、以下のサブノードの下にあります。
rhq-agent
.デフォルトの設定ノードが呼び出されます。デフォルト
したがって、通常、エージェントの永続化された設定は、以下のユーザー設定にあり rhq-agent/defaultます。
data/inventory.dat
ファイルを取得します。そのファイルをローカルマシンにコピーします。次に、他のエージェントと同じプラグインを使用して、ローカルマシンでエージェントを実行します。エージェントは必ずしもサーバーに接続する必要はなく、プラグインコンテナーを起動する必要があるため、エージェントが登録されている必要があります。次に、インポートされた DAT ファイルから情報をエクスポートします。
inventory --xml --export=/bad-inventory.xml /the/bad/inventory.dat
--export
オプションを指定しないと、XML は単に stdout コンソールウィンドウにダンプされます。
rhq.communications.connector.bind-address
値を設定します(サーバーから受信メッセージをリッスンします)。
- 優先順位が新しい IP アドレスと同じになるように、エージェントの設定を変更します。agent プロンプトで setconfig prompt コマンドを実行します。
setconfig rhq.communications.connector.bind-address=IP_address
Do not changeagent-configuration.xml
。変更は反映されません。エージェントがバックグラウンドでデーモンプロセスとして実行している場合は、スクリプト(rhq-agent-wrapper.sh|bat)を使用してシャットダウンし、再起動します。 - 設定の編集後にエージェントを再起動します。
INFO (org.rhq.enterprise.agent.AgentAutoDiscoveryListener)- {AgentAutoDiscoveryListener.server-offline} The Agent has auto-detected the Server going offline [InvokerLocator [servlet://server:7080/jboss-remoting-servlet-invoker /ServerInvokerServlet?rhq.communications.connector.rhqtype=server]] - the agent will stop sending new messages ... INFO (org.rhq.enterprise.agent.AgentAutoDiscoveryListener)- {AgentAutoDiscoveryListener.server-online} The Agent has auto-detected the Server coming online [InvokerLocator [servlet://server:7080/jboss-remoting-servlet-invoker /ServerInvokerServlet?rhq.communications.connector.rhqtype=server]] - the agent will be able to start sending messages now
- rhq.agent.server-auto-detection
- rhq.communications.multicast-detector.enabled
rhq.agent.client.server-polling-interval-msecs
値が 0(通常は 60000)よりも大きくなります。それ以外の場合は、エージェントはサーバーがダウンしたタイミングを認識できません。
A.6. ログメッセージ
02:31:33,095 WARN [CommandProcessor] {CommandProcessor.failed-authentication} Command failed to be authenticated! This command will be ignored and not processed: Command: type=[identify]; cmd-in-response=[false]; config=[{}]; params=[null]
13:43:10,781 WARN [LoadContexts] fail-safe cleanup (collections) : org.hibernate.engine.loading.CollectionLoadContext@103583b <rs=org.postgresql.jdbc3.Jdbc3ResultSet@d16f5b>
A.7. サーバーおよびエージェントプラグイン
rhq-plug-in.xml
プラグイン記述子が含まれる Maven pom が含まれます。
A.8. 一般的なリソースに関する質問
> discovery -f
/etc/sysconfig/network
以下のように変更します。
NETWORKING_IPV6=no
/etc/modprobe.conf
を追加します。
alias net-pf-10 off alias ipv6 off
service ip6tables stop
chkconfig ip6tables off
/etc/rsyslog.conf
)でメッセージをフォーマットして JBoss ON が理解できるようにします。例:
$template RHQfmt,"%timegenerated:::date-rfc3339%,%syslogpriority-text%,%syslogfacility-text%:%msg%\n"
$template RHQfmt,"%timegenerated:::date-rfc3339%,%syslogpriority-text%,%syslogfacility-text%:%msg%\n" *.* /var/log/messages-for-rhq;RHQfmt *.* @@127.0.0.1:5514;RHQfmt
/var/log/messages-for-rhq
送信します。
chmod a+x scriptname
A.9. JBoss リソース
- 問: すべての JNP クレデンシャルがリソースの接続プロパティーで適切に設定されていても、JBoss AS サーバーが緑色の可用性を示し、1 つの JBoss AS サーバーのみが緑色の状態で表示されるのはなぜですか?
- 問: JBoss EAP 5 や Tomcat などのサーバーをインポートする場合、インベントリー内に子 JVM リソースが表示されますが、これは Red(DOWN)になります。なぜですか?
- 問: JBoss EAP インスタンスの監視を試みると、「Connection failure Failed to authenticate principal=null, securityDomain=jmx-console」というエラーが表示されます。
- 問: JBoss AS インスタンスを監視する場合、その下には JVM リソースは表示されません。
- 問: JBoss AS 5.1 を監視できますか?
- 問: エージェントは JBoss サーバーを検出し、接続プロパティーを取得できますが、JNP 接続は失敗します。なぜですか?
-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=5222 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=true -Dcom.sun.management.jmxremote.password.file=/jmxremote.password -Dcom.sun.management.jmxremote.access.file=/jmxremote.access
jboss.platform.mbeanserver
システムプロパティーが設定されている。たとえば、Red Hat Enterprise Linux では、この ${JBOSS_HOME}\bin\run.conf
ファイルには以下の設定が必要です。
JAVA_OPTS="$JAVA_OPTS -Djboss.platform.mbeanserver"
C:\Program Files
ます。
2012-01-12 15:03:38,982 DEBUG [ResourceContainer.invoker.daemon-1] (org.rhq.plugins.jbossas5.ApplicationServerComponent)- Failed to connect to Profile Service. java.lang.RuntimeException: Failed to lookup JNDI name 'ProfileService' from InitialContext. at org.rhq.plugins.jbossas5.connection.AbstractProfileServiceConnectionProvider.lookup(AbstractProfileServiceConnectionProvider.java:84) [snip]
A.10. Postgres リソース
- postgres ユーザーが削除されている。
- postgres ユーザーのパスワードが変更になりました。
- Linux では、管理ログインがに設定されてい ident sameuserます。
- 検出された Postgres リソースをインベントリーします。この可用性はダウン状態になり、子リソースを見つけることはありません。
- Postgres リソースの INVENTORY タブに移動します。
- の下 Connection Propertiesにある Edit ボタンをクリックします。
- Postgres インスタンスで有効なスーパーユーザーアカウントを反映するように、ロール名およびパスワードフィールドを変更します。
pg_hba.conf
ファイルの設定を変更してパスワードベースのログインを許可するために、Red Hat Enterprise Linux システムで Postgres を変更する必要がある場合があります。
postgres.conf
ファイルで以下の行を追加または変更します。
stats_start_collector = on
A.11. Apache リソース
- 問: Apache コネクターはどこで取得できますか?
- 問: Response Time モジュールで Apache をインストルメント化しましたが、VirtualHosts に対して RT メトリックは表示されていません。
- 問: Apache メトリクスの一部はゼロの値を表示します。なぜですか?
- 問: Augeas プラグインとは何ですか?
- 問: 「java.lang.UnsatisfiedLinkError: Unable to load library 'augeas': libaugeas.so: cannot open shared object file: No such file or directory"?
- 問: Apache SNMP モジュールがエラーを出して起動できないのはなぜですか?
- エージェントのシステムユーザーが
_rt log
ファイルを読み取りできますか?たとえば、RHEL/Apache では、デフォルトのパーミッション/var/log/httpd
は 700、root です。ls -arltd /var/log/httpd/ drwx------ 2 root root 4096 Jul 28 11:36 /var/log/httpd/
回避策として、httpd ログに代替ログディレクトリーを指定するか、権限を変更することです/var/log/httpd
。これら両方には、特定のセキュリティー上の影響があります。root としてエージェントを実行することもできますが、これが最も望ましいオプションですが、ファイルのパーミッションを変更してシステムセキュリティーを侵害しないようにする必要がある場合があります。たとえば、JBoss ON は、700、postgres パーミッションをデータディレクトリー上でアクセスするため、root 権限なしで postgres デーモンを監視できません。これらのパーミッションは変更されないため、エージェントを root として実行するのは残りの唯一のオプションです。 - Apache Vhost テンプレートに対する Response Time Metric を有効にし、応答時間が有効にされているか?これはデフォルトで無効になっています。
- Administration > > System Configuration Templates | Apache HTTP Server> Apache Virtual Hostで、をクリックし Edit Metric Templateます。
- の横にあるチェックボックスを選択し HTTP Response Timeます。
- ページの下部で、を選択し Update schedules for existing resources of marked typeます。
- コレクションの間隔を設定します。
- Go ボタンをクリック[>]します。
- 1 分あたりの GET リクエストの受信バイト数
- 1 分あたり POST リクエストの受信バイト数
- 1 分あたり受信バイト数の合計
- hosts
- grub
- apt
error | 原因 |
---|---|
/etc/httpd/conf/httpd.conf の 1376 行での構文エラー: Unable to write to SNMPvar directory"(stderr) | 「 SNMPVar」ディレクティブで指定されているディレクトリーが存在し、Apache プロセスを所有するユーザーが書き込み可能であることを確認します。 |
init_master_agent: Invalid local port(Permission denied)"(error_log ファイル内) |
Apache error_log に以下のようなログメッセージが含まれるかどうかを確認します。
[Notice] SELinux policy enabled; httpd running as context user_u:system_r:httpd_t:s0
これは、SELinux(Security-Enhanced Linux)ポリシーにより httpd プロセスが SNMP エージェントポート 1610 にバインドされないようにします。この問題を解決するには、コマンドを実行してから Apache を再起動して /usr/bin/setenforce 0、SELinux を Permissive モードに変更します。その後、error_log に以下のようなメッセージが表示されるはずです。
[notice] SELinux policy enabled; httpd running as context user_u:system_r:unconfined_t"
このメッセージには、unconfined_t という用語があります。これは、SELinux がプロセスの制限を解除していることを示します。
|
A.12. Tomcat リソース
A.13. プロビジョニングおよびコンテンツ
A.14. アラート
INFO [CacheConsistencyManagerBean] localhost took [51]ms to reload global cache INFO [CacheConsistencyManagerBean] localhost took [49]ms to reload cache for 1 agents
A.15. 監視
- 有効になっています。
- ログへのパスが有効である。
- 選択した日付の形式がログにあるものと一致します。
java.text.SimpleDateFormat
.