Skip to main content
A newer release of this product is available.

Replace services appliance

Contributors netapp-perveilerk netapp-pcelmer netapp-lhalbert ssantho3 netapp-pcarriga netapp-madkat
PDFs

You might need to replace the appliance if it is not functioning optimally or if it has failed.

Before you begin

  • You have a replacement appliance with the same part number as the appliance you are replacing.

  • You have labels to identify each cable that is connected to the appliance.

  • You have physically located the appliance.

About this task

The StorageGRID node will not be accessible while you replace the appliance. If the appliance is functioning sufficiently, you can perform a controlled shutdown at the start of this procedure.

Note If you are replacing the appliance before installing StorageGRID software, you might not be able to access the StorageGRID Appliance Installer immediately after completing this procedure. While you can access the StorageGRID Appliance Installer from other hosts on the same subnet as the appliance, you can't access it from hosts on other subnets. This condition should resolve itself within 15 minutes (when any ARP cache entries for the original appliance time out), or you can clear the condition immediately by purging any old ARP cache entries manually from the local router or gateway.
Steps

  1. Display the current configurations of the appliance and record them.

    1. Log in to the appliance to be replaced:

      1. Enter the following command: ssh admin@grid_node_IP

      2. Enter the password listed in the Passwords.txt file.

      3. Enter the following command to switch to root: su -

      4. Enter the password listed in the Passwords.txt file.

        When you are logged in as root, the prompt changes from $ to #.

    2. Enter: run-host-command ipmitool lan print to display the current BMC configurations for the appliance.

  2. Shut down the appliance: shutdown -h now

  3. If any of the network interfaces on this StorageGRID appliance are configured for DHCP, you might need to update the permanent DHCP lease assignments on the DHCP servers to reference the MAC addresses of the replacement appliance. The update ensures the appliance is assigned the expected IP addresses. See Update MAC address references.

  4. Remove and replace the appliance:

    1. Label the cables and then disconnect the cables and any network transceivers.

      Important To prevent degraded performance, don't twist, fold, pinch, or step on the cables.

    2. Remove the failed appliance from the cabinet or rack.

    3. Transfer the two power supplies, eight cooling fans, and two SSDs from the failed appliance to the replacement appliance.

      The two SSDs are placed in the slots as shown in the following diagram:

      Drive locations

      HDD02 or HDD2 refer to the drive in the upper slot, and HDD03 or HDD3 refer to the drive in the lower slot.

      Follow the instructions provided for replacing these components.

    4. Install the replacement appliance into the cabinet or rack.

    5. Replace the cables and any optical transceivers.

    6. Power on the appliance and wait for it to rejoin the grid.

    7. Confirm that the appliance node appears in the Grid Manager and that no alerts appear.

  5. Log in to the replaced appliance:

    1. Enter the following command: ssh admin@grid_node_IP

    2. Enter the password listed in the Passwords.txt file.

    3. Enter the following command to switch to root: su -

    4. Enter the password listed in the Passwords.txt file.

  6. Restore BMC network connectivity for the replaced appliance. There are two options:

    • Use static IP, netmask, and gateway

    • Use DHCP to obtain an IP, netmask, and gateway

      1. To restore the BMC configuration to use a static IP, netmask, and gateway, enter the following commands:

        run-host-command ipmitool lan set 1 ipsrc static

        run-host-command ipmitool lan set 1 ipaddr Appliance_IP

        run-host-command ipmitool lan set 1 netmask Netmask_IP

        run-host-command ipmitool lan set 1 defgw ipaddr Default_gateway

      2. To restore the BMC configuration to use DHCP to obtain an IP, netmask, and gateway, enter the following command:

        run-host-command ipmitool lan set 1 ipsrc dhcp

  7. After restoring BMC network connectivity, connect to the BMC interface to audit and restore any additional custom BMC configuration you might have applied. For example, you should confirm the settings for SNMP trap destinations and email notifications. See Configure BMC interface.

  8. Confirm that the appliance node appears in the Grid Manager and that no alerts appear.

After replacing the part, return the failed part to NetApp, as described in the RMA instructions shipped with the kit. See the Part Return & Replacements page for further information.

Related information

View status indicators

View boot-up codes for appliance