Skip to content

docs: clarify mid vs mid2 offline license key compatibility (#5404) (CP: v24)#5425

Merged
mshabarov merged 1 commit intov24from
cherry/cherrypick-5404-to-v24
Mar 31, 2026
Merged

docs: clarify mid vs mid2 offline license key compatibility (#5404) (CP: v24)#5425
mshabarov merged 1 commit intov24from
cherry/cherrypick-5404-to-v24

Conversation

@mcollovati
Copy link
Copy Markdown
Contributor

The download-offline-license Maven goal always generates a mid2 machine ID, but Vaadin 24.9 and earlier only accept mid keys. This causes confusing "Invalid offline key" errors.

Add a version compatibility table to the offline license section, a warning that the Maven goal only works for Vaadin 25+, and improve the related troubleshooting entry in the knowledge base.

@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 31, 2026

AI Language Review

In the file "Knowledge Base", the following new sections were added under the "Licenses" heading:

  1. Detected an Offline License Version 1, but Version 2 is required

    • Ensure correct key versions are discussed, with explicit instructions to confirm the necessity for updating to a version 2 offline key.
  2. Invalid Machine ID Format

    • The text should clarify the need to verify the offline key type according to the specific version requirements of the Vaadin software.
  3. Invalid Offline Key

    • The section explains possible errors with offline keys, but an explicit step-by-step guidance on resolving these potential errors would improve clarity and user support.

Overall, clarify instructions for verifying and downloading the correct license keys, with consistent and detailed guidance on troubleshooting and resolution paths.

* docs: clarify mid vs mid2 offline license key compatibility

The download-offline-license Maven goal always generates a mid2 machine
ID, but Vaadin 24.9 and earlier only accept mid keys. This causes
confusing "Invalid offline key" errors.

Add a version compatibility table to the offline license section, a
warning that the Maven goal only works for Vaadin 25+, and improve the
related troubleshooting entry in the knowledge base.

* Apply suggestions from code review

Co-authored-by: Mikhail Shabarov <61410877+mshabarov@users.noreply.github.com>

---------

Co-authored-by: Mikhail Shabarov <61410877+mshabarov@users.noreply.github.com>
@mcollovati mcollovati force-pushed the cherry/cherrypick-5404-to-v24 branch from 8f4bd3b to 736c738 Compare March 31, 2026 12:34
@mcollovati mcollovati requested a review from mshabarov March 31, 2026 12:42
@mshabarov mshabarov merged commit 80a2f1e into v24 Mar 31, 2026
5 checks passed
@mshabarov mshabarov deleted the cherry/cherrypick-5404-to-v24 branch March 31, 2026 12:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants