Router Name Configuration

By default, the router name automatically mirrors the assigned hostname such that if the operator changes the hostname, the router name also changes to match it.

Configuring with the Solace CLI

Config-Sync will not automatically synchronize this object or property. Therefore, if the event broker is being used in a high-availability (HA) redundant configuration or in a replicated site, you must manually configure this object/property on each mate event broker or replicated Message VPN.

To determine whether an object/property is synchronized by Config-Sync, look up the command used to configure the object/property in the CLI Command Reference or type the command in the Solace CLI, ending the command with "?". The Help lists whether the object/property is synchronized.

For a Solace PubSub+ event broker, if you want to configure a router name that is separate from the hostname, enter the following CONFIG command in the Solace CLI:

solace(configure)# router-name <name> [defer]

Where:

<name> is the router name. Router names can contain up to 64 characters, composed of alphanumeric characters 0 to 9, a to z, A to Z, underscore '_', dot '.', and hyphen '-'. Note that '_', '.' and '-' cannot be used at the beginning or end of a router name. Router names must be unique among all configured event brokers.

defer specifies that the name change is to be deferred until the next time an event broker restart occurs. If this option is not specified when the router-name CONFIG command is issued, the system prompts you to confirm the router name change, and then it automatically powers down and restarts the event broker.

The no version of this command, no router-name, deletes the given name from the event broker, and it causes the router name to again mirror the hostname such that if the operator changes the hostname, the router name also changes to match it.

Configuring with Configuration Keys

For a Solace PubSub+ software event broker container, you can use the routername configuration key to set the router name that is used when the software event broker container is created. For more information, see Initializing a Software Event Broker Container.