Open topic with navigation

TIBCO iProcess® Engine 11.10.0

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

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:

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

Did you find this helpful?

Yes No
Great!
Thanks for taking the time to give us some feedback.
Sorry about that

Why wasn't this helpful? (check all that apply)

Could not find what I was looking for
Instructions confusing or unclear
Instructions did not work

Want to tell us more?

Please select at least one option or provide details about the issue!!

Error occurred while submitting feedback.

Error2 occurred while submitting feedback.

TIBCO iProcess® Engine

Copyright © 1994-2025. Cloud Software Group, Inc. All Rights Reserved.