IP Addressing in Hypervisor Environments

The default behavior for a Solace PubSub+ software message broker in a hypervisor is to dynamically receive its IP address configuration from the host. Alternatively, it is possible to manually associate a Solace PubSub+ IP interface with a host OS physical interface. For example, you may have two host Ethernet interfaces and want to switch the Solace PubSub+ IP interface (intf0) physical port mapping from eth0 to eth1.

In this section, an example is shown on how to manually assign a host Ethernet interface to a Solace PubSub+ physical interface; however, the software message broker portion of the configuration steps can be done with configuration keys and cloud-init on first start-up of the software message broker. Using cloud-init and configuration keys is the recommended approach to configuration in production environments, and for further information on using cloud-init, refer to Initializing with Cloud-Init.

The following example shows how to manually assign a host Ethernet interface (eth1) to a Solace PubSub+ physical interface (intf0):

  1. Log into the host as sysadmin through the VM console.
  2. On the host, configure an Ethernet interface (for example, eth1). For a discussion on host interface configuration refer to Software Message Broker Host Interface Configuration
  3. Enter the following command to access Solace CLI:

    [sysadmin@ip-177-0-128-20 ~]$ solacectl cli

  4. Once inside Solace CLI, the first step is to shutdown intf0:

    ip-177-0-128-20> enable
    ip-177-0-128-20# configure
    ip-177-0-128-20(configure)# ip vrf management
    ip-177-0-128-20(configure/ip/vrf)# interface intf0:1
    ip-177-0-128-20(configure/ip/vrf/interface)# shutdown

    Changing management addresses or default routes may leave

    the appliance unreachable over a network connection.

    As well changing management addresses results in newly

    unreachable routes being deleted.

    Do you want to continue (y/n)? y

  5. The next step is to perform the assignment of eth1 to intf0:
  6. ip-177-0-128-20(configure)# interface intf0
    ip-177-0-128-20(configure/interface)# os-physical-interface eth1
    ip-177-0-128-20(configure/interface)# exit
    ip-177-0-128-20(configure)# ip vrf management
    ip-177-0-128-20(configure/ip/vrf)# interface intf0:1
    ip-177-0-128-20(configure/ip/vrf/interface)# no shutdown

    The association between the host Ethernet interface and the Solace PubSub+ physical interface will immediately take effect.

  7. Enter the following show command to confirm the assignment:

    ip-177-0-128-20(configure)# show interface intf0

    Interface: intf0

    OS Physical Interface: eth1

    MAC address: 02:56:4d:52:84:01

    Enabled: yes

    Operational State: Up

    Last Failure Reason: N/A

    Last Failure Time: N/A

    Rx pkts:           37741      Rx bytes:     2437254

    Tx pkts:            1163      Tx bytes:      134416

    Link detected: yes

    Media type: N/A