Installing the ToolsTalk Server Application

Before you begin with the ToolsTalk 2 server installation, make sure all the requirements are met as described in section Before Installing or Upgrading.

Before installing the Server Application, make sure that the Atlas Copco Data Communication (ACDC) installed and running is compatible with the current version of the ToolsTalk 2 (only for versions of from 2.13 onwards). Please see the Atlas Copco Data Communication Installation User Guide.

  1. Place the executable file ToolsTalkServer<xxx>.exe in a desired folder on your computer. The <xxx> represents the version of the file.

  2. Double-click on the executable file.

  3. Select Yes to Do you want to allow this app to make changes to your device?

  4. Select Next in the Atlas Copco Tools Talk Server - InstallShield Wizard window to continue.

  5. Read and then select I accept the terms in the license agreement. Select Next to continue.

    Select Print if you would like to print the license agreement.

  6. Select Change... to install the application in a different location. The default location is C:\Program Files (x86)\Atlas Copco\ToolsTalk Server\

    Select Next to continue.

  7. Select Install to finish the installation.

  8. Select Finish to complete the installation and the ToolsTalk 2 Configuration window opens up or the User Access Control dialog from Windows may be prompted.

  9. If Windows prompts the User Access Control dialog requesting permission, Select Yes to Do you want to allow this app to make changes to your device?

    When the installation is completed, the ToolsTalk 2 Configuration window opens up.

    If an error occurs during installation, a step is unclear, or a parameter name or value is unclear, look for more information in the Troubleshooting section.

  10. Enter the parameters in the FMS tab. Select Get Host ID Information to start the FMS and get the Host ID.

    If you want to change the Host ID, select from the Host IDs drop-down list and select Update Active Host ID to update the Active Host ID if needed.

  11. Enter the parameters in the Database Settings tab.

    When the parameters in the SQL Server Address and/or Database name are added/updated, it is saved automatically.

  12. Enter the parameters, User name and Password in the Database Credentials and select Test Connection.

    The User name and Password should be the same as used for the Microsoft SQL Server installation.

    If you select Test Connection, the configurator checks if the provided username and password are correct. If Test Connection fails, an error “Database connection test failed, see log file for details!” appears.

  13. Select Install Database.

    Upon successful installation of the database, the message Database creation succeed is displayed.

  14. Enter the parameters in the Server Settings tab.

  15. Select Save and the Status tab is displayed.

    When performing an installation for the first time, If you select the Status tab before entering all the parameters in the FMS, Database Settings and Server Settings tabs, the status are greyed out and an error "Installation Incomplete. Finish the installation to view the status" is displayed.

FMS

Installing the ToolsTalk Server application is dependent on the FMS service for licensing. FMS services uses system identifiers, called Host ID, for identification and setting licenses. The features available in ToolsTalk 2 are tied to a Host ID used by a particular client and this value is registered on the Atlas Copco license portal. If you want to change the Host ID, the new Host ID must be registered on the Atlas Copco license portal by replacing the old Host ID and this will then move all the features tied to the old Host ID to the new Host ID.

This functionality allows you to read a list of Host IDs used in the past, the currently used active Host ID and the default Host ID and also allows you to change the active Host ID as required to suit network interfacing requirements.

 

Select Get Host ID Information to get the active Host ID being used.

FMS Settings

Parameters

Description

Default Host ID

Default Host ID which is registered. Default Host ID can be any available Host ID on the machine. It is usually the first Host ID in the list of Host IDs'

Host IDs

List of available Host IDs available on a particular machine depending on the different network interfaces.

Active Host ID

Current Host ID which is active and is being used. Default Host ID is overwritten by Active Host ID if it is specified

Last Used Active Host ID

Indicates which was the last Active Host ID used.

To change the active Host ID:

  1. Select the required Host ID from the Host IDs drop-down.

    This is now also reflected in the Active Host ID field.

  2. Select Update Active Host ID.

  3. Select Save.

The active Host ID is now changed and the FMS services can be restarted for the new settings to be applied.

Server Settings Parameters

Server Settings Parameters

Parameters

Description

Authentication Mode

The authentication mode used to verify user authority. Select Windows (Active directory) or None.

Active Directory Group

Only visible if the Authentication Mode selected is Windows. Specifies what active directory group a user must be member of. Example: Must always be in the format DOMAINNAME\GROUPNAME

If the Authentication Mode selected is Windows, then you can test if active directory group is correct and if the user account you would like to use belongs to the active directory group.

Enter the Active Directory Group and select Test AD Group.

Enter the User Account and select Test, to verify the active directory group and the group name.

An error message is displayed if the user has entered a wrong domain name or wrong group name or both. An error is also displayed if the entered domain name and group name are correct but the user account entered does not belong to that active directory group.

An information message is displayed if the test was successful.

Server Address

IP or Hostname of the ToolsTalk 2 Server.

Web Application Port

Communication port for ToolsTalk 2.

Select Test Tools Talk Server to check if the ToolsTalk 2 server is up and running. This functionality tests and verifies if the Server Address and the Web Application Port entered is working correctly.

If the ToolsTalk 2 server is up and running, an information message appears to indicate that the test succeeded and if there is any issue with ToolsTalk 2 server, an error message is displayed with some more information in the log file.

Controller Port

Port 9016 is used as the default controller port. If using the port 9016, make sure this port is open and you can connect to it, else the application will not work.

Port 80 is used when the function Connect/disconnect/add controller is used from ToolsTalk 2 to interact with a controller.

If you enter a controller port that is not the same as the configured controller port on Atlas Copco Data Communication, a warning is displayed. Make sure that the controller port on ToolsTalk 2 and Atlas Copco Data Communication is the same.

Make sure that the controller port you enter is open and is possible to connect to!

Backup

Parameters

Description

Controller Backup Folder

Specifies a folder where the backup for the controllers will be located.

The Active Directory Group and Controller Backup Folder are empty by default.

ACDC Communication Settings

Parameters

Description

Server Address

IP or Hostname of the Atlas Copco Data Communication server

Web API Port

Port for Web API

SignalR Port

Port for SignalR

Database Installation Settings

Database Settings Parameters

Parameters

Description

SQL Server Address

IP or Hostname of the SQL Server

The Microsoft Windows Defender Firewall will prevent connections through the network to SQL Server. Therefore, it is required to configure SQL Server to accept connections by using TCP/IP. This setting can be modified in section SQL Server Configuration Manager in Windows Computer Management.

Computer Management -> SQL Server Configuration Manager -> SQL Server Network Configuration -> Protocols for MSSQLSERVER -> TCP/IP -> Enabled

Database Name

The Database/Catalog used by ToolsTalk 2. The database will be created during database installation if not already existing.

Database Credentials

Parameters

Description

User name

The username of a database user with the credentials to create databases/catalogs. Usually the system administrator credential.

Password

Enter the password. Usually the system administrator credential

Installation

Parameters

Description

Manual Script

Specifies whether or not the database has been manually created.

If this box is checked, ToolsTalk 2 expects that you have already created the SQL catalogue and the default user manually. The entered User Name and Password will be the default credentials that connects to the SQL server and are stored in clear text in the configuration files.

This setting should be only used if you have created the database catalogue and user yourself.

The ToolsTalk 2 application is available in the start menu.

Status

Parameters

Description

Refresh

Refreshes the status view and updates with the latest status of the services involved.

Start

Start a service for the first time.

Stop

Stops the service.

Restart

Restarts a stopped service.

If the Atlas Copco Data Communication is installed in a different server compared to ToolsTalk 2, it is not possible to view or modify the status of the Atlas Copco Data Communication service.