Installing and updating Installation Manager on z/OS

On IBM z/OS® you can install packages by using silent installations and console mode.

About this task

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 Linux® and UNIX default directory settings. For more information about installation modes and default directory locations, see Installing as an administrator, nonadministrator, or group.

Note:

Installation Manager users can use the default directory locations for z/OS to establish a single read/write file system for an Installation Manager instance. This file system contains all the binary files and data for a specific instance of Installation Manager. You can use other values for these directories.
The z/OS system that is used to install Installation Manager for z/OS must run z/OS UNIX® System Services (z/OS UNIX) with an HFS or zFS file system configured.

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

Procedure

Obtain a copy of the Installation Manager installation files by 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. You can obtain an extract command for z/OS from IBM z/OS UNIX System Services Ported Tools.
    If you use the jar command to extract the installation files, you 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.
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
Note: If you 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.
Choose locations for the binary files, agent data, and shared resources directories for Installation Manager. You can use the z/OS or UNIX default directories or select a different directory location. You 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

Note: If you 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.
Log on to the shell with the user ID selected to install Installation Manager.
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
Note: If you 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.
If you need to update Installation Manager:
1. Download a current set of Installation Manager installation files or install a current Installation Manager PTF if you installed the installation files with SMP/E.
2. Rerun the command or the sample job that you 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.