Install and update Installation Manager on z/OS

On ZOS we can install packages using silent installations and console mode.

The install command is not included with the installation files for z/OS as the GUI mode is not supported for z/OS. Use the installc, userinstc, or groupinstc commands to install Installation Manager and the associated runtime data on z/OS. The default directory settings for z/OS are different from the UNIX default directory settings. For information about installation modes and default directory locations, see Install as an administrator, nonadministrator, or group.

For information about z/OS, see z/OS Internet Library.

Procedure

  1. Obtain a copy of the Installation Manager installation files using one of the following methods:

    • Download a current Installation Manager kit for z/OS and copy it as a binary file to your z/OS system (for example, use FTP).

      1. Go to the Installation Manager download links technical document and click the applicable download document link. The download document contains details about downloading the installation files.

      2. Use an extract or jar command to extract the installation files to a directory such as /usr/lpp/InstallationManager/V1R4. We can obtain an extract command for z/OS from IBM z/OS UNIX System Services Ported Tools.

        If we use the jar command to extract the installation files, we must restore the file permissions, especially the execute permissions, for the extracted files before you continue:

        chmod -R 755 /usr/lpp/InstallationManager/V1R4

      3. Run the ./set-ext-attr.sh command to set extended attributes for the installation files. After the command completes, remount the installation files as read-only.

    • Install the no-charge product Installation Manager for IBM z/OS (5655-IMZ, FMID HGIN140). See the Installation Manager PTF document for a list of the PTFs that update the Installation Manager installation files to a particular level.
  2. Choose or create a user ID to install and run Installation Manager. The user ID must have these characteristics:

    • Read/write home directory
    • Read access to FACILITY profile BPX.FILEATTR.APF
    • Read access to FACILITY profile BPX.FILEATTR.PROGCTL
    • Read access to FACILITY profile BPX.FILEATTR.SHARELIB
    • Read access to UNIXPRIV profile SUPERUSER.FILESYS.CHOWN
    • Read access to UNIXPRIV profile SUPERUSER.FILESYS.CHANGEPERMS

    If we installed the Installation Manager installation kit with SMP/E, use the Installation Manager sample job GIN2ADMN in SGINJCL to create this user ID and group and to assign appropriate permissions.

  3. Choose locations for the binary files, agent data, and shared resources directories for Installation Manager. We can use the z/OS or UNIX default directories or select a different directory location. We can create and mount a new physical file system to contain these directories and their contents. All directories must be in a read/write file system, be owned by the user ID that installs Installation Manager, and have directory permissions 755. If Installation Manager is run in group mode, the directories must be owned by the default group for the user ID that installs Installation Manager and must have directory permissions 775. Use the zCreateFileSystem.sh script in the tools directory of the Installation Manager installer to create and mount a file system for the Installation Manager:
    zCreateFileSystem.sh -name data_set_name -type HFS|ZFS
[-volume volume]
[-cylinders primary_cylinders secondary_cylinders]
[-megabytes primary_megabytes secondary_megabytes]
[-mountpoint mount_point -owner owner -group group]
[-perm permissions]

    Example:

    zCreateFileSystem.sh -name OMVS.PRV.WITMAINT.SGINHFS -type ZFS -volume PRV005 -cylinders 2500 250 -mountpoint /InstallationManager -owner IMADMIN -group IMGROUP -perm 775

    If we installed the Installation Manager installation kit with SMP/E, use the Installation Manager sample job GIN2CFS in SGINJCL to create and mount a file system for Installation Manager.

  4. Log on to the shell with the user ID selected to install Installation Manager.

  5. Install Installation Manager with the installc, userinstc, or groupinstc commands. To change to the default values for the installation and agent data directories, use -installationDirectory and -dataLocation. Use installc for administrator mode, userinstc for nonadministrator mode, and groupinstc for group mode.

    • Install Installation Manager in admin mode with default values:

      installc -acceptLicense

    • Install Installation Manager in group mode with user-specified Installation Manager binaries and appdata locations:

      groupinstc -installationDirectory /opt/im1 -dataLocation /var/im1 -acceptLicense

    If we installed the Installation Manager installation kit with SMP/E, use the Installation Manager sample job GIN2INST in SGINJCL to run the installc, userinstc, or groupinstc command to create Installation Manager.

  6. If we need to update Installation Manager:

    1. Download a current set of Installation Manager installation files or install a current Installation Manager PTF if we installed the installation files with SMP/E.
    2. Rerun the command or the sample job that we used to create Installation Manager.

    3. Ensure that the new installation files are used and that the command or sample job runs under the original Installation Manager user ID that specifies the same options: -installationDirectory and –dataLocation.
Related tasks:
  • Install or update Installation Manager silently using the installer
  • Install Installation Manager using console mode
    Home