Patching INUBIT BPC modules

Usage

The INUBIT patch installer includes the option to patch INUBIT BPC.

Prerequisites

You have installed a former INUBIT BPC version as of INUBIT 7.4.0.36.
You have downloaded the INUBIT patch installer, refer to Downloading the Executable Patch.
- Windows
  
  .\patchWinX64-7.4.0.79.exe
- Linux
  
  ./patchLinuxX64-7.4.0.79.bin
You have stopped both Elasticsearch and Karaf, refer to Starting and Stopping the Business Process Center in the INUBIT installation guide.

Proceed as follows

Start the patch installer.

→ A GUI opens with the patch installer start screen.

If the patch installer is not able to start the GUI due to a missing graphical environment, e.g., on a Linux server, it automatically starts in console mode.
Choose the installer language.
In the Choose Install Set dialog, choose Business Process Center.

Choose the directory where the BPC to be patched is installed.

The patch installer checks whether the directories elasticsearch and karaf or elasticsearch-7.5.2 and karaf-3.0.2 exist below the <bpc-installdir> directory. If they exist, the patch installation continues as usual. Otherwise, an error message is displayed to ask to enter a valid path.

Check the Patch Installation Guide for additional hints.
Check the Pre-Installation Summary.

Click Install to start the patch installation, actually.

→ The latest BPC modules (war files, jar files, and the BPC workflow patch BusinessProcessCenter-workflow-patch-<bpc-version>.diagrams.zip) will be added to the <bpc-installdir>/bpc_modules directory.

Before installing the new BPC modules, the files in the <bpc-installdir>/bpc_modules/ directory are backed up to the <bpc-installdir>/bpc_modules/lastversion_backup/ directory.

Already deployed modules inside <bpc_installdir>/karaf/deploy/ are backed up to the <bpc-installdir>/bpc_modules/deploy_backup/ directory.

The lastversion_backup directory can be used if you want to roll back to a previous version of BPC before patching 7.4.0.39.

Rollback of BPC to previous BPC version is possible as of INUBIT 7.4.0.36. You can roll back manually by deploying BPC modules from the backup folders (lastversion_backup and deploy_backup) below the <bpc_installdir>/bpc_modules/ directory.

The current BPC patch workflows are stored as BusinessProcessCenter-workflow-patch-<bpcversion>.diagrams.zip file in the <bpc-installdir>/bpc_modules/ directory.

If the directories lastversion_backup and deploy_backup exist, they will be deleted.

Once the patch installer has finished successfully, start Elasticsearch and Karaf, refer to the Starting and Stopping the Business Process Center section in the INUBIT Installation Guide.
Copy the updated modules (frontend and backend) from the bpc_modules directory to the <bpc_installdir>/bpc/<Karaf-dir>/deploy directory.
Wait until all the modules are deployed successfully and are in the Active status.
Check the following log file for error messages in the <bpc-installdir> directory: inubit_Patch_Install_<date_time>.log

Continue with Updating the BPC Workflows