The default hostname for a Solace PubSub+ event broker is
solace. Note that this hostname is typically used in the examples throughout the product documentation. However, you should change the hostname through the Solace CLI to something that is more descriptive and differentiates it from other event brokers. In addition, if you are using multi-node routing, you must configure unique hostnames because nodes in a multi-node network must have a unique router name.
For appliances, hostnames are typically configured through the
setup Privileged EXEC command that is used to initially configure appliances (refer to Initial Set Up). However, you can also use the following commands to configure a new hostname for an event broker.
Config-Sync will not automatically synchronize this object/property. Therefore, if the Solace PubSub+ 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 Config-Syncʼed, look up the command used to configure the object/property in the Command Line Interface Reference, or, in the Solace CLI, end the command with “?”. The Help will list whether the object/property is Config-Syncʼed.
To configure an appliance hostname, do the following:
- Enter the following command to check the current host name and any deferred host name (that is, a host name that may be set to be applied on the next event broker restart):
solace> show hostname
- To change the hostname, enter the following commands:
solace(configure)# hostname <name> [defer]
<name>is the hostname of the event broker. Host 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 hostname. Host names must be unique among all configured event brokers.
deferspecifies 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
hostnameGlobal CONFIG command is issued, the system prompts you to confirm the hostname change, and then it automatically powers down and restarts the event broker.
The no version of this command,
no hostname, resets the host name to the default value of
For software event broker machine images, it is possible for hostnames to be automatically set in some environments. For example it is common in cloud environments for a configuration agent to set the hostname automatically when an instance is created. The event broker will learn the hostname from the system the first time it starts up. Therefore, it is generally not advisable to change the hostname from that which the cloud provider assigns.
For software event broker Docker containers, the hostname is assigned when the container is created—it cannot be changed after. You can use the
docker create command option
–-hostname to assign the hostname when the container is created. For more information about support for docker create options, see Docker Create Options Configuration.