Final workshop prep: ZGC+G1 dual setup, all docs updated

Author: Luqman Saeed

.env.example

@@ -1,7 +1,7 @@
 # TradeStreamEE Environment Variables
 
 # Payara Micro Version (used by all Dockerfiles)
-PAYARA_VERSION=7.2026.3
+PAYARA_VERSION=7.2026.5
 
 # JVM Options for Azul Platform Prime
 # Adjust these for your performance requirements

.profileconfig.json

@@ -0,0 +1,64 @@
+{
+    "jfrConfig": {
+        "settings": "profile"
+    },
+    "asyncProfilerConfig": {
+        "jfrsync": true,
+        "alloc": true,
+        "event": "wall",
+        "misc": ""
+    },
+    "file": "$PROJECT_DIR/profile.jfr",
+    "conversionConfig": {
+        "nonProjectPackagePrefixes": [
+            "java.",
+            "javax.",
+            "kotlin.",
+            "jdk.",
+            "com.google.",
+            "org.apache.",
+            "org.spring.",
+            "sun.",
+            "scala."
+        ],
+        "enableMarkers": true,
+        "initialVisibleThreads": 10,
+        "initialSelectedThreads": 10,
+        "includeGCThreads": false,
+        "includeInitialSystemProperty": false,
+        "includeInitialEnvironmentVariables": false,
+        "includeSystemProcesses": false,
+        "ignoredEvents": [
+            "jdk.ActiveSetting",
+            "jdk.ActiveRecording",
+            "jdk.BooleanFlag",
+            "jdk.IntFlag",
+            "jdk.DoubleFlag",
+            "jdk.LongFlag",
+            "jdk.NativeLibrary",
+            "jdk.StringFlag",
+            "jdk.UnsignedIntFlag",
+            "jdk.UnsignedLongFlag",
+            "jdk.InitialSystemProperty",
+            "jdk.InitialEnvironmentVariable",
+            "jdk.SystemProcess",
+            "jdk.ModuleExport",
+            "jdk.ModuleRequire"
+        ],
+        "minRequiredItemsPerThread": 3
+    },
+    "additionalGradleTargets": [
+        {
+            "targetPrefix": "quarkus",
+            "optionForVmArgs": "-Djvm.args",
+            "description": "Example quarkus config, adding profiling arguments via -Djvm.args option to the Gradle task run"
+        }
+    ],
+    "additionalMavenTargets": [
+        {
+            "targetPrefix": "quarkus:",
+            "optionForVmArgs": "-Djvm.args",
+            "description": "Example quarkus config, adding profiling arguments via -Djvm.args option to the Maven goal run"
+        }
+    ]
+}

Dockerfile

@@ -1,7 +1,7 @@
 # Multi-stage Dockerfile for TradeStreamEE
-# Uses Azul Platform Prime (Zing) for Pauseless Garbage Collection demonstration
+# Uses Azul Zulu 25 with ZGC for low-latency concurrent garbage collection
 
-FROM azul/zulu-openjdk:21 AS build
+FROM azul/zulu-openjdk:25-latest AS build
 WORKDIR /app
 
 # Copy Maven wrapper and pom.xml first for better layer caching
@@ -18,16 +18,16 @@ COPY src ./src
 RUN ./mvnw spotless:apply
 RUN ./mvnw clean package -DskipTests
 
-# Use Azul Platform Prime for C4 GC
-FROM azul/prime:21
+# Azul Zulu 25 with ZGC for concurrent garbage collection
+FROM azul/zulu-openjdk:25-latest
 
 LABEL maintainer="TradeStreamEE"
-LABEL description="High-frequency trading dashboard with Aeron + SBE + Payara Micro + Azul C4"
+LABEL description="High-frequency trading dashboard with Aeron + SBE + Payara Micro + Zulu 25 ZGC"
 
 WORKDIR /opt/payara
 
 # Add Payara Micro from URL
-ARG PAYARA_VERSION=7.2026.3
+ARG PAYARA_VERSION=7.2026.5
 ADD https://nexus.payara.fish/repository/payara-community/fish/payara/extras/payara-micro/${PAYARA_VERSION}/payara-micro-${PAYARA_VERSION}.jar /opt/payara/payara-micro.jar
 
 # Copy WAR file from build stage
@@ -43,26 +43,25 @@ RUN mkdir -p /opt/payara/recordings /opt/payara/gc-logs && chmod 777 /opt/payara
 EXPOSE 8080
 EXPOSE 9009
 
