# Configuring the Settings Tab

The Settings tab configures the Atlas Copco Data Communication Service, the Atlas Copco Data Communication WebAPI Services, the Protocol Server Store database, the on-premises database, and the Atlas Copco cloud.

## ACDC

Enables settings for the Atlas Copco Data Communication Service.

Configuring ACDC

1. Verify the General settings.

   The general settings that need to be configured for the service.

2. Verify the Protocol Servers settings.

   The various controllers or tools connected to the service.

3. Verify the Protocol Server Store settings.

   The external service that keeps track of the data consumed and stored within the controller. This is important in the event of a connection failure between the controllers and the Data Communication service.

4. Verify the Internal RabbitMQ settings.

   The settings for the internal communication with the Atlas Copco Data Communication service.

5. If needed, verify the ToolsTalk 2 RabbitMQ settings.

   The connection settings between ToolsTalk 2 and the controllers using RabbitMQ.

6. Review the settings and click Save.

General
Settings | Description
--- | ---
General Settings | Server IP The IP address that the controllers are connected to. Graph Compression Enables/disables graph value compression in the database. Start Protocol Servers The protocol servers handling the communication between ACDC and the controllers. Select the checkbox to enable the protocol listeners. Start Consumers Enables/disables dispatching messages from the message queue and send them to DB and/or Atlas Copco cloud.
Log Settings | Level Indicates the level of detail in the information to be stored in the log. Location The target location for the log files.

Protocol Servers
Settings | Description
--- | ---
Protocol Server Ports | The ports used by the specific protocol listeners. The available options are: Px2 Px2 with TLS Power Focus 4000 PIM Power Focus 4000 PowerMACS PIM PowerMACS TNOP PIM TNOP TNDCP Enabling TLS for any protocol requires a certificate to be provided in Security Settings. To use TLS 1.3, Atlas Copco Data Communication WebAPI Services must run on Windows Server 2022 or later.
Enable Protocol Servers | Enable/disable listeners for specific protocols. The available options are: Px2 Px2 with TLS Power Focus 4000 PowerMACS TNOP TNDCP Open Protocol SYS6000 Enabling TLS for any protocol requires a certificate to be provided in Security Settings. To use TLS 1.3, Atlas Copco Data Communication WebAPI Services must run on Windows Server 2022 or later.

Protocol Server Store
Settings | Description
--- | ---
General Settings | Port The port used by the Protocol Server Store. Hostname The host where the Protocol Server Store is installed.
Log Settings | Level Indicates the level of detail in the information to be stored in the log. Location The target location for the log files.
Database settings | Database Provider The database provider for storing controller data. The available options are: SQL Server Recommended for installation as an on-premise database. SQLite Recommended for any other type of installation. Location The path to where the SQLite database should be stored. This setting is only applicable if you select SQLite as the database provider.

Internal RabbitMQ
Settings | Description
--- | ---
General RabbitMQ Settings | Hostname The host where RabbitMQ is installed. Port The port number of the machine connecting RabbitMQ. Username The username used by Atlas Copco Data Communication when connecting to the RabbitMQ broker. Password The password used by Atlas Copco Data Communication when connecting to the RabbitMQ broker.
Internal Queue | Virtual Host The name of the RabbitMQ virtual host used by Atlas Copco Data Communication for internal communication. Management API Port The port used to access the RabbitMQ management plugin UI. Management API Scheme The API scheme used for accessing the RabbitMQ management plugin UI.
Internal Services | Virtual Host The name of the RabbitMQ virtual host used by Atlas Copco Data Communication for communicating with the Protocol Server Store service. Verification Status Verify the connection after adding the configuration settings.

