Chapter 16. Tectia for Windows

Our treatment of Tectia in previous chapters has focused on Unix implementations, but Tectia is fully supported on Microsoft Windows platforms. It's packaged as a suite of products, including:

Tectia Client

A GUI application that initiates outgoing SSH connections, with a terminal emulator, supporting key-management functionality, port forwarding, and file transfers using SFTP, plus command-line programs for scripting

Accession Lite

An authentication agent

Tectia Connector

Transparent, dynamic port forwarding for selected applications

Tectia Server

A service to accept incoming SSH connections

At press time, the Tectia products can be installed on the versions of Windows listed in Table 16-1. Consult the latest documentation for a complete list of supported platforms.

Table 16-1. Supported Microsoft Windows platforms for SSH Tectia

Program

95

98

Me

NT

2000

XP

Server 2003

Tectia Client

-

any

any

4.0SP6

SP2

any

any

Accession Lite

-

any

any

4.0SP6

SP2

any

any

Tectia Connector

-

-

-

4.0SP6

SP2

SP1

-

Tectia Server

-

-

-

4.0SP6

SP2

any

any

Tectia products are shipped as Windows Installer Packages.[167] The easiest way to install is to use Windows Explorer to double-click on the included .msi files:

  • TectiaClient-version.msi

  • TectiaConnector-version.msi

  • TectiaServer-version.msi

These files can be found in the install/windows folder on your distribution media, or downloaded from the ssh.com web site, depending on how you purchased the products. The installers must be run by a user with administrative privileges. Installing the Connector package requires a reboot.

During interactive installation, you'll see a series of dialogs; use these to specify the install directory if the default location is not appropriate. By default, Tectia products are installed within the Program Files folder in a Tectia subfolder named SSH Communications Security.[168] Files for each product are collected in separate subfolders under the Tectia subfolder:

  • SSH Secure Shell

  • SSH Accession Lite

  • SSH Tectia Connector

  • SSH Secure Shell Server

We'll refer to these as the "installation folders." The installers also create entries in the Start/Programs menu, under the program groups:

  • SSH Tectia Client

  • SSH Tectia Connector

  • SSH Tectia Server

The installer for the Client package optionally creates desktop icons for the GUI client application:

  • SSH Tectia Client

  • SSH Tectia Client - File Transfer

The PATH environment variable is updated to include the installation folder for the Client package, so scripts can easily access command-line programs.

The Server installer generates host key files by running ssh-keygen2 in a command window: this can take several minutes to complete.[169] The server is added as a service that starts automatically whenever the system boots.

Tectia products can also be installed silently, using the msiexec command-line tool:

    C:\> msiexec /q /i Tectia<Product>-<version>.msi INSTALLDIR="<path>"

If the INSTALLDIR argument is omitted, the default locations are used. Silent installation is handy for rolling out products to a large number of systems.

To remove Tectia products, use the Add/Remove Programs section of the Control Panel, or the command:

    C:\> msiexec /q /x Tectia<Product>-<version>.msi

The Tectia Server must be stopped before it is uninstalled.



[167] Accession Lite is included with the Client and Connector packages and is not available as a separate package.

[168] The Program Files folder can be determined by examining the value of the PROGRAMFILES environment variable. It is typically C:\Program Files.

[169] If you run Server installer in silent mode, the host key is not generated automatically. Use ssh-keygen2 to generate the host key manually.