Configuration files

The default configuration file is in source-dir/etc/qdrouterd.conf. This configuration file will cause the router to run in standalone mode, listening on the standard AMQP port (5672). When run, Dispatch Ruter looks for the configuration file in /etc/qpid-dispatch/qdrouterd.conf by default. If you wish to use a different path, the "-c" command line option will instruct Dispatch Router as to which configuration to load.

An example conf file is

# Config file for router listening on default amqp port
container {
    worker-threads: 4
    container-name: QDR.X
}

listener {
    addr: 0.0.0.0
    port: amqp
    sasl-mechanisms: ANONYMOUS
}

connector {
    role: inter-router
    addr: 0.0.0.0
    port: 20005
    sasl-mechanisms: ANONYMOUS
}

router {
    mode: interior
    area: A
    router-id: QDR.X
}

There are up to five sections in the config file

- container -- The general operation of the AMQP container

   container-name
          The name of the AMQP container. If not specified, the container name will be set to a value of the container's choosing.
          The automatically assigned container name is not guaranteed to be persistent across restarts of the container.

   worker-threads
          The number of threads that will be created to process message traffic and other application work 
          (timers, non-amqp file descriptors, etc.)

- ssl-profile (optional) -- Zero or more SSL profiles may be defined and then referenced later in listeners (for incoming connections) or connectors (for outgoing connectors).

   name   The name of the profile to be referenced later.

   cert-db
          The path to the database that contains the public certificates of trusted certificate authorities (CAs).

   cert-file
          The path to the file containing the PEM-formatted public certificate to be used on the local end of any connections
          using this profile.

   key-file
          The path to the file containing the PEM-formatted private key for the above certificate.

   password-file
          If the above private key is password protected, this is the path to a file containing the password that unlocks 
          the certificate key.

   password
          An alternative to storing the password in a file  referenced  by password-file is to supply the password right here in the 
          configuration file. This option can be used by supplying the password in the 'password' option. Don't use both password and
          password-file in the same profile.

- listener and connector -- Location and security for listeners and connectors

   addr   The listener or connector IP address

   port   The listener or connector port

   sasl-mechanisms
          A list of accepted SASL mechanisms

- router -- Router specific settings

   mode   One of "standalone", "interior", or "edge". In standalone mode, the router operates as a single component. It does not 
          participate in the routing protocol and therefore will not coorperate with other routers. In interior mode, 
          the router operates in cooreration with other interior routers in an interconnected network. In edge mode, the router 
          operates with an uplink into an interior router network. Edge routers are typically used as connection  concentrators  
          or as security firewalls for access into the interior network.

   router-id
          Each router is assigned a router-id that is unique. For interior router mode only.

Comments are entered by starting the line with a #

index