-# Default JVM Options for Azul Platform Prime
+# Default JVM Options for Azul Zulu 25 + ZGC
 #
 # NOTE: These JAVA_OPTS are used for single-instance deployments (start.sh script).
 # For cluster deployments (start-comparison.sh), these values are overridden by
 # docker-compose-{c4,g1}.yml environment variables. See those files for actual
 # runtime flags in cluster mode.
 #
-# Azul Platform Prime uses C4 GC by default - no need to specify -XX:+UseZGC
+# ZGC is a concurrent collector with sub-millisecond pauses on Java 25.
 #
 # JFR is OFF by default. Ad-hoc recordings are produced via the /api/jfr REST
 # endpoints. To enable an always-on circular recording, set JFR_ALWAYS_ON=true
 # in the environment; see docker-entrypoint.sh.
 ENV JAVA_OPTS="-Xms8g \
     -Xmx8g \
+    -XX:+UseZGC \
     -Xlog:gc*:file=/opt/payara/gc-logs/gc.log:time,uptime,level,tags:filecount=5,filesize=10M \
     --add-opens java.base/jdk.internal.misc=ALL-UNNAMED \
     --add-opens java.base/sun.nio.ch=ALL-UNNAMED \
     --add-opens java.base/java.nio=ALL-UNNAMED \
-    -XX:+UnlockDiagnosticVMOptions \
-    -XX:+UnlockExperimentalVMOptions \
     -XX:+AlwaysPreTouch \
     -XX:+UseTransparentHugePages \
     -XX:+UseStringDeduplication \

Dockerfile.scale

@@ -1,7 +1,7 @@
 # Multi-stage Dockerfile for TradeStreamEE with Hazelcast Clustering
-# Uses Azul Platform Prime (Zing) for Pauseless Garbage Collection demonstration
+# Uses Azul Zulu 25 with ZGC for low-latency concurrent garbage collection
 
-FROM azul/zulu-openjdk:21 AS build
+FROM azul/zulu-openjdk:25-latest AS build
 WORKDIR /app
 
 # Copy Maven wrapper and pom.xml first for better layer caching
@@ -18,16 +18,16 @@ COPY src ./src
 RUN ./mvnw spotless:apply
 RUN ./mvnw clean package -DskipTests
 
-# Use Azul Platform Prime for C4 GC
-FROM azul/prime:21
+# Azul Zulu 25 with ZGC for concurrent garbage collection
+FROM azul/zulu-openjdk:25-latest
 
 LABEL maintainer="TradeStreamEE"
-LABEL description="High-frequency trading dashboard with Aeron + SBE + Payara Micro + Azul C4 + Hazelcast Clustering"
+LABEL description="High-frequency trading dashboard with Aeron + SBE + Payara Micro + Zulu 25 ZGC + Hazelcast Clustering"
 
 WORKDIR /opt/payara
 
 # Add Payara Micro from URL
-ARG PAYARA_VERSION=7.2026.3
+ARG PAYARA_VERSION=7.2026.5
 ADD https://nexus.payara.fish/repository/payara-community/fish/payara/extras/payara-micro/${PAYARA_VERSION}/payara-micro-${PAYARA_VERSION}.jar /opt/payara/payara-micro.jar
 
 # Copy WAR file from build stage
@@ -39,29 +39,27 @@ RUN mkdir -p /opt/payara/recordings /opt/payara/gc-logs && chmod 777 /opt/payara
 EXPOSE 8080
 EXPOSE 5701
 
-# Default JVM Options for Azul Platform Prime
+# Default JVM Options for Azul Zulu 25 + ZGC
 #
 # NOTE: These JAVA_OPTS are defaults for the cluster image. However, when launched
 # via docker-compose-c4.yml, these values are overridden by environment variables
 # in that file. See docker-compose-c4.yml for actual runtime flags in cluster mode.
 #
 # Reduced heap size (4GB vs 8GB) for multi-instance deployments.
