Upgrading Previously Installed SSH Tectia Client Software

	Note
	Before starting the upgrade, make backups of all configuration files where you have made modifications. See instructions in Backup of Configuration Files.

If you are running both SSH Tectia client-side tools and SSH Tectia Server on the same machine, install the same release of each SSH Tectia product, because there are dependencies between the common components.

Check if you have some Secure Shell software, for example earlier versions of SSH Tectia products or OpenSSH server or client, running on the machine where you are planning to install the new SSH Tectia versions.

Before installing SSH Tectia Server on Unix platforms, stop any OpenSSH servers running on port 22, or change their listener port. You do not need to uninstall the OpenSSH software.

The following table shows you which SSH Tectia versions you need to uninstall before you can upgrade to SSH Tectia Client 6.1. When upgrading versions marked upgrade on top, the earlier version is automatically removed during the upgrade procedure. Also, when installing via SSH Tectia Manager, the earlier versions are removed automatically.

Table 2.2. Upgrade lines

SSH Tectia version	AIX	HP-UX	Linux	Solaris	Windows
SSH Secure Shell 2.x-3.x	remove	remove	remove	remove	remove
SSH Tectia 4.0	remove	remove	remove	remove	remove
SSH Tectia 4.1-4.x	remove	remove	remove	remove	upgrade on top
SSH Tectia 5.x-6.x	upgrade on top	upgrade on top	upgrade on top	remove	upgrade on top

The configuration file format and file locations have been changed in SSH Tectia Client 5.0. Because of that, the configuration files behave differently when upgrading from 4.x and from 5.x-6.x:

The 4.x configuration files are not migrated to 6.1, but the default 6.1 configuration is used. However, the connection profiles are migrated from 4.x to 6.1 on Windows platforms.
The 5.x-6.x configuration files are migrated to 6.1 as such and automatically taken into use there.

When necessary, you can modify the configuration files by using the SSH Tectia Configuration GUI or by editing the XML configuration files manually with an ASCII text editor or an XML editor.

A separate document, SSH Tectia Client/Server Migration Guide, gives detailed instructions on upgrading from the SSH Tectia client/server solution 4.x to 6.x, including information on migrating the configuration files.

On Windows, a backup copy is automatically made of the earlier SSH Tectia Client configuration files and stored in the user-specific directory:

"%APPDATA%\SSH\backup-<version>-<date>"

where

<version> is the SSH Tectia release

<date> is the date of the upgrade.