7.3 Deploying a Replacement Appliance VM

To upgrade the PlateSpin Transformation Manager 2 to PlateSpin Transformation Manager 2019.2, you can deploy the replacement virtual machine image for the PlateSpin Transformation Manager 2019.2 Appliance, and re-use Disk 2 (/vastorage).

7.3.1 Deploy the PTM VM

  1. In vSphere, copy the extracted OVF file to the new VMware VM folder you created for the replacement Appliance VM.

  2. In vSphere, click File > Deploy OVF Template.

  3. Click Browse, then navigate to and select the extracted OVF file.

  4. Name the replacement Appliance VM with the same name as the parent VM folder you created.

  5. Select the same Datastore folder where you copied the Disk 2 .vmdk file.

  6. Accept the default for the disk format.

  7. Do not select Power on After Deployment.

  8. Click Finish.

    The VM is created in the VM folder with Disk 1 in the specified Datastore.

7.3.2 Edit the PTM VM Properties

  1. In vSphere, right-click the VM you just deployed and select Edit Settings.

    The VM Properties dialog displays the VM properties.

  2. Set the Memory and CPU settings to match the old PTM Appliance, or increase them as needed.

  3. Configure Disk 2 (/vastorage) to reuse the existing disk:

    1. Click Add > Hardware.

    2. Select Hard Disk > Next.

    3. Select Use an existing Virtual disk, then click Next.

    4. Click Browse, then navigate to and select the copy of Disk 2 that you made for the new PTM Appliance.

    5. Click Next > Next > Finish.

7.3.3 Configure PTM Appliance Credentials

  1. In vSphere, power on the VM.

  2. When you are prompted, set the PTM credentials:

    1. Set the VM root password.

    2. Set the vaadmin root password.

7.3.4 Complete the Upgrade

After you upgrade the software, you must log in as the vaadmin user to the Appliance Management Console (on port 9443). The PlateSpin Transformation Manager Complete Upgrade page is presented instead of the Appliance Management Console because the Appliance detects that the RPM files for PlateSpin Transformation Manager have been modified. You must complete the upgrade before you can manage the appliance or log in to the PlateSpin Transformation Manager Web Interface.

  1. In the Appliance Management Console, complete the upgrade by running the Transformation Manager upgrade script:

    1. In a web browser, connect to the PlateSpin Transformation Manager Appliance Management Console and log in as the vaadmin user:

      https://<ptm-server-ipaddr-or-fqdn>:9443

    2. When you are redirected to the Upgrade page, click Complete Upgrade, then wait for the upgrade to complete.

      The upgrade automatically stops and restarts the PlateSpin Transformation Manager service and the PlateSpin Migrate Connector for PTM service.

      The upgrade script performs the following tasks:

      • Stops the PlateSpin Transformation Manager service.

      • Applies the Transformation Manager upgrade.

      • Stops the PlateSpin Migrate Connector service.

      • Applies the Migrate Connector upgrade.

      • Expands the PTM database schema and applies the changes to your PTM database.

        NOTE:If necessary, the upgrade process expands the database schema and applies the schema changes to your database. The existing database values are not affected.

      • Restarts the Migrate Connector service.

      • Restarts the Transformation Manager service.

      The process takes about 5 minutes.

  2. (Optional) Use a keytool to reset the Jetty keystore settings to what they were before the upgrade. Use the values you saved in Section 7.2.1, Save Jetty Settings.

  3. When the upgrade is complete, verify the settings:

    1. Log in to the Appliance Management Console and check settings.

    2. Log in to PTM Web Interface and check PTM settings and data.

  4. Continue with Section 7.3.5, Post Upgrade Configuration Tasks.

7.3.5 Post Upgrade Configuration Tasks

  1. (Optional) Reapply the Jetty settings you saved in Section 7.2.1, Save Jetty Settings.

  2. (Optional) Reapply the custom theme settings as described in Section 7.2.2, Save Customized Default Theme Files.

  3. For next steps in the upgrade, refer to the Section 6.4, PlateSpin Upgrade Checklist.