External RabbitMQ
Settings | Description
--- | ---
ToolsTalk 2 RabbitMQ | Enable publishing of messages to ToolsTalk 2 (from release v2.17) via RabbitMQ. RabbitMQ must be installed before you can continue with the settings. For more information how to install RabbitMQ, see RabbitMQ Overview. Exchange Name The name of the RabbitMQ exchange that Atlas Copco Data Communication communicates with. Hostname The hostname of the RabbitMQ broker. The host where RabbitMQ broker is installed. By default, this field is empty which means RabbitMQ publishing is turned off. Specify a value to turn on RabbitMQ publishing. Port The port that Atlas Copco Data Communication uses when connecting to the RabbitMQ broker. Virtual Host The virtual host name that Atlas Copco Data Communication uses when connecting to the RabbitMQ. It is required to be / if it is not possible to change within ToolsTalk 2 configuration. Default value: ACDC-TT2 Username The username Atlas Copco Data Communication is using when connecting to the RabbitMQ broker. Password The password Atlas Copco Data Communication is using when connecting to the RabbitMQ broker. If Atlas Copco Data Communication has already been installed, restart the AtlasCopco_DataCommunication service to activate the settings.
ToolsNet RabbitMQ | Enable publishing of messages to ToolsNet via RabbitMQ. Exchange Name The name of the RabbitMQ exchange that Atlas Copco Data Communication communicates with. Hostname The hostname of the RabbitMQ broker. The host where RabbitMQ broker is installed. By default, this field is empty which means RabbitMQ publishing is turned off. Specify a value to turn on RabbitMQ publishing. Port The port that Atlas Copco Data Communication uses when connecting to the RabbitMQ broker. Default value: 5672. Virtual Host The virtual host name that Atlas Copco Data Communication uses when connecting to the RabbitMQ. It is required to be / if it is not possible to change within ToolsNet configuration. Default value: ACDC-ToolsNet. Username The username that Atlas Copco Data Communication uses when connecting to the RabbitMQ broker. Password The password that Atlas Copco Data Communication uses when connecting to the RabbitMQ broker.

## Web API

Enables settings for the Atlas Copco Data Communication WebAPI Services to collect data over a web API with an option to host using HTTPS.

Configuring Web API

1. Verify the folder path for the Settings File.

2. Verify the Port Settings.

   Enter the Web API Port number used for hosting the Web API without enabling HTTPS. The default port is 7110.

3. Verify the Log Settings, if required.

   Log Settings
   Settings | Description
   --- | ---
   Level | Indicates the level of detail in the information to be stored in the log.
   Location | The target location for the log files.

4. To configure Web API for HTTPS, in Https Settings, ensure that the Enable Https checkbox is selected.

   Enabling HTTPS requires a certificate to be provided in Security Settings. The certificate needs to be setup prior to installing the Atlas Copco Data Communication service. It will not be generated automatically by the service.

5. When using HTTPS, enter the External Web Api Https Port and Internal Web Api Https Port used for hosting Web API. The default port values are 7443 for external and 7111 for internal HTTPS ports respectively.

6. Review the settings and click Save.

## On Premise

Enables the settings for the on-premise database. The Service will store the data in a local database.

Configuring On Premise

1. Select Enable settings for on-prem database.

2. Select the Database Provider:

   - SQL Server

3. Enter the Data Source, the IP address for an SQL Server.

   If the SQL Server is hosted on the computer running the installation, the IP address is `127.0.0.1.`

4. By default, Initial Catalog shows the name of the database. This value cannot be modified.

5. Review the settings and click Save.

## Alture

Configuring Alture

1. Select the checkbox Enable settings for Atlas Copco cloud.

2. Review the settings and click Save.

Settings | Description
--- | ---
IOT Hub Connection String | The IoT Hub Connection String, provided by Atlas Copco.
IOT Hub Communication Protocol | The protocol used when communicating with the IoT Hub.
Heartbeat interval | The interval in which Atlas Copco Data Communication should send a message to IoT Hub to verify that the service is functional (in seconds).
Proxy Server | The URL for the proxy to use, if a proxy should be used.
Proxy Username | The username to use for the proxy connection.
Proxy Password | The password to use for the proxy connection.
Proxy Domain | The domain for the proxy connection.
Maximum Batch Size | Maximum allowed batch size to be used when sending multiple messages together to Azure IOT hub.
Cache To Disk Interval | Cache offload to disk interval (in seconds) for storing Unit information together with Result, Jobresult, Event and Program sequence numbers.

