Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

付録A よくある質問

A.1. 全般

問:
JBoss Operations Network と RHQ の違いは何ですか?
答:
RHQ は、JBoss Operations Network のアップストリームのオープンソースバージョンです。JBoss Operations Network は RHQ 上に構築された商用製品で、Red Hat を通じた豊富なテストおよび公式カスタマーサポートを提供します。
問:
バグを検索して機能拡張要求を送信するには、公開されている問題トラッカーシステムが存在するか?
答:
バグの検索、バグの報告、または機能強化リクエストの送信には、Bugzilla を使用します。Other ディストリビューションを選択し、RHQ Project コンポーネントを選択します。
問:
サポートされるデータベース
答:
PostgreSQL 8.2.4 以降 8.2.x バージョン。PostgreSQL 8.3、8.4、および 9.0 のすべてのリリース、および Oracle 11 はサポートされるデータベースです。
サポートされるデータベース、サーバーおよびエージェントのプラットフォーム、および Java バージョンの完全なリストは、で利用でき http://www.redhat.com/jboss_on/requirements ます。
問:
JBoss ON を Java 5 で起動できないのはなぜですか?
答:
Java 5 はサポート対象外になりました。Java 6 にアップグレードします。
サポートされるデータベース、サーバーおよびエージェントのプラットフォーム、および Java バージョンの完全なリストは、で利用でき http://www.redhat.com/jboss_on/requirements ます。
問:
ユーザーの設定内容を見つけるにはどうすればよいですか?
答:
データベースクライアントまたは http://server.hostname:7080/coregui/#Test/ ページのいずれかで、以下の SQL コマンドを実行します。
select id, name, string_value 
from rhq_config_property 
where configuration_id = (select configuration_id 
from rhq_subject 
where name = 'your-user-name')
問:
JBoss ON で使用される正規表現の構文
答:
JBoss ON は、UI と設定ファイルの両方において、正規表現を使用します。すべての正規表現は、Regex 構文および 日付/時刻の形式構文 の Sun ドキュメントで説明されているように、標準の Java 形式に従います。
問:
JBoss ON がリソースの可用性をチェックする頻度
答:
エージェントは、サーバー用に利用できるリソースを毎分チェックし、サービスについては 10 分ごとにチェックします。エージェント自体は、合計インベントリーのサブセットで 30 秒ごとに可用性チェックを実行します。これにより、エージェントに安定した負荷が保持され、メモリー集約型使用量の急増が回避されます。エージェントは結果を JBoss ON サーバーに送信します。
特定のリソースが利用可能な状態についてチェックされる頻度は、メトリクスの頻度のスケジュールと同様にスケジュールされます。この可用性チェックの間隔は、その Monitoring > Schedules タブのリソースについて変更できます。
エージェント自体が可用性チェックを実行する頻度は、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"
問:
JBoss ON エージェントは起動時に待機する理由
答:
コマンドラインから JBoss ON エージェントを起動すると、send > プロンプトには続行されず、そこに留まり、待機することがあります。これには、いくつかの理由があります。

サーバーはエージェントの登録要求を拒否しました。

エージェントが起動時にこのメッセージを返すと、エージェントは 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]
これに対処するには、オプションを指定してエージェントを起動 --clean し、正しい名前を付けます。

エージェントはサーバーに到達できません。

これは、サーバーがダウンしているか、ファイアウォールがトラフィックをブロックしたためにサーバーにアクセスできないエージェントの状態です。サーバーマシンのポート 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]}]
これに対応するには、--clean オプションを使用してエージェントを対話的に起動します。

エージェントの起動は問題ありませんが、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]}]
サーバーログには、複数の CommandProcessor.failed-authentication メッセージが含まれる可能性があります。つまり、エージェントのポートは、サーバーが通信できないようにファイアウォールによりブロックされている可能性があります。

高可用性の IP アドレスの正引きおよび後方マッピングは一致しません。

コンピューターの IP アドレスをコンピューター名に逆マッピングでき、この名前が同じ IP アドレスにマッピングされていることを確認します。すべてのホストで true である必要があります。

たとえば、IP アドレスが 172.31.7.7 の場合、名前解決の結果は以下のようになります。
$ 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
エージェントサーバー通信が機能し、その通信が停止している場合は JBoss ON サーバー UI に移動します。次に Administration> High Availability> に移動し、表示される名前が予想される内容 Server と一致するかどうかを確認します。エージェントは同じかどうかを確認します。
これが機能し、エージェントがハングしている場合には、設定が間違っている可能性もあります。
問:
How do I install a supported version of PostgreSQL on Red Hat Enterprise Linux?
答:
Red Hat Enterprise Linux 5.5 のデフォルトの PostgreSQL バージョンは、サポート対象外である PostgreSQL の古いバージョンであるため、更新する必要があります。
Red Hat カスタマーポータルから Postgres をインストールするには、以下を実行します。
  1. RHN/JBoss の認証情報 を使用 して http://rhn.redhat.com にログインします。
  2. Red Hat Application Stack v2 チャネルを追加します。
  3. システムを更新します。
    sudo yum update
  4. 具体的には 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 のすべてのリリースをサポートします。
  5. JBoss ON サーバーを通常通りにインストールおよび設定します。
問:
JBoss ON コンソールから JBoss ON データベースに SQL コマンドを実行するにはどうすればよいですか?
答:
SQL ページに移動します。
http://server.example.com:7080/coregui/#Test/
問:
VMWare で JBoss ON はサポートされますか?
答:
VMware ESX は、Red Hat Enterprise Linux では、ベアメタルと同等のサポートです。VMWare 製品にハードウェアの問題が発生した場合は、VMWare サポートと連携して問題を解決します。
JBoss EAP は、Red Hat Enterprise Linux のすべての現行バージョンで完全にサポートされます。サポートレベルと SLA は、購入したエンタイトルメントによって異なります。
問:
メモリー不足の状態をデバッグできるようにするには、メモリー不足または要求に応じてエージェントまたはサーバーがヒープをダンプするにはどうすればよいですか?
答:
これらの JVM 引数をサーバーまたはエージェントに渡します(設定)。 RHQ_AGENT_ADDITIONAL_JAVA_OPTS または RHQ_SERVER_ADDITIONAL_JAVA_OPTS 変数)。
-XX:+HeapDumpOnOutOfMemoryError -XX:+HeapDumpOnCtrlBreak
特定の場所にヒープダンプファイルをドロップするには、path:
-XX:HeapDumpPath=location
SUN JVM Debugging Options 」を参照してください。

A.2. インストールおよびアップグレードの問題

