21.3 Reverting to a Previously Installed Software Configuration State

You can use the rug ro date_time command or create a checkpoint by using rug cpa checkpoint_name command to revert to a previously installed software configuration state.

An Example Use Case: In this use case, you enable the rollback preference, install a package, and then roll back to the previously installed configuration state. The package is automatically uninstalled.

  1. Enable the Rollback preference by executing the rug set rollback true command.

    The Rollback preference is set to False by default.

  2. Subscribe to a catalog by executing the rug sub catalog_name command.

  3. List all packages contained in the catalog by executing the rug pa catalog_name command.

  4. Make a note of the date and time when you enable the Rollback preference by executing the date command.

    or

    Create a checkpoint by using the rug cpa checkpoint_name command.

  5. Install a package by executing the rug in package_name command.

  6. Ensure that the package is installed by executing the rug pa catalog_name command.

    The status of the package should be "i".

  7. Roll back to the previously installed configuration state by executing the rug ro date_time command.

    or

    If you have created a checkpoint in Step 4, then execute the rug ro checkpoint_name command.

    For example: rug ro "02/20/2009 15:55:56 PM"

    The date and time you specify must be from the time you enable the Rollback preference to the current time. If you do not specify the date, the current date is used.

    Specify the date in the mm/dd/yyyy format. For example, 02/28/2007. For more information on the date format, see the rug man page or rug (1).

    The package installed in Step 5 is uninstalled.

  8. To ensure that the package is uninstalled, execute the rug pa catalog_name command and verify that the status of the package is blank.