Verify that the ACDC application server supports the minimum TLS version required by the Alture installation. The recommendation is to use TLS 1.2 or higher.

## Unify

Configuring Unify

1. Select the Enable Unify checkbox and choose between HTTP or HTTPS as the protocol.

2. Enter a valid port number in Unify Backend Port.

3. Select the appropriate License File.

4. In CDM Database Settings, enter the IP address for an SQL Server in Data Source.

   Required if On-premise and Unify are enabled.

5. By default, Initial Catalog, shows the name of the database. This value cannot be modified.

6. In Log Settings, set the level of detail in the information to be stored in the log using the Level drop-down menu and the target location of the log files using Location.

In Publishing Settings, the settings for MQTT and RabbitMQ can be configured. The settings define messages to be published to MQTT or RabbitMQ or both. The prerequisite for this is to set Topics in MQTT and Routing keys in RabbitMQ before configuring and starting the Atlas Copco Data Communication service.

Publishing Settings
Settings | Description
--- | ---
MQTT Settings | MQTT broker must be installed before you can continue with the settings. MQTT Topics are used in the MQTT ecosystem for the broker to determine which clients receive specific messages. Enable Publish To MQTT Select this checkbox to publish data to an MQTT broker. By default, this checkbox is disabled. When enabled, more settings are available: Broker URL The host where the MQTT broker is installed. A URL must be entered to be able to publish messages to MQTT broker. Username Enter the username for MQTT broker authentication. Leave this field blank, if you use the MQTT broker without authentication configured. Password The password for the broker. Leave this field blank, if you use the MQTT broker without authentication configured.
RabbitMQ Settings | RabbitMQ must be installed before you can continue with the settings. For more information how to install RabbitMQ, see RabbitMQ Overview. In RabbitMQ, exchanges are used as routing mediators that decide what messages are sent to a queue, multiple queues or discarded. Queues deliver messages to consumers using a FIFO model. Bindings are used by exchanges to route messages to specific queues. Routing keys in RabbitMQ are attached to exchanges to filter specific messages and route them to the bounded queues. Enable RabbitMQ Publishing: Toggles the RabbitMQ publishing settings to be visible. When enabled, the following setting are available: Exchange Name: The name of the RabbitMQ exchange to use. Hostname: The host where RabbitMQ is installed. (This value must be set if the Enable RabbitMQ Publishing checkbox is checked) Username: The username Atlas Copco Data Communication is using when connecting to the RabbitMQ broker. Password: The password Atlas Copco Data Communication is using when connecting to the RabbitMQ broker. Virtual Host: The name of the RabbitMQ virtual host. Port: The port Atlas Copco Data Communication is using when connecting to the RabbitMQ broker. Publish Ack Timeout: Time allowed for message acknowledgment (in seconds).
CDM Settings | The CDM version(s) of the messages that should be published. Applies to both MQTT and RabbitMQ publishing. The latest CDM version is selected by default. It is possible to select more than one version. Latest version for all models: A checkbox that will select the latest version for each entity, excluding the depricated models. Clearing the checkbox will deselect the latest version of the models. It is recommended to keep the other versions selected if they are already selected. The available models are: Results Tools Joining Processes Tightening System Assets Trace All models have a multi-select drop-down list. Select the versions that should be published. When selecting multiple versions, each version will be published on the topics. Deprecated models: ACDC can publish models from earlier CDM versions that are in a draft state or not recommended to use. The available options are: Deprecated Results Deprecated Programs Deprecated Events Deprecated Traces

## Remote Logging

Elastic Stack
Settings | Description
--- | ---
Elastic Stack | Enable loggging to Elasticsearch: Enables logging to Elasticsearch. Url: Url to Elasticsearch. Username: Username for Elasticsearch. Password: Password for Elasticsearch. Index: Elasticsearch index. The logs are sent to this index.

## Security Settings

1. In Choose Certificate, select a certificate that will be used for TLS and/or HTTPS.

2. Use the Verify certificate button to verify that the selected certificate is valid.

3. After reviewing the settings, click Save and then click Close.