Submitting jobs to install Installation Manager on remote hosts

In a flexible management environment, we can submit the Install IBM Installation Manager job to install the Installation Manager on registered hosts of the job manager.

Start the job manager and the targets. Ensure that the targets for which to install Installation Manager are registered with the job manager.

To submit jobs, the ID at the job manager must be authorized for the administrator role or the operator role. When you submit a job, we can specify a user name and password for authentication and authorization at the target or targets. When you submit a job to multiple targets, the user name and password or the credentials for the submitter must apply to all of the job targets.

To run the job against a large number of targets, optionally create a group of targets and submit the job against the group.

For instructions on updating an existing instance of Installation Manager, see Submitting jobs to update Installation Manager on remote hosts.

(iseries) To perform the installIM job as an administrative user on IBM i , the user profile must have *JOBCTL, *ALLOBJ and *SECADM authorizations.

(zos) Note: CIM jobs to install, uninstall, and update Installation Manager are not supported on z/OS targets. We must first install Installation Manager on z/OS targets before using CIM manage offerings jobs.

We can use the console of the job manager or the deployment manager to submit the job. From the console, choose the Install IBM Installation Manager job, specify the targets, schedule the job, review the summary, and submit the job.

Instead of using a console, we can run the installIM job script in the AdministrativeJobs command group. See the Administrative job types topic.

For Windows targets, CIM sends unzip.exe to the target to unzip the Installation Manager zip file. If we do not want to use unzip.exe from CIM, we can set the JVM parameter:

If this parameter is set to true, CIM unzips the zip file from the job manager and sends individual files to the target. We must restart the server after changing this parameter.

For Linux/UNIX targets, if CIM detects an instance of unzip, CIM sends the zip file to the target and then unzips the zip file. If CIM does not detect an instance of unzip, CIM unzips the zip file from the job manager and sends individual files to the target. Sending the files individually usually requires more time than unzipping on the target. For IBM i targets, CIM uses the jar command found on the IBM i target to unzip the zip file.

After the centralized installation manager successfully completes the installation process on a remote node, it then deletes the installation image files that are located in the temporary location specified during the installation process. If the installation is unsuccessful, the files remain in the temporary location for you to use to determine what caused the installation error. However, we can safely delete the files.

Supported configurations: IBM Installation Manager 1.5.2 or later is required.

  1. Click Jobs > Submit from the navigation tree of the console.

  2. Choose the Install IBM Installation Manager job and click Next.

  3. Choose job targets.

    1. Select a group of targets from the list, or select Target names.

    2. If we selected Target names, then specify a target name and click Add, or click Find and specify the chosen targets on the Find targets page.

    3. If user authentication is required, specify a user name, password, or any other authentication values as needed.

    4. Click Next.

  4. On the Specify the job parameters page, specify the location of the Installation Manager instance to install.

    If we do not specify the IBM Installation Manager installation kit path, the installIM job searches for the most recent IBM Installation Manager installation kit that is suitable for the target platform from the installation kit repository on the Job Manager. By default, the installation kit repository is <profile_home>/IMKits. We can change the location from the Job Manager. Click Jobs > Installation Manager installation kits, then modify 'Installation Manager installation kits location' to a different location. For the command line, we can check for the repository location at: <profile_home>/properties/cimjm/CIMJMMetadata.xml.

    Optional...

    • Installation Manager agent data location: specifies the location of the Installation Manager agent data.

      The data location cannot be a subdirectory of the installation location.gotcha

    • Installation Manager installation directory: specifies the location of the Installation Manager installation directory.

    If we select the Skip prerequisite checking check box, specified that no prerequisite checking is performed when installing Installation Manager and that Installation Manager disk space checking is disabled. For the job to run successfully, you must select I accept the terms in the license agreements. Click Next

    To review the Installation Manager license, perform the following steps:

    Avoid trouble: Run the install command from the Installation Manager install kit.gotcha

    • For the GUI (GUI), run the following command and follow the instructions:

      • install

      • install.exe

    • For the command line, run the following command and follow the instructions:

      • installc -c

      • installc.exe -c

    To install Installation Manager so that it can be used by a group of users, specify the installType optional parameter. Values for the parameter include:

    • group: specify a group installation of Installation Manager. If the target is not one of the supported operating system types, the job will fail.

    • single: perform a single user installation in non administrative mode. This option is available for all CIM supported platforms.

    • Auto: the command initiates a single user installation in non administrative mode if the are a non administrative user. If we are an administrator, this action performs an administrative installation.

  5. Schedule the job, and click Next.

  6. Review the summary, and click Finish to submit the job.


Results

The job runs and installs Installation Manager on the selected targets.


What to do next

On the Job status page, click the job ID and view the job status. Click the status refresh icon

to refresh the displayed job status.

If the job is not successful, view any error messages that result from running the job, correct the error condition, and submit the job again.


Related tasks

  • Manage Installation Manager using the job manager
  • Submitting jobs to update Installation Manager on remote hosts for v8.5
  • Submitting jobs to uninstall Installation Manager on remote hosts
  • Start and stop the job manager

  • Administrative job types