SSH

Installing Tectia Software

Installing Tectia Client on Windows
Installing Tectia Server (and Client) on Windows
Installation Complete

This section introduces how Tectia Client and Server are installed on Windows running on the 64-bit x86-64 platform architecture.

Installing Tectia Client on Windows

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

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

You must have administrator rights to install Tectia Client on Windows.

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.

To install Tectia Client on Windows, do the following:

  1. Extract the contents of the installation zip file to any temporary location.

    [Note]Note

    The license file will be automatically imported to the correct location, if 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. The installation wizard will show an error message about missing license file, and when you attempt to start Tectia Client, you are prompted to install the license manually to the correct directory:

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

  2. Locate the correct installation 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.

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

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

    To install all components, select Complete when the wizard prompts for the setup type.

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

The default installation directory is:

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

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.2. The PrivX Desktop GUI icon


Installing Tectia Server (and Client) on Windows

The Windows installation package is provided in the MSI (Windows Installer) format for Microsoft Windows versions running on the 64-bit (x86-64) platform architecture. Tectia Server installation package can be used to install also Tectia Client.

The installation package is a zip file containing the Tectia Client/Server license files and the executable Windows Installer (MSI) packages.

You must have administrator rights to install Tectia Client/Server on Windows.

[Note]Note

Tectia Server cannot be installed on file systems that do not support permissions (for example, FAT16 or FAT32). The hard disk partition where Tectia Server is installed must use the NTFS file system.

The installation is carried out by a standard installation wizard. The wizard will prompt you for information and will copy the program files, install the services, and generate the host key pair for the server.

To install Tectia Server and (optionally) Tectia Client on Windows, do the following:

  1. Extract the contents of the installation zip file to any temporary location.

  2. Locate the correct installation file 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.

    • <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 files for Tectia Client/Server will be imported automatically, if 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 import the license files (sts70.dat for Tectia Server and stc70.dat for Tectia Client) after completing the installation. The installation wizard will show an error message about missing license files, and when you attempt to start Tectia Client/Server, you are prompted to import the license(s) manually to the correct directory:

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

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

    The installation wizard will display options Typical, Custom and Complete.

    If you do not want to install both Tectia Server and Client, select Custom and choose which product components you wish to install.

    The server host key is generated during the installation.

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

  6. For Tectia Server to be fully functional after installation, you must restart the computer.

    [Note]Note

    If you do not restart the computer after installing Tectia Server, the server will run with the following limitations in the authentication of local users and domain users from one-way trusted domains:

    • Public-key authentication will not work.

    • Certificate authentication, keyboard-interactive submethods RADIUS and RSA SecurID, and host-based authentication will only work if the password cache is enabled and the user's password is stored in the cache.

    • Authentication selectors of type User group (user-group) and Administrator (user-privileged) will not work.

    Tectia Server will write warning messages into the Windows Event Log. Use the Windows Event Viewer to examine the log contents (On the Tectia Server Configuration tool's Tectia Server page, click the View Event Log button.

    Tectia Server will start automatically every time the computer is started, and it stays running in the background. Tectia Server displays no icons on the desktop, but you can see it listed in the Windows Start → (All) Programs menu.

  7. Usually there is no need to manually restart Tectia Server.

    If you need to restart Tectia Server (for example because of a missing license or because some other secure shell software is running on port 22), use the Tectia Server Configuration GUI as follows:

    1. In the Windows Start menu, click (All) Programs → Tectia Server → Tectia Server Configuration.

    2. Under the Server Status, click the Start Server button.

      The Server will start, and the status changes first to Starting... and then to Running.

    3. To exit the Tectia Server configuration GUI, click OK.

Installation Complete

After a successful installation, Tectia Client and Tectia Server are automatically started at reboot and they keep running in the background until you stop them manually, or shut the host down.

You can use Tectia Client and Tectia Server with the default settings to test their functions. For instructions on opening a secure connection for the first time, see Chapter 3.

It is also possible to customize the behavior of the Tectia client/server solution according to your needs. To learn more about modifying the Tectia configuration for different purposes, refer to the later chapters in this manual:

  • Chapter 4 explains configuring of authentication methods
  • Chapter 5 explains secure file transfer
  • Chapter 6 explains securing application connections.