Skip to content

Improve gateway error messages#7905

Merged
ryaplots merged 3 commits into
v3.36from
feature/improve-gateway-errors
May 28, 2026
Merged

Improve gateway error messages#7905
ryaplots merged 3 commits into
v3.36from
feature/improve-gateway-errors

Conversation

@mjamescompton
Copy link
Copy Markdown
Contributor

Summary

Extend the error mapping for claim related errors regarding The Things Indoor Gateway Pro.

Changes

  • Update getClaimGatewayErrorMessage

Testing

Steps

To test this you need to setup The Things Indoor Gateway Pro to a selection of states. This can only be done internally by the team.

Configure the The Things Indoor Gateway Pro billing to be suspended, detached, not set. Use the gateway owner token.

Error messages

subscriptionDetached: `The gateway billing is detached. Open the Gateway Status page by scanning the QR code on the gateway.`,
subscriptionSuspended: `Your gateway billing is suspended. Open the Gateway Status page by scanning the QR code on the gateway.`,
subscriptionUnknown: `The gateway billing is not set up yet. Open the Gateway Status page by scanning the QR code on the gateway.`,

Configure the The Things Indoor Gateway Pro billing to be not set. Create a fleet with no slots. Use the gateway owner token to register gateway.

Error message

There are no available Gateway Licenses for this gateway. Open the Gateway Status page by scanning the QR code on the gateway.

Configure the The Things Indoor Gateway Pro to be attached to a Gateway License within a fleet, create a second Gateway Fleet and use the empty fleets owner token.

Error message

The gateway EUI matches a Gateway License, but the fleet ID does not match. Open the Gateway Status page by scanning the QR code on the gateway.

Go to register gateway in the console. Using the provided gateway EUIs and owner token for each state and check to see the correct error messages.

Results
Regressions

Before updates to the Gateway Controller the raw error messages from the stack will be shown.

Notes for Reviewers

...

Checklist

  • Scope: The referenced issue is addressed, there are no unrelated changes.
  • Compatibility: The changes are backwards compatible with existing API, storage, configuration and CLI, according to the compatibility commitments in README.md for the chosen target branch.
  • Documentation: Relevant documentation is added or updated.
  • Testing: The steps/process to test this feature are clearly explained including testing for regressions.
  • Infrastructure: If infrastructural changes (e.g., new RPC, configuration) are needed, a separate issue is created in the infrastructural repositories.
  • Changelog: Significant features, behavior changes, deprecations and fixes are added to CHANGELOG.md.
  • Commits: Commit messages follow guidelines in CONTRIBUTING.md, there are no fixup commits left.

@mjamescompton mjamescompton self-assigned this May 4, 2026
@github-actions github-actions Bot added the ui/web This is related to a web interface label May 4, 2026
@mjamescompton mjamescompton marked this pull request as ready for review May 26, 2026 12:53
@mjamescompton mjamescompton requested a review from a team as a code owner May 26, 2026 12:53
@mjamescompton mjamescompton requested a review from ryaplots May 26, 2026 12:53
Comment thread pkg/webui/lib/errors/utils.js
Comment thread pkg/webui/lib/errors/utils.js
@mjamescompton mjamescompton requested a review from ryaplots May 28, 2026 08:07
@ryaplots ryaplots merged commit 7b384c8 into v3.36 May 28, 2026
13 checks passed
@ryaplots ryaplots deleted the feature/improve-gateway-errors branch May 28, 2026 08:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ui/web This is related to a web interface

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants