Skip to main content

Clone appliance node

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

The cloning process might take several days to transfer data between the source node (appliance being replaced) and the target (new) appliance.

Before you begin
  • You have installed the compatible target appliance into a cabinet or rack, connected all cables, and applied power.

  • You have verified that the StorageGRID Appliance Installer version on the replacement appliance matches the software version of your StorageGRID system, upgrading the StorageGRID Appliance Installer firmware, if necessary.

  • You have configured the target appliance, including configuring StorageGRID connections, SANtricity System Manager (storage appliances only), and the BMC interface.

    • When configuring StorageGRID connections, use the temporary IP addresses.

    • When configuring network links, use the final link configuration.

Note Leave the StorageGRID Appliance Installer open after you complete initial target appliance configuration. You will return to the target appliance's installer page after you start the node cloning process.

You should clone only one appliance node at a time to maintain StorageGRID network performance and data availability.

Steps
  1. Place the source node you are cloning into maintenance mode.

  2. From the StorageGRID Appliance Installer on the source node, in the Installation section of the Home page, select Enable Cloning.

    The Primary Admin Node connection section is replaced with the Clone target node connection section.

    Clone target node connection section
  3. For Clone target node IP, enter the temporary IP address assigned to the target node for the network to use for clone data-transfer traffic, and then select Save.

    Typically, you enter the IP address for the Grid Network, but if you need to use a different network for clone data-transfer traffic, enter the IP address of the target node on that network.

    Note Using the 1-GbE Admin Network for clone data transfer results in slower cloning.

    After the target appliance is configured and validated, in the Installation section, Start Cloning is enabled on the source node.

    If issues exist that prevent cloning, Start Cloning is not enabled and issues that you must resolve are listed as the Connection state. These issues are listed on the StorageGRID Appliance Installer Home page of both the source node and the target appliance. Only one issue displays at a time and the state automatically updates as conditions change. Resolve all cloning issues to enable Start Cloning.

    When Start Cloning is enabled, the Current state indicates the StorageGRID network that was selected for cloning traffic, along with information about using that network connection. See Considerations and requirements for appliance node cloning.

  4. Select Start Cloning on the source node.

  5. Monitor the cloning progress using the StorageGRID Appliance Installer on either the source or target node.

    The StorageGRID Appliance Installer on both the source and target nodes indicates the same status.

    Cloning progress

    The Monitor Cloning page provides detailed progress for each stage of the cloning process:

    • Establish clone peering relationship shows the progress of cloning set up and configuration.

    • Clone another node from this node shows the progress of data transfer. (This part of the cloning process can take several days to complete.)

    • Activate cloned node and leave this one offline shows the progress of transferring control to the target node and placing the source node in a pre-install state, after data transfer is complete.

  6. If you need to terminate the cloning process and return the source node to service before cloning is complete, on the source node go to the StorageGRID Appliance Installer Home page and select Advanced > Reboot Controller, and then select Reboot into StorageGRID.

    If the cloning process is terminated:

    • The source node exits maintenance mode and rejoins StorageGRID.

    • The target node remains in the pre-install state. To restart cloning the source node, start the cloning process again from step 1.

When cloning successfully completes:

  • The source and target nodes swap IP addresses:

    • The target node now uses the IP addresses originally assigned to the source node for the Grid, Admin, and Client Networks.

    • The source node now uses the temporary IP address initially assigned to the target node.

  • The target node exits maintenance mode and joins StorageGRID, replacing the source node.

  • The source appliance is in a pre-installed state, as if you had prepared it for reinstallation.

Note If the appliance does not rejoin the grid, go to the StorageGRID Appliance Installer Home page for the source node, select Advanced > Reboot Controller, and then select Reboot into Maintenance Mode. After the source node reboots in maintenance mode, repeat the node cloning procedure.
  • User data remains on the source appliance as a recovery option if an unexpected issue occurs with the target node. After the target node has successfully rejoined StorageGRID, user data on the source appliance is outdated and is no longer needed.

    Outdated user data is overwritten when you install or expand the source appliance as a new node in another grid.

    You can also reset the controller configuration on the source appliance to make this data inaccessible:

    1. Open the StorageGRID Appliance Installer for the source appliance using the temporary IP address initially assigned to the target node.

    2. Select Help > Support and Debug Tools.

    3. Select Reset Storage Controller Configuration.

      Note If needed, contact technical support for assistance resetting the storage controller configuration.
      Note Overwriting the data or resetting the controller configuration makes the outdated data difficult or impossible to retrieve; however, neither method securely removes the data from the source appliance. If a secure erase is required, use a data-wiping tool or service to permanently and securely remove data from the source appliance.

You can:

  • Use the source appliance as a target for additional cloning operations: no additional configuration is required. This appliance already has the temporary IP address assigned that were originally specified for the first clone target.

  • Install and set up the source appliance as a new appliance node.

  • Discard the source appliance if it is no longer of use with StorageGRID.