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
Resolving The 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.
The IBM Installation Manager is a tool used to install and maintain software packages. The IBM WebSphere Application Server (WAS) v8.0 and later product now requires the use of the IBM Installation Manager for installation. Prior to installing the IBM Web Sphere Application Server v8.0 or later product, you must follow the instructions below to download and install the latest version of the IBM Installation Manager product.
NOTES:
How do I locate the IBM Installation Manager version currently installed on my IBM i?
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.
The IBM Installation Manager is a tool used to install and maintain software packages. The IBM WebSphere Application Server (WAS) v8.0 and later product now requires the use of the IBM Installation Manager for installation. Prior to installing the IBM Web Sphere Application Server v8.0 or later product, you must follow the instructions below to download and install the latest version of the IBM Installation Manager product.
NOTES:
- IBM WebSphere Application Server v9.0 requires IBM Installation Manager v1.8.5 or later.
- 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 and later
- 57xxJV1 Option 17 is required for WAS v9.0
- IBM i 7.3 OS requires IBM Installation Manager v1.8.4 t a minimum.
- IBM i 7.4 OS requires IBM installation Manager v1.8.9.4 at a minimum.
- 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". The IBM i WAS Group PTF is only available for WAS v8.5.5 and earlier. For WAS v9.0 and later, you will need to manually download the latest version 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. 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
- Execute the CHGOPTA EXTMEDFMT(*YES) CL command PRIOR TO loading the CD/DVD disc or image.
- Insert the IBM Installation Manager media disc into the optical drive of the IBM i server.
- 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/
- 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.
- 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
When updating the IBM Installation Manager using the repository provided in the IBM i WAS Group PTF, please follow the steps listed below.
- 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.
- 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.
- 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. | Change to the IM repository directory: cd /IMRepository When installing from a CD/DVD: cd /QOPT/IM_<version>_IBMI/IM_<version>_OS400.motif.ppc/ When installing from the repository provided with the IBM i WAS Group PTF: 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.6.2000.20130301_2248 : IBM® Installation Manager : 1.6.2 |
| 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":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]
Historical Number
666361944
Was this topic helpful?
Document Information
Modified date:
04 May 2021
UID
nas8N1010434