問:
サーバーのインストール(またはアップグレード)時にエラーメッセージが表示されます。意味は?
答:
アップグレード中に、以下のようなエラーメッセージがコンソールに表示されます。
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:[.....]
これは無視できます。
問:
サーバーをインストールしましたが、接続できません。What's wrong?
答:
インストーラーが実行時に 0.0.0.0 にバインドされていない場合、必要な接続プロパティーは rhq-server.properties ファイル内のサーバーに設定されません。java.rmi.server.hostname パラメーターは、jboss.bind.address パラメーターの値に一致するサーバーの実際の IP アドレスに手動で設定する必要があります。rhq-server.properties ファイルを編集した後にサーバーを再起動して、新しい設定を読み込む。
問:
インストーラーは「Relation RHQ_Principal does not exist」で PostgreSQL で失敗します。
答:
まず、JBoss ON サーバーインストーラーに PostgreSQL に接続するための適切なパーミッションがあることを確認します。PostgreSQL 設定ファイルを開き pg_hba.conf、パーミッションが有効になっていることを確認します。インストール用の PostgreSQL の設定に関する詳細は、『インストール 『ガイド』』 を参照してください。
問:
サーバーをアップグレードしましたが、インストーラーページに接続して設定しようとすると、引き続き(以前の) coregui/ モジュールにリダイレクトしようとします。インストーラーにアクセスする方法は?
答:
一部のブラウザーは、以前の coregui/ モジュールをキャッシュし、アップグレードした coregui/ モジュールがロードされていなくても、アップグレード後に自動的にリダイレクトを試みます。
インストーラーページに直接移動します。
http:/server.example.com:7080/installer/start.jsf
問:
ORA-01843 では、Oracle で JBoss ON インストールに失敗します。
答:
この問題は、Oracle が 4 月の省略形が APR ではないロケールで実行されると発生します。現在、以下の 2 つの回避策があります。
  • Oracle を別のロケールにします。
  • インストーラーを実行する前にサーバーディストリビューションファイルのいずれかを編集します。
    1. 古いサーバーディレクトリーを削除して、インストールパッケージを再度展開します。
    2. serverRoot/jon-server-3.3.0.GA/jbossas/server/default/rhq-installer.war/WEB-INF/classes ディレクトリーを開きます。
    3. 編集 db-data-combined.xml01-APR-08 形式の日付を、現在のロケールにあるように更新します。
    4. ファイルを保存します。
    5. インストーラーを再実行し、データベースの上書きを選択します。

A.3. ユーザーインターフェース

問:
自動検出されたリソースを無視するにはどうすればよいですか?
答:
エージェントが新規プラットフォームを検出し、インベントリーに使用したくないリソースを発見した場合は、サーバーにこれらのリソースを無視するように指示する必要があります。
まず、自動検出ポートレットでインポートするリソースを選択し、不要なリソースの選択を解除できます。ポートレットに表示されている限り、インポートされません。
または、インポートしないリソースを選択し Ignore、オンにすると、ポートレットには表示されなくなります。ただし、新しく検出されたプラットフォームのリソースでこれを試みると、失敗します。この理由により、インベントリーはプラットフォームを tree-root として使用してツリーのような構造で構成されています。サーバーまたはサービスがシステムに取得される場合(インポートまたは無視されているかどうかに関わらず)、その root の下にアタッチされます。プラットフォームがまだインベントリーにインポートされていない場合、無視されるリソースがに割り当てられるルートはありません。
以下の手順を実行して、プラットフォームでサーバーを無視できます。
  1. プラットフォームをインポートし、そのサーバーをオフのままにします。
  2. プラットフォームが正常にインポートされたら、サーバーを選択し、をクリックし Ignoreます。
プラットフォームだけを無視することはできません。プラットフォームを無視する場合は、エージェントを実行しないでください。
問:
リソース検索ボックスから検索の提案を選択しましたが、結果が得られませんでした。なぜですか?
答:
検索ドロップダウンの提案はカテゴリーごとにフィルターされませんが、検索結果 になります。たとえば、Server タブを使用している場合、CPU がサービスカテゴリーにある場合でも type==CPU、動的検索の提案が出力されます。選択した場合は type==CPU、検索結果がカテゴリーによってフィルターされ、検索が暗黙的にサーバーカテゴリーに設定されて いる ため、検索には何も返されません。
問:
GWT Message Center でエラーやスタックトレースが利用できないことがあります。実際の問題は何ですか?
答:
UI にエラーがある場合は、エラー ID が表示され、角括弧で囲まれます。これは、JBoss ON サーバーのログファイルでエラーおよびスタックトレースを追跡するために使用できます。例:
java.lang.RuntimeException:[1312480384219] ...
これらの例外はサーバー側で発生し、GWT クライアントに転送されるため、サーバー側のログ情報はより便利です。
問:
GUI の MONITOR タブのグラフおよびチャートが表示されるのはなぜですか?
答:
以下のようなエラーが JBoss ON サーバーログに表示されます。
java.lang.NoClassDefFoundError: Could not initialize class org..enterprise.gui.image.chart.ColumnChart
グラフおよびチャートでテキストを生成するには、Java では特定のシステムフォントをインストールする必要があります。必要なフォントパッケージがインストールされていない場合は、エラーメッセージが表示されます。Red Hat Enterprise Linux で、urw-fonts パッケージがインストールされていることを確認します。
yum install urw-fonts

A.4. server

問:
サーバーを起動すると、ログにサーブレットエラーが表示されます。What's wrong?
答:
サーバーが起動し、エージェントがすでに実行中の場合は、に関連してエラーが生じる可能性があります。 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 ...
このエラーは正常で、起動時にサーバーがクラスをロードするシーケンスに関連します。リモーティングクラスは起動シーケンスの初期段階でロードされます。これは、サーバーが完全に開始する前にエージェントへの接続を試みることを意味します。これにより、ログに記録されるエラーが発生する可能性があります。これらのエラーは、サーバーが完全に起動すると削除されるはずです。
エラーは無視しても問題ありません。
問:
JBoss ON サーバーからデバッグメッセージを取得する方法
答:
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ます。
注記
デフォルトでは、コンソールウィンドウにはデバッグメッセージは表示されません。これは、log4j CONSOLE アペンダーにしきい値があるためです。 INFO.デバッグメッセージがコンソールにも表示されるようにするには、CONSOLE アペンダーのしきい値設定をに変更します。 DEBUG.
場合によっては、JBoss ON サーバーランチャースクリプトからデバッグメッセージが必要な場合もあります。これには、環境変数を設定する必要があります。 RHQ_SERVER_DEBUG 任意の値を設定します。ランチャーの開始時にこの変数を設定すると、スクリプトはデバッグメッセージを出力します。
問:
サーバーの JVM のコマンドラインオプションを指定する方法
答:
Red Hat Enterprise Linux では、デフォルトの最大ヒープサイズと permgen サイズを上書きし、を使用して設定します。 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


からその他すべての JVM オプションを設定します。 RHQ_SERVER_ADDITIONAL_JAVA_OPTS 環境変数。例:
 RHQ_SERVER_ADDITIONAL_JAVA_OPTS= "-Dfoo= true" 
 export RHQ_SERVER_ADDITIONAL_JAVA_OPTS

Windows では、他のすべての JVM オプションで 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
問:
すべてのデータのスキーマをどのようにパージするか?
答:
すべてのデータのデータベーススキーマを完全にパージする必要があるインスタンスがあります。これは、カスタムプラグインを作成し、多くのリソース階層情報やメタデータを置き換える必要がある場合に便利です。データベースからすべてのデータを削除し、スキーマをそのままにするには、サーバーを再インストールします。
  1. 現在の JBoss ON サーバーディレクトリーを保存します。
    mv jon-server-3.3.0.GA/ jon-server-3.3.0.GA.bak/
  2. 最新の JBoss ON バイナリーを展開します。
    unzip jon-server-3.3.0.GA.zip
  3. 新しいサーバープロセスを開始します。
    serverRoot/jon-server-3.3.0.GA/bin/rhqctl.sh start
  4. JBoss ON GUI を開き、インストール設定を行います。選択可能な場合は、のオプションを選択し Overwrite existing dataます。これにより、サーバーの以前のインストール用のデータがすべて削除されます。
