SSH

Installing on Windows

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

The downloaded 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.

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 Tectia Client, see first Upgrading Previously Installed Tectia Client Software.

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

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

  2. Locate the Windows Installer file ssh-tectia-client-<version>-windows.msi (where <version> corresponds to the version and build number, for example 6.3.14.123). On some Windows versions the .msi file type is not shown for the installer file.

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

    [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 DVD.

    If you run the .msi installer directly from the online .zip package, you need to manually import the stc63.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 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" on 32-bit Windows versions

    • "C:\Program Files (x86)\SSH Communications Security\SSH Tectia\SSH Tectia AUX\licenses" on 64-bit Windows versions

    Warning about a missing license file

    Figure 2.1. Warning about a missing license file

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

  5. The Typical installation of 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.

    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 Tectia Client

    Figure 2.2. Installation options with Tectia Client

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

  7. You have to restart the computer after installing Tectia Client. Click Yes to restart.

The default installation directory is:

Silent Installation

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, Tectia Client is installed with the default settings and without any additional features.

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

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

In the command, <version> is the current version of Tectia Client (for example, 6.3.14.123), and <path> is the path to the desired installation directory. If the INSTALLDIR variable is omitted, Tectia Client is installed to the default location ("C:\Program Files\SSH Communications Security\SSH Tectia"). However, on 64-bit Windows where a 32-bit version of Tectia Client is installed, the default location is "C:\Program Files (x86)\SSH Communications Security\SSH Tectia".

Desktop Icons

During installation, Tectia icons are added to your desktop. There are separate program icons for Tectia SSH Terminal and Secure 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 Tectia SSH Terminal GUI icon

Figure 2.3. The Tectia SSH Terminal GUI icon

The Tectia Secure File Transfer GUI icon

Figure 2.4. The Tectia Secure File Transfer GUI icon