SSH

Installing the Tectia Client Software

Installing on AIX
Installing on Linux (RPM)
Installing on Linux (DEB)
Installing on Solaris
Installing on Windows

This section gives instructions on installing Tectia Client locally on the supported operating systems.

See the installation instructions for Tectia Client per platform in the following sections.

Installing on AIX

The downloaded installation package contains the compressed installation files.

Two packages are required: one for the common components of Tectia Client and Server, and one for the specific components of Tectia Client.

To install Tectia Client on AIX, follow the instructions below:

  1. Unpack the downloaded tar package.

  2. Unpack the installation packages:

    $ uncompress ssh-tectia-common-<version>-aix-6-7-powerpc.bff.Z
    $ uncompress ssh-tectia-client-<version>-aix-6-7-powerpc.bff.Z
    

    In the commands, <version> is the current package version of Tectia Client (for example, 7.0.0.123).

  3. Install the packages by running the following commands with root privileges:

    # installp -d ssh-tectia-common-<version>-aix-6-7-powerpc.bff SSHTectia.Common
    # installp -d ssh-tectia-client-<version>-aix-6-7-powerpc.bff SSHTectia.Client
    
  4. Copy the license file to directory: /etc/ssh2/licenses. (This is not necessary in "third-digit" maintenance updates.) See also Licensing.

Installing on Linux (RPM)

Tectia Client for Linux platforms is supplied in RPM (Red Hat Package Manager) binary packages for Red Hat Enterprise Linux and SUSE Linux running on the 64-bit x86-64 platform architecture.

The downloaded installation package contains the RPM installation files. Two packages are always required: one for the common components of Tectia Client and Server, and one for the specific components of Tectia Client. If you want to use the product with a graphical user interface (GUI), install also the optional GUI support package.

To install Tectia Client on Linux, follow the instructions below:

  1. Unpack the downloaded tar package.

  2. When installing on SUSE or Red Hat Enterprise Linux versions running on the 64-bit x86-64 architecture, use the packages named:

    ssh-tectia-common-<version>-linux-x86_64.rpm
    ssh-tectia-client-<version>-linux-x86_64.rpm
    ssh-tectia-guisupport-<version>-linux-x86_64.rpm

    In the commands, <version> indicates the product release version and the current build number (for example, 7.0.0.123).

  3. Install the packages with root privileges:

    # rpm -ivh ssh-tectia-common-<version>-linux-x86_64.rpm
    # rpm -ivh ssh-tectia-client-<version>-linux-x86_64.rpm
    # rpm -ivh ssh-tectia-guisupport-<version>-linux-x86_64.rpm

    Or upgrade the packages if you already have an older Tectia Client version installed:

    # rpm -Uvh ssh-tectia-common-<version>-linux-x86_64.rpm
    # rpm -Uvh ssh-tectia-client-<version>-linux-x86_64.rpm
    # rpm -Uvh ssh-tectia-guisupport-<version>-linux-x86_64.rpm
  4. Copy the license file to the /etc/ssh2/licenses directory. (This is not necessary in "third-digit" maintenance updates.) See also Licensing.

  5. Before you can run the PrivX Desktop client GUI, you will need to install the following dependencies:

    On SUSE:

    # zypper install libxcb-cursor0

    On RHEL/Rocky:

    # dnf install xcb-util-wm xcb-util-keysyms xcb-util-cursor
    [Note]Note

    You need to enable the EPEL repository to obtain some of the dependencies.

    Extra dependencies for PrivX Desktop have been verified on RHEL/Rocky 8.x and later, and may need to be adapted for other RPM-based distributions.

Installing on Linux (DEB)

Tectia Client for Debian GNU/Linux is supplied in Debian (DEB) binary packages for Ubuntu and Debian running on the 64-bit x86-64 architecture.

The Tectia installation bundle contains the DEB installation files and the license file.

To install Tectia Client on Debian Linux, follow the instructions below:

  1. Download the relevant installation bundle according to your license type:

    • Commercial Tectia Quantum Safe Edition License:

      tectia-client-<version>-linux-ubuntu-x86_64-comm-pqc.tar
    • Commercial License:

      tectia-client-<version>-linux-ubuntu-x86_64-comm.tar
    • Evaluation:

      tectia-client-<version>-linux-ubuntu-x86_64-upgrd-eval.tar

    In the package names, <version> corresponds to the release version and build number, for example 7.0.0.123-1.

  2. Unpack the downloaded tar package.

  3. Select the installation packages. Two packages are always required: one for the common components of Tectia Client and Server, and one for the specific components of Tectia Client.

    ssh-tectia-common-<version>_linux-x86_64.deb
    ssh-tectia-client-<version>_linux-x86_64.deb
    
  4. Install the packages with root privileges:

    # dpkg -i ssh-tectia-common-<version>_linux-x86_64.deb
    # dpkg -i ssh-tectia-client-<version>_linux-x86_64.deb
    
  5. Copy the license file to the /etc/ssh2/licenses directory. (This is not necessary in "third-digit" maintenance updates.)

  6. Before you can run the PrivX Desktop client GUI, install the following dependencies:

    # apt install libxcb-cursor0
    [Note]Note

    Extra dependencies for PrivX Desktop have been verified on Ubuntu, and may need to be adapted for other Debian-based distributions.

Installing on Solaris

The downloaded installation package contains the compressed installation files.

Two packages are required: one for the common components of Tectia Client and Server, and one for the specific components of Tectia Client.

Tectia Client includes support for Zones on Solaris 11. The Tectia software can be installed into the global and local zones. When the Tectia software is installed into the global zone, it becomes automatically installed also into the existing local zones. However, if the local zones are added into the system later, the Tectia Client needs to be separately installed on them.

