Upgrading Previously Installed Secure Shell Software

If you are running both SSH Tectia Client and Server on the on same machine, install the same release of each, 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 Server 5.3. When installing via SSH Tectia Manager, the earlier versions are removed automatically.

Table 2.3. Upgrade lines

Upgrade lines

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

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

The 4.x configuration files are not migrated to 5.3, but the default 5.3 configuration is used. However, the connection profiles are migrated from 4.x to 5.3 on Windows platforms.
Earlier 5.x configuration files are migrated to 5.3 as such and automatically taken into use there.
For SSH Tectia Client, a backup copy is automatically made of the earlier 5.x Client configuration files and stored in the user-specific directory "%USERPROFILE%\Application Data\SSH\backup-<version>-<date>" (where <version> is the SSH Tectia release and <date> is the date of the upgrade).

	Note
	Before starting the upgrade, make backups of all configuration files where you have made modifications.

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

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