Configure communication broker ports

You configure communication broker ports by setting the PORTS parameter in the bbc.cb.ports name space on all OMi servers and HPE Operations Agents that communicate with each other. You can configure this parameter by using ovconfchg at a command prompt.

The values must contain one or more host names or IP addresses and have the following format:

<host>:<port>[,<host>:<port>] ...

The <host> can be either a domain name or IP address.

If you must configure communication broker ports on multiple systems, you can use wildcards and ranges, as follows:

• You use a wildcard at the start of a domain name by adding an asterisk (*).

  Example:

  • *.emea.example.com:5000

  • *.test.com:5001

  • *:5002

• You can use wildcards at the end of an IP address by adding up to three asterisks (*).

  Example:

  • 192.168.1.*:5003

  • 192.168.*.*:5004

  • 10.*.*.*:5005

• You can replace one octet in an IP address with a range. The range must be before any wildcards.

  Example:

  • 192.168.1.0-127:5006

  • 172.16-31.*.*:5007

Using multiple values in the PORT parameter

If you specify multiple values for the PORTS parameter, separate each with a comma (,).

Example:

ovconfchg -ns bbc.cb.ports -set PORTS *.emea.example.com:5000,10.*.*.*:5005

When you specify multiple values using wildcards and ranges that overlap, the server or node selects the port to use in the following order:

• Fully qualified domain names.

• Domain names with wildcards.

• Complete IP addresses.

• IP addresses with ranges.

• IP addresses with wildcards.

Example PORT parameter with multiple values and wildcards

Configure communication broker ports on all OMi servers and monitored nodes with the following command:

ovconfchg -ns bbc.cb.ports -set PORTS *.emea.example.com:6000,10.*.*.*:6001,loadbalancer.emea.example.com:6002,10.0-127.*.*:6003

The following ports will be used:

• Hostname: node1.asia.example.com
IP address: 10.127.1.1
Communication broker port: 6003.

• Hostname: loadbalancer.emea.example.com
IP address: 10.1.1.1
Communication broker port: 6002.

• Hostname: node1.test.com
IP address: 192.168.1.1
Communication broker port: 383.

1. Log in to the system that you want to configure as a user with administrative rights and open a command prompt or shell.

2. On systems that run a UNIX or Linux operating system, ensure that the PATH variable contains the path to the agent commands.

   • On HP-UX, Solaris, or Linux, type export PATH=/opt/OV/bin:$PATH and then press Enter.

   • On AIX, type export PATH=/usr/lpp/OV/bin:$PATH and then press Enter.

3. On the HPE Operations Agent system, set the new communication broker port:

   ovconfchg -ns bbc.cb -set SERVER_PORT <port>

   Restart the communication processes:

   ovc -kill
ovc -start

4. On all systems that open connections to this HPE Operations Agent system, configure the communication broker to send communication to the new port:

   ovconfchg -ns bbc.cb.ports -set PORTS <host>:<port>

   If the PORTS parameter is already set, use ovconfchg -edit and append the hostname and port to the existing value.

To organize settings for many communication broker ports, you have the following options:

• You can add parameters of any name in the bbc.cb.ports name space.

  Example:

  ovconfchg -ns bbc.cb.ports -set CB_OM *.emea.example.com:6000,10.*.*.*:6001
ovconfchg -ns bbc.cb.ports -set CB_OMi omi.emea.example.com:6002,10.0-127.*.*:6003

  The value of any parameter in the name space is evaluated. The PORTS parameter is optional.

• You can specify values on separate lines in a text file.

  Example:

  *.emea.example.com:6000
  10.*.*.*:6001
  omi.emea.example.com:6002
  10.0-127.*.*:6003

  Save the file in the folder <data_dir>/conf/bbc. Use the following command to configure the system to read the file:

  ovconfchg -ns bbc.cb.ports -set CB_PORTS_CFG_FILE <file_name>