Skip to Content
Last modified by Tobias Wintrich on 2025/12/08 09:00
Show last authors
1 This article describes possible causes and troubleshooting steps for situations where one or more clients cannot register with the TCMS server.
2
3 (% class="box infomessage" %)
4 (((
5 You can identify the error message on an affected client via the [[Manual TCMS Registration>>doc:Handbuecher.Rangee Thin Client Admin Guide 12\.00.Kapitel 3 - Administration des Clients.3\.E Remote Administration.3\.E\.D\. Manuelle TCMS Registrierung]].
6 )))
7
8 {{toc/}}
9
10 = TCMS registration fails with error "reason: Forbidden" =
11
12 == Issue Description ==
13
14 When registering a RangeeOS client with the TCMS, the error message *"reason: Forbidden"* appears:
15
16 [[image:1765180252119-404.png||height="380" width="800"]]
17
18 This message indicates that the client was rejected by the TCMS. In practice, this is typically caused by one of two issues.
19
20 == Possible Causes and Solutions ==
21
22 === 1. Restriction due to subnet configuration ===
23
24 In the TCMS Kommbox, under **Remote Administration**, you will find the option **“Allow access from subnets”**.
25 If one or more subnets are defined here, only clients whose subnet explicitly appears in this list are allowed to register.
26
27 **Solution:** 
28
29 * Open the **Kommbox** of the TCMS.
30 * Navigate to **Remote Administration**.
31 * Add the subnet of the affected clients to the “Allow access from subnets” list, or remove all existing entries.
32 * Save the settings.
33 * Restart the TCMS.
34
35 ----
36
37 === 2. Faulty TCMS firmware version (13.00 Build 121) ===
38
39 When using firmware **13.00 Build 121**, issues may occur if clients attempt to register via the **additional API port**.
40 In this build, access to the API port is incorrectly blocked, causing the *“Forbidden”* message.
41
42 **Solution:** 
43
44 * Update the TCMS to a **current firmware version** in which this problem has been resolved.
45 * Be sure to follow the official update guide:
46 [[TCMS – Upgrade or Update the TCMS>>https://kb.rangee.com/HowTos/TCMS%20-%20Upgrade%20bzw.%20Update%20des%20TCMS/]]
47
48 (% class="box warningmessage" %)
49 (((
50 Before updating, **always create a database backup** and import it again after the update is complete.
51 )))