Troubleshooting
Problem
This document includes information on how to download the latest version of the IBM Installation Manager (IM) and how to install/upgrade your IBM Installation Manager product on the IBM i.
Environment
IBM i OS
IBM Installation Manager
Resolving The Problem
This document includes information on how to download the latest 19.x version of the IBM Installation Manager (IM) and how to install/upgrade your IBM Installation Manager product on the IBM i.
The IBM Installation Manager is a tool used to install and maintain software packages. The IBM WebSphere Application Server (WAS) v8.0, v8.5, and v9.0 Traditional products require the use of the IBM Installation Manager for installation and fix updates. Prior to installing the IBM Web Sphere Application Server v8.0, v8.5, or v9.0 Traditional products, you must follow the instructions below to download and install the latest 1.9.x version of the IBM Installation Manager product.
NOTES:
The IBM Installation Manager is a tool used to install and maintain software packages. The IBM WebSphere Application Server (WAS) v8.0, v8.5, and v9.0 Traditional products require the use of the IBM Installation Manager for installation and fix updates. Prior to installing the IBM Web Sphere Application Server v8.0, v8.5, or v9.0 Traditional products, you must follow the instructions below to download and install the latest 1.9.x version of the IBM Installation Manager product.
NOTES:
- IMPORTANT!!! - IBM advises all IBM i clients to stay on version 1.9.x in order to upgrade to future releases of the IBM i OS. IBM i 7.6 OS only supports version 1.9.x. If you upgrade to version 1.10.x, a rollback to version 1.9.x may be required.
- IBM WebSphere Application Server v9.0 requires IBM Installation Manager v1.8.5 or later.
- Do not use Installation Manager version 1.10.x with IBM i 7.6 since JDK 11 is not available.
- Do not use Installation Manager versions 1.8.9.5 or 1.9.0 with the IBM i OS since these versions contain a defect with JDK 8.0.
- These LPPs are required to be installed PRIOR to attempting the WAS v9.0 product installation.
- 57xxJV1 Option 14 is required for Installation Manager v1.8.0-1.8.9.3
- 57xxJV1 Option 16 is required for Installation Manager v1.8.9.4 to v1.9.2.x
- 57xxJV1 Option 19 is required for Installation Manager v1.10.x
- 57xxJV1 Option 17 is required for WAS v9.0
- IBM i 7.6 requires IBM Installation Manager v1.9.3 or a newer v1.9.x version to be installed.
- IBM i 7.5 requires IBM Installation Manager v1.9.2.1 or a newer 1.9.x version to be installed.
- IBM i 7.4 requires IBM Installation Manager v1.8.9.4 - 1.9.x to be installed.
- IBM i 7.3 requires IBM Installation Manager v1.8.4 - 1.9.x to be installed.
- If you already have the IBM Installation Manager installation CD/DVD, refer to the section below entitled, "How to install the IBM Installation Manager from a CD/DVD".
- If you are looking to update the IBM Installation Manager product using the repository provided in the IBM i WAS Group PTF, refer to the section below entitled, "How to update the IBM Installation Manager using the repository provided with the IBM i WAS Group PTF". NOTE: Effective immediately, the IBM WebSphere Application Server v8.5 IBM i Group PTFs for IBM i 7.4 (SF99661), IBM i 7.3 (SF99581), and IBM i 7.2 (SF99481) will no longer be released. Please review the IBM document, IBM WebSphere Application Server V8.5 Group PTFs for IBM i OS Will No Longer Be Released, for more information. For WAS v9.0 and later, you will need to manually download the latest version 1.9.x of the IBM Installation Manager using the instructions below.
How do I locate the IBM Installation Manager version currently installed on my IBM i?
- Display the "IBM_Installation_Manager.x.x.x.swtag" stream file in the /QIBM/ProdData/InstallationManager/properties/version directory.
WRKLNK '/QIBM/ProdData/InstallationManager/properties/version/*' - Enter Option 5 next to the "IBM_Installation_Manager.x.x.x.swtag" stream file to display its contents. The IM version will be display next to the "<ProductVersion>" XML element.
How to download the latest version of the IBM Installation Manager (IM) product
| 1. | Open a Web browser on your PC and go to the following URL: http://www-01.ibm.com/support/docview.wss?uid=swg27025142 |
| 2. | Scroll down to the Download Tables section. Click on the Download document link under the Installation Manager column next to the latest version of the IBM Installation Manager product. IBM DOES NOT RECOMMEND UPDATING TO IM 1.10.x!!! This will take you to the Download document for the IM product.
|
| 3. | Scroll down to the Change history section and locate the list of downloads for each operating system version. |
| 4. | Click on the FC link under the Download Options column for the "OS400/IBM i" download item. |
| 5. | Locate the refresh pack with the description, "IBM Installation Manager Install Kit for all OS/400 versions..." for the Installation Manager version you wish to install and then check mark the box for this item.
|
| 6. | Click Continue to start the download process. |
| 7. | Sign in with your IBM ID and click the "Accept" button if you agree to the license terms & conditions. If you do not have one, you will need to register for one at this time. |
| 8. | Ensure the box next to the refresh pack is selected and then click on the Download now button. If you have download issues and wish to change your download option, you can click on the Change download options link on the right-hand side of the page in the Download options box. Here, you can select one of the available download options and click on the Continue button to proceed. |
| 9. | Click the Download now button or the ZIP file link (HTTPS download) to begin the download process. |
| 10. | If you selected Download using Download Director. the Download Director Java applet will initialize and start the download. Note: Click Run, Yes, Allow, etc. if prompted to trust this source. The target file path will be specified in the download window. You can also click Details to obtain more information on your download. |
How to prepare the IM repository for installation
| 1. | Locate the agent.installer.os400.motif.ppc_x.x.xxx.xxxx_xxx.zip OR com.ibm.cic.agent.offering_x.x.xxxx.xxxxxxxx_xxxx.zip file on your PC. |
| 2. | Rename the agent.installer.os400.motif.ppc_x.x.xxx.xxxx_xxx.zip OR com.ibm.cic.agent.offering_x.x.xxxx.xxxxxxxx_xxxx.zip file to IM.zip. |
| 3. | Create a directory called /IMRepository on your IBM i IFS using the following command: MKDIR DIR('/IMRepository') |
| 4. | Copy the IM.zip file from your PC to the /IMRepository directory on the IBM i IFS using System i Navigator, a mapped network drive, or FTP. |
| 5. | Once the ZIP file has been copied, start a Qshell terminal session using the following command: STRQSH |
| 6. | Change to the /IMRepository directory: cd /IMRepository |
| 7. | Extract the contents of the ZIP file to the directory: jar xvf IM.zip |
| 8. | Once the jar command completes and returns to a dollar sign ($), the IM repository is now ready for installation. Your IM repository path is now /IMRepository. |
How to install the IBM Installation Manager from a CD/DVD
To install the IBM Installation Manager product from the disc that came with IBM Web Enablement (5722-WE2) package, please follow the steps outlined below based on your preferred installation method.
Physical CD/DVD media
| 1 | Execute the CHGOPTA EXTMEDFMT(*YES) CL command PRIOR TO loading the CD/DVD disc or image. |
| 2 | Insert the IBM Installation Manager media disc into the optical drive of the IBM i server. |
| 3 |
Execute the WRKLNK '/QOPT/*' command to determine the IM repository path. The IM repository path will be something similar to the following:
/QOPT/IM_<version>_IBMI/IM_<version>_OS400.motif.ppc/ |
| 4 |
Use this IM repository path in place of the /IMRepository directory path in Step 4 in the section How to install the IBM Installation Manager from the IM repository.
|
| 5 | Follow the steps under the section How to install the IBM Installation Manager from the IM repository to install/update your IBM Installation Manager product. |
NOTE: The installation repository path might change over time. Locate the directory path containing the installc file and use this path as the installation repository path if the example above does not fit your installation media.
How to update the IBM Installation Manager using the repository provided with the IBM i WAS Group PTF
NOTE: Effective immediately, the IBM WebSphere Application Server v8.5 IBM i Group PTFs for IBM i 7.4 (SF99661), IBM i 7.3 (SF99581), and IBM i 7.2 (SF99481) will no longer be released. Please review the IBM document, IBM WebSphere Application Server V8.5 Group PTFs for IBM i OS Will No Longer Be Released, for more information. For WAS v9.0 and later, you will need to manually download the latest version 1.9.x of the IBM Installation Manager using the instructions below.
When updating the IBM Installation Manager using the repository provided in the IBM i WAS Group PTF, please follow the steps listed below.
| 1 | Execute the WRKLNK ' /QIBM/WAS/IMFIXPACKS/IM/*' command to determine the IM repository path. The IM repository path will be something similar to the following: /QIBM/WAS/IMFIXPACKS/IM/<version>/FIXPACK. |
| 2 | Use this IM repository path in place of the /IMRepository directory path in Step 4 in the section How to install the IBM Installation Manager from the IM repository. |
| 3 | Follow the steps under the section How to install the IBM Installation Manager from the IM repository to install/update your IBM Installation Manager product. |
How to install the IBM Installation Manager from the IM repository
| 1. | Sign into a 5250 green screen emulation session with a user ID that has *ALLOBJ and *SECADM special authorities explicitly specified on the profile. |
| 2. | Start a Qshell terminal session using the following command: STRQSH |
| 3. | Set your umask using the following command: umask 022 |
| 4. | If you are installing from the IM repository directory, use the following command: cd /IMRepository If you are installing from a CD or DVD, use the following command: cd /QOPT/IM_<version>_IBMI/IM_<version>_OS400.motif.ppc/ If you are installing from the repository provided with the IBM i WAS Group PTF, use the following command: cd /QIBM/WAS/IMFIXPACKS/IM/<version>/FIXPACK |
| 5. | Begin the IM installation using the following command: ./installc -acceptLicense -log /tmp/IMInstallLog.log |
| 6. | When the installation is complete, you should receive a message similar to the following for your IM version: Updated to com.ibm.cic.agent_1.6.2000.20130301_2248 in the /QIBM/ProdData/InstallationManager/eclipse directory. |
| 7. | You can also verify the installation was successful by running the following command in Qshell: /QIBM/ProdData/InstallationManager/eclipse/tools/imcl listInstalledPackages -long You should see something similar to the following for your IM version if the installation was successful: /QIBM/ProdData/InstallationManager/eclipse : com.ibm.cic.agent_1.9.3000.20240905_1526 : IBM® Installation Manager : 1.9.3 |
| 8. | If you see the messaging above with no errors, you have completed the installation of the IBM Installation Manager and are now ready to install the IBM WebSphere Application Server product. |
[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CMVAA2","label":"WebSphere Application Server-\u003EInstallation Manager or IM"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]
Historical Number
666361944
Was this topic helpful?
Document Information
Modified date:
05 May 2025
UID
nas8N1010434