Chapter 5 Migrating Appliance Instances

This chapter describes how to use the Oracle Linux Storage Appliance migration feature, which enables you to easily migrate an appliance storage pool from one Oracle Cloud Infrastructure Compute instance to another Oracle Cloud Infrastructure Compute instance. This feature is useful if you need to deploy your appliance on a new Compute instance with additional Oracle OCPU and memory resources, as it eliminates the need to rebuild your existing file system server.

The migration feature is also necessary if you need to upgrade your appliance from version 1 to version 2 of the appliance or from an Oracle Linux to an Oracle Autonomous Linux version of the appliance. For more information about Oracle Linux Storage Appliance with Oracle Autonomous Linux, see Section 1.2, “Using the Oracle Linux Storage Appliance With Oracle Autonomous Linux”.

5.1 About Migrating Appliance Instances

Note the following important information about migrating your appliance instances:

  • During the migration process the block volume storage pool is reconfigured on the newly migrated Compute instance.

  • No shared file systems are migrated during the migration process, as these file systems remain on the existing block volumes.

  • Migration only works for Compute instances that have remotely attached block volumes. Migrating DenseIO shapes with local NVMe devices is not supported.

5.2 Migrating an Appliance Instance

The following information applies to migrating an appliance from one Compute instance to another Compute instance. If you are upgrading from version 1 to version 2, see Section 6.2, “Upgrading the Oracle Linux Storage Appliance From Version 1 to Version 2”.

Important

Before migrating an existing appliance instance, first back up your appliance instance, including the Samba global settings, ssh keys and OCI service access configuration on the Administration page, which are not included in the migration process.

You initiate the migration process in the Administration page of the Oracle Linux Storage Appliance web interface. You then complete the migration steps in the Oracle Cloud Infrastructure console.

The following procedure describes how to migrate an existing appliance to a new Oracle Cloud Infrastructure Compute instance.

  1. In the web interface for the source instance, click the Administration tab, then click Prepare for migration.

  2. In the Oracle Cloud Infrastructure console for the source instance, do the following:

    1. Stop the source instance.

    2. Detach all of the block volumes that are currently attached to the source instance, then terminate the source instance.

    Note

    After you have stopped the source instance, detached the block volumes, and terminated the source instance, the web interface for the appliance becomes unavailable.

  3. In the Oracle Cloud Infrastructure console for the destination instance, do the following:

    1. Create a new appliance instance that meets the following requirements:

      • Must use a shape with no local storage attached.

      • Must be in the same compartment and availability domain as the source instance.

      • Must be the same or later appliance version as the source instance's version.

    2. Attach all of the block volumes that were detached from the source instance to the destination instance.

      Note

      The process of attaching the volumes can take a few minutes.

    3. Reboot the destination instance.

    4. Log in to the web interface for the destination instance and confirm that all of the shares and exports that you migrated are available.