Your browser does not allow storing cookies. We recommend enabling them.


Upgrading to Tectia Server for IBM z/OS 6.6.3

Preparing for the Product Upgrade

After you have uploaded the files required for the upgrade, do the following on your z/OS host:

  1. Receive the Tectia SSH Assistant application data set (replace the XXXX in the name with the correct build number):


    Press Enter repeatedly to page through the command output and when prompted, press R to replace the existing data set.

    You should see this message in the end of the command output: Restore successful to dataset 'prefix.SSZASST.PDS'.

  2. Set up the application libraries by EXECing the Rexx script $RECEIVE that is inside the restored data set:


    You should see this message in the end of the command output: Restore successful to dataset 'prefix.SSZASST.SKEL'.

  3. EXEC the Tectia SSH Assistant application:

  4. Update the following settings in the Tectia SSH Assistant ISPF application:

    • 0.1 SETI: Version and Tarball. Make sure you enter the correct Version. It must correspond with the untarred directory name of the product version you are upgrading to.


      You can check the current Version by pressing PF1 (help).

    • 0.2 SETO: DSName and Mountpoint


    You only have to type in the Version. For the other fields (Tarball, DSName and Mountpoint) it is enough to blank the field out and press Enter. A suitable value based on the Version will automatically be added to the field.

    For more information on all the available settings, see Installation Settings and Defaults.

  5. Generate the required installation jobs. When updating an existing working installation, it is enough to successfully run jobs 7 to 13. When new licenses are to be installed, also job 14 must be run. To generate all the installation jobs at once, use the 1.99 GENALL option.

    For descriptions of the installation jobs, see Generating Product Installation Jobs.

Completing the Product Upgrade

The installing user must next do the following to complete the upgrade:

  1. In Tectia SSH Assistant, go to 0 SETM → 3 SETL and define the installation log data set from which to extract the installation settings:

    Logfile   ===> '<prefix>.SSZ.INSTALL.LOG'
  2. In 0.1 SETI and 0.2 SETO, check that the installation input and output settings are correct.

  3. In 2.1 JOBS, submit the following installation jobs:

    • 07 (SAVE) - Save key data from previous installation (generated by action 1.7 SAVE).


      If the Certificate server is running, running this job may result in error code 0256. You can ignore the error.

    • 08 (ZFSA) - Define the installation zFS: allocate a new zFS data set, format and mount it onto the defined mount point, using names and attributes given in the settings panel 0.2 SETO (generated by action 1.8 ZFS).

    • 09 (LOAD) - Load the installation zFS (generated by action 1.9 LOAD).

    • 10 (REST) - Restore key data from previous installation (generated by action 1.10 RESTORE).

    • 11 (OPTT) - Create the /opt/tectia symlink (generated by action 1.11 SYMLINK).


      This job will delete a previously existing /opt/tectia symlink. However, if the existing /opt/tectia is a directory and not a symlink, this job will fail. This is to avoid the accidental deletion of directory contents that may not have been backed up.

      To delete the /opt/tectia directory, use the -r option with the rm command. Note that to delete the directory, you must first unmount the existing mount point.

    • 12 (LIBS) - Create PDS libraries for sample jobs and parameters (generated by action 1.12 SSZLIBS).

    • 13 (PROC) - Set up started task procedures (generated by action 1.13 PROCLIB).

    • 14 (LICN) - Install new licenses (generated by action 1.14 LICENCE).


    If the installing user is not allowed to run the server, re-grant them console rights by running job 01 (IUSR) (generated by action 1.1 INSTUSER) again. The installing user must then log on again to acquire the new console rights.

  4. To restart the server, go to 4 TASK → 1 TSRV and enter 3 TSRVR.

    To check the version of the running server, enter 5 TSRVQV.

  5. (Optional) You can use job U01ZDEL, accessible via the Tectia SSH Assistant main menu option 5 UTIL, to delete the previous installation ZFS. The job unmounts the installation ZFS, deletes the mount point, and deletes the installation ZFS data set (i.e., everything under /opt/tectia). Only the PROCs and samples will be retained.


    Job U01ZDEL uses the previous version number, so if you run "Generate installation jobs" (1 GENJ) multiple times for the same release, the job will remove the ZFS of the current installation.




What to read next:

  • Reduce Secure Shell risk. Get to know the NIST 7966.

    The NISTIR 7966 guideline from the Computer Security Division of NIST is a direct call to action for organizations regardless of industry and is a mandate for the US Federal government.
    Download now
  • ISACA Practitioner Guide for SSH

    With contributions from practitioners, specialists and SSH.COM experts, the ISACA “SSH: Practitioner Considerations” guide is vital best practice from the compliance and audit community.
    Download now