問:
JDBC アクセスおよびトレース SQL をデバッグする方法
答:
log4jdbc を使用して JDBC およびアクセスおよびトレース SQL をデバッグできます。
問:
サーバーの email/SMTP 設定が正しいことを確認するにはどうすればよいですか?
答:
サーバーが正常に電子メールを送信できることを確認するには、rhqadmin ユーザーとして GUI にログインして、メールテストページを開きます。
http://server.example.com:7080/coregui/#Test/
問:
サーバーマシンには /var/run という書き込み可能なディレクトリーがありません。rhq-server.sh スクリプトを取得して、その pid ファイルを正常に書き込みするにはどうすればよいですか?
答:
環境変数の設定 RHQ_SERVER_PIDFILE_DIR pid ファイルを保存するディレクトリーのフルパスを設定します。スクリプトを実行すると、その変数の値がデフォルトの場所を上書きします。2.1 またはそれ以前のスクリプトがある場合は、直接編集して rhq-server.sh、希望のディレクトリー /var/run に切り替えます。
問:
サーバーを起動しようとすると、「Exception created identity」で例外が発生し、サーバーは起動に失敗します。どうすればよいですか?
答:
参照しているメッセージは、以下のようになります。
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)
これは JBoss ON 固有のものです。これは、JBoss/Remoting 通信の失敗によって生じます。通常、コアの問題はホスト名が解決できないためです。JBoss/Remoting は実際のエラーメッセージを生成しないため、通常はこの問題がユーザーに非表示になります。このエラーは、通常、マシンのホスト名が外部で解決できないことを示しています。JBoss ON が正常に機能するには、すべてのサーバーおよびエージェントが相互のホスト名を解決できる必要があります。ベストプラクティスは、ホストファイル(例: /etc/hosts)を使用してすべてのサーバーおよびエージェントのマッピングを維持することです。これにより、DNS が失敗しても JBoss ON が正常に機能し続けます。ただし、ホストファイルの使用は、お使いの環境では実用的ではない場合があります。この場合、JBoss ON インストールを開始する前に時間がかかる必要があります。これにより、JBoss ON を実行する予定の各ホストが、nslookup などのツールを使用して計画された環境にある他のすべてのホスト名を適切に解決できることを確認してください。
注記
サーバーおよびエージェントが特定の機能に対してホストルックアップを実行するため、この設定は、設定された値に排他的に IP アドレスを使用している場合でも適用されます。
問:
サーバーログに「Have not packet from agent ...」というメッセージが表示されます。ダウンしていると疑われるため、バックフィルが行われます。 意味は?
答:
[org.rhq.enterprise.server.core.AgentManagerBean] Have not heard from agent [agent_name]
since [timestamp]. Will be backfilled since we suspect it is down

つまり、エージェントは利用可能なレポートを必要な時間に送信しませんでした。デフォルトは 2 分ですが、Administration > System Configuration > Settings ページで設定することができます。必要な時間で可用性レポートが送信されない場合、サーバーはエージェントがダウンしていることを前提とします。この時点で、そのエージェントによって管理されるすべてのリソースの可用性が DOWN にバックバックされ、リソースの可用性は red になります。
これは、以下のような理由により発生する可能性があります。
  1. エージェントは実際にシャットダウンまたはクラッシュした。
  2. エージェントがシャットダウンまたはクラッシュしているマシン。
  3. エージェントとサーバー間のネットワークがダウンし、エージェントがサーバーに接続し、可用性レポートを送信することを禁止していました。
  4. エージェントが実行しているマシンは偽装されるため、エージェントの速度が遅くなり、エージェントが十分な速度でレポートを送信できないようにします。
問:
サーバーとエージェント間でファイアウォールを設定する際に考慮すべきポートは何ですか?
答:
注記
デフォルトはデフォルト値です。JBoss ON サーバーまたはエージェントのインストール時に異なる値を設定できます。
デフォルトのサーバーポートは、7080(標準)および 7443(セキュアな SSL)です。
標準接続とセキュアな接続の両方で、デフォルトのエージェントポートは 16163 です。
また、サーバーはデータベースと通信する必要があります。デフォルトのポートは、データベースの種類によって異なります。
問:
サーバーを Windows サービスとしてインストールしましたが、エラーメッセージなしで起動できません。サーバーを Windows サービスとして起動するにはどうすればよいですか?
答:
ローカルシステムアカウントとして実行するようにサーバーをインストールし、そのアカウントにはセキュリティー上の懸念があるため、サーバーまたはマシンを実行するための適切なパーミッションがない可能性があり、ローカルシステムアカウントがネットワークにアクセスできない、または Java を実行できないことが原因です。
これに対応するには、サーバーを適切に実行できるユーザーを Windows ボックスに作成します。ユーザー権限をテストするには、ユーザーとしてログインし、そのユーザーが実行できるかどうかを rhq-server.bat console 確認します。次に、サーバーを、で Windows サービスとしてインストールします。 RHQ_SERVER_RUN_AS_ME 環境変数がに設定されます。 true:
rhq-server.bat remove
set RHQ_SERVER_RUN_AS_ME=true
rhq-server.bat install

問:
Oracle── の使用時に ORA-12519, TNS:no appropriate service handler found error を修正するにはどうすればよいですか?
答:
本番環境では Oracle── はサポートされませんが、テスト環境または開発環境に使用するものもあります。ORA-12519 エラーを停止するには、この設定を設定します
ALTER SYSTEM SET PROCESSES=150 SCOPE=SPFILE;
。これにより、Oracle── データベースを再起動します。
問:
サーバーログまたはスタックトレースにこのエラーが表示 されています: WARN [QueryTranslatorImpl] firstResult/maxResults with collection fetch; apply in memory.その意味と原因は何ですか?
答:
このエラーは Hibernate サービスによって発行され、さまざまな理由でトリガーされる可能性があります。このエラーは無視できます。
問:
「同一の論理プラグイン」と「異なるコンテンツ」および「非推奨とみなされる」というメッセージをサーバーが定期的にログに記録しないようにするにはどうしたらよいですか?
答:
Bugzilla 676073 の既知の問題です。これを回避するには、サーバーをシャットダウンし、サーバーのファイルシステムからプラグイン jar を削除し、サーバーを再起動します。
問:
JBoss ON の LDAP ユーザー認証と LDAP グループ承認の違い
答:
認証 は、リソースにアクセスしようとしているエンティティーが要求するアイデンティティーであることを確認するのに使用されるプロセスです。承認 とは、エンティティーがリソースにアクセスするために必要な権限を決定するプロセスのことです。という名前のユーザー jsmith が JBoss ON にログインしようとしているとします。認証は、ログインを jsmith 試行するプロセスで、JBoss ON がデータベースに存在する jsmith ユーザーと同じです。これは、パスワードを検証することで検証できます。jsmith ログインしたら、JBoss ON は、これらのリソースの設定の編集、新しいアプリケーションのプロビジョニング、サーバー設定の変更、JBoss ON でその他のタスクを表示 jsmith できるリソースを決定します。
通常、JBoss ON は独自のユーザーデータベースを使用してユーザーを識別し、認証します。最初に JBoss ON にユーザー情報について LDAP サーバーを確認し、そのユーザーのベースで有効な JBoss ON ユーザーのベースを使用すると、LDAP 認証を有効にすることができます。これは LDAP 認証 です。これは基本的にパススルー認証です。ユーザーが JBoss ON へのログインを試行します。JBoss ON は最初に認証情報を LDAP サーバーに送信して、LDAP サーバーがそのユーザーを保存しているかどうかを確認します。LDAP サーバーで認証に失敗した場合、JBoss ON は独自のデータベースをチェックします。
JBoss ON のすべての承認はロールに基づきます。ユーザーとリソースグループの両方がロールに追加され、パーミッションはそれらのロールに割り当てられます。これらのロールは JBoss ON で作成および管理されますが、LDAP グループのグループメンバーシップを使用して JBoss ON ロールにユーザーを提供することは可能です。基本的には LDAP 内の既存のユーザーのリストを取り、「ロールメンバーにこのリストを使用」とだけます。 LDAP グループが JBoss ON ロールに追加され、その LDAP グループのすべてのメンバーは自動的にロール権限を持つ権限を持ちます。これは LDAP 承認 です。
注記
LDAP 認証は LDAP 認証に推奨されますが、必須ではありません。
詳細はを参照してください 10章認証および承認用の LDAP サービスの統合
問:
LDAP グループ承認を設定するにはどうすればよいですか?
答:
以下で、LDAP 認証が Administration タブで設定され System Settingsます。
最初に JBoss ON を設定し、LDAP ユーザーが LDAP ユーザーアカウントを使用して認証できるようにします(「LDAP ユーザー認証の設定」)。(LDAP 認証は必要ありませんが、推奨されます。) その後、JBoss ON を LDAP サーバーの LDAP グループを確認するように設定します(「LDAP ユーザーグループを JBoss ON のロールに関連付ける」)。
LDAP サーバー設定には、LDAP グループ承認の設定を確認する必要がある要素が 5 つあります。
  • 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 属性を持つメンバーを一覧表示します。
