Roll back packages using imcl commands

We can revert to an earlier version of an installed package using the rollback command. Packages are specified by a package ID. Optionally, we can add an underscore with the version of the package ID to roll back to. If the version is not specified, then the package is rolled back to the previous version. When you specify multiple packages, all the packages must be installed in the same installation directory.

Identify the package ID and version by running the listInstalledPackages command. For more information, see List installed packages using imcl commands.

If we use repositories that require authentication, create a storage file. The -keyring and -password options that are used to store credentials to a key ring file are deprecated. Use the -secureStorageFile and -masterPasswordFile options to store credentials to a credential file. For more information, see Migrate from key ring files to storage files. For versions 1.6.1 and earlier, use the -keyring option. For more information, see Store credentials in a key ring file.

Use the rollback command to remove an update that you applied to a product package. When you roll back a package, Installation Manager uninstalls the updated resources, and reinstalls the resources from the previous version. We can roll back only one version level at a time.

When you roll back to an earlier version of a package, the package is restored with the same features that are associated with that version. Use the modify command to add and remove features.

For installed fixes, a fix is uninstalled if the fix does not apply to the version of the product that you rolled back to. A fix is not uninstalled if you roll back to a version of the product that the fix applies to.

We cannot roll back Installation Manager to an earlier version.

If we did not save files for rollback and you roll back to a version that requires entitlement, we must be entitled to the previous version for the rollback to finish. Entitlement is based on your IBM ID credentials. For information about entitlement, see IBM Entitlement Help.

Procedure

  1. Open a command-line utility.

  2. Open the tools directory.

  3. Run the rollback command: 
     imcl rollback packageID[_version] 
	 [ -repositories source_repository ] 
	 [ -installationDirectory installation_directory ]
	 [ -connectPassportAdvantage ]
	 [ -properties key_1=value_1a,,value_1b ]
	 [ -preferences preference_key=value ]
	 [ -secureStorageFile storage_file -masterPasswordFile master_password_file | -keyring keyring_file [ -password password ] ]
    Enclose file paths that include spaces with double quotation marks.


Example

Operating system Administrator Nonadministrator Group
Windows imcl.exe rollback com.ibm.package_7.1 -repositories http://repository/package/7.1/repository.config -installationDirectory \installation_dir\Package -secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt imcl.exe rollback com.ibm.package_7.1 -repositories http://repository/package/7.1/repository.config -installationDirectory \installation_dir\Package -secureStorageFile C:\credential.store -masterPasswordFile C:\master_password_file.txt Not available
Linux, UNIX, IBM i, z/OS , and OS X ./imcl rollback com.ibm.package_7.1 -repositories http://repository/package/7.1/repository.config -installationDirectory /installation_dir/Package -secureStorageFile /var/credential.store -masterPasswordFile /var/master_password_file.txt ./imcl rollback com.ibm.package_7.1 -repositories http://repository/package/7.1/repository.config -installationDirectory /installation_dir/Package -secureStorageFile user_home /credential.store -masterPasswordFile /user_home/master_password_file.txt ./imcl rollback com.ibm.package_7.1 -repositories http://repository/package/7.1/repository.config -installationDirectory /installation_dir/Package_Group -secureStorageFile user_home/credential.store -masterPasswordFile /user_home/master_password_file.txt

Group mode is not supported on IBM i.
Home