Migrating Pivotal Platform to a New Datastore in vSphere
Page last updated:
This topic describes how to migrate your Pivotal Platform installation to a new vSphere datastore.
Both the new and existing vSphere datastores must reside in the same datacenter.
To avoid service disruption, VMware recommends that you configure your overall Pivotal Platform deployment for high availability (HA). In addition, check for configurations necessary to achieve HA in each of your installed product tiles.
If your environment has any single points of failure, service may be disrupted as a result of the migration.
These sections describe the steps you should perform prior to the migration.
Ensure that your Pivotal Platform environment is fully backed up.
For more information about how to back up Pivotal Platform, see Backing Up Deployments.
Document your current environment settings before proceeding with the datastore migration. Record which VMs are running and in which datastore they reside. If you experience any issues during or after the migration, you must have this information to restore your environment.
To obtain this information:
Run one of these commands:
- If you use BOSH CLI v2, run:
bosh -e BOSH-ENVIRONMENT instances --details > instances.txtWhere
BOSH-ENVIRONMENTis 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
- If you use BOSH CLI v2, run:
Save the resulting
instances.txtfile to a safe location.
Note the datastore where each VM resides in vSphere.
In Pivotal Application Service (PAS), check the Status tab and make sure there are no errors or reported issues.
In each tile installed in your Pivotal Platform deployment, check the Status tab and make sure there are no errors or reported issues.
To check the status of your BOSH Director:
Check that there are no pending changes and that the status of all tiles is green.
Make sure the last Installation Log does not contain any errors.
Before proceeding with the migration, click Review Pending Changes and Apply Changes to make sure there are no errors in the Installation Log.
To migrate your Pivotal Platform deployment to a new datastore:
Navigate to the Ops Manager Installation Dashboard.
Click the BOSH Director tile.
Select vCenter Config.
Update the Ephemeral Datastore Names and Persistent Datastore Names fields to reflect the new datastore names.
Note: If you use the datastore clustering feature in vSphere, provide only the individual names of the datastores in the cluster. Do not provide the name of the cluster that contains them.
Click Review Pending Changes, then Apply Changes.
Confirm that the BOSH Director VM has persistent disk on the new datastore.
- Select vCenter Resource Pools and select the Resource Pool that contains your Pivotal Platform deployment VMs and new datastore.
- Click the Related Objects and Virtual Machines.
- Locate the Ops Manager VM and verify that the VM has an expected value in the Provisioned Space column.
In the BOSH Director tile, select Director Config.
Select the Recreate all VMs option.
Click Review Pending Changes.
If you are using any service tiles, select the Recreate All On-Demand Service Instances errand for each of the tiles you migrate.
Click Apply Changes.