LDAP 承認を有効にしたら、JBoss ON のロールを LDAP ディレクトリーの適切なグループに関連付けることができます。

A.5. エージェント

問:
共有ディスクリソースを持つ複数の仮想マシンをホストする物理マシンがあります。各仮想インスタンスでエージェントを実行する方法
答:
同じボックスで複数のエージェントを実行できますが、エージェントは 2 つの異なるエージェントのインストールディレクトリーから実行する必要があります。
問:
JBoss ON エージェントからデバッグメッセージを取得する方法
答:
JBoss ON エージェントを起動する前に、エージェントがデバッグメッセージのロギングを開始する最も簡単な方法で、環境変数を設定する方法が最も簡単です。 RHQ_AGENT_DEBUG 任意の値を設定します。エージェントを起動すると、ランチャースクリプトとエージェント自体の両方がデバッグメッセージを出力します。この環境変数を使用すると、エージェントは内部 log4j 設定ファイルを使用します。
どの log4j カテゴリーに DEBUG 優先順位があるかをより詳細に制御するには、conf/log4j.xml ファイルを編集してエージェントを再起動して変更を読み込みます。未設定 RHQ_AGENT_DEBUG エージェントが log4j.xml ファイルを使用し、その環境変数を設定する log4j.xml と、内部的に設定された log4j 設定でエージェントが上書きされます。
ログメッセージは agentRoot/rhq-agent/logs ディレクトリーにあるログファイルにあります。
サービスラッパーを使用して Microsoft Windows で JBoss ON エージェントを起動する場合は、設定する必要があります。 RHQ_AGENT_DEBUG サービスをインストールします。
rhq-agent-wrapper.bat install

問:
サーバーへの接続が許可されているエージェントを制限するにはどうすればよいですか?
答:
サーバーの JBoss/Remoting サーブレット設定を変更して、IPs エージェントのリクエストを制限します。エージェントが特定のサブネットにある場合は、接続をそのサブネットに制限できます。
  1. 以下の名前と場所を使用して、制限ルールのファイルを作成します。
    vim serverInstallDir/jbossas/server/default/deploy/rhq.ear/jboss-remoting-servlet-invoker-2x.r3040.jon.war/WEB-INF/context.xml
  2. このコンテンツをファイルに追加します。
     
    <Context> 
    <Valve className="org.apache.catalina.valves.RemoteAddrValve" 
    allow="192.168.*,142.104.128.*,10.224.27.182"/> 
    </Context>
    allow= 属性は、サーバーへの接続が許可される IP の一覧です。その他の IP はすべてブロックされます。
問:
root でエージェントを実行する必要がありますか?
答:
root でエージェントを実行する必要はありません。
ただし、一部のリソースタイプには、ユーザーが設定ファイルやプロセスにアクセスできる項目に非常に厳格な制限があり、root としてエージェントを実行することが、これらのリソースを管理または監視する唯一の方法になります。
たとえば、PostgreSQL プラグインを使用すると、エージェントは PostgreSQL 設定ファイルをプローブでき postgres.confます。PostgreSQL 権限のない root 以外のユーザーとしてエージェントを実行すると、エージェントはファイルの読み取りおよび管理ができません。(また、エージェントログにはこのようなログメッセージがあります)。 iptables や一部の JBoss サーバーなど、同様の特権ファイルを持つ他のリソースがあります。
エージェントを root として実行すると、これらを管理するエージェント権限が付与されます。その権限レベルがない場合、エージェントには管理リソースのビューが制限されます。
問:
JBoss ON エージェントを新たにインストールしたかのようにクリーンアップするにはどうすればよいですか?
答:
エージェントの設定には、エージェントの(ローカル)永続設定、エージェントインベントリー(および関連するリソースデータ)、およびサーバーインベントリーのプラットフォームエントリーの 3 つの点があります。
エージェント設定をクリーンアップし、新規であるかのようにエージェントを再起動するには、以下の 2 つの手順を実行します。
  1. JBoss ON サーバーインベントリーから platform エントリーを削除します。プラットフォームエントリーは agent エントリーの代表であるため、実際には JBoss ON トポロジーからエージェントが削除されます。
  2. エージェントを停止し、--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
問:
バックグラウンドの Windows サービスとして実行中のエージェントの「clean config」を実行する方法
答:
JBoss ON エージェントの Windows サービス(すべての Windows サービスなど)は特定のユーザーとして実行されます。そのユーザーの Windows レジストリーに移動し、エージェントの設定ノードを削除します。RHQ Agent は標準の Java Preferences API を使用して、エージェントの設定は Windows レジストリーの通常の Java Preferences の場所(HKEY_CURRENT_USER\Software\JavaSoft\Prefs\rhq-agent\default など)のノードとして保存されます。("default" は preferences ノードの名前です)。
ノードを削除すると、以前の設定のみが削除されます。エージェントを再度起動する前にエージェントを再設定する必要があります。最も簡単なパスは、フォアグラウンドでエージェントを起動し、インタラクティブなエージェント設定を確認してから、そのセッションを停止し、サービスとしてエージェントを起動します。
エージェントは、agent-configuration.xml ファイルから設定を読み取るように強制できます。エージェントがファイルから設定を再読み込みするよう強制するには、フォアグラウンドで起動できないため、再設定がより困難になります。
エージェントが JBoss ON リソースとして追加された場合は、「Execute Command prompt」操作を実行して config --import agent-configuration.xml コマンドを実行します。
3 番目のパラメーターに rhq-agent-wrapper.conf ファイルを編集し、行を追加することができます。
wrapper.app.parameter.3=--cleanconfig
これにより、サービスとして起動される agent-configuration.xml たびにエージェントの設定を再読み込みします。この場合、エージェントに必要な(およびオプション)の設定をすべて事前に設定し、正しい設定で再起動するように agent-configuration.xml する必要があります。
問:
すべてのエージェントでプラグインを更新するにはどうすればよいですか?
答:
新しいプラグインをシステムに追加する場合や、既存のプラグインをアップグレードする場合は、エージェントに新しいプラグインバージョンで既存のプラグインを更新するように指示することができます。
この操作は、エージェントプロンプト plugins update で prompt コマンドを個別に実行するか、エージェントの OPERATION タブ内の Update All Plugins タスクを使用して UI で実行できます。
すべてのエージェントを最新のプラグインで更新するには、JBoss ON エージェントの autogroup でグループ操作を実行します。まず、Browse Resources ページに移動して自動グループを作成します。その後、Group Definitions> New Definition ボタンをクリックします。autogroup 定義には、以下の式が必要です。
resource.resourceType.pluginName = RHQAgent
resource.resourceType.typeName = RHQ Agent

