Recovering iProcess Engine 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.

What to Do

If you are using iProcess Engine with the Oracle database, follow these steps to restore your original system:

  1. Log in as the background user, for example, the IPEADMIN user.

  2. Delete the SWDIR directory structure.

  3. Restore your backup of the SWDIR directory structure. See your operating system documentation for more information about how to do this.

  4. Run the SWDIR\bin\fixperms program, to grant appropriate permissions on all files in and under SWDIR. Use the command:

SWDIR\bin\fixperms -r -y SWDIR

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

If you are using iProcess Engine with the SQL Server database, follow these steps to restore your original system:

  1. Re-install the version of the iProcess Engine or Process Engine that you were attempting to upgrade from. Make sure that you install it in the same folder.

    2. Warning 

    Do not start iProcess Engine or Process Engine at the end of installation.

  2. Restore the backup of your iProcess system directory (SWDIR) which you made before attempting the upgrade.

  3. From the SQL Server, restore the backup of the iProcess database which you made before attempting the upgrade. See the SQL Server documentation for more information about how to do this.

  4. Restore default file permissions to all iProcess server files. (This may be necessary if any file permissions were changed during the backup or restore operation.) To do this:

    5. a. Log in as the IPEADMIN user.
    b. Take ownership of all files in and the SWDIR folder.
    c. Give Full Control to Everyone for all files in and the SWDIR folder.
    d. Run the SWDIR\bin\fixperms utility.

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