License Error Messages
License operations in iRis Cloud — validating an access token or a license code, registering a HMI Device, replacing a license, and receiving purchased licenses — talk to the license server. When one of them fails, a notification shows the message followed by its error code, for example “License code is invalid. (ECH00215)”; validation errors also appear under the field, without the code. This page lists every code, the message shown, and what to do.
Where errors appear
Section titled “Where errors appear”| Code range | Screen |
|---|---|
ECH00201 – ECH00217 | Add new device dialog — access token and license code validation. |
ECH00231 – ECH00239 | Add new device dialog — registering the HMI Device with its license. |
ECH00251 – ECH00262 | Register license dialog in the HMI Device details — replacing a license. |
ECH00291 – ECH00308 | Select licenses page — receiving purchased licenses. |
Error codes
Section titled “Error codes”| Code | Message | What to do |
|---|---|---|
ECH00201 | Access token was not entered. | Enter the access token and click Validate. |
ECH00202 | Access token is already in use. | The token belongs to another HMI Device. Check the token on the HMI Device. |
ECH00211 | License code was not entered. | Enter a license code, or leave the field empty when the free trial is offered. |
ECH00212, ECH00213, ECH00214, ECH00216 | A temporary error occurred. Please try again later. | Try again in a few minutes. If it keeps failing, contact your administrator. |
ECH00215 | License code is invalid. | Check the code. Copy it from the claim page or the License management page instead of typing it. |
ECH00217 | License code is already in use. | The code is assigned to another HMI Device. Pick a pending license from Available licenses. |
ECH00231 | License code was not entered. | Enter a license code. |
ECH00232, ECH00233, ECH00237 | A temporary error occurred. Please try again later. | Try again in a few minutes. |
ECH00234 | License code is invalid. | Check the code and validate it again. |
ECH00235 | License code is already in use. | Pick a pending license. |
ECH00236 | License code has expired. | An expired license cannot be registered. Pick a pending license. |
ECH00238 | Failed to register the device. Please try again later. | Try again. If it keeps failing, contact your administrator. |
ECH00239 | Trial license already used for this access token. | The free trial was used for this token in the meantime. Validate the token again and enter a license code. |
ECH00251 | License code was not entered. | Enter a license code in the Register license dialog. |
ECH00252, ECH00253, ECH00258 | A temporary error occurred. Please try again later. | Try again in a few minutes. |
ECH00254 | License code is invalid. | Check the code and validate it again. |
ECH00255 | License code is already in use. | Pick a pending license. |
ECH00256 | License code has expired. | Pick a pending license. |
ECH00257 | The license cannot be renewed yet because more than 30 days remain until expiration. | Wait until the current license is within 30 days of its expiration date. |
ECH00259 | Failed to renew the license. Please try again later. | Try again. If it keeps failing, contact your administrator. |
ECH00260 | The license to renew could not be found. | Reload the HMI Device details and try again. |
ECH00261 | The device and license information do not match. | Reload the HMI Device details and try again. |
ECH00262 | This license has already been renewed and is no longer in use. | Reload the HMI Device details; the license was already replaced. |
ECH00291, ECH00293, ECH00294, ECH00295 | Could not load the license list. Please try again. (the code itself is not shown on the page) | Click Retry. If it keeps failing, go back to the claim page and click Send to iRis Cloud again; if that does not help, contact your administrator. |
ECH00292 | The handoff link is invalid or has expired. Open the claim page from the latest purchase email and click [Send to iRis Cloud] again. If it keeps failing, contact the license provider. | Use the link in the latest purchase email. |
ECH00301 | The delivery link is missing. Click [Send to iRis Cloud] on the claim page again. | Go back to the claim page and click Send to iRis Cloud again. |
ECH00302 | No licenses to register, or more than 100 at once. Please reload the list and try again. | Reload the list and select between 1 and 100 licenses. |
ECH00303 | The same license code was selected more than once. | Reload the list and select again. |
ECH00304 | Some license codes are already registered. Reloading the list. | The list reloads by itself; the registered codes show the Used badge. |
ECH00305 | Some license codes are already registered on the license server. Reloading the list. | The list reloads by itself; select the remaining codes. |
ECH00306 | The license server integration is misconfigured. Please contact the administrator. | Contact your administrator. |
ECH00307 | The license server could not be reached. Please try again later. | Try again in a few minutes. |
ECH00308 | The licenses could not be registered. Please try again later. | Try again. If it keeps failing, contact your administrator. |
For the normal flow, see Register a License to a HMI Device and Receive Purchased Licenses.