第15章 qdmanage を使用した管理

qdmanage ツールは、ランタイム時に実行中のルーターの設定を表示および変更するコマンドラインツールです。

注記

qdmanage を使用してルーターに変更を加えると、変更はすぐに有効になりますが、ルーターは停止した場合に失われます。ルーターの設定に永続的な変更を加える場合は、ルーターの /etc/qpid-dispatch/qdrouterd.conf 設定ファイルを編集する必要があります。

以下の構文で qdmanage を使用できます。 

$ qdmanage [<connection-options>] <operation> [<options>]

これにより、以下が指定されます。

  • 操作を実行するルーターを指定する 1 つ以上のオプションの 接続オプション や、ルーターがセキュアな接続のみを受け入れる場合はセキュリティー認証情報を指定するための 1 つ以上のオプション。

    接続オプションを指定しない場合、qdmanage は localhost でリッスンするルーターおよびデフォルトの AMQP ポート (5672) に接続します。

  • ルーターで実行する操作。
  • 操作を実行する設定エンティティーを指定する 1 つ以上のオプション、またはコマンド出力のフォーマット方法を指定します。

qdmanage コマンドを入力すると、AMQP 管理操作のリクエストとして実行され、JSON 形式のコマンド出力として応答が返されます。

たとえば、以下のコマンドはルーターでクエリー操作を実行してから、JSON 形式で応答を返します。 

$ qdmanage query --type listener
[
  {
    "stripAnnotations": "both",
    "addr": "127.0.0.1",
    "multiTenant": false,
    "requireSsl": false,
    "idleTimeoutSeconds": 16,
    "saslMechanisms": "ANONYMOUS",
    "maxFrameSize": 16384,
    "requireEncryption": false,
    "host": "0.0.0.0",
    "cost": 1,
    "role": "normal",
    "http": false,
    "maxSessions": 32768,
    "authenticatePeer": false,
    "type": "org.apache.qpid.dispatch.listener",
    "port": "amqp",
    "identity": "listener/0.0.0.0:amqp",
    "name": "listener/0.0.0.0:amqp"
  }
]

関連情報