これにより、すべての JBoss ON エージェントをメンバーとして動的に追加する互換性のあるグループが作成されます。
注記
すでにエージェントと、メンバーとして互換性のあるグループがある場合には、このグループの作成ステップを省略できます。
次に、agent グループに移動します。OPERATIONS タブで Update All Plugins 操作を呼び出します。これは、そのグループ内のすべてのエージェントがプラグインを更新するように指示します。グループ操作が完了すると、すべてのエージェントに最新のすべてのプラグインが含まれます。
問:
登録後にエージェント名を変更するにはどうすればよいですか?
答:
エージェントを初めて起動すると、エージェント名の設定画面で尋ねられます。この名前は、環境内のすべてのエージェントで一意でなければなりません。登録後、この名前は変更できません。このエージェントの再登録を試みる場合は、前のステップで登録した名前と同じ名前で再登録する必要があります。
エージェント名は、UI の JBoss ON エージェントリソース名とは異なります。JBoss ON エージェントリソースをインベントリーにインポートする場合、そのリソースの名前は agent_name JON エージェントになります。この JBoss ON エージェントリソース名は、INVENTORY タブ内で値を編集して変更できます。この名前を変更しても、エージェントが登録されている名前は変更されません。エージェントは、元のエージェント名で登録されています。
問:
すべてのマシンでエージェントを実行したいが、正常に起動するのは 1 つだけです。残りのアドレスは正しくないアドレスにバインドされるため失敗します。
答:
このエラーが発生する可能性がある事項がいくつかあります。
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)を渡します。これにより、エージェントは設定ファイルを再読み込みし、以前永続化した古い設定をオーバーライドするように指示します。
ホームディレクトリーが NFS に保存されている場合は、すべてのマシン(Red Hat Enterprise Linux)で同じ Java 設定$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

問:
Windows サービス経由でエージェントを起動すると、エージェントが起動しなくなり、エージェントラッパーログファイルで「java.lang.IllegalStateException: The name of this agent is not defined - you cannot start the agent」というエラーが表示されます。意味は?
答:
Windows サービスとしてインストールする際に、エージェントは初期セットアップの設定を要求できません。ユーザーがプロンプトを表示および応答するコンソールがないためです。つまり、事前に設定されたファイルで情報を渡すか、またはサービスとしてサービスとしてインストールする前に、サービスを実行するユーザーとして、標準(サービス以外の)モードでエージェントを実行する必要があります。
問:
エージェントのセットアップは適切ですが、エージェントは「Cause: org.jboss.remoting.CannotConnectException: Can not connect http client invoker」というメッセージが表示されます。
答:
このエラーは、通常、サーバーのエンドポイントアドレスがエージェントによって解決できるものに設定されていない場合に表示されます。JBoss ON サーバーの高可用性クラウド設定が原因で、各サーバーのパブリックエンドポイントアドレスはすべての JBoss ON エージェントによって解決可能である 必要 があります。
GUI の高可用性ページでサーバーエンドポイントの情報を確認し、必要に応じて設定を変更します。更新後、エージェントを再起動します。
問:
使用しているエージェントマシンには、という書き込み可能なディレクトリーがありません /var/run。rhq-agent-wrapper.sh スクリプトを取得して、pid ファイルを正常に書き込みするにはどうすればよいですか?
答:
環境変数の設定 RHQ_AGENT_PIDFILE_DIR pid ファイルを保存するディレクトリーのフルパスを設定します。スクリプトを実行すると、その変数の値がデフォルトの場所を上書きします。古いスクリプト(2.1 以前)がある場合は、直接編集して rhq-agent-wrapper.sh、希望のディレクトリー /var/run に切り替えます。
問:
エージェントがリソースをスキャンする頻度。
答:
エージェントがインストールされると、そのプラットフォームおよびそれにあるすべてのアプリケーション(サーバー、サービス、またはインベントリーに追加できるその他の項目)が スキャン されます。潜在的なリソースを検索するプロセスは 検出 です。
リソースのタイプ(プラットフォーム、サーバー、およびサービス)には、さまざまなスキャンがあります。サーバーおよびプラットフォームの高度なスキャンは、エージェントが 15 分ごとに開始します。サービススキャンは、インベントリーにすでにインポートされているサーバーで実行されている低レベルのサービスを検出します。これらのスキャンは、デフォルトで 24 時間ごとに実行されます。これらの間隔はいずれも設定可能です。
注記
検出スキャンで子プロセス、サーバー、またはサービスを検出する前に、サーバーをインベントリーにインポートする必要があります。
問:
エージェントの永続化設定を表示するにはどうすればよいですか?
答:
エージェントの設定は、最初にエージェントの設定で指定さ agent-configuration.xml れている値で読み取られ、上書きされます。エージェントを最初に設定した後は、その設定が永続化され、設定をクリアしない限り agent-configuration.xml、その設定に再び参照されることはありません。
エージェントの永続化設定を表示する方法は複数あります。
  1. エージェントが JBoss ON インベントリーにある場合は、エージェントの Configuration タブに移動し、ライブ設定を表示します。これは永続する設定と同じです。
  2. エージェントがデーモン以外のモードで実行されている場合は(たとえば、コンソールにエージェントプロンプトがある場合は)、getconfig または config prompt コマンドを使用してライブ設定を表示できます。詳細は help getconfig、または help config を入力します。
  3. エージェントが JBoss ON インベントリーにある場合は、Execute Prompt Command 操作を実行し、getconfig prompt コマンドを実行します。
  4. エージェント設定は標準の Java Preferences API バッキングストアに保存されるため、Google の Java Preferences Tool などの Java 設定を調べることのできるツールを使用できます。これは、ファイルシステムのような表示を Java 設定に提供できる GUI ツールです。エージェントの設定は、ノード名の User preferences ノードに保存され rhq-agentます。起動時にノード名のエージェントに渡される -p オプションに応じて、実際の構成設定は、以下のサブノードの下にあります。 rhq-agent.デフォルトの設定ノードが呼び出されます。 デフォルトしたがって、通常、エージェントの永続化された設定は、以下のユーザー設定にあり rhq-agent/defaultます。
