Broker 10.15 | webMethods Broker Documentation | Administering webMethods Broker | Managing Broker Servers | Configuring the hostname Parameter
 
Configuring the hostname Parameter
The domain name service (DNS) used by the host machine where the Broker Server is running must be capable of bi-directional name resolution. This means that your DNS must be able to resolve the name of the host machine to the correct IP address and also be able to resolve the machine's IP address back to the correct name.
When a host machine uses the Dynamic Host Configuration Protocol (DHCP) to dynamically obtain its IP address, many DNS servers will not return the correct name for a given IP address. In this case, you must contact your IT department or your network administrator and ask that a static IP address be assigned to the host machine.
Verify the name and IP address of the host machine by using the commands described in the section Reverse Lookup below.
Unless the 'hostname' parameter is set, Broker Server will perform a reverse DNS lookup to obtain its hostname. If hostname resolution is not working correctly, then connectivity between Brokers may not work reliably. If reverse lookup does not give correct results, then you must set the 'hostname' parameter. For more information, see webMethods Broker Server Configuration Parameters.
Note:
If the Broker Server is running in one of the following setups, then the hostname must be resolved correctly:
*Territory/territory gateway
*Cluster/cluster gateway
*High availability active/passive setup
*Cloud infrastructure such as AWS and Azure.
Reverse Lookup
Broker relies on reverse DNS lookup to determine the numeric IP address and the host name. Reverse lookup is also applicable when you create and use a connection factory with Broker host details.
Use the following commands at the command prompt to verify that the reverse lookup gets the fully qualified domain name (FQDN).
Command
Description
nslookup <hostname>
Displays the fully qualified domain name and IP address of:
*DNS
*Host machine identified by hostname.
nslookup <hostIP>
Displays the fully qualified domain name and IP address of:
*DNS
*Host machine identified by hostIP.
nslookup -query=ptr <reverse IP>.in-addr.arpa <DNS>
Displays the fully qualified domain name of the host machine for which you specified the reverse IP address ( reversIP ) of the host machine and the fully qualified domain name of the DNS ( DNS ).