Let's say you have upgraded one or more packages using the imcl (Installation Manager command line tool) with the input option and an XML file. For example, let's say the imcl listInstalledPackages command shows that you have upgraded your WebSphere network deployment (ND) manager (dmgr) from version 8.5.5.20 to 8.5.5.21.

~]$ /opt/WebSphere/InstallationManager/eclipse/tools/imcl listInstalledPackages -long
/opt/WebSphere/InstallationManager/eclipse : com.ibm.cic.agent_1.9.2001.20211222_1411 : IBM® Installation Manager : 1.9.2.1
/opt/WebSphere/AppServer : com.ibm.websphere.ND.v85_8.5.5021.20220202_1245 : IBM WebSphere Application Server Network Deployment : 8.5.5.21

In this scenario, you will create an XML file that will be used to roll back the upgrade.

touch rollback.xml

Following is an example XML file.

• In the <server> block, "repository location" should be the path to your repository.config file.
• In the <rollback> block, use the ID, version and profile for the prior version of the package that was installed.

<?xml version="1.0" encoding="UTF-8"?>
<agent-input>
<server>
  <repository location='/opt/IBM/FixPacks/9009/repository.config'/>
</server>
<profile id='IBM WebSphere Application Server V9.0' 
  installLocation='/opt/IBM/WebSphere/AppServer'>
  <data key='eclipseLocation' value='/opt/IBM/WebSphere/AppServer'/>
  <data key='user.import.profile' value='false'/>
  <data key='cic.selector.nl' value='en, fr, it, zh, ro, ru, zh_TW, de, ja, pl, es, cs, hu, ko, pt_BR'/>
</profile>

<rollback>
  <offering id='com.ibm.websphere.ND.v85'
      version='8.5.5020.20210708_1826'
      profile='IBM WebSphere Application Server V8.5'/>
</rollback>

<preference name='com.ibm.cic.common.core.preferences.eclipseCache' value='/opt/IBM/IMShared'/>
<preference name='com.ibm.cic.common.core.preferences.connectTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.readTimeout' value='30'/>
<preference name='com.ibm.cic.common.core.preferences.downloadAutoRetryCount' value='0'/>
<preference name='offering.service.repositories.areUsed' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.ssl.nonsecureMode' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.http.disablePreemptiveAuthentication' value='false'/>
<preference name='http.ntlm.auth.kind' value='NTLM'/>
<preference name='http.ntlm.auth.enableIntegrated.win32' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.preserveDownloadedArtifacts' value='true'/>
<preference name='com.ibm.cic.common.core.preferences.keepFetchedFiles' value='false'/>
<preference name='PassportAdvantageIsEnabled' value='false'/>
<preference name='com.ibm.cic.common.core.preferences.searchForUpdates' value='false'/>
</agent-input>

AVOID TROUBLE

If you have a WebSphere deployment manager (dmgr) with nodes federated into the deployment manager, roll back the packages on the deployment manager BEFORE rolling back the packages on the nodes being managed by the dmgr.

You should stop the components being rolled back before rolling back the packages.

• Start the deployment manager
• Start the node
• Start the application servers (JVMs)

Here is how you would roll back the packages using the icml input command and rollback.xml.

/opt/IBM/InstallationManager/eclipse/tools/imcl input rollback.xml 
-log log.xml
-acceptLicense
-showprogress

If the packages are successfully rolled back, something like this should be displayed.

Installed 9.0.0.7-WS-WASProd-IFPH01368_9.0.7.20180810_1256 to the /opt/IBM/WebSphere/AppServer directory.

Likewise, listing the installed packages should show that the packages have been rolled back.

~]# /opt/IBM/InstallationManager/eclipse/tools/imcl listInstalledPackages -long
/opt/WebSphere/AppServer : com.ibm.websphere.ND.v85_8.5.5020.20210708_1826 : IBM WebSphere Application Server Network Deployment : 8.5.5.20

After the packages have been rolled back, you can then start the product that the packages were rolled back on.

• Start the deployment manager
• Start the node
• Start the application servers (JVMs)