警告
サードパーティーツールを使用する優先順位の値を変更せずに、サードパーティーツールの値を変更しないでください。誤った優先度を誤った値に変更すると、これによりエージェントが無効になる可能性があります。このメカニズムは、エージェントの設定を表示する場合にのみ使用します。
問:
エージェントの JVM プロセスに設定された環境変数と Java システムプロパティーを確認するにはどうすればよいですか?
答:
version agent prompt コマンドは、エージェントプロセスの環境変数およびシステムプロパティーの一覧を表示します。は、すべてのシステムプロパティーの version --sysprops 一覧を version --env 提供し、すべての環境変数の一覧を提供します。(エージェントプロンプトで、そのコマンドの構文 help version を確認します。)
問:
別のマシンで実行しているエージェントからインベントリー情報をダンプするにはどうすればよいですか?
答:
エージェントインベントリーが破損すると、エージェントのインベントリーをダンプすると、問題のデバッグに役立ちます。
この情報を取得するには、エージェントの data/inventory.dat ファイルを取得します。そのファイルをローカルマシンにコピーします。次に、他のエージェントと同じプラグインを使用して、ローカルマシンでエージェントを実行します。エージェントは必ずしもサーバーに接続する必要はなく、プラグインコンテナーを起動する必要があるため、エージェントが登録されている必要があります。次に、インポートされた DAT ファイルから情報をエクスポートします。
inventory --xml --export=/bad-inventory.xml /the/bad/inventory.dat
この --export オプションを指定しないと、XML は単に stdout コンソールウィンドウにダンプされます。
これで、お客様エージェントがそのインベントリーであることを記述した XML ファイルが作成されます。
問:
エージェントマシンの IP アドレスを変更する必要があります。この変更でサーバーとエージェントを最新の状態に維持するにはどうすればよいですか?
答:
エージェントには設定優先順位があり、サーバーソケットの開始時にエージェントがバインドする IP アドレスの rhq.communications.connector.bind-address 値を設定します(サーバーから受信メッセージをリッスンします)。
エージェントの IP アドレスを変更し(古いエージェントの IP アドレスを無効にした場合)、以下の操作を行う必要があります。
  1. 優先順位が新しい IP アドレスと同じになるように、エージェントの設定を変更します。agent プロンプトで setconfig prompt コマンドを実行します。
    setconfig rhq.communications.connector.bind-address=IP_address
    Do not change agent-configuration.xml。変更は反映されません。
    エージェントがバックグラウンドでデーモンプロセスとして実行している場合は、スクリプト(rhq-agent-wrapper.sh|bat)を使用してシャットダウンし、再起動します。
  2. 設定の編集後にエージェントを再起動します。
エージェントを再起動すると、その新規 IP アドレスが使用されます。
問:
サーバーが稼働状態のままになったときに、サーバーが稼働し続けることをエージェントが停止するにはどうすればよいですか?
答:
エージェントログに以下のようなエラーが表示される可能性があります。
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
つまり、エージェントは自動検出され、マルチキャスト検出を介してサーバーがダウンしてからバックアップされます。これは、エージェントがサーバーのステータスの検出を試みる 2 番目の方法である discovery-via-polling とは異なります。
エージェントが稼働中またはダウンしたサーバーを正しく検出している場合は、ネットワークがマルチキャストトラフィックに対応していないか、マルチキャストネットワークが異常に動作している可能性があります。いずれの場合も、エージェントマルチキャスト検出を無効にし、代わりにポーリングに依存してサーバーステータスの変更を検出します。
マルチキャスト検出を無効にするには、以下のエージェント設定を false に設定します。
  • rhq.agent.server-auto-detection
  • rhq.communications.multicast-detector.enabled
マルチキャスト検出を無効にするため、ポーリング検出機能が有効になっていることを確認してください。つまり、rhq.agent.client.server-polling-interval-msecs 値が 0(通常は 60000)よりも大きくなります。それ以外の場合は、エージェントはサーバーがダウンしたタイミングを認識できません。
エージェントを再設定したら、通信サブシステムが変更を検出できるようにエージェントを再起動します。

A.6. ログメッセージ

問:
「Command failed to be authenticated」メッセージとは
答:
エージェントには、最初にサーバーに登録する際にセキュリティートークンが割り当てられます。トークンは、エージェントがサーバーとともに自己識別する方法です。エージェントがトークンで自身を識別しない場合や、誤ったトークンで自身を特定すると、サーバーはそのエージェントへのアクセスを拒否します。このため、サーバーは、エージェントが適切に登録されるまで、そのエージェントからのコマンドを拒否します。
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]
通常、認証エラーの失敗 は、エージェントの設定が間違っていること、または別のエージェントとして自身を識別しようとする未知のエージェントであることを意味します。--cleanconfig コマンドラインオプションを使用してエージェントを再起動して、その設定をクリーンアップし、再登録します。
注記
JBoss ON 環境を侵入から保護する方法として、セキュリティートークンメカニズムに依存しないでください。エージェントサーバー通信用に SSL を設定します。
問:
「 fail-safe cleanup」メッセージとは?
答:
これらのメッセージは無視できます。これは、JBoss ON によって使用される Hibernate サービスと、メモリーリークを防ぐために、それ自体が自動的にクリーンアップされる方法に関連しています。
13:43:10,781 WARN [LoadContexts] fail-safe cleanup (collections) : 
org.hibernate.engine.loading.CollectionLoadContext@103583b 
<rs=org.postgresql.jdbc3.Jdbc3ResultSet@d16f5b>

A.7. サーバーおよびエージェントプラグイン

問:
JBoss ON の拡張方法
答:
他の外部プロジェクトやカスタムアプリケーションをサポートするために、新しいプラグインを作成できます。
問:
JBoss ON のプラグインを作成するにはどうすればよいですか?
答:
エージェントおよびサーバープラグインの記述は、JBoss ON のドキュメントセットの『プラグインガイド 『』 で説明しています。
問:
スケルトンプラグインモジュールとは何ですか?
答:
カスタムプラグインの作成を開始するには、JBoss ON ソースコードで利用可能なテンプレートである custom-plug-in maven モジュールスケルトンから始まります。これには、定義された依存関係、リソースコンポーネントのスターターセット、および最小 rhq-plug-in.xml プラグイン記述子が含まれる Maven pom が含まれます。

A.8. 一般的なリソースに関する質問

問:
インベントリーからプラットフォームを削除しました。再検出するにはどうすればよいですか?
答:
エージェントのコマンドプロンプトで以下のコマンドを実行して、エージェントの検出を強制できます。
> discovery -f
問:
Red Hat Enterprise Linux プラットフォームでは、インターフェース「sit0」が検出されますが、常に red になります。インベントリーからこのインターフェースを削除するにはどうすればよいですか?
答:
ネットワークアダプターは子サービスであるため、現時点で JBoss ON に無視するか、インベントリー化しないように指示することはできません。
ただし、マシン自体でこのインターフェースを簡単に無効にする方法はあります。このボックスへの root または sudo アクセスがある場合は、IPv6 サポートをすべて無効にします。
NETWORKING_IPV6 値を /etc/sysconfig/network以下のように変更します。
NETWORKING_IPV6=no
警告
このインターフェースを無効にすると、IPv6 サポートが無効になります。
次に、以下の行 /etc/modprobe.conf を追加します。
alias net-pf-10 off
alias ipv6 off
ipv6tables サービスを停止します。
service ip6tables stop
ipv6tables サービスを無効にします。
chkconfig ip6tables off
問:
syslog メッセージを JBoss ON イベントとして収集するにはどうすればよいですか?
答:
Linux プラットフォームプラグインは、syslog メッセージをイベントとして送信して監視できます。syslog メッセージは、syslog メッセージファイルを読み取るか、またはソケットリスナー経由でそれらを受信することでプラグインによって収集されます。
syslog は、JBoss ON が解析できる方法でメッセージをフォーマットするように設定する必要があります。JBoss ON(プラットフォームのプラグイン設定または接続プロパティー)に対して正規表現が syslog メッセージを解析できるか、または syslog 設定ファイル(/etc/rsyslog.conf)でメッセージをフォーマットして JBoss ON が理解できるようにします。例:
$template RHQfmt,"%timegenerated:::date-rfc3339%,%syslogpriority-text%,%syslogfacility-text%:%msg%\n"
この形式 RHQfmt でメッセージを書き出すために syslog 設定で使用する場合、JBoss ON はログメッセージを完全に理解します。例:
$template RHQfmt,"%timegenerated:::date-rfc3339%,%syslogpriority-text%,%syslogfacility-text%:%msg%\n"
*.* /var/log/messages-for-rhq;RHQfmt
*.* @@127.0.0.1:5514;RHQfmt
どちらも syslog メッセージに書き込み、プラットフォームの接続プロパティーで設定されるポート 5514 のリスナーに TCP 経由でメッセージを /var/log/messages-for-rhq 送信します。
問:
Red Hat Enterprise Linux では、スクリプトリソースの実行に失敗します。
答:
スクリプトリソースで Execute 操作を呼び出すと、スクリプトを実行できないことを示すエラーメッセージですぐに失敗します。スクリプト自体が実行可能であることを確認します。以下を実行するスクリプトを設定します。
chmod a+x scriptname

