Upgrading to Tectia Server for IBM z/OS 6.5.0

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:


    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.

    • 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. 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).

    • 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).

    • Submit only in the case of a major release upgrade: 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.