6.4 Upgrading PlateSpin Transformation Manager

Before you begin, download the files for PlateSpin Transformation Manager 1.1.1 and PlateSpin Migrate Connector 1.1.1 from the Micro Focus Patch Finder website. See Section 6.3, Downloading Software.

To upgrade the PTM and Migrate Connector software on the Appliance:

Enable SSH on the PTM Appliance.

See Section 3.4.4, Enabling or Disabling the SSH Service
From your computer, start an SSH session for ptm-ipaddr-or-dns-name on port 22, then log in as the root user to the Appliance.

You can use any SSH tool, such as Putty.
Copy the files that you downloaded to a location on the Appliance.
Launch a terminal console, then navigate to the location where you copied the files.
Save a copy of the /opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/ssl.ini file, or make a note of the Jetty keystore settings for the following parameters. The default values for PTM 1.1 are shown here. Your settings might be different if you have ever made changes to the Jetty keystore using the appropriate keytool software. You will need to reset these keystore settings after the upgrade.
```
# Setup a keystore and truststore
jetty.keystore=certs/keystore
jetty.truststore=certs/keystore

# Set the passwords.
jetty.keystore.password=changeit
jetty.keymanager.password=changeit
jetty.truststore.password=changeit
```
Import the PTM Public Key to your keyring.

Launch a terminal, then enter one of the following commands as the root user:
```
gpg --import <ptm-public-key-filename>

or

rpm --import <ptm-public-key-filename>
```
Apply the PlateSpin Transformation Manager upgrade files. In the console, enter
```
rpm -Uvh platespin-transformationmanager-1.1.1-xxx.x.x86_64.rpm
```
Replace xxx.x with the actual build numbers.
Upgrade the Migrate Connector instance on the Appliance:
1. Apply the PlateSpin Migrate Connector upgrade files. In a console, enter
```
rpm -Uvh platespin-migrate-connector-1.1.1-xxx.x.x86_64.rpm
```
  Replace xxx.x with the actual build numbers.
Exit the SSH session.
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 service pack upgrade.
  - Stops the PlateSpin Migrate Connector service.
  - Applies the Migrate Connector service pack 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.
Use a keytool to reset the Jetty keystore settings to what they were before the upgrade. Use the values you saved in Step 5.
(Optional) Re-configure your custom Theme.

If you configured a custom Theme, you must copy the upgraded master Theme files to your Themes folder, and then apply your preferred theme settings. See Section 7.0, Configuring a Custom UI Theme for the Web Interface.
If you have installed instances of PlateSpin Migrate Connector on your standalone SUSE Linux Enterprise Server 11 SP4 servers, you must also upgrade Connector on those servers. See Before You Install or Upgrade to PlateSpin Migrate Connector 1.1.1 and Upgrading PlateSpin Migrate Connector from 1.1 to 1.1.1 in the PlateSpin Migrate Connector Quick Start.