...
...
continuing troubleshooting, make sure you |
...
understand pairing by reading this article. |
This
...
Establishing Trust between Terminal and Server - Terminal Pairing
We assume you're running at least server version 20230801.
Quick jump
My Terminal firmware version is:
Terminal with version 20230801 and newer
...
article contains a list of recommended steps to pair a terminal.
The recommended steps differ based on the terminal's current state and the version installed on it.
This guide assumes your server version is at least 20230801.
Jump here to the right section that applies to your case:
My terminal has version 20230801 and higher
Pairing steps
Deployment Scenario | Terminal |
|---|
State TakeSet the terminal server's host/IP via advanced admin. Look for Previously paired, VPN configured | Terminal was paired in past to this server and has VPN configuration already generated. | Set on terminal server’s host/ip via advanced administration. Terminal should show error screen with pairing code displayed.
|
In , approve new pairing request will appear on terminal list page. Approve the pairing request. 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 |
Never paired, No VPNTerminalhasnever 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. | Create terminal on server
|
, generate VPN config. Set host/IP.As above. | Scenario B | Never paired | Create terminal on server, set host/IP. | As above. |
Scenario B | Previously paired | Set host/IP. | As above. |
Unpairing Steps
Deployment Scenario | Terminal State | Actions to Take |
|---|
Scenario A | Paired and connected | Unpair via terminal list action menu. |
Scenario B | Paired and connected | As above. |
Terminal with a version newer than 20190130 but older than 20230801
Pairing Steps
...
. Generate VPN configuration for terminal. Set on terminal server’s host/ip via advanced administration. Terminal should show error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. 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. | Create terminal on server. Set on terminal server’s host/ip via advanced administration. Terminal should show error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. Terminal will pair and connect to master service.
| |
Terminal operates in Deployment Scenario B | Terminal was paired in past to this server. | Set on terminal server’s host/ip via advanced administration. Terminal should show error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. 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 |
|---|
Terminal operates in Deployment Scenario A | Terminal is paired and connected to VPN and master service | Unpair terminal via action menu in list of terminals. Terminal will unpair and show error screen with pairing code displayed.
|
Terminal operates in Deployment Scenario B | Terminal is paired and connected to master service | Unpair terminal via action menu in list of terminals. Terminal will unpair and show error screen with pairing code displayed.
|
My terminal has a newer version than 20190130 but has an older version than 20230801
Pairing steps
The machine will need to undergo terminal upgrade to version 20230801 before it can be paired. The good news is that gate service should take care of it automatically.
Deployment Scenario | Terminal |
|---|
State TakeSet the terminal server's host/IP via advanced admin. Look for Previously paired, VPN configured | Terminal was paired in past to this server and has VPN configuration already generated. | Set on terminal server’s host/ip via advanced administration. Terminal contacts server and displays following Error: Terminal unpaired After a while gate service automatically upgrades terminal to a newer version. This step will be performed automatically. Terminal should after a while start showing error screen with pairing code displayed.
|
In , approve new pairing request.Scenario A | Never paired, No VPNnew pairing request will appear on terminal list page. Approve the pairing request. 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. | Create terminal on server
|
, generate VPN config. Set host/IP.As above. | Scenario B | Never paired | Create terminal on server, set host/IP. | As above. |
Scenario B | Previously paired | Set host/IP. | As above. |
Terminal with version 20190130 or older
Pairing Steps
You're working with a pretty old machine here. Upgrade the terminal twice. Again, the gate service should handle this.
Deployment Scenario | Terminal State | Actions to Take | Notes |
|---|
Scenario A | Previously paired, VPN configured | Set the terminal server's host/IP via advanced admin. Look for error screen with pairing code. | In CAS, approve new pairing request. |
Scenario A | Never paired, No VPN | Create terminal on server, generate VPN config. Set host/IP. | As above. |
Scenario B | Never paired | Create terminal on server, set host/IP. | As above. |
Scenario B | Previously paired | Set host/IP. | As above. |
...
. Generate VPN configuration for terminal. Set on terminal server’s host/ip via advanced administration. Terminal contacts server and displays following Error: Terminal unpaired After a while gate service automatically upgrades terminal to a newer version. This step will be performed automatically. Terminal should after a while start showing error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. 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. | Create terminal on server. Set on terminal server’s host/ip via advanced administration. Terminal contacts server and displays following Error: Terminal unpaired After a while gate service automatically upgrades terminal to a newer version. This step will be performed automatically. Terminal should after a while start showing error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. Terminal will pair and connect to master service.
| |
Terminal operates in Deployment Scenario B | Terminal was paired in past to this server. | Set on terminal server’s host/ip via advanced administration. Terminal contacts server and displays following Error: Terminal unpaired After a while gate service automatically upgrades terminal to a newer version. This step will be performed automatically. Terminal should after a while start showing error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. Terminal will pair and connect to master service.
| |
My terminal is version 20190130 and older
Pairing steps
Terminal with this version is an archaic piece of machine.
The machine needs to undergo two subsequent terminal upgrades. The good news is that gate service should take care of it automatically.
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. | Set on terminal server’s host/ip via advanced administration. Terminal contacts server and displays following Error: Terminal unpaired After a while gate service automatically upgrades terminal to a newer version. This step will be performed twice automatically. Terminal should after a while start showing error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. 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. | Create terminal on server. Generate VPN configuration for terminal. Set on terminal server’s host/ip via advanced administration. Terminal contacts server and displays following Error: Terminal unpaired After a while gate service automatically upgrades terminal to a newer version. This step will be performed twice automatically. Terminal should after a while start showing error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. 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. | Create terminal on server. Set on terminal server’s host/ip via advanced administration. Terminal contacts server and displays following Error: Terminal unpaired After a while gate service automatically upgrades terminal to a newer version. This step will be performed twice automatically. Terminal should after a while start showing error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. Terminal will pair and connect to master service.
| |
Terminal operates in Deployment Scenario B | Terminal was paired in past to this server. | Set on terminal server’s host/ip via advanced administration. Terminal contacts server and displays following Error: Terminal unpaired After a while gate service automatically upgrades terminal to a newer version. This step will be performed twice automatically. Terminal should after a while start showing error screen with pairing code displayed. On server in CAS new pairing request will appear on terminal list page. Approve the pairing request. Terminal will pair and connect to master service.
| |