Your browser does not allow this site to store cookies and other data. Some functionality on this site may not work without them. See Privacy Policy for details on how we would use cookies.


Upgrading Previously Installed Tectia Client Software


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 Tectia client-side tools and Tectia Server on the same machine, install the same release of each Tectia product, because there are dependencies between the common components.

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

Before installing 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 Tectia versions you need to uninstall before you can upgrade to Tectia Client 6.2. When upgrading versions marked upgrade on top, the earlier version is automatically removed during the upgrade procedure. Also, when installing via Tectia Manager, the earlier versions are removed automatically.

Table 2.2. Upgrade lines

Tectia versionAIXHP-UXLinuxSolarisWindows
SSH Secure Shell 2.x-3.xremoveremoveremoveremoveremove
Tectia 4.0removeremoveremoveremoveremove
Tectia 4.1-4.xremoveremoveremoveremoveupgrade on top
Tectia 5.x-6.xupgrade on topupgrade on topupgrade on topremoveupgrade on top or remove if Transparent TCP Tunneling is installed

The configuration file format and file locations have been changed in 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.2, but the default 6.2 configuration is used. However, the connection profiles are migrated from 4.x to 6.2 on Windows platforms.

  • The 5.x-6.x configuration files are migrated to 6.2 as such and automatically taken into use there.

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

If you have the Transparent TCP Tunneling option installed, uninstall the previous version of the client before upgrading to the 6.2 Tectia Client and restart the computer after the uninstallation. See Removing from Windows .


As of version 6.2.5 of Tectia Client, the Transparent TCP Tunneling option is no longer included in the Windows installation package. Transparent TCP Tunneling is available on Tectia ConnectSecure.

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



<version> is the Tectia release

<date> is the date of the upgrade.