HBA Replacement

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

ESD/Safety Precautions

Before replacing an HBA, review the following safety warning.

To prevent equipment damage from ESD, always ensure that the appliance 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:

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

Procedure for Standalone Appliances

Perform the following steps to replace an HBA in a standalone Solace PubSub+ appliance:

Register the Worldwide Name (WWN) used by the HBA with the external disk storage array that is used.
Example:
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
Enter the following User EXEC command to determine the current version of Solace PubSub+ software that the appliance is running:
solace> show version
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.
Ensure that the internal disks are in a redundant state:
Enter the following command:
```
solace# show disk
```
Example:
   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.
Enter the following command to turn off power to the appliance:
solace# power-down
Physically remove the existing HBA and install the replacement HBA in its place. Refer to one of the following:

For PubSub+ 3260 HBA replacements: Blade Replacement in PubSub+ 3260s
For PubSub+ 3530 HBA replacements: Blade Replacement in PubSub+ 3530s & 3560s
For PubSub+ 3560 HBA replacements: HBA Replacement in PubSub+ 3560s

After the new HBA has been properly installed in the chassis, power up the appliance:
- For a PubSub+ 3230s or PubSub+ 3260, use a paper clip to press the () on/standby button on the front panel of the replacement appliance to turn power back on to the appliance.
- For a PubSub+ 3530 or PubSub+ 3560, press the () on/standby button at the rear panel of the appliance.
Alternately, use WOL to turn power back on to the appliance through a WOL magic packet (refer to Turning On Power to Routers Using Wake On LAN for details).

Procedure for Redundant Appliances

Perform the following steps to replace an HBA used by an appliance that belongs to an HA redundant pair of Solace PubSub+ appliances:

Register the Worldwide Name (WWN) for the replacement HBA with the external disk storage array that is used.
Example:
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
Determine the current version of Solace PubSub+ software that the appliance is running.
Enter the following commands:
solace2> show version
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.
Ensure that the internal disks are in a redundant state.
Enter the following command:
solace2# show disk
Example:
   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.
Enter the following command to turn off power to the appliance:
solace2# power-down
Physically remove the existing HBA and install the replacement HBA in its place. Refer to one of the following:
- For PubSub+ 3230 HBA replacements: Blade Replacement in PubSub+ 3260s
- For PubSub+ 3530 HBA replacements: Blade Replacement in PubSub+ 3530s & 3560s
- For PubSub+ 3560 HBA replacements: HBA Replacement in PubSub+ 3560s
After the new HBA has been properly installed in the chassis, power up the appliance:
- For a PubSub+ 3230 or PubSub+ 3260, use a paper clip to press the () on/standby button on the front panel of the replacement appliance to turn power back on to the appliance.
- For a PubSub+ 3530 or PubSub+ 3560, press the () on/standby button at the rear panel of the appliance.
Alternately, use WOL to turn power back on to the appliance through a WOL magic packet (refer to Turning On Power to Routers Using Wake On LAN for details).
If the appliance is the backup appliance in the redundant pair, to ensure that the appliance 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 again.

Enter the release-activity Redundancy CONFIG CLI command on the primary appliance to surrender activity to the backup appliance.

solace1(configure)# redundancy
solace1(configure/redundancy)# release-activity
solace1(configure/redundancy)# exit
solace1(configure)#

To verify the appliance has taken activity from the mate appliance, enter the following command:
solace2(configure)# show redundancy
Once it is confirmed that the backup appliance has taken activity, enter the no release-activity Redundancy CONFIG CLI command on the primary appliance to enable it to take activity again.
```
solace1(configure)# redundancy
solace1(configure-redundancy)# no release-activity
solace1(configure-redundancy)# end
solace1#
```
If auto-revert is disabled, enter the revert-activity Redundancy ADMIN CLI command on the backup appliance to revert activity back to the primary appliance.

Provide feedback