NAME

qdmanage - A management tool for Dispatch routers.

SYNOPSIS

qdmanage operation [options...] [arguments...]

DESCRIPTION

An AMQP management client for use with qdrouterd. Sends AMQP management operations requests and prints the response in JSON format. This is a generic AMQP management tool and can be used with any standard AMQP managed endpoint, not just with qdrouter.

OPERATIONS

query [ATTR...]

Prints the named attributes of all entities. With no arguments prints all attributes. The --type option restricts the result to entities extending the type.

create [ATTR=VALUE...]

Create a new entity with the specified attributes. With the --stdin option, read attributes from stdin. This can be a JSON map of attributes to create a single entity, or a JSON list of maps to create multiple entitiees.

read

Print the attributes of an entity specified by the --name or --identity options. With the --stdin option, create entities based on data from stdin. This can be a JSON map of attributes to create a single entity, or a JSON list of maps to create multiple entitiees.

update [ATTR=VALUE...]

Update the attributes of an existing entity. With the --stdin option, read attributes from stdin. This can be a JSON map of attributes to update a single entity, or a JSON list of maps to update multiple entitiees. If an ATTR name is listed with no =VALUE, that attribute will be deleted from the entity.

delete

Delete an entity specified by the --name or --identity options.

get-types [TYPE]

List entity types with their base types. With no arguments list all types.

get-operations [TYPE]

List entity types with their operations. With no arguments list all types.

get-attributes [TYPE]

List entity types with their attributes. With no arguments list all types.

get-annotations [TYPE]

List entity types with their annotations. With no arguments list all types.

get-mgmt-nodes
List all other known management nodes connected to this one.

OPTIONS

-h, --help

show this help message and exit

--version

Print version and exit.

--type=TYPE

Type of entity to operate on.

--name=NAME

Name of entity to operate on.

--identity=ID

Identity of entity to operate on.

--indent=INDENT

Pretty-printing indent. -1 means don't pretty-print (default 2)

--stdin

Read attributes as JSON map or list of maps from stdin.

CONNECTION OPTIONS

-b URL, --bus=URL

URL of the messaging bus to connect to (default 0.0.0.0)

-r ROUTER-ID, --router=ROUTER-ID

Router to be queried

-t SECS, --timeout=SECS

Maximum time to wait for connection in seconds (default 5)

--sasl-mechanism=MECH

Force SASL mechanism (e.g. EXTERNAL, ANONYMOUS, PLAIN, CRAM-MD5, DIGEST-MD5, GSSAPI).

--ssl-certificate=CERT

Client SSL certificate (PEM Format)

--ssl-key=KEY

Client SSL private key (PEM Format)

Run qdmanage --help to see options.

FILES

/usr/local/share/doc/qpid-dispatch/qdrouter.json
Management schema for qdrouterd.
/usr/local/share/doc/qpid-dispatch/qdrouter.json.readme.txt
Explanation of the management schema.

EXAMPLES

Show the logging configuration

qdmanage query --type=log

Enable debug and higher log messages by default:

qdmanage udpdate name=log/DEFAULT enable=debug+

Enable trace log messages only for the MESSAGE moudle and direct MESSAGE logs to the file "test.log"

qdmanage udpdate name=log/MESSAGE enable=trace output=test.log

Set MESSAGE logging back to the default:

qdmanage udpdate name=log/MESSAGE enable=default

Disable MESSAGE logging:

qdmanage udpdate name=log/MESSAGE enable=none

SEE ALSO

qdrouterd(8), qdstat(8), qdrouterd.conf(5)

http://qpid.apache.org/components/dispatch-router