Skip to content

docs: clarify architecture-specific JDK requirements - #6909

Merged
lvs0075 merged 1 commit into
tronprotocol:developfrom
halibobo1205:codex/docs-jdk-architecture
Aug 6, 2026
Merged

docs: clarify architecture-specific JDK requirements#6909
lvs0075 merged 1 commit into
tronprotocol:developfrom
halibobo1205:codex/docs-jdk-architecture

Conversation

@halibobo1205

Copy link
Copy Markdown
Collaborator

What does this PR do?

  • Clarifies the current JDK restrictions enforced when both building and running java-tron:
    • x86_64 / amd64 requires JDK 8.
    • ARM64 / aarch64 requires JDK 17.
  • Replaces the architecture-ambiguous JVM options example with a heap-size-only example.
  • Explains that generated distributions already include GC options appropriate for the build architecture and required JDK.

Why are these changes required?

The JDK mapping is not merely a build-toolchain recommendation. It is enforced at build time in build.gradle and again when a FullNode starts through Arch.throwIfUnsupportedJavaVersion().

The existing documentation could be interpreted as allowing either JDK 8 or JDK 17 regardless of CPU architecture. This led to a reasonable but incorrect assumption that a node could run with JDK 17 on x86_64.

This PR makes the currently supported build and runtime combinations explicit and helps prevents users from copying incompatible GC options between JDK 8 and JDK 17 deployments.

This PR has been tested by:

  • Unit Tests: Not run (documentation-only changes).
  • Manual Testing:
    • Verified the documented requirements against the build-time and FullNode startup checks.
    • Verified the architecture-specific generated JVM option files.
    • Ran git -c core.whitespace=cr-at-eol diff --check.

Follow up

  • Coordinate an equivalent clarification for the related pages on developers.tron.network.
  • JDK 17 support on x86_64 remains planned for a future release.

Extra details

ARM64 / aarch64 support is available starting with GreatVoyage-v4.8.1.

Refs #6895

@github-actions
github-actions Bot requested a review from 317787106 August 6, 2026 06:11
@halibobo1205 halibobo1205 linked an issue Aug 6, 2026 that may be closed by this pull request
4 tasks
Document the required JDK per CPU architecture and replace ambiguous JVM option examples.

Refs tronprotocol#6895
@halibobo1205
halibobo1205 force-pushed the codex/docs-jdk-architecture branch from 47af05a to 378f89e Compare August 6, 2026 06:39

@waynercheung waynercheung left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@lvs0075
lvs0075 merged commit 4a21592 into tronprotocol:develop Aug 6, 2026
3 checks passed
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.

[Bug] FullNode.jar rejects Java 17 on amd64 architecture

5 participants