SSH Tectia

Installing on Windows

The Windows installation packages are provided in the MSI (Microsoft Installer) format. The same package is compatible with the 32-bit (x86) and the 64-bit (x64) versions of Microsoft Windows.

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

On the installation disk, the installation package for Windows is located in the /install/windows/ directory.

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

Installation of SSH Tectia Server requires rebooting the computer.

[Note]Note

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

SSH Tectia Server includes support for Entrust certificates on Windows XP. The necessary libraries are automatically included in the installation.

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.

[Note]Note

Upgrade is different from performing uninstall and install in a row. When you start an upgrade, check the Release Notes to see if upgrading to the new version will require a reboot.

To install SSH Tectia Server on Windows, follow the instructions below:

  1. Make sure no other Secure Shell software is using port 22 (SSH Tectia Server default listen port). Stop any competing server software or change their listen port.

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

    [Note]Note

    The license file will be imported automatically, when you extract the contents of the online .zip package before running the .msi installer, or if you are installing from the installation disk.

    If you run the .msi installer directly from the online .zip package, you need to manually import the sts61.dat license file after completing the installation. The installation wizard will show an error message about missing license file, and when you attempt to start the SSH Tectia Server, you are prompted to import the license manually to the correct directory.

  3. Locate the installation file ssh-tectia-server-<version>-windows.msi (where <version> shows the SSH Tectia Server version and build number, for example 6.1.9.123).

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

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

    The server host key is generated during the installation. The key generation may take several minutes on slow machines.

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

  7. Fresh installation always requires rebooting the computer. In case you were performing an upgrade, a reboot is not necessarily required.

  8. Reboot the computer.

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

    In case the server does not (re)start automatically, you can start it manually according to the instructions given in Starting and Stopping on Windows.

Silent Installation

SSH Tectia Server can also be installed silently on a server host. 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, SSH Tectia Server is installed with the default settings and without any additional features.

[Note]Note

After the SSH Tectia Server has been installed, the server is automatically restarted.

The following command can be used to install SSH Tectia Server silently:

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

In the command, <version> is the current version of SSH Tectia Server (for example, 6.1.9.123), and <path> is the path to the desired installation directory. If the INSTALLDIR variable is omitted, SSH Tectia Server is installed to the default location ("C:\Program Files\SSH Communications Security\SSH Tectia").