A.9. JBoss リソース

問:
すべての JNP クレデンシャルがリソースの接続プロパティーで適切に設定されていても、JBoss AS サーバーが緑色の可用性を示し、1 つの JBoss AS サーバーのみが緑色の状態で表示されるのはなぜですか?
答:
JBoss AS JNP クライアントの動作方法に問題があります。複数の JBoss AS サーバーを 1 つのボックスで管理する場合、これらのサーバーのセキュリティークレデンシャルはすべて同じである必要があります(例: JNP のユーザー名とパスワードは同じである必要があります)。
問:
JBoss EAP 5 や Tomcat などのサーバーをインポートする場合、インベントリー内に子 JVM リソースが表示されますが、これは Red(DOWN)になります。なぜですか?
答:
JMX リモーティングを有効にしてサーバーが セキュア化 された場合、適切な認証情報を検出できないため、エージェントは JMX サーバーに接続できません。
たとえば、JMX サーバーに以下のシステムプロパティーがある場合:
-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
エージェントの JMX プラグインは JMX サーバーのプロセスに対するコマンドラインを検査し、JMX サーバーがリモートおよびセキュアであることを確認し、セキュアでリモートの JMX コネクターを設定しようとします。エージェントには適切な認証情報がないため、リモート JMX MBean サーバーに接続できず、DOWN 状態にあることを前提とします。
リソースの Inventory タブでリソースのを編集 Connections Settingsし、JMX リモートアクセスファイルに設定した有効なユーザー名とパスワードを入力します。これにより、JBoss ON がリモート JMX エンドポイントを通過できるようになります。
JBoss ON は親リソースに接続し、それを使用して JMX サーバーに接続できます。この場合、Connection Settings サブタブで、プロパティー 以外 の接続プロパティーの設定 Type を解除し Parentます。JVM の親 JBoss EAP リソースは、JVM に接続するための情報を提供できます。
問:
JBoss EAP インスタンスの監視を試みると、「Connection failure Failed to authenticate principal=null, securityDomain=jmx-console」というエラーが表示されます。
答:
JBoss EAP の ドキュメントおよび JBoss EAP 4.3 ドキュメント で説明されているように、jmx-console はデフォルトでセキュア化されます。EAP のドキュメントに記載されているユーザー名とパスワードを定義します。その後、このユーザー名とパスワードを JBoss EAP インスタンスの Inventory> Configuration Properties ページの下に追加します。
注記
設定パラメーター(-c)を指定せずに JBoss EAP インスタンスを起動すると、実稼働設定でインスタンスが開始されます。
問:
JBoss AS インスタンスを監視する場合、その下には JVM リソースは表示されません。
答:
JBoss ON で JBoss AS リソースの JVM リソースを検出するには、対応する JBoss AS インスタンスが Java 5 以降を実行している必要があります。また、以下から開始する必要もあります。 jboss.platform.mbeanserver システムプロパティーが設定されている。たとえば、Red Hat Enterprise Linux では、この ${JBOSS_HOME}\bin\run.conf ファイルには以下の設定が必要です。
JAVA_OPTS="$JAVA_OPTS -Djboss.platform.mbeanserver"
問:
JBoss AS 5.1 を監視できますか?
答:
いいえ。エージェントが検出しないように、JBoss AS 5.1 プロファイルサービスに問題があります。
JBoss EAP 5.0 以降のバージョンおよび JBoss AS 6.0 を監視できます。
問:
エージェントは JBoss サーバーを検出し、接続プロパティーを取得できますが、JNP 接続は失敗します。なぜですか?
答:
これは、などの pathname にスペースを持つディレクトリーにエージェントがインストールされている場合に、主に Windows で実行され C:\Program Filesます。
エージェントが JBoss サーバーを検出し、その接続プロパティーをすべて検索できる場合は、ログでプロファイルサービスへの接続に失敗したかどうかを確認します。
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]
エージェントを pathname に空白のないディレクトリーに移動し、JBoss リソースを再検出します。

A.10. Postgres リソース

問:
ユーザー「postgres」に対して認証に失敗したことに関する PostgreSQL 検出でエラーが表示されるのはなぜですか?
答:
Postgres プラグインは、Postgres のユーザー名とパスワードを使用してデータベースサーバーにログインしようとします。多くのインストールでは、これはデフォルトのスーパーユーザーであり、機能します。ただし、以下の複数の理由でこのログインが失敗する可能性もあります。
  • postgres ユーザーが削除されている。
  • postgres ユーザーのパスワードが変更になりました。
  • Linux では、管理ログインがに設定されてい ident sameuserます。
これを解決するには、以下を行います。
  • 検出された Postgres リソースをインベントリーします。この可用性はダウン状態になり、子リソースを見つけることはありません。
  • Postgres リソースの INVENTORY タブに移動します。
  • の下 Connection Propertiesにある Edit ボタンをクリックします。
  • Postgres インスタンスで有効なスーパーユーザーアカウントを反映するように、ロール名およびパスワードフィールドを変更します。
さらに、pg_hba.conf ファイルの設定を変更してパスワードベースのログインを許可するために、Red Hat Enterprise Linux システムで Postgres を変更する必要がある場合があります。
問:
なぜ Postgres リソースのメトリクスが NaN として表示されるのはなぜですか?
答:
多くのインストールでは、Postgres はデフォルトで統計コレクターを開始しません。統計収集を有効にするには、postgres.conf ファイルで以下の行を追加または変更します。
stats_start_collector = on
問:
Postgres データベースの監視に必要なデータベース接続の数
答:
JBoss ON に準拠する各 Postgres データベースには 1 つの接続が必要です。
問:
JBoss ON で永続化されているデータベースをドロップできないのはなぜですか?
答:
可用性および統計の監視頻度により、Postgres プラグインはデータベースへの接続を開放します。JBoss ON で現在使用されているデータベースを破棄しようとすると、使用中のデータベースに関するエラーが発生します。データベースをドロップするには、データベースを監視する JBoss ON エージェントまたはデータベースリソースを JBoss ON から削除する必要があります。これにより、Postgres プラグインの Postgres サーバーへの接続が閉じ、データベースをドロップすることができます。

A.11. Apache リソース

問:
Apache コネクターはどこで取得できますか?
答:
Apache プラグインは、SNMP コネクターなどのカスタムモジュールを介して Apache Web サーバーを監視します。コネクターは、GUI の Downloads ページの JBoss ON サーバーからダウンロードできます。
問:
Response Time モジュールで Apache をインストルメント化しましたが、VirtualHosts に対して RT メトリックは表示されていません。
答:
VirtualHosts に RT メトリクスが表示されていない場合は、以下の 2 つの確認を行う必要があります。
  1. エージェントのシステムユーザーが _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 として実行するのは残りの唯一のオプションです。
  2. Apache Vhost テンプレートに対する Response Time Metric を有効にし、応答時間が有効にされているか?これはデフォルトで無効になっています。
これを行うには、以下に移動します。
  1. Administration > > System Configuration Templates | Apache HTTP Server> Apache Virtual Hostで、をクリックし Edit Metric Templateます。
  2. の横にあるチェックボックスを選択し HTTP Response Timeます。
  3. ページの下部で、を選択し Update schedules for existing resources of marked typeます。
  4. コレクションの間隔を設定します。
  5. Go ボタンをクリック[>]します。
