15.2 Deploying a Replacement Appliance VM

To upgrade the PlateSpin Transformation Manager 2019.2 to PlateSpin Transformation Manager 2019.5, you deploy the replacement virtual machine image for the PlateSpin Transformation Manager 2019.5 Appliance.

15.2.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 new parent VM folder you created.

  5. For storage, select the same Datastore folder where you copied the old Disk 2 .vmdk file.

  6. Accept the default for the disk format for Disk 1.

  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.

  9. Continue with Edit the PTM VM Properties.

15.2.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 a new Disk 2 (/vastorage).

    1. On the Virtual Machine Properties page, select the Hardware tab, then click Add.

    2. In the Add Hardware wizard, configure the hard disk.

      Page

      Action

      Device Type

      1. Select Hard Disk, then click Next.

      Select a Disk

      1. Select Create a new virtual disk, then click Next.

      Create a Disk

      1. In the Capacity section, specify the amount of hard disk space that you want to allocate.

        See Disk 2 /vastorage for information about minimum disk capacity requirements.

      2. In the Disk Provisioning section, select either of the following disk formats, depending on the VMware version that you are running:

        • Thick Provision Eager Zeroed

        • Support clustering features such as Fault Tolerance

      3. In the Location section, select Specify a datastore or datastore cluster, click Browse, select a datastore, then click OK.

      4. Click Next.

      Advanced Options

      1. In the Virtual Device Node section, select SCSI (1:0) from the drop-down list.

        NOTE:Do not change the controller to VMware Paravirtual at this point of the installation process. You can optionally modify this setting as a post-installation task. See Change the SCSI Controller to VMware Paravirtual SCSI for Hard Disk 2.

      2. In the Mode section, select Independent and Persistent.

        These settings allow the appliance to be updated.

      3. Click Next.

      Summary

      1. Review the specifications you set for the new hard disk, then click Finish.

  4. Configure a new Disk 3 that uses the old Disk2 (/vastorage_old) that contains the exported data from the old database:

    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 the old Disk 2 (/vastorage_old) that you made for the new PTM Appliance.

    5. Click Next > Next > Finish.

  5. Continue with Configure PTM Appliance Credentials and Settings.

15.2.3 Configure PTM Appliance Credentials and Settings

Configure the replacement PTM Appliance settings using the information you collected in Table 13-1, PTM Appliance Configuration Guidelines.

  1. In vSphere, power on the VM.

    You will be prompted to complete the configuration.

  2. On the Passwords and Time Zones page, complete the following settings, then click Next.

    • vaadmin user password

    • root user password

    • NTP Server IP address or DNS name

    • Region

    • Time zone

  3. On the Network Configuration page, complete the following settings, then click Next.

    • Static IP address for the VM

    • Network mask

    • Gateway IP address

    • DNS host name associated with the static IP address

    • DNS server IP address

    • Domain search

  4. Select the new Disk 2 (sdb) and accept the default formatting, then click Next.

  5. Click Configure.

  6. After the configuration completes, continue with Configuring PTM Server.

15.2.4 Configure PTM Server for the Replacement Appliance

Configure the replacement PTM Server settings using the information you collected in Table 13-1, PTM Appliance Configuration Guidelines.

  1. In a web browser, navigate to the following URL:

    https://ip_address_or_DNS_name:9443

    Use the IP address or DNS name of the server that you specified during the appliance deployment.

  2. Log in to the appliance using the vaadmin user and the password that you set.

  3. On the Initial Server Configuration page, complete the following information:

    1. PostgreSQL Database Connection

      Select Auto Setup Local Database to automatically create a database instance, database administrator user, and a password for the user. Table 15-2 shows the default settings.

      Table 15-2 PostgreSQL Database Default Values

      Parameter

      Default Value

      Database Host

      localhost

      Database Port

      5432

      Create a New Database

      Selected

      Database Name

      transmgr

      Database User Name

      tmadmin

    2. Initial User Configuration

      Provide the full name, email address, and a password for this user.

    3. Web Server Configuration

      We recommend secure port 8183 and SSL options for accessing the Web Interface. You can enable or disable the HTTP port 8182 to allow non-secure traffic.

  4. Click Submit.

  5. After the configuration completes successfully, continue with Restore the Data and Settings.