How to use imcl command to view the list of the packages, updates, and features in a source repository

Body

During installing Products and Fixes with IBM Installation Manager, Installation Manager searches open repositories where Packages and Fixes exist. But how can you verify the applicable packages, updates, and features are in a target repository from the command line?

Installation Manager provides the command line tool, imcl, to manage installation. The imcl command can be found in <IM_ROOT>/eclipse/tools subdirectory.

Where <IM_ROOT> is root directory where IM is installed.

We will introduce how to verify the installed packages and view the list of applicable packages, updates, and features to the installed packages.

How to verify the installed packages

Use command: "imcl listInstalledPackges" to view a list of packages that are already installed by the Installation Manager.

Windows: imcl.exe listInstalledPackages
AIX, HP-UX, Linux, Solaris: imcl listInstalledPackages

Example:

 ./imcl listInstalledPackages
com.ibm.websphere.ND.v80_8.0.3.20120320_0536
com.ibm.websphere.WCT.v80_8.0.5.20121022_1902
com.ibm.websphere.PLG.v80_8.0.6.20130328_1645
com.ibm.websphere.IHS.v80_8.0.5.20121022_1902
com.ibm.websphere.IBMJAVA.v70_7.0.4001.20130510_2103
com.ibm.websphere.ND.v85_8.5.2.20130327_1831
 

If you would like to verify more details like version, features, installed fixes, and rollback versions, run the command with the "-verbose "option.

Example:

./imcl listInstalledPackages -verbose
[Package]
Name: IBM WebSphere Application Server Network Deployment (com.ibm.websphere.ND.v85)
Version: 8.5.0.2 (8.5.2.20130327_1831)
Repository: /usr/IBMWASREPO
Features:
    IBM 64-bit WebSphere SDK for Java (com.ibm.sdk.6_64bit)
    EJBDeploy tool for pre-EJB 3.0 modules (ejbdeploy)
    Embeddable EJB container (embeddablecontainer)
    WebSphere Application Server Liberty Profile (liberty)
    Stand-alone thin clients and resource adapters (thinclient)
Fixes:
    8.5.0.0-WS-WASND-AixPPC3264-IFPM87806 (8.5.0.0-WS-WASND-AixPPC3264-IFPM87806)
Rollback versions:
    8.5.0.0 (8.5.0.20120501_1108)

How to verify the installable packages

Use command: "imcl listAvailablePackages" to list the packages that are installable to the existing products.

Windows: imcl.exe listAvailablePackages -repositories [source_repository]
AIX, HP-UX, Linux, Solaris: imcl listAvailablePackages -repositories [source_repository]

Example:

 ./imcl listAvailablePackages -repositories /usr/IBMWASREPO
com.ibm.websphere.BASE.v85_8.5.5001.20131018_2242
com.ibm.websphere.BASE.v85_8.5.5002.20140408_1947
com.ibm.websphere.IBMJAVA.v70_7.0.4001.20130510_2103
com.ibm.websphere.IBMJAVA.v70_7.0.5000.20131010_1516
com.ibm.websphere.IBMJAVA.v70_7.0.6001.20140324_2202
com.ibm.websphere.IBMJAVA.v71_7.1.0.20140324_2146
com.ibm.websphere.ND.v85_8.5.5001.20131018_2242
com.ibm.websphere.ND.v85_8.5.5002.20140408_1947

How to verify installable iFixes

Use the command: "imcl listAvailableFixes" to view a list of applicable Fixes to the specified product in a source repository.

1. Listing the installed packages by using listInstalledPackages
Windows:imcl.exe listInstalledPackages
AIX, HP-UX, Linux, Solaris:imcl listInstalledPackages

2. View a list of iFixes which is applicable to installed product by using listAvailableFixes [packageID_version]. Specify the packageID to the [packageID_version] which is verified on step 1 above.
Windows: imcl.exe listAvailableFixes [packageID_version] -repositories [source_repository]
AIX, HP-UX, Linux, Solaris: imcl listAvailableFixes [packageID_version] -repositories [source_repository]

Example:

1. Listing the installed packages by using listInstalledPackages

./imcl listInstalledPackages
com.ibm.cic.agent_1.7.3000.20140521_1925
com.ibm.websphere.ND.v80_8.0.7.20130725_2248
com.ibm.websphere.WCT.v80_8.0.5.20121022_1902
com.ibm.websphere.PLG.v80_8.0.6.20130328_1645
com.ibm.websphere.IHS.v80_8.0.5.20121022_1902
com.ibm.websphere.ND.v85_8.5.5002.20140408_1947
com.ibm.websphere.IBMJAVA.v70_7.0.4001.20130510_2103
 

2. Verify if installable iFixes to the specified packages:"com.ibm.websphere.IBMJAVA.v70_7.0.4001.20130510_2103" exist in the target repository:

./imcl listAvailableFixes com.ibm.websphere.IBMJAVA.v70_7.0.4001.20130510_2103 -repositories /mnt/inst.repositories/7.0.1.0-WS-WASJavaSDK7-AixPPC64-IFPI19111.zip
7.0.1.0-WS-WASJavaSDK7-AixPPC64-IFPI19111_7.0.1000.20140603_0500
 

From the result, we can see the iFix: "7.0.1.0-WS-WASJavaSDK7-AixPPC64-IFPI19111_7.0.1000.20140603_0500" is applicable to the installed package: "com.ibm.websphere.IBMJAVA.v70_7.0.4001.20130510_2103"
 

How to verify installable features

Use the command "imcl listAvailablePackages -features" to view a list of installable features in a source repository.

Windows: imcl.exe listAvailablePackages -repositories [source_repository] -features -long
AIX, HP-UX, Linux, Solaris: imcl listAvailablePackages -repositories [source_repository] -features -long

Example:

./imcl listAvailablePackages -repositories /usr/IBMWASREPO -features -long
/usr/IBMWASREPO : com.ibm.websphere.ND.v85_8.5.1.20121017_1724 : IBM WebSphere Application Server Network Deployment : 8.5.0.1 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,liberty,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit
/usr/IBMWASREPO: com.ibm.websphere.ND.v85_8.5.5000.20130514_1044 : IBM WebSphere Application Server Network Deployment : 8.5.5.0 : core.feature,ejbdeploy,thinclient,embeddablecontainer,samples,com.ibm.sdk.6_32bit,com.ibm.sdk.6_64bit

From the result, we can see the feature : core.feature, ejbdeploy, thinclient, embeddablecontainer, samples, liberty, com.ibm.sdk.6_32bit, com.ibm.sdk.6_64bit are installable with WAS V8.5.0.1.

For more information, please see the product documentation topic: Listing repository contents by using the imcl command

title image (modified) credit: (cc) Some rights reserved by Nemo