In case you are installing Tectia Client into a sparse zone, note that the installation process will report a failure in creating symlinks. The actual installation is finished successfully, but you need to manually add the /opt/tectia/bin to the path settings.

For information on the Solaris Zones, see the Oracle documentation: System Administration Guide: Solaris Containers-Resource Management and Solaris Zones.

To install Tectia Client on Solaris, follow the instructions below:

  1. Unpack the downloaded tar package.

  2. When installing on Solaris version 11 running on the SPARC architecture, use the packages named:

    ssh-tectia-common-<version>-solaris-11-sparc.pkg.Z
    ssh-tectia-client-<version>-solaris-11-sparc.pkg.Z
    

    When installing on Solaris version 11 running on the x86-64 architecture, use the packages named:

    ssh-tectia-common-<version>-solaris-11-x86_64.pkg.Z
    ssh-tectia-client-<version>-solaris-11-x86_64.pkg.Z
    

    In the commands, <version> indicates the product release version and the current build number (for example, 7.0.0.123).

  3. Unpack the installation packages to a suitable place. The standard place is /var/spool/pkg in Solaris environment. In the command examples below, we use Solaris 11 x86-64:

    $ uncompress ssh-tectia-common-<version>-solaris-11-x86_64.pkg.Z
    $ uncompress ssh-tectia-client-<version>-solaris-11-x86_64.pkg.Z
    
  4. Install the packages with the pkgadd tool with root privileges:

    # pkgadd -d ssh-tectia-common-<version>-solaris-11-x86_64.pkg all
    # pkgadd -d ssh-tectia-client-<version>-solaris-11-x86_64.pkg all
    
  5. Copy the license file to directory: /etc/ssh2/licenses (This is not necessary in "third-digit" maintenance updates.) .

Installing on Windows

The Windows installation packages are provided in the MSI (Windows Installer) format for Microsoft Windows versions running on the 64-bit (x86-64) platform architecture.

The downloaded installation package is a zip file containing the license file and the executable Windows Installer (MSI) package.

The installation is carried out by a standard installation wizard. The wizard prompts you for information, copies the program files, and sets up the client.

[Note]Note

If you want to install both Tectia Client and Tectia Server on the same machine, you must install both products using the Tectia Server installer ssh-tectia-server-<version>-windows-<platform>.msi, where <version> shows the Tectia Client/Server release version and build number (for example 7.0.0.123), and <platform> shows the platform architecture (x86_64 for 64-bit Windows versions).

If you are upgrading a previous installation of Tectia Client, see first Upgrading Previously Installed Tectia Client Software.

To install Tectia Client on Windows, follow the instructions below:

  1. Extract the installation zip file contents to a temporary location.

  2. Locate the correct Windows Installer file ssh-tectia-client-<version>-windows-<platform>.msi, where:

    • <version> shows the Tectia Client/Server release version and build number, for example 7.0.0.123.

    • <platform> shows the platform architecture x86_64 for 64-bit Windows versions.

  3. Double-click the installation file, and the installation wizard will start.

    [Note]Note

    The license file will be imported automatically, when you extract the contents of the .zip package before running the .msi installer.

    If you run the .msi installer directly from the .zip package, you need to manually install the stc70.dat license file after completing the installation. The installation wizard will show an error message about missing license file (see below), and when you attempt to start the Tectia Client, you are prompted to install the license manually to the correct directory:

    • "C:\Program Files (x86)\SSH Communications Security\SSH Tectia\SSH Tectia AUX\licenses" on 64-bit Windows versions

    Warning about a missing license file

    Figure 2.1. Warning about a missing license file


    On Windows 10, Tectia packages downloaded via browser may trigger a Windows protected your PC warning. In such cases, proceed with the installation by clicking More info and Run anyway.

  4. Follow the wizard through the installation steps and fill in information as requested.

  5. The Typical installation of Tectia Client includes the sshg3.exe, scpg3.exe, and sftpg3.exe command-line tools, and the graphical user interface for terminal and file transfer.

    To also install Transparent TCP Tunneling (described in Transparent TCP Tunneling on Windows), select Complete when the wizard prompts for the setup type.

    To select specific components to install, select Custom when the wizard prompts for the setup type. The next dialog box allows you to exclude some of the components from the installation. See Figure 2.2.

    Installation options with Tectia Client

    Figure 2.2. Installation options with Tectia Client


  6. When the installation has finished, click Finish to exit the wizard.

  7. You have to restart the computer after installing Tectia Client. Click Yes to restart.

The default installation directory is:

  • "C:\Program Files (x86)\SSH Communications Security\SSH Tectia" on 64-bit Windows versions

Silent Installation

Tectia Client can also be installed silently on a workstation. Silent (non-interactive) installation means that the installation procedure will not display any user interface and will not ask any questions from the user. This option is especially useful for system administrators, as it allows remotely-operated automated installations.

In silent mode, Tectia Client is installed with the default settings and without any additional features.

The following command can be used to install Tectia Client silently:

msiexec /q /i ssh-tectia-client-<version>-windows-<platform>.msi INSTALLDIR="<path>"

In the command:

  • <version> shows the current version of Tectia Client, for example 7.0.0.123.

  • <platform> shows the platform architecture x86_64 for 64-bit Windows versions.

  • <path> is the path to the desired installation directory. If the INSTALLDIR variable is omitted, Tectia Client is installed to the default location.

Desktop Icon

During Windows installation, a PrivX Desktop icon is added to your desktop. It opens the GUI for Tectia Client.

The PrivX Desktop GUI icon

Figure 2.3. The PrivX Desktop GUI icon