SSH

Installing on Linux on IBM System z

Use these instructions when you are installing Tectia Server for Linux on IBM System z. For instructions on installing Tectia Server on Linux running on the 32-bit x86 and the 64-bit x86-64 platform architecture, see Installing on Linux .

Download the online installation package containing the RPM (Red Hat Package Manager) installation files for Tectia Server for Linux on IBM System z. The same installation package can be used on all supported Linux versions on IBM System z.

On the installation disk, the installation packages for Linux are located in the /install/linux/ directory.

Two packages are required: one for the common components of Tectia Client and Server, and one for the specific components of Tectia Server.

Before installing on Red Hat Enterprise Linux for IBM System z version 6, the following 32-bit system libraries must be installed:

Use the following commands to install the libraries:

cd rhel-6/EServer/s390x/Packages
sudo rpm -ivh glibc-2.12-1.7.el6.s390.rpm \
              nss-softokn-freebl-3.12.7-1.1.el6.s390.rpm \
              libXau-1.0.5-1.el6.s390.rpm
sudo rpm -ivh --force libstdc++-4.1.2-50.el5.s390.rpm \
                      libgcc-4.1.2-50.el5.s390.rpm

To install Tectia Server for Linux on IBM System z, follow the instructions below:

  1. Unpack the downloaded tar package.

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

  3. Select the installation packages for Linux on IBM System z.

    ssh-tectia-common-<version>-linux-s390.rpm
    ssh-tectia-server-<version>-linux-s390.rpm
    

    In the commands, <version> indicates the product release version and the current build number (for example, 6.3.14.123).

  4. Install the packages with root privileges:

    # rpm -Uvh ssh-tectia-common-<version>-linux-s390.rpm
    # rpm -Uvh ssh-tectia-server-<version>-linux-s390.rpm
    

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

  5. Copy the license file to the /etc/ssh2/licenses directory. (This is not necessary in "third-digit" maintenance updates.) See Licensing.

    If this is the initial installation of Tectia Server, the directory does not yet exist. You can either create it manually or copy the license after the installation. In the latter case, you have to start the server manually after copying the license file.

  6. The installation should (re)start the server automatically.

    [Note]Note

    If the server does not start (for example because of a missing license or because some other secure shell software is running on port 22), you can start it after correcting the problem by issuing the command:

    # /etc/init.d/ssh-server-g3 start
    

For instructions on installing the client-side tools included in Tectia Server for Linux on IBM System z, refer to the Client User Manual.