6.2 Before You Upgrade

We recommend that you make a copy of the vastorage disk before you upgrade software on the appliance.

To copy the vastorage disk:

  1. (Optional) Note the settings you made for your custom Theme.

    Your custom Theme files are not stored on the vastorage disk. If you configured a custom Theme, you should note the settings you made to your custom files. The files will not be overwritten during an upgrade, but you will need to apply the settings to the new or upgraded master Theme files after the upgrade, or if you need to roll back to a redeployed appliance. See Section 7.0, Configuring a Custom UI Theme for the Web Interface.

  2. Log in to the Appliance Console, then shut down the PTM service and the Migrate Connector service.

    See Section 3.4.1, Starting, Stopping, or Restarting System Services.

  3. Wait for the services to shut down gracefully, then log out of the Appliance Console.

  4. Log in to VMware vSphere for the Appliance host, then power down the Appliance VM.

    At shutdown, PTM copies essential configuration files to the /vastorage/conf/ folder, including the configuration for the Migrate Connector instance installed on the Appliance:

    Archive:  vaconfig.zip
 etc/sysconfig/novell/NvlVAinit
 etc/Novell-VA-release
 usr/lib64/jvm/java/jre/lib/security/cacerts
 etc/opt/novell/ganglia/monitor/gmond.conf
 etc/opt/novell/ganglia/monitor/gmetad.conf
 etc/opt/novell/ganglia/monitor/net.d/recv.conf
 etc/opt/novell/ganglia/monitor/net.d/send.conf
 etc/sysconfig/SuSEfirewall2
 etc/sysconfig/scripts/SuSEfirewall2-custom
 etc/opt/microfocus/ps_transform_mgr/config/com.netiq.tm.backend.connpool.cfg
 etc/opt/microfocus/ps_transform_mgr/config/com.netiq.tm.backend.auth.cfg
 etc/opt/microfocus/ps_transform_mgr/config/connector.properties.save
 etc/opt/microfocus/ps_transform_mgr/config/connector.properties
 etc/opt/microfocus/ps_transform_mgr/config/version.properties
 etc/opt/microfocus/ps_transform_mgr/config/system.properties
 etc/opt/microfocus/ps_transform_mgr/config/transformationmanager-themes.cfg
 etc/opt/microfocus/ps_transform_mgr/config/pgusr.in
 etc/opt/microfocus/ps_transform_mgr/config/quartz-scheduler.cfg
 etc/opt/microfocus/ps_transform_mgr/config/system.properties.rpmnew
 etc/opt/microfocus/ps_transform_mgr/config/system.properties.save
 etc/opt/microfocus/ps_transform_mgr/config/war-tm-config.xml
 etc/opt/microfocus/ps_transform_mgr/config/security/tmKeystore.jks
 etc/opt/microfocus/ps_transform_mgr/config/security/tm_cert.der
 etc/sysconfig/postgresql
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/servlet.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/https.ini.bak
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/ssl.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/https.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/ssl.ini.bak
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/logging.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/http.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/annotations.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/jaas.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/gzip.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/servlets.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/start.d/webapp.ini
 opt/microfocus/ps_transform_mgr/tm-jetty-base/resources/logback.xml
 opt/microfocus/ps_transform_mgr/tm-jetty-base/resources/logging.properties
 opt/microfocus/ps_transform_mgr/tm-jetty-base/resources/jetty-logging.properties
 opt/microfocus/migrate_connector/config/settings.cfg
 opt/microfocus/migrate_connector/custom_callouts/post_cutover_testing_callout.py
 opt/microfocus/migrate_connector/custom_callouts/submit_validation_callout.py.rpmnew
 opt/microfocus/migrate_connector/custom_callouts/submit_validation_callout.py
 opt/microfocus/migrate_connector/custom_callouts/pre_cutover_testing_callout.py.rpmnew
 opt/microfocus/migrate_connector/custom_callouts/__init__.py
 opt/microfocus/migrate_connector/custom_callouts/pre_cutover_testing_callout.py
 opt/microfocus/migrate_connector/custom_callouts/custom_import_callout.py

  5. In vSphere, navigate to the datastore that contains the vastorage disk and make a copy of it.

  6. When the copy is complete, restart the Appliance, then continue with the upgrade.

    See Upgrading PlateSpin Transformation Manager.

If the upgrade fails, you can roll back to a previous state.

  1. Reinstall the previous Appliance OVF and attach the copied disk as its vastorage disk.

    The installation uses the stored configuration files to configure the Appliance, and requires minimal configuration information, such as the vaadmin password. When the system comes up, it functions as it did previously.

  2. (Optional) If you previously imported custom certificates, re-import them.