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 Server 2003 and Server 2008.

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

On the CD-ROM, the installation package for Windows is located in the /install/windows/ directory.

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

[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 2000 and 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.

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 a CD-ROM.

    If you run the .msi installer directly from the online .zip package, you need to manually import the sts60.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.0.19.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. The installation should (re)start the server automatically. To start the server manually, follow 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.0.19.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").