Manage Installation Manager using the job manager

We can store and manage all of the installation manager installation kits from a central location.

Before we can work with IBM Installation Manager, you must register at least one host with the job manager. We must also have acquired one or more Installation Manager installation kits.

(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.

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

If we have multiple Installation Manager offerings or need to manage Installation Manager on multiple remote machines, the job manager can automate this process. Job manager can also store your Installation Manager installation kits in a single repository. This allows us to manage the installation kits from a single location and send the installation kits to multiple machines.

• We can submit an inventory job to see what is installed on a host.

  (iseries) Note: The centralized installation manager can not discover profiles for Application Client and Plugin on IBM i platforms.

  • We can submit and inventory job with a username and password; for example:

    • Jacl:
      $AdminTask submitJob {-jobType inventory -targetList {hostname} -username username -password password}

    • Jython:
      AdminTask.submitJob('-jobType inventory -targetList [hostname] -username user -password xxxxxx')

  • If we saved user credentials while registering host, we can submit an inventory job without credentials; for example:

    • Jacl:
      $AdminTask submitJob {-jobType inventory -targetList {hostname} }

    • Jython:
      AdminTask.submitJob('-jobType inventory -targetList [hostname] ')

• We can browse the Installation Manager installation kit directory and change the directory location. Perform this task using the console GUI. Open the console and select Submit Jobs > Installation Manager installation kits. For more information, see Installation Manager installation kits.

• We can submit a job to install Installation Manager on a host using the console.

  1. In the console, select Job > Submit.

  2. In the job type menu list, select Install IBM Installation Manager. Click Next.

  3. Specify the job parameters. The Install Action menu has the following options:

     • Install based on login credentials

     • Install for single user only

     • Install for a group of users

• We can submit a job to install Installation Manager on a host by sending the installation kit from the command line.

  The installIM job has the following required parameters:

  • kitPath: Specify the full path name to the IBM Installation Manager kit on the job manager machine.

  • acceptLicense: Must be set to true, if we do not specify this parameter, the job will fail.

  The installIM job has the following optional parameters:

  • installPath: Specify the path to install Installation Manager on the remote machine. If this parameter is not specified, then Installation Manager is installed to the default location.

  • dataPath: Specify the Installation Manager data path on the remote machine. If this parameter is not specified, the default Installation Manager data path is used.

  • installAction: Specify a group or single user installation of Installation Manager. If the parameter is not specified, then the parameter is automatically selected depending on the user account type. For example, if your user account belongs to an administrative group, then the job will install Installation Manager for all users of the administrative group.

  • Submit the install Installation Manager job without credentials; for example:

    • Jacl:
      $AdminTask submitJob {-jobType installIM -targetList {hostname} -jobParams { {installPath <path>} {dataPath <path>} {kitPath <path>} {acceptLicense true} } -description "IM install without username"}

    • Jython:
      AdminTask.submitJob ('-jobType installIM -targetList [hostname] -jobParams [[installPath <path>] [dataPath <path>] [kitPath <path>] [acceptLicense true]] -description "IM install without username"')

  • Submit the install Installation Manager job using a private key; for example:

    • Jacl:
      $AdminTask submitJob {-jobType installIM -targetList {hostname} -jobParams { {installPath <path>} {dataPath <path>} {kitPath <path>} {acceptLicense true} } -privateKeyFile "<key file path>" -description "IM install with private key"}

    • Jython:

      AdminTask.submitJob ('-jobType installIM -targetList [hostname] -jobParams [
      [installPath <path>] [dataPath <path>] [kitPath <path>] [acceptLicense true] ]
      -privateKeyFile '<key file path>' -description "IM install with private key"')

  • Submit the install Installation Manager job using a user name and password; for example:

    • Jacl:
      $AdminTask submitJob {-jobType installIM -targetList {hostname} -jobParams { {installPath <path>} {dataPath <path>} {kitPath <path>} {acceptLicense true} } -username root -password abcd -description "IM install with username and pwd"}

    • Jython:
      AdminTask.submitJob ('-jobType installIM -targetList [hostname] -jobParams [[installPath <path>] [dataPath <path>] [kitPath <path>] [acceptLicense true] ] -username root -password abcd -description "IM install with username and pwd"')

• We can review the Installation Manager license.

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

    • run install

    • install.exe

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

    • run installc -c

    • installc.exe -c

• We can submit a job to update Installation Manager on a host by providing an Installation Manager repository URL from the command line. This job has the following required parameter:

  • acceptLicense: Must be set to true, if we do not specify this parameter, the job will fail.

  For example:

  • Jacl:
    $AdminTask submitJob {-jobType updateIM -targetList {hostname} -jobParams { {installPath <path>} {repository <repository URL>} {keyringFile <file path>} {keyringPassword <keyringpwd>} {acceptLicense true} } -username root -password <password> -description "update IM with username and pwd"}

  • Jython:
    AdminTask.submitJob('-jobType updateIM -targetList [hostname] -jobParams [ [installPath <path>] [repository <repository URL>] [keyringFile <file path>] [keyringPassword] [acceptLicense true] ] -username <username> -password <password>')

• We can submit a job to update Installation Manager on a host using the console.

  1. In the console, selectJob > Submit.

  2. In the job type menu list, select Update IBM Installation Manager. Click Next.

  3. Specify target names and target authentication.

  4. Specify the job parameters and accept the license agreement:

     • installPath: IBM Installation Manager installation location.

     • repository: IBM Installation Manager repository.

     • keyringFile: IBM Installation Manager key ring file, the credentials for the protected repository are retrieved from the key ring file.

     • keyringPassword: Password for accessing key ring file.

• We can delete Installation Manager installation kits from the repository. Perform this task using the console GUI. Open the console and select Jobs > Installation Manager installation kits. For more information, see Installation Manager installation kits.

• We can submit a job to uninstall IBM Installation Manager. For example:

  • Jacl:
    $AdminTask submitJob {-jobType uninstallIM -targetList {hostname} -jobParams { {installPath <IM install path>}}}

  • Jython:
    AdminTask.submitJob('-jobType uninstallIM -targetList [hostname] -jobParams [ [installPath <IM install path>] ]]')

• We can submit a job to uninstall Installation Manager using the console.

  1. In the console, select Jobs > Submit.

  2. In the job type menu list, select Uninstall IBM Installation Manager. Click Next.

  3. Specify target names and target authentication.

  4. Specify the job parameters.

     • The following parameter is required: installPath, IBM Installation Manager installation location.

• We can submit a job to find Installation Manager data locations. We can add specific data locations, or search the system for Installation Manager data locations.

  1. In the console, select Jobs > Submit.

  2. In the job type menu list, select Add or search for Installation Manager data locations. Click Next.

  3. Specify target names and target authentication.

  4. Specify the job parameters.

     • We can specify Installation Manager data locations.

     • We can search the system for Installation Manager data locations.

Results

You have installed, updated, or deleted Installation Manager and Installation Manager installation kits on a target machine.

What to do next

We can continue to view node resources and do other job management tasks such as submit jobs, create node groups for job submission, and view nodes.

Related tasks

Install WebSphere Application Server v8.5 using the job manager and command line

Manage Installation Manager using the job manager

Start and stop the job manager

Administrative job types