Document breaking changes in GlassFish 7.1 and 8.0

[OndroMih]

Description

List of breaking changes:

• Admin CLI JAR Not Work as Before #25729 - admin-cli.jar moved and is no longer runnable. Instead of admin-cli.jar, scripts and tools should use the asadmin, asadmin.batorasadmin.javascripts. This breaks the Arquillian GlassFish connector provided by the Arquillian project. We recommend using the OmniFish Arquillian connector. Some IDEs might be impacted too, if they useadmin-cli.jar`
• Java <17 not supported in GlassFish 7.1, Java <21 not supported in 8.0
• asadmin commands no longer accept options for the asadmin tools itself after the command to execute. E.g. asadmin start-domain --port 4848 doesn't work and should be asadmin --port 4848 start-domain. This was already deprecated and is not supported anymore
• Redesign of GlassFish bootstrap #25183
• Embedded GlassFish doesn't ship with keystore and truststore files because it's a security risk (glassfish 7.1.0 embedded doesn't create key and trust stores #25875)

[pzygielo]

• Stand-alone client fails due to ClassNotFoundException even if gf-client.jar is included in classpath #25855

[OndroMih]

Most IDEs don’t work - they either need a configuration tweak or an update of a plugin.

• fixed in IntelliJ 2026.1: https://youtrack.jetbrains.com/projects/IDEA/issues/IDEA-383405/Support-Glassfish-7.1.0-with-Java-25
• will be fixed in Netbeans 30: Adjust GlassFish plugin for changes in GlassFish 7.1 apache/netbeans#9297
• Eclipse IDE - in progress: Adapt to GlassFish 7.1, 8.0 OmniFish-EE/eclipse-plugin-glassfish#7

[OndroMih]

• upgrade from 7.0.25 to 7.1.0-m1 fails due to password #25800

Workaround: convert keystore.jks to keystore.p12 and cacerts.jks to cacerts.p12

[OndroMih]

JVM options need to be modified (see ec91ab4):

• <jvm-options>--add-opens=java.naming/javax.naming.spi=ALL-UNNAMED</jvm-options> should be replaced by <jvm-options>--add-opens=java.naming/javax.naming.spi=org.glassfish.main.jdke</jvm-options>