Installing the Client by Using ServerClickOnce
Important notice about releases before 2.21.3:
The certificate used for signing ClickOnce installers has expired in these releases. Existing server/client installations will continue to work, but when installing new clients, "Unknown Publisher" will be shown in a warning dialog. If your system only allows installation of applications signed with trusted certificates, new clients cannot be installed. To solve these issues, upgrade to release 2.21.3 or later and assign a trusted certificate. The clients must be re-installed after upgrading. See "ClickOnce Client" below for more information.
Save the executable file ToolsTalkServerClickOnce<xxx>.exe in a desired folder on your computer. The <xxx> represents the version of the file.
Double-click on the executable file.
Select Yes to Do you want to allow this app to make changes to your device?
Select Next in the Atlas Copco Tools Talk Server ClickOnce - InstallShield Wizard window to continue.
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.
Select Change... to install the application in a different location. The default location is C:\Program Files\Atlas Copco\ToolsTalk ClickOnce\
Select Next to continue.
Select Install to finish the installation.
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.
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.
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.
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.
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.
Select Install Database.
Upon successful installation of the database, the message Database creation succeed is displayed.
Enter the parameters in the Server Settings tab.
Enter the parameters in the ACDC Settings tab.
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.
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:
Select the required Host ID from the Host IDs drop-down.
This is now also reflected in the Active Host ID field.
Select Update Active Host ID.
Select Save.
The active Host ID is now changed and the FMS services can be restarted for the new settings to be applied.
Database Settings
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. |
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 |
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 catalog 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 catalog and user yourself. |
Server Settings
Parameters | Description |
|---|---|
Authentication Mode | The authentication mode used to verify user authority. Select Windows (Active directory) or None. If None is selected, Authentication Mode is not enabled. If you want to enable Authentication Mode after installation, you need to uninstall clients for each user before changing the setting in ToolsTalk 2 Configuration window. Remember to resign the clients before reinstalling the clients again. |
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. Select in the drop-down between the addresses saved in the server or enter a new address. |
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. |
Convert Service URL to IP Address | On or Off. When On is selected, if a hostname is used in the address, it is converted to an IP address. |
Make sure that the controller port you enter is open and is possible to connect to.
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.
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.
Enter the parameters in the Exchange Server Settings field.
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.
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.
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. |
The link to the ClickOnce Client link is available to copy and send to users to download the ClickOnce Client.
Parameters | Description |
|---|---|
Certificate Password (2.21.3+): | If a custom certificate is specified, the certificate password is specified here. Optionally specify a password protected PFX certificate, to use for signing the ClickOnce client files. By specifying a certificate trusted by your system, no warning will be shown during client installation and the installation will work also on systems that prevent installation of applications without trusted signatures. If you do not assign a certificate, you can use a self-signed certificate from Atlas Copco instead (untrusted).We recommend to use a trusted custom certificate. We advise you to specify the same certificate when upgrading to a new version, since changing certificate will require the clients to be re-installed. |
Copy Link | Copies the link to the ClickOnce Client. |
Sign | Can be used to sign into the ClickOnce Client if needed and the link to the ClickOnce Client will be available again. |
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.
Deploying the Client On a Remote Machine
Browse to the server, via web browser, by using the link:
http://<FULL COMPUTER NAME>:<PORT NUMBER>/deploym
Replace <FULL COMPUTER NAME> and <PORT NUMBER>.
Make sure that the <FULL COMPUTER NAME> is exactly the same as on which the server and database are located. If Full Computer Name [TOOLSE277256.ATLASCOPCO.COM] or Computer Name [TOOLSE277256] is set, then a DNS server must exist and be set in the controller, otherwise it is not possible to add controllers to the ToolsTalk 2 environment.
Save the executable file ToolsTalk.Client.WPF.Desktop.application on your computer.
Double-click on the executable file, or select Open if prompted.
ToolsTalk 2 client opens with the latest version installed.
The ToolsTalk 2 client will always open with the latest server version by using ClickOnce.
Deploying the Client on Local Machine
If ClickOnce was installed in the default folder, navigate to “C:\Program Files (x86)\Atlas Copco\ToolsTalk ClickOnce\ClientDeploy” and double click on ToolsTalk.Client.WPF.Desktop Application manifest file to deploy the client.
Once the installation is completed, the ToolsTalk 2 icon is created on the desktop.
