docs: document mid2/offlineKeyV2 + JNA troubleshooting for License Checker 2.3.1 backport (v23)#5820
Open
mcollovati wants to merge 4 commits into
Open
docs: document mid2/offlineKeyV2 + JNA troubleshooting for License Checker 2.3.1 backport (v23)#5820mcollovati wants to merge 4 commits into
mcollovati wants to merge 4 commits into
Conversation
mcollovati
force-pushed
the
docs/license-checker-2.3.1-offline-key-v23
branch
from
July 17, 2026 05:06
2c9950b to
ab2d13e
Compare
…1 backport mid2/offlineKeyV2 support was backported to Vaadin 23.6. Document the V2 key format alongside the legacy mid/offlineKey: add the offlineKeyV2 home directory path, a since-V23.6 note that both formats are accepted, and clarify that the logs show a mid2 on 23.6+ while the license-checker-machineid command still prints the legacy mid.
Vaadin 23.6 ships License Checker 2.3.1, whose 'Detected an offline license version 1, but version 2 is required' message can appear even with a valid version 1 key when the version 1 machine ID cannot be computed -- commonly because the JNA native library is blocked or fails to load. Document how to confirm the real cause with mvn -X and the two ways to resolve it.
- Add JNA and OSHI to the Vaadin.Abbr exceptions. - Wrap version-specific offline-key and troubleshooting content in Vaadin.Versions = NO/YES, matching the pattern used elsewhere in the docs.
mcollovati
force-pushed
the
docs/license-checker-2.3.1-offline-key-v23
branch
from
July 17, 2026 05:21
ab2d13e to
84f343a
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Updates the license documentation for the License Checker 2.3.1 backport, which brings
mid2/offlineKeyV2support to Vaadin 23.6.Changes
articles/configuration/licenses.adoc:mid2/offlineKeyV2offline key format (the page previously covered only the legacymid/offlineKey), badgedsince V23.6, including theofflineKeyV2home-directory path and a note that 23.6+ accepts both formats.mvn -X/./gradlew --debugdiagnosis tip.Docs issue: #5817
Related License Checker issue: vaadin/license-checker-vaadin10#245