Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Installation

The DCM Lists Service can be installed using the installer. After installation, the configuration can be found in the <blueriq installation home>\Services\dcm-lists-service\conf folder.

Alternatively, you can install the DCM Lists Service on any of the supported platforms of Blueriq. The installation procedure resembles the ones for the Runtime:

  • Deploy the WAR file on the application server
  • Configure the spring.config.additional-location 

See Installing Runtime for details on each specific platform.

Note

Although it is possible to deploy the DCM Lists Service in the same JVM as the Blueriq Runtime, we recommend, at least for acceptance and production environments, to deploy it on its own JVM or depending on the throughput of the application, on its own server.

Table of Contents

System requirements

Minimal

2 CPU cores
256 MB Heap

2 CPU cores
512 MB Heap

Third party tools

RabbitMQ

The DCM Lists Service receives events from the Blueriq Runtime application via the RabbitMQ Messaging system (see Queue configuration and Configuration for the DCM Lists Service). The DCM Lists Service should be able to connect to the RabbitMQ instance.

MongoDB

The DCM Lists Service stores its data in MongoDB. The DCM Lists Service should be able to read and write data into a MongoDB instance.


Ideally, both tools run on their own dedicated server, with sufficient resources. We refer to the websites of MongoDB and RabbitMQ for advice on hardware requirements for these components.

Configuration


Info
titleNote

For Blueriq 12.5 to 12.7.1, the RabbitMQ properties were directly under the spring.data key.


The DCM Lists Service requires a blueriq-dcm-lists-service.yml  file in the spring.config.additional-location you configured for it. Here, you can specify the location of RabbitMQ, MongoDB and configure some additional settings:

Code Block
languageyml
titleblueriq-dcm-lists-service.yml
spring:
  data:
    mongodb:
      host: mongodb.yourdomain.local
      port: 27017
      database: DcmListsService

blueriq:
  dcm:
    lists:
      event:
        consumer:
          rabbitmq:
            host: rabbitmq.yourdomain.local
            port: 5672
            virtualHost: /
            username: youruser
            password: yourpass
            ssl:
              enabled: false
            queueNames: yourQueueName

#######################################################################
## Security configuration                                            ##
##                                                                   ##
## Here you can override the default username/password               ##
####################################################################### 
spring:
  security:
    user:
      name: <username>
      password: '{noop}<password>'