-# Azul Platform Prime uses C4 GC by default - no need to specify -XX:+UseZGC
+# ZGC is a concurrent collector with sub-millisecond pauses on Java 25.
 #
 # JFR is OFF by default. Workshop scenarios use ad-hoc recordings via the REST API
 # (POST /api/jfr/recording/start). To enable a long-running always-on circular
 # recording, set JFR_ALWAYS_ON=true in the environment.
 ENV JAVA_OPTS="-Xms4g \
     -Xmx4g \
+    -XX:+UseZGC \
     -Xlog:gc*:file=/opt/payara/gc-logs/gc.log:time,uptime,level,tags:filecount=5,filesize=10M \
     --add-opens java.base/jdk.internal.misc=ALL-UNNAMED \
     --add-opens java.base/sun.nio.ch=ALL-UNNAMED \
     --add-opens java.base/java.nio=ALL-UNNAMED \
-    -XX:+UnlockDiagnosticVMOptions \
-    -XX:+UnlockExperimentalVMOptions \
     -XX:+AlwaysPreTouch \
     -XX:+UseTransparentHugePages \
-    -XX:-UseBiasedLocking \
     -XX:+UseStringDeduplication \
     -XX:+OptimizeStringConcat \
     -Djava.net.preferIPv4Stack=true \
@@ -74,7 +72,7 @@ HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
 # Copy Hazelcast configuration
 COPY src/main/resources/hazelcast-config.xml /opt/payara/hazelcast-config.xml
 
-# Set unique cluster name for C4 environment and update discovery members
+# Set unique cluster name for ZGC environment and update discovery members
 RUN sed -i 's/payara-trader-cluster/payara-trader-c4/' /opt/payara/hazelcast-config.xml && \
     sed -i 's/trader-stream-/trader-stream-c4-/' /opt/payara/hazelcast-config.xml
 

Dockerfile.scale.standard

@@ -1,7 +1,7 @@
 # Multi-stage Dockerfile for TradeStreamEE with Hazelcast Clustering
-# Uses Eclipse Temurin (Standard OpenJDK) for comparison against Azul Platform Prime
+# Uses Eclipse Temurin 25 (Standard OpenJDK) for comparison against Azul Zulu ZGC
 
-FROM azul/zulu-openjdk:21 AS build
+FROM eclipse-temurin:25 AS build
 WORKDIR /app
 
 # Copy Maven wrapper and pom.xml first for better layer caching
@@ -18,16 +18,16 @@ COPY src ./src
 RUN ./mvnw spotless:apply
 RUN ./mvnw clean package -DskipTests
 
-# Use Eclipse Temurin (Standard OpenJDK)
-FROM eclipse-temurin:21
+# Eclipse Temurin 25 with G1GC for comparison against ZGC
+FROM eclipse-temurin:25
 
 LABEL maintainer="TradeStreamEE"
 LABEL description="High-frequency trading dashboard with Hazelcast Clustering (Standard JVM Comparison)"
 
 WORKDIR /opt/payara
 
 # Add Payara Micro from URL
-ARG PAYARA_VERSION=7.2026.3
+ARG PAYARA_VERSION=7.2026.5
 ADD https://nexus.payara.fish/repository/payara-community/fish/payara/extras/payara-micro/${PAYARA_VERSION}/payara-micro-${PAYARA_VERSION}.jar /opt/payara/payara-micro.jar
 
 # Copy WAR file from build stage

Dockerfile.standard

@@ -1,7 +1,7 @@
 # Multi-stage Dockerfile for TradeStreamEE
-# Uses Eclipse Temurin (Standard OpenJDK) for comparison against Azul Platform Prime
+# Uses Eclipse Temurin 25 (Standard OpenJDK) for comparison against Azul Zulu ZGC
 
-FROM azul/zulu-openjdk:21 AS build
+FROM eclipse-temurin:25 AS build
 WORKDIR /app
 
 # Copy Maven wrapper and pom.xml first for better layer caching
@@ -18,16 +18,16 @@ COPY src ./src
 RUN ./mvnw spotless:apply
 RUN ./mvnw clean package -DskipTests
 
-# Use Eclipse Temurin (Standard OpenJDK)
-FROM eclipse-temurin:21
+# Eclipse Temurin 25 with G1GC for comparison against ZGC
+FROM eclipse-temurin:25
 
 LABEL maintainer="TradeStreamEE"
 LABEL description="High-frequency trading dashboard (Standard JVM Comparison)"
 
 WORKDIR /opt/payara
 
 # Add Payara Micro from URL
-ARG PAYARA_VERSION=7.2026.3
+ARG PAYARA_VERSION=7.2026.5
 ADD https://nexus.payara.fish/repository/payara-community/fish/payara/extras/payara-micro/${PAYARA_VERSION}/payara-micro-${PAYARA_VERSION}.jar /opt/payara/payara-micro.jar
 
 # Copy WAR file from build stage