SSH

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 6.6.3.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 (sts66.dat for Tectia Server and stc66.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.