You are viewing the documentation for Blueriq 16. Documentation for other versions is available in our documentation directory.

This installation's purpose is to provide an quick way to start a Case-Modelling stack, for development purposes.

Deploy the DCM stack

Extract the ZIP file mentioned above to a location on your hard disk. The path where the ZIP file is extracted should not contain any whitespace.

The only thing you need to do before running is placing a license file in the conf\runtime and conf\case-engine folders. When using the new Blueriq DCM Dashboard service, the license file needs to be placed in the conf\runtime-dashboards and conf\case-engine-dashboards folders.

Also note that you need a license where the 'case engine' feature is enabled. The DCM Foundation also relies on the 'external flow' license. Please contact support when licenses are needed.

Start the DCM stack

A bat file starts all different components in the Case-Modelling setup. Each component is started in a CMD window which is minimized.

For the default Case-Modelling setup, use the start-DCM-stack.bat file. When using the new Blueriq DCM Dashboard, use the start-DCM-dashboards-stack.bat file.

After every component is started, the landing page is launched in your browser. Please allow some time for all components to have properly started before accessing the runtime.

Accessing the DCM stack

For the default Case-Modelling setup you can visit the Runtime on http://localhost:30008/runtime.

For the new DCM Dashboard setup can visit the default preconfigured dashboard on http://localhost:30000/dashboard/default.

Stop the DCM stack

A at file stops all running components.

For the default Case-Modelling setup, use the stop-DCM-stack.bat file. When using the new Blueriq DCM Dashboard service, use the stop-DCM-dashboards-stack.bat file.

Note that the CMD windows are not closed when it is done. You should do this yourself.

Studio connection

The DCM stack contains a Studio connection based on the assumption that Studio is installed with the default port. If Studio runs on another port, change it in conf\runtime\application-development-tools.properties and conf\case-engine\application-development-tools.properties. When change it in conf\runtime\application-development-tools.properties and conf\case-engine\application-development-tools.properties, change it in conf\runtime-dashboards\application-development-tools.properties and conf\case-engine-dashboards\application-development-tools.properties

The stack is set up to work with the DCM Foundation models. Either using the model exports in the DCM Development installation, or using the Studio environment. The latest foundation models can be found at DCM Foundation - Case-Modelling (v4). When the project is imported, the shortcuts might have to be updated at the runtime.

System requirements

The DCM stack will only run on the Windows operation system.

The DCM stack consists of 5 Tomcat instances, including instances for MongoDB (document database), Qpid (queue) and the document renderer. Components that need relational storage (SQL) use an embedded H2 database. When using the new Blueriq DCM Dashboard service, the stack additionally contains an extra tomcat instance for the Dashboard service, Nginx, Keycloak and a gateway service that runs as a standalone jar.

The stack requires at least 3 GB of free disk space and 4 GB of (free) memory, or 6GB of (free) memory when using the new Blueriq DCM Dashboard service. Also, all the components start at once, so starting puts a heavy load on the processor. Other than that, any modern computer running Windows 10 or later should be able to run this.

Note that QPid and H2 are provided as low impact replacements for RabbitMQ and MSSQL/OracleDB. They are suitable for demo/development scenarios.

In production scenarios, we expect RabbitMQ and MSSQL/Oracle to be used.

Users and passwords

  • DCM Foundation: Aanvrager/Aanvrager, Behandelaar/Behandelaar and Beheerder/Beheerder
  • H2 Console: h2/h2
  • Qpid management, Customerdata and DCM lists: blueriq/welcome
  • DCM Maintenance App: audit/a, guest/g, maintainer/m or owner/o
  • MongoDB: no authentication set up by default
    • You can use any MongoDB client to connect to inspect MongoDB content. MongoDB itself offers Compass as a visual client.
    • Connection String: mongodb://localhost:30012/ 
  • Keycloak (when using the new Blueriq DCM Dashboard service): admin/admin