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

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

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

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

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.

If you are upgrading a previous installation of SSH Tectia Client, see first Upgrading Previously Installed SSH Tectia Client Software.

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

  1. 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 stc60.dat license file after completing the installation. The installation wizard will show an error message about missing license file (see below), and when you attempt to start the SSH Tectia Client, you are prompted to import the license manually to the correct directory:

    "C:\Program Files\SSH Communications Security\SSH Tectia\SSH Tectia AUX\licenses"

    Warning about a missing license file

    Figure 2.1. Warning about a missing license file

  2. Locate the installation file ssh-tectia-client-<version>-windows.msi (where <version> corresponds to the version and build number, for example 6.0.10.123).

  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. The Typical installation of SSH Tectia Client 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.

    [Note]Note

    Transparent TCP tunneling is supported as an optional feature on Windows 2000 and XP.

    If you want to select the components to install, select Custom when the wizard prompts for the setup type. The next dialog box allows you to exclude some of the components from the installation. See Figure 2.2.

    Installation options with SSH Tectia Client

    Figure 2.2. Installation options with SSH Tectia Client

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

The default installation directory is "C:\Program Files\SSH Communications Security\SSH Tectia".

Silent Installation

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

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

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

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

SSH Tectia Program Group

The installation creates a new program group in the Start → Programs menu. The default name for this program group is SSH Tectia Client.

The SSH Tectia Client program group

Figure 2.3. The SSH Tectia Client program group

The Documentation link opens the User Documentation view on the SSH website.

The SSH Tectia - File Transfer link opens a Secure Shell session with the file transfer GUI.

The SSH Tectia - Terminal link opens a Secure Shell session with the terminal GUI.

The SSH Tectia - Configuration link opens the GUI for configuring the Connection Broker.

Desktop Icons

During installation, SSH Tectia icons are added to your desktop. There are separate program icons for SSH Tectia Terminal and File Transfer windows. They both start the same application, ssh-client-g3.exe. The first icon starts the terminal window and the latter starts the file transfer window.

The SSH Tectia Terminal icon

Figure 2.4. The SSH Tectia Terminal icon

The SSH Tectia File Transfer icon

Figure 2.5. The SSH Tectia File Transfer icon