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

Verify the General settings.

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

The various controllers or tools connected to the service.
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.
Verify the Internal RabbitMQ settings.

The settings for the internal communication with the Atlas Copco Data Communication service.
If needed, verify the ToolsTalk 2 RabbitMQ settings.

The connection settings between ToolsTalk 2 and the controllers using RabbitMQ.
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.

ToolsTalk 2 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. The setting turns on or off the RabbitMQ publishing feature. The default value is blank, which means that RabbitMQ publishing is turned off. An entered value turns on the 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. 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.

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

Verify the folder path for the Settings File.
Verify the Port Settings.

Enter the Web API Port number used for hosting the Web API without enabling HTTPS. The default port is 7110.
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.
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.
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.
Review the settings and click Save.

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.

On Premise

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

Configuring On Premise

Select Enable settings for on-prem database.
Select the Database Provider:
- SQL Server
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.
By default, Initial Catalog shows the name of the database. This value cannot be modified.
Review the settings and click Save.

Alture

Configuring Alture

Select the checkbox Enable settings for Atlas Copco cloud.
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

Select the checkbox Enable Unify.
Enter a valid License Key.

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

In Choose Certificate, select a certificate that will be used for TLS and/or HTTPS.
Use the Verify certificate button to verify that the selected certificate is valid.
After reviewing the settings, click Save and then click Close.