Configuring Appliance IP Interfaces

To create a physical interface instance on the Solace PubSub+ appliance, enter the following Global CONFIG command:

solace(configure)# create interface <phy-interface> <mode>

To modify an existing physical interface instance on the Solace PubSub+ appliance, enter the following Global CONFIG command:

solace(configure)# interface <phy-interface> [<mode>]

Where:

<phy-interface> is an ASCII string specifying the Ethernet interface port or LAG to be configured. Valid values are chassis/lag1/eth<port> (for example, eth1); <cartridge>/<slot>/<port> (for example, 1/1/8); <cartridge>/<slot>/lag<N> (for example, 1/1/lag1). There is no default value.

<mode> is the LAG mode. The possible values are:

  • LACP—multiple physical Ethernet interfaces are bundled into a single virtual interface
  • active-backup—one physical interface is active, and the other interface is standby

The no version of this command, no interface will delete the given interface.

  • A LAG cannot be created on a slot which does not contain a NAB.
  • A LAG can not be deleted if IP interfaces reference it.

When configuring mated Solace PubSub+ appliances for active/active redundancy, both appliances in the active/active pair must be configured identically; the only exception is identifying whether a client’s configuration is considered to be backup. For example, configuring independent IP interfaces for the eight NAB ports on the primary appliance and pairing it with a single Link Aggregation Group (LAG) interface for the NAB ports on the mate appliance results in unpredictable behavior. This requirement is not enforced by appliances, but operation is unpredictable if the redundant configuration is mismatched on mated appliances. Refer to HA Configuration for Appliances for details on configuring IP interfaces for system redundancy.

Adding Members

To add physical interface members to a LAG on a member by member basis, enter the following Interface CONFIG command:

solace(configure/interface)# member <phy-interface>

Where:

<phy-interface> is an ASCII string specifying the physical interface port on the Management or NAB network interface. Valid values are eth<port> | <cartridge>/<slot>/<port> | <cartridge>/<slot>/lag<N> (for example: eth1, chassis/lag1, 1/5/2, 1/6/lag1). There is no default value.

The no version of this command, no member, removes a member port from a LAG.

Executing the no member Interface CONFIG command may cause a short disruption in customer service to the NAB. CLI and management sessions are unaffected.

Configuring Primary Members

To configure the primary member for active-backup mode, enter the following CONFIG command:

solace(configure/interface)# primary-member <phy-interface>

Where:

<phy-interface> is an ASCII string specifying the physical interface port on the Management or NAB network interface. Valid values are eth<port> | <cartridge>/<slot>/<port> | <cartridge>/<slot>/lag<N> (for example: eth1, chassis/lag1, 1/5/2, 1/6/lag1). There is no default value.

The no version of this command, no primary-member, removes a primary member for active-backup mode.

Configuring Egress Traffic Shaping

To potentially increase the application-level throughput (that is, goodput) rate of messages from an appliance, you can use traffic shaping on physical interfaces. This allows you to adjust the egress data bit rate from the NAB to better match the capabilities of network equipment and applications.

The egress traffic shaping facility is only available for interfaces configured on the following NABs: NAB-0610EM, NAB-0210EM-04, NAB-0401ET-04, NAB‑0801ET‑04, and NAB-0810EM-01. If egress traffic shaping is configured for an interface, but your appliance does not use one of the listed NABs, the configuration will not affect egress traffic rates.

To configure egress traffic shaping for the given physical interface, enter the following CONFIG command:

solace(configure/interface)# traffic-shaping
solace(configure/interface/traffic-shaping)# egress
solace (...gure/interface/traffic-shaping/egress)# rate-limit <mbps>

Where:

<mbps> is the maximum sustained egress rate in Mbps

Operational rates will not exactly match the configured rate. The operational rate limit is a product of CPU timing limitations, and it will reflect the best available match without exceeding the configured value.

Enabling Egress Traffic Shaping

To enable egress traffic shaping on the given physical interface, enter the following CONFIG commands:

solace(configure/interface)# traffic-shaping
solace(configure/interface/traffic-shaping)# egress
solace (...gure/interface/traffic-shaping/egress)# no shutdown

To disable egress traffic shaping on the given physical interface, enter the following Interface CONFIG commands:

solace(configure/interface)# traffic-shaping
solace(configure/interface/traffic-shaping)# egress
solace (...gure/interface/traffic-shaping/egress)# shutdown

Configuring Ingress LACP Control Packet Rates

You can configure the rate at which each LACP LAG interface expects to receive control packets from its peer.

When receiving packets, the NAB uses a fast or slow timeout, depending on the rate you configured for each LAG. It times out any LACP state received from the peer ports three seconds after its reception if the rate is set to fast, or 90 seconds if set to slow. The default is fast, to enable early detection of expired peer LACP state and minimize packet loss.

Configuring the LACP rate has no impact on the rate at which the NAB sends packets to the peer. This rate is determined by the peer.

To configure the ingress LACP control packet rate, enter the following CONFIG commands:

solace(configure/interface)# lacp rate {fast | slow}

Where:

fast configures the interface to expect LACP packets from the peer once every second . This is the default value.

slow configures the interface to expect LACP packets from the peer once every 30 seconds .

The no form of this command no lacp rate sets the rate to the default value.

Starting / Stopping Interfaces

To start the given interface, enter the following CONFIG command:

solace(configure/interface)# no shutdown

To stop the given interface, enter the following CONFIG command:

solace(configure/interface)# shutdown