注記
RT メトリクスが機能するようになりました。メトリクスが表示されるまでに約 10 分かかる場合があります。
問:
Apache メトリクスの一部はゼロの値を表示します。なぜですか?
答:
SNMP モジュールでモニタリングする場合は、3 つのメトリクスでゼロの値が表示されます。
  • 1 分あたりの GET リクエストの受信バイト数
  • 1 分あたり POST リクエストの受信バイト数
  • 1 分あたり受信バイト数の合計
これは、SNMP がリクエスト本文から情報を解釈する方法により生じます。まず、SNMP はリクエストボディーにさまざまな長さの値を提供し、GET リクエストにはボディーがないため、GET 応答は計算されず、値をゼロにします。次に、リクエストチャンクがある場合、Apache はリクエストボディーサイズを計算しません。
問:
Augeas プラグインとは何ですか?
答:
Augeas プラグインは、他のプラグインの拡張ポイントとしてのみ存在する抽象プラグインです。Augeas プラグインは、Augeas ネイティブライブラリーにアクセスするために他の依存プラグインに必要な Java JNI クラスを提供します。たとえば、OpenSSHD プラグインは、Augeas ライブラリーを使用して OpenSSH デーモン設定にアクセスするため、Augeas プラグインによって異なります。その他の JBoss ON プラグインは、以下の Augeas プラグインを使用します。
  • hosts
  • grub
  • apt
問:
「java.lang.UnsatisfiedLinkError: Unable to load library 'augeas': libaugeas.so: cannot open shared object file: No such file or directory"?
答:
これは、Augeas ベースのプラグインがデプロイされていることを意味しますが、Red Hat Enterprise Linux ボックスには Augeas ネイティブライブラリーがインストールされていません。Augeas ライブラリー インストールに関する詳細は、http://augeas.net を参照してください。
問:
Apache SNMP モジュールがエラーを出して起動できないのはなぜですか?
答:
一般的なエラーと原因がいくつかあります。
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 リソース

問:
Tomcat リソースの Configuration タブに移動すると、「 this resource's configuration has not been initialized」というエラーが表示されます。なぜですか?
答:
特に、 リソースにアクセスし、Configuration タブを開くとエラーが発生します。
そのため、設定管理が Tomcat リソースに対して有効になっていません。これを行うには、Tomcat サーバーのタブに移動し、Connections サブ Inventory タブを開いて、設定を明示的に有効にします。

A.13. プロビジョニングおよびコンテンツ

問:
Ant レシピ XML を直接アップロードしてバンドルを作成しようとすると、XML コンテンツが破損したと思われ、タグは古い順に配置されます。
答:
ANT スクリプトをレシピとしてアップロードする場合は、のような XML 表記を使用することはできません <property name="a" />。のように、明示的に定義されたクローズタグが必要です <property name="a"></property>。Ant スクリプト XML ファイルを訂正しない場合は、ファイルのアップロードの代わりに、レシピを直接 text フィールドに貼り付けます。
問:
JBoss ON の JBoss パッチコンテンツ機能は実際に何を行うのですか?完全に自動化されているか?
答:
パッチプロセスにより、パッチ zip に含まれるアップグレードされた jar/class ファイルが含まれる既存の jar/class ファイルが更新されます。非実行手順など、一部の変更は手作業で完了しなければならない 場合があります。設定にパッチが適用される jar の 1 つが含まれない場合、そのステップはスキップされます。
パッチプロセスでは、サーバー設定プロファイルが呼び出されるか、または派生するベースイメージを明示的に考慮しません。
JBoss サーバーのパッチや JBoss ON リソースへのコンテンツをストリーミングするその他の方法は、『 『基本的な管理ガイド』』 で説明されています。

A.14. アラート

問:
アラート定義を作成しました。エージェントが直ちにアラートを発生させるはずのデータを報告していることがわかります。しかし、警告は表示されません。なぜですか?
答:
アラート定義が作成されると、JBoss ON サーバーアラートキャッシュに挿入してから JBoss ON サーバークラウド全体で伝播するのに数秒かかります。アラート定義がサーバーアラートキャッシュにあるまでアラートは起動されません。
アラート定義がキャッシュに挿入されると、メッセージは JBoss ON サーバーログに記録されます。
INFO  [CacheConsistencyManagerBean] localhost took [51]ms to reload global cache
INFO  [CacheConsistencyManagerBean] localhost took [49]ms to reload cache for 1 agents
通常、アラート定義がキャッシュに追加されるまで約 30 秒かかります。定義の作成後、1 分以上待ってからアラートが発生しているかどうかを確認します。
問:
同じメトリクスを使用している場合に、各種のアラート定義条件の異なるメトリクス値でアラートがトリガーされるのはなぜですか?
答:
これは、エージェントからデータを測定する際にアラート条件がどのように処理されるかによって発生する可能性があります。これは、単一のアラート定義に同じメトリクスを使用する複数の条件があり、そのアラート定義が「ALL」と併用される場合に発生します。たとえば、アラート定義に「alert if metric X is greater than 5」の条件が 1 つあり 「alert if metric X less than 10」という条件が異なります。
アラート条件範囲は、範囲のチェックを実行してこれを回避します。詳細は、Bugzilla 735262 を参照してください

A.15. 監視

問:
Events タブが「ログイベントソース」のいずれかのイベントをキャプチャーしないのはなぜですか?
答:
イベントソースを定義する際には、以下の 3 つの項目を確保する必要があります。
  • 有効になっています。
  • ログへのパスが有効である。
  • 選択した日付の形式がログにあるものと一致します。
イベントソースの作成時にデフォルトの日付形式を選択し、その形式がログにある内容と一致しない場合、ログイベントについて何もキャプチャーされません。
たとえば、デフォルトの日付形式 2017-07-14 15:36:25,075 を選択し、ログに 2017.08.27-09:46:34 の場合、ログイベントはキャプチャーされません。
の説明に従って、異なる日付形式を指定します。 java.text.SimpleDateFormat.
問:
ベースラインの自動計算を行うタイミング
答:
JBoss ON GUI の Administration ページに移動し、Server Configuration リンクをクリックします。の設定が表示され Automatic Baseline Configuration Propertiesます。は、ベースラインが計算される頻度を Baseline Frequency 決定します。デフォルトは 3 日です。つまり、ユーザーが手動で設定したものを除き、3 日ごとに新しいベースラインのセットが計算されます。これらはユーザーが設定したベースラインに固定されたままになります。
Baseline Dataset 測定の基準が計算される前に測定用に収集された必要のあるデータの最小セットを決定します。デフォルトは 7 日です。たとえば、ベースラインの計算が必要となると判断されると、デフォルトでは 3 日ごとに、7 日間またはそれよりも古いデータがある測定値のみに基準が算出されます。7 日前のデータがない測定は省略されます。これにより、測定のベースラインが計算されると、計算に含める適切なデータの代表的なセットがあります(デフォルトでは、基準計算に含まれるデータが 7 日になります)。

A.16. operations

問:
「 Operations」タブをクリックしましたが、利用可能な操作は表示されません。また、「表示しない項目」と書かれています。 操作のスケジュール方法
答:
この Schedules タブには、スケジュールされた操作の一覧が表示されます。これは、設定済みですが実行されていない操作を示します。スケジュールされた操作がない場合、タブには No items to show を読み取る説明があります。
これは、リソースに利用できる操作がないことを意味します。つまり、操作がスケジュールされていないことを意味します。
操作をスケジュールするには、Operations タブ New の左下隅をクリックし、操作情報を入力します。