This topic describes how to migrate your VMware Tanzu Operations Manager installation to a new vSphere datastore.

Prerequisites

  • The new and existing vSphere datastores must reside in the same data center.

  • To avoid service disruption, VMware recommends that you configure your overall Tanzu Operations Manager deployment for high availability (HA). In addition, check for configurations necessary to achieve HA in each of your installed product tiles.

Before you begin

The following sections describe the steps to do prior to the migration.

Step 1: Back up your environment

Ensure that your Tanzu Operations Manager environment is fully backed up.

For more information about how to back up Tanzu Operations Manager, see Backing up Deployments.

Step 2: Document current environment settings

Document your current environment settings. Record which VMs are running and in which datastore each one resides. If you experience any issues during or after the migration, you must have this information to restore your environment.

To obtain this information:

  1. Run one of these commands:

    • If you use BOSH CLI v2, run:

      bosh -e BOSH-ENVIRONMENT instances --details > instances.txt
      

      Where BOSH-ENVIRONMENT is the alias you assigned to your BOSH Director.

    • If you use the original version of the BOSH CLI, run:

      bosh-old instances --details > instances.txt
      
  2. Save the resulting instances.txt file to a safe location.

  3. Note the datastore where each VM resides in vSphere.

Step 3: Check system health

Check the Status tab in your runtime product tiles, such as VMware Tanzu Application Service for VMs (TAS for VMs) or VMware Tanzu Kubernetes Grid Integrated Edition (TKGI), and make sure there are no errors or reported issues.

Step 4: Check installed products health

In each tile installed in your Tanzu Operations Manager deployment, check the Status tab and verify that there are no errors or reported issues.

Step 5: Check BOSH Director status

To check the status of your BOSH Director:

  1. Verify that there are no pending changes and that the status of all tiles is green.

  2. Verify that the last installation log does not contain any errors.

  3. Before you proceed with the migration, click Review Pending Changes and then click Apply Changes to make sure there are no errors in the installation log.

Migrate Tanzu Operations Manager to a new datastore

To migrate your Tanzu Operations Manager deployment to a new datastore:

  1. Go to the Tanzu Operations Manager Installation Dashboard.

  2. Click the BOSH Director tile.

  3. Click vCenter Config.

  4. Update the Ephemeral Datastore Names and Persistent Datastore Names text boxes to reflect the new datastore names.
    If you use the datastore clustering feature in vSphere, provide only the datastore cluster name in the Persistent Datastore Cluster Names // Ephemeral Datastore Cluster Names fields.

  5. Click Save.

  6. Click Review Pending Changes.

  7. Deselect the Select All Products check box so that only the BOSH Director tile is still selected.

  8. Click Apply Changes.

  9. Confirm that the BOSH Director VM has persistent disk on the new datastore.

    1. From vCenter, find the BOSH Director VM.
    2. In the Related Objects section, verify that the storage has been updated to the new datastore.
  10. In the BOSH Director tile, click Director Config.

  11. Select Recreate VMs deployed by the BOSH Director.

  12. Click Review Pending Changes.

  13. If you are using any service tiles, select the Recreate All On-Demand Service Instances errand for each tile you migrate.

  14. Click Apply Changes.

check-circle-line exclamation-circle-line close-line
Scroll to top icon