3.2 Preparing for Upgrade

3.2.1 Ensuring Valid Credentials for Target Cloud Containers

The credentials in the Migrate database for target Cloud containers must be valid at export and import. Ensure that the password does not change or expire after export and until the import completes after upgrade. If your password is pending expiration, modify the password in the Cloud provider environment and update the credentials in Migrate before you begin an export.

WARNING:If credentials are invalid during import, the Cloud container is not imported and its associated workload configurations are corrupted in the imported database. To use the same Migrate server for migrations to the target Cloud container, you must re-install PlateSpin Server, which resets the database. You must re-configure all target containers and workloads.

3.2.2 Backing Up Your Database Files Before Upgrade

During the upgrade, the PlateSpin Migrate installation program transparently exports data from your existing database and re-imports it into a new database instance as required. However, as an additional measure of precaution, consider backing up your database files on the PlateSpin Server prior to the upgrade.

  1. Log in to the PlateSpin Migrate Server host machine as the Administrator user.

  2. On your server host, stop MS SQL services:

    1. On the Start menu, click Run, type services.msc, then click OK.

    2. In the Services window, right-click the SQL Server items, then select Stop.

  3. Copy all *.mdf and *.ldf files to a location outside the product installation directory. The default location of these files is:

    \Program Files\PlateSpin Migrate Server\Database

  4. Restart MS SQL services that you stopped in Step 2.

Continue with Backing Up Your Custom Linux blkwatch Drivers Before Upgrade, or proceed with the upgrade as detailed in Upgrading Migrate.

3.2.3 Backing Up Your Custom Linux blkwatch Drivers Before Upgrade

During the upgrade, the PlateSpin Migrate installation program will overwrite custom Linux blkwatch drivers that you previously added to PlateSpin Migrate. Consider saving a copy of your custom Linux blkwatch drivers prior to the upgrade.

  1. Log in to the PlateSpin Migrate Server host machine as the Administrator user.

  2. Navigate to the PlateSpin application's installation directory, such as C:\Program Files\PlateSpin Migrate Server\.

  3. Open the .\Packages\9D470BFF-E30F-4015-83D8-4D308A8C8B1B\ folder and copy the 1.package file out of this folder to a temporary directory.

  4. Rename 1.package with the .zip file extension (1.zip), then extract the contents of the file to this temporary directory.

  5. Save your CustomKernel* content to another temporary location.

Proceed with the upgrade, as detailed in Upgrading Migrate.

After the upgrade, you should upload again any custom Linux blkwatch drivers you need for future migrations. See KB Article 7005873.

3.2.4 Exporting Your Migration Data Before Upgrade

If you have workload migrations in progress that you want to continue after an upgrade, use the Import/Export utility (ImportExportAll.bat) to export the workload migration data. See Section 3.6, Exporting or Importing PlateSpin Migration Data. You can import the data if it is needed after an upgrade.