Versions Compared

Old Version 6

changes.mady.by.user Karel Kyovsky

Saved on

compared with

New Version Current

changes.mady.by.user Petr Pokorný

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Make sure you understand what pairing before continuing troubleshooting
Info
Info

Before continuing troubleshooting, make sure you understand pairing by reading this article.

This article contains a list of recommended steps to pair a terminal.
Recommended The recommended steps differ based on different state the terminal is in and a different version it has 's current state and the version installed on it.

This guide assumes you have sever your server version is at least 20230801.

Jump here to the right section that applies to your case:

...

Deployment Scenario

Terminal state

Actions to take

Notes

Terminal operates in Deployment Scenario A

Terminal was paired in past to this server and has VPN configuration already generated.

  1. Set on terminal server’s host/ip via advanced administration. Terminal should show error screen with pairing code displayed.

  2. On server in CAS new pairing request will appear on terminal list page.

  3. Approve the pairing request.

  4. Terminal will pair and connect to master service via VPN channel.

If terminal displays “VPN connection error” it means that you probably didn’t generate VPN configuration.

Terminal operates in Deployment Scenario A

Terminalhasnever been paired to this server and doesn’t have VPN configuration generated yet.

This case applies for example to new terminals that has been purchased.

  1. Create terminal on server.

  2. Generate VPN configuration for terminal.

  3. Set on terminal server’s host/ip via advanced administration. Terminal should show error screen with pairing code displayed.

  4. On server in CAS new pairing request will appear on terminal list page.

  5. Approve the pairing request.

  6. Terminal will pair and connect to master service via VPN channel.

If terminal displays “VPN connection error” it means that you probably didn’t generate VPN configuration.

Terminal operates in Deployment Scenario B

Terminalhasnever been paired to this server.

This case applies for example to new terminals that has been purchased.

  1. Create terminal on server.

  2. Set on terminal server’s host/ip via advanced administration. Terminal should show error screen with pairing code displayed.

  3. On server in CAS new pairing request will appear on terminal list page.

  4. Approve the pairing request.

  5. Terminal will pair and connect to master service.

Terminal operates in Deployment Scenario B

Terminal was paired in past to this server.

  1. Set on terminal server’s host/ip via advanced administration. Terminal should show error screen with pairing code displayed.

  2. On server in CAS new pairing request will appear on terminal list page.

  3. Approve the pairing request.

  4. Terminal will pair and connect to master service.

Unpairing steps

Note

Unpairing should only be done when necessary. Currently, there are two reasons for unpairing: when the terminal is stolen or when the server is changed.

Deployment Scenario

Terminal state

Actions to take

Notes

Terminal operates in Deployment Scenario A

Terminal is paired and connected to VPN and master service

  1. Unpair terminal via action menu in list of terminals.

  2. Terminal will unpair and show error screen with pairing code displayed.

!!! This action should not be necessary. Only reason for unpair is when terminal is stolen or when server is changed !!!

Terminal operates in Deployment Scenario B

Terminal is paired and connected to master service

  1. Unpair terminal via action menu in list of terminals.

  2. Terminal will unpair and show error screen with pairing code displayed.

!!! This action should not be necessary

  1. .

Only reason for unpair is when terminal is stolen or when server is changed !!!

My terminal has a newer version than 20190130 but has an older version

...

than 20230801

Pairing steps

Machine The machine will needs need to undergo terminal upgrade to version 20230801 before it can be paired. Good The good news is that gate service should take care of it automatically.

...

Terminal with this version is an archaic piece of machine.
Machine The machine needs to undergo two subsequent terminal upgrades. Good The good news is that gate service should take care of it automatically.

...