SSH Tectia 
PreviousNextUp[Contents] [Index]

    About This Document >>
    Installing SSH Tectia Server for IBM z/OS >>
        Preparing for Installation >>
        Upgrading Previously Installed Secure Shell Software >>
            From OpenSSH
            From SSH Tectia Server for IBM z/OS Version 5.x
            From SSH Tectia Server for IBM z/OS Version 6.0
            From SSH Tectia Server for IBM z/OS when Two Versions Exist
        Installing the SSH Tectia Server for IBM z/OS Software >>
        Removing the SSH Tectia Server for IBM z/OS Software
    Getting Started with SSH Tectia Server for IBM z/OS >>
    Configuring the Server >>
    Authentication >>
    System Administration >>
    File Transfer Using SFTP >>
    Secure File Transfer Using Transparent FTP Security >>
    Tunneling >>
    Troubleshooting SSH Tectia Server for IBM z/OS >>
    Man Pages and Default Configuration Files >>
    Log Messages >>

From SSH Tectia Server for IBM z/OS Version 5.x

The product structure and the installation directory of SSH Tectia Server for IBM z/OS has changed in version 6.0. If you have an earlier version of SSH Tectia Server for IBM z/OS installed, it can coexist with version 6.0, as can the 5.x version.

The upgrade procedure will migrate your 5.x configuration and the keys automatically to the 6.x version.

Before proceeding with the installation as described in Installing the Software, condsider the following issues.

When you run setup.sh for upgrading from version 5.x you must choose if you want to keep the old 5.x installation intact or if you want to uninstall all 5.x files. You must run setup.sh either with

./setup.sh --uninstall-old 

or

./setup.sh --keep-old

If you choose to uninstall 5.x, please note that the directories /etc/ssh2 and /usr/lpp/ssh2 will get unconditionally removed after the upgrade procedure has succesfully completed. Make sure that those directories do not contain any files you want to keep for reference (ad-hoc configuration backups, notes etc.) before running setup.sh.

If you choose to keep the 5.x installation, nothing from the old 5.x will be uninstalled by the setup.sh script. In case you want to have both the 5.x and the 6.x servers running simultaneously, you must change the TCP port of either one of them, because otherwise the two installed servers will compete for default port 22.

To avoid conflicts at the next IPL please check and update:

  • Your started task JCL for the server
  • Operator instructions for running the server
  • Any other sshd2 init procedures (/etc/rc for example)

When upgrading from 5.x to 6.x, these files/directories under /etc/ssh2/ are copied from the 5.x installation to your new installation at /opt/tectia/ and they continue to be used with SSH Tectia Server 6.1 for IBM z/OS:

hostkey
hostkey.pub
sshd2_config
ssh_certd_config
ssh_ftadv_config
random_seed
ssh_banner_message
ssh-socks-proxy-config.xml
upgrade_history
auth/
hostkeys/
subconfig/
knownhosts/

If you are using the SOCKS proxy functionality, you must review and update your ssh-socks-proxy-config.xml configuration file after setup.sh has finished.

The existing /etc/ssh2/ssh2_config or $HOME/.ssh2/ssh2_config configuration files are not used by SSH Tectia Server 6.1 for IBM z/OS client components. You have to create new opt/tectia/etc/ssh-broker-config.xml and $HOME/.ssh2/ssh-broker-config.xml files.

For information on upgrading SSH Tectia client tools configurations from to version 5.x to 6.1, see SSH Tectia Server for IBM z/OS Migration Guide.

PreviousNextUp[Contents] [Index]


[ Contact Information | Support | Feedback | SSH Home Page | SSH Products ]

Copyright © 2011 SSH Communications Security Corp.
This software is protected by international copyright laws. All rights reserved.
Copyright Notice