Updating to Signavio Workflow Accelerator 3.22

Signavio Workflow has been renamed to Signavio Workflow Accelerator. If you use Workflow Accelerator in combination with Signavio Process Manager, you must update Process Manager to version 10.15.

To update Workflow Accelerator from a version prior to 3.11, you MUST first update the system to version 3.15 before you can update to version 3.22. Download Signavio Workflow 3.15 and follow the respective previous update instructions, before you continue with this section.

As well as upgrading the application, you should upgrade MongoDB. See the following section for more information.

Updating MongoDB

Workflow Accelerator 3.22 now supports the latest version of MongoDB (3.4.x) which comes with improved performance and functionality. You should upgrade to MongoDB version 3.4, as Workflow Accelerator releases will require it.

You can only update to MongoDB 3.4 if you are currently using version 3.2. The official MongoDB documentation contains for more information about the update: https://docs.mongodb.com/manual/release-notes/3.4-upgrade-standalone/

To update your standalone MongoDB 3.2 to version 3.4 follow these steps:

  1. Stop the Tomcat application server - see section Stopping Signavio Workflow Accelerator .
  2. Create a backup of your database using mongodump - see section Backup .
  3. Stop MongoDB - see Stopping Signavio Workflow Accelerator .
  4. Windows only: manually remove the created MongoDB service by executing
    $MONGO_HOME\bin\mongod.exe --remove
    with administrator privileges on the command line cmd
  5. Uninstall MongoDB 3.2.x, but ensure you don't delete the data directory and configuration file of your database as well as the backup!
  6. Install MongoDB 3.4.x.
  7. Windows only: Open the command line cmd with administrative privileges and execute the following command. Make sure to use absolute paths and replace them with the matching paths on your system.
    • C:\MongoDB\bin\mongod.exe --config C:\MongoDB\mongod.cfg --install
    • The referenced configuration file is the one you have created previously for the old version of MongoDB and should still be in the same location.
  8. Start the new MongoDB instance.
  9. Enable new functionality for version 3.4 by executing the following command on the command line.

Windows

  1. Open a command line with administrative privileges
  2. Navigate to the MongoDB bin directory
    • For example C:\MongoDB\bin
  3. Execute the following command:
    • Replace <username> with your MongoDB user, e.g. signavio
    • Replace <password> with your MongoDB user password
mongo.exe admin -u <username> -p <password> --eval "db.adminCommand( { setFeatureCompatibilityVersion: '3.4' } )"

Debian

  1. Open a command line
  2. Execute the following command:
    • Replace <username> with your MongoDB user, e.g. signavio
    • Replace <password> with your MongoDB user password
mongo admin -u <username> -p <password> --eval "db.adminCommand( { setFeatureCompatibilityVersion: '3.4' } )"

You finished the MongoDB update successfully.