Rolling back packages by using `imcl` commands

You can revert to an earlier version of an installed package by using the rollback command. Packages are specified by a package ID. You 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.

Before you begin

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

If you 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, you must use the -keyring option. For more information, see Storing credentials in a key ring file.

About this task

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. You 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.

You cannot roll back Installation Manager to an earlier version.

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

Procedure

Open a command-line utility.
Open the tools directory.

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

Table 1. Examples of the `rollback` command by operating system and mode
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 the OS X operating system	`./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_directory /credential.store -masterPasswordFile /user_home_directory/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_directory/credential.store -masterPasswordFile /user_home_directory/master_password_file.txt` Group mode is not supported on IBM i.