Upgrading PINsafe on Microsoft Windows

From Swivel Knowledgebase
Jump to: navigation, search


Overview

This document covers upgrading Swivel on Microsoft Windows and supplements the article Upgrade PINsafe which should be used with this article. For Swivel appliance upgrades see the relevant patch files.


Prerequisites

  • Existing Swivel installation on Microsoft Windows, 2000, 2003, 2008, XP, Vista, Win7
  • Latest Swivel software
  • To upgrade to Swivel 3.8 or later, you need Java 1.6. It is recommended that you update to the latest version of Java anyway.
  • Swivel 3.8 is compatible with versions of Tomcat versions 5.5 to 7.

If an external database such as MySQL or MSSQL is used make a backup of the database, since it may be modified if it was upgraded and you may need to go back to the previous version database state should something go wrong.


Moving Swivel to another server

The steps detailed here can be used to move Swivel to another Microsoft Windows Server. As an overview the steps required are:

  • Make a copy of the Swivel data;
  • Install new instance of Swivel, on a new server;
  • Copy configuration and data files, to new Swivel server.

See below specific information on each of these steps.


Upgrading Swivel on the same server

The steps detailed here can be used to upgrade an existing Swivel instance on the same Microsoft Windows Server. As an overview the steps required are:

  • Make a copy/backup of the Swivel data;
  • Remove the old instance of PINsafe;
  • Install new instance of PINsafe;
  • Copy configuration and data files, to new Swivel instance.

See below specific information on each of these steps.


Microsoft Windows Swivel Upgrade steps

Upgrade Java if required

Check what version of Java you are running. If you are on 1.5, upgrade to 1.6 or 7 - you should be able to download the latest version from the Oracle website: http://www.oracle.com/technetwork/java/javase/downloads/index.html.

If you upgrade Java, make sure that Tomcat is reconfigured to use the new version. The simplest way to do this is through the Tomcat Control Panel. If this is not already running, select Monitor Tomcat from the start menu. You may need to right-click and select Run As Administrator. Right-click on the taskbar icon and select Configure. Select the Java tab, and make sure that Use default is checked.


Upgrading from Versions of Swivel Earlier Than 3.9.1

Follow this procedure if you are upgrading from a version of Swivel PINsafe numbered 3.9.4900 or earlier to any subsequent version.

Upgrading_from_Swivel_3-9_and_Earlier_on_Microsoft_Windows

Upgrading from Versions of Swivel From 3.9.1.4908 Onwards

Follow this procedure if you are upgrading from a version of PINsafe numbered 3.9.1.4908 or later to any subsequent version.

Upgrading from Swivel 3-9-1 on Microsoft Windows

Upgrading versions 3.2 to 3.9

Use this section if you are upgrading TO a version of Swivel PINsafe numbered 3.9.4900 or earlier from a still earlier version. This section is provided for reference only - you are generally advised to upgrade to the latest version.

Upgrading Swivel 3-2 to 3-9 on Microsoft_Windows

Testing

Verify that the PINsafe server can be connected to, from the local host use:

http://127.0.0.1:8080/pinsafe

Verify that the new version is listed.


Known Issues

Troubleshooting

Transports absent after upgrade