HBA Replacement

This section describes how to replace Host Bus Adapters (HBAs) in an appliance event broker. The HBA that is replaced could be either the same model or another model that is compatible with an appliance event broker of the same chassis type. The provided HBA replacement procedures preserve any spooled messages.

Before you begin, review the ESD/Safety Precautions and Tool and Equipment Requirements.

Depending on whether you have an appliance event broker configured as a standlone or with redundancy, see one of the following procedures:

ESD/Safety Precautions

Before replacing an HBA, review the following safety warning.

To prevent equipment damage from ESD, always ensure that the appliance event broker chassis is electrically connected to earth ground. Always follow ESD prevention procedures when removing and replacing power supplies. Use an anti-static wrist strap, or another anti-static device. If no wrist strap or mat is available, ground yourself by touching the metal part of the chassis.

Tool and Equipment Requirements

The following tools and equipment are required to replace an HBA in an appliance event broker:

  • Electrostatic discharge wrist strap
  • Anti-static mat
  • Anti-static packaging for HBA
  • No. 2 Phillips head screwdriver (Solace 3530s and Solace 3560s)
  • No. 1 slotted screwdriver (Solace 3560s)
  • a compatible replacement HBA (ordered from Solace)

Procedure for Standalone Appliance Event Brokers

Perform the following steps to replace an HBA in a standalone appliance event broker:

  1. Register the Worldwide Name (WWN) used by the HBA with the external disk storage array that is used. 
       HBA-0208FC-01-A s/n: FC23016580
     
    WWN1 = 20:00:00:90:fa:07:09:e2:10:00:00:90:fa:07:09:e2
    WWN2 = 20:00:00:90:fa:07:09:e3:10:00:00:90:fa:07:09:e3
  2. Enter the following User EXEC command to determine the current version of Solace software that the appliance event broker is running: 
    solace> show version
  3. As a protective measure, enter the following command to make a copy of the current software configuration in the /configs subdirectory: 
    solace> enable
solace# copy current-config
/configs/<version>_preBladeReplacementCfg

    Where:

    <version> is the version number of current software as seen in the output of the show version User EXEC command.

  4. Ensure that the internal disks are in a redundant state:

    Enter the following command:

    solace# show disk
       Reload required:               No
     
    Attribute                        Disk 1               Disk 2
    ------------------ -------------------- --------------------
    Device Model                ST3250310NS          ST3250310NS
    Capacity (MB)                    238475                38475
    Admin State                     enabled              enabled
    Operational State                failed                   up
     
    RAID in fully redundant state: Yes

    If the displayed output shows the RAID disk drives to be in a non-redundant state, contact Solace, and stop this hardware replacement procedure immediately to prevent software corruption on the appliance event broker.

  5. Enter the following command to turn off power to the appliance event broker: 
    solace# power-down
  6. Physically remove the existing HBA and install the replacement HBA in its place. Refer to one of the following:
  7. After the new HBA has been properly installed in the chassis, power up the appliance event broker:

    For a Solace 3530 or Solace 3560, press the () on/standby button at the rear panel of the appliance event broker.

    Alternately, use WOL to turn power back on to the appliance event broker through a WOL magic packet (refer to Turning On Power to Routers Using Wake On LAN for details).

Procedure for Redundant Appliance Event Brokers

Perform the following steps to replace an HBA used by an appliance event broker that belongs to an HA redundant pair of appliance event brokers:

  1. Register the Worldwide Name (WWN) for the replacement HBA with the external disk storage array that is used. 
       HBA-0208FC-01-A s/n: FC23016580
     
    WWN1 = 20:00:00:90:fa:07:09:e2:10:00:00:90:fa:07:09:e2
    WWN2 = 20:00:00:90:fa:07:09:e3:10:00:00:90:fa:07:09:e3
  2. Determine the current version of Solace software that the appliance event broker is running.

    Enter the following commands:

    solace2> show version
  3. As a protective measure, enter the following command to make a copy of the current software configuration in the /configs subdirectory: 
    solace2> enable
solace2# copy current-config
/configs/<version>_preBladeReplacementCfg

    Where:

    <version> is the version number of current software as seen in the output of the show version User EXEC command.

  4. Ensure that the internal disks are in a redundant state.

    Enter the following command:

    solace2# show disk
       Reload required:               No
    Attribute                        Disk 1               Disk 2
    ------------------ -------------------- --------------------
    Device Model                ST3250310NS          ST3250310NS
    Capacity (MB)                    238475                38475
    Admin State                     enabled              enabled
    Operational State                failed                   up
    RAID in fully redundant state: Yes

    If the displayed output shows the RAID disk drives to be in a non‑redundant state, contact Solace, and stop this hardware replacement procedure immediately to prevent software corruption on the appliance event broker.

  5. Enter the following command to turn off power to the appliance event broker: 
    solace2# power-down
  6. Physically remove the existing HBA and install the replacement HBA in its place. For more information, see one of the following:
  7. After the new HBA has been properly installed in the chassis, power up the appliance event broker:

    For a Solace 3530 or Solace 3560, press the () on/standby button at the rear panel of the appliance event broker.

    Alternately, use WOL to turn power back on to the appliance event broker through a WOL magic packet (refer to Turning On Power to Routers Using Wake On LAN for details).

  8. If the appliance event broker is the backup appliance event broker in the redundant pair, to ensure that the appliance event broker can properly access the external disk storage array, perform a failover so that it takes activity. You can then switch activity back to its mate appliance event broker again.
  9. Enter the release-activity Redundancy CONFIG CLI command on the primary appliance event broker to surrender activity to the backup appliance event broker. 
    solace1(configure)# redundancy
solace1(configure/redundancy)# release-activity
solace1(configure/redundancy)# exit
solace1(configure)#
  10. To verify the appliance event broker has taken activity from the mate appliance event broker, enter the following command: 
    solace2(configure)# show redundancy

    Once it is confirmed that the backup appliance event broker has taken activity, enter the no release-activity Redundancy CONFIG CLI command on the primary appliance event broker to enable it to take activity again.

    solace1(configure)# redundancy
solace1(configure-redundancy)# no release-activity
solace1(configure-redundancy)# end
solace1#
  11. If auto-revert is disabled, enter the revert-activity Redundancy ADMIN CLI command on the backup appliance event broker to revert activity back to the primary appliance event broker.