Upgrading PINsafe on Microsoft Windows
Contents
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
- Latest Swivel backup (requires the Tomcat service to be stopped if the internal Db is used) See Backup PINsafe on a Software Only Install
- 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:
Verify that the new version is listed.
