Rounds Pro Deployment

Deploy Rounds Pro for the First Time

The following table outlines the steps that you must complete to deploy and configure this module for the first time. These instructions assume that you have completed the steps for deploying the basic system architecture.

These tasks may be completed by multiple people in your organization. We recommend, however, that the tasks be completed in the order in which they are listed.

StepTaskNotes
1Review the data model to determine which relationship definitions you will need to modify to include your custom Equipment and Functional Location families. Modify any relationship definitions as needed via Configuration Manager.This step is required only if you have asset data in families outside of the baseline Equipment and Functional Location families.
2 Assign Security Users to the following Rounds Pro Security Groups:
  • MI Rounds-Pro Administrator
  • MI Rounds-Pro Mobile User
This step is required.
3Install the Rounds Pro mobile application on the mobile device that you plan to use for data collection.This step is required only if you will use a mobile device for data collection. For information on installation of Rounds Pro on mobile devices, refer to the Rounds Pro Mobile documentation.
4Set the local time zone on the mobile device that you will use for data collection, typically the user time zone.This step is required only if you will use a mobile device for data collection.
5Configure ActiveMQ settings for Rounds ServiceThis step is required.

Configure ActiveMQ settings for Rounds Service

The Rounds Service is responsible for syncing the data between APM Server and the Rounds Pro app, it is also responsible to handle the changes on Steps and Step Templates and works with the core scheduling service. Rounds Service should be running on all APM Application Servers. Ensure the Rounds Service is Running on all the APM Servers. This service is configured to use a single shared ActiveMQ queue service across APM. Available queue configuration options include retries and concurrency limit. Changes to the following settings are optional.

Procedure

  1. On the APM Server, access the folder that contains the Rounds Service files.
    Note: If you have installed APM in the default location, you can locate the folder in C:\Program Files\Meridium\ApplicationServer\Rounds-service.
  2. Access the appsettings.json file in an application that can be used to modify JSON files (for example, Notepad++).
  3. In the file, locate the following text:
    "Queue_Config": {
               "Queues": [
                 {
                   "Name": "ROUNDSPRO_Queue",
                   "IsCancelAllowed": false,
                   "ConcurrencyLimit": 16,
                   "Retries": 100
                  }
                 ]
                }
    Note: ConcurrencyLimit indicates the maximum number of messages that will be consumed concurrently. Retries indicates the number of times it retries to send the messages to ActiveMQ if it fails.
  4. Update the key values as desired.
  5. Save and close the file.

Results

The updated settings will be applied when the Rounds Service is restarted.