# 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\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.

    To enable HTTPS for the Web API in ToolsTalk 2 Server and ClickOnce, select Enable HTTPS and select a certificate from Local Machine Certificate Store > Personal on the Windows machine where ToolsTalk Server is installed. The certificate must be set up before Atlas Copco Data Communication Service is installed. The certificate will not automatically be generated. The certificate must include the Server Authentication purpose.

15. Enter the parameters in the ACDC Settings tab.

16. 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. Port 80 can be changed during installation. For more information, see Prerequisites for Installation.

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 Settings

ACDC Communication Settings
Parameters | Description
--- | ---
Server Address | IP or Hostname of the Atlas Copco Data Communication server
Web API Port | Port for Web API

## Validating the ACDC Exchange Server Settings

The parameters of the exchange server settings should be the same on both Atlas Copco Data Communication and ToolsTalk 2. It is possible to verify if the parameters are the same by using the Validate option in the ACDC Settings tab.

1. Enter the parameters in the Exchange Server Settings field.

2. Select Validate.

   If the parameters entered as correct the validation is successful.

   If the parameters entered are not the same as present in Atlas Copco Data Communication, then an error "The configured value is not equal to the corresponding ACDC value" is displayed.

3. Select Use ACDC Configuration if the validation failed.

   This will replace the incorrect parameters in the ToolsTalk 2 exchange server configuration with the parameters present in the ACDC configuration.

Exchange Server Settings
Parameters | Description
--- | ---
Exchange server topic name | The topic name of the exchange server used for communication between Atlas Copco Data Communication and ToolsTalk 2
Exchange server address | IP address of the exchange server.
Exchange server port | Port of the exchange server.
Exchange server username | Username used to access the exchange server.
Exchange server password | Password for the exchange server.

## 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.

Relevant Information

- Compatibility Matrix
- Troubleshooting - Internal