Restoring Your Original System if an Upgrade Fails

Problem Description

In some circumstances, it is possible that an upgrade can fail and leave the iProcess Engine system in an unusable condition. If this happens:

1. You must restore your original system to its previous condition before you can either use it or attempt to upgrade it again.
2. If you suspect that:
— the error was caused by an external factor (for example, a system hardware failure while the upgrade was in progress), you can, if you want, attempt to upgrade the system again.
— the error was connected with the upgrade process itself (for example, the installer crashes for unknown reasons), TIBCO recommends that you do not attempt to upgrade again. Instead, you should contact TIBCO Support for further assistance.

Affected Database

Oracle, DB2

What to Do

To restore your original system:

  1. Restore the backup of the iProcess Engine database schema that you made earlier (see Backing up TIBCO iProcess Engine Database Schema). See your database documentation for more information about how to do this.

  2. Make sure that $SWDIR points to the correct iProcess Engine installation, then delete the $SWDIR directory and its contents. (If you are not logged in as root, you should ask the root user to perform this task.)

  3. Restore the backup of the $SWDIR directory structure that you made earlier (see Backing Up the TIBCO iProcess Engine File System). See your operating system documentation for more information about how to do this.

  4. Use the following command to grant appropriate permissions on all files in and under $SWDIR:

$SWDIR/bin/fixperms -r -y $SWDIR

Your original system should now be restored to the same state it was in before you attempted to upgrade it.