Wiki source code of Allgemein – TCMS-Registrierung schlägt fehl
Last modified by Tobias Wintrich on 2025/12/08 09:00
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
4.1 | 1 | This article describes possible causes and troubleshooting steps for situations where one or more clients cannot register with the TCMS server. |
| |
2.1 | 2 | |
| 3 | (% class="box infomessage" %) | ||
| 4 | ((( | ||
| |
4.1 | 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]]. |
| |
2.1 | 6 | ))) |
| 7 | |||
| 8 | {{toc/}} | ||
| 9 | |||
| |
4.1 | 10 | = TCMS registration fails with error "reason: Forbidden" = |
| |
2.1 | 11 | |
| |
4.1 | 12 | == Issue Description == |
| |
2.1 | 13 | |
| |
4.1 | 14 | When registering a RangeeOS client with the TCMS, the error message *"reason: Forbidden"* appears: |
| |
2.1 | 15 | |
| 16 | [[image:1765180252119-404.png||height="380" width="800"]] | ||
| 17 | |||
| |
4.1 | 18 | This message indicates that the client was rejected by the TCMS. In practice, this is typically caused by one of two issues. |
| |
2.1 | 19 | |
| |
4.1 | 20 | == Possible Causes and Solutions == |
| |
2.1 | 21 | |
| |
4.1 | 22 | === 1. Restriction due to subnet configuration === |
| |
2.1 | 23 | |
| |
4.1 | 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. | ||
| |
2.1 | 26 | |
| |
4.1 | 27 | **Solution:** |
| |
2.1 | 28 | |
| |
4.1 | 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. | ||
| |
2.1 | 34 | |
| 35 | ---- | ||
| 36 | |||
| |
4.1 | 37 | === 2. Faulty TCMS firmware version (13.00 Build 121) === |
| |
2.1 | 38 | |
| |
4.1 | 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. | ||
| |
2.1 | 41 | |
| |
4.1 | 42 | **Solution:** |
| |
2.1 | 43 | |
| |
4.1 | 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/]] | ||
| |
2.1 | 47 | |
| 48 | (% class="box warningmessage" %) | ||
| 49 | ((( | ||
| |
4.1 | 50 | Before updating, **always create a database backup** and import it again after the update is complete. |
| |
2.1 | 51 | ))) |