Merge branch 'release/3.9' into 3.8-api

Author: RichardSmedley

antora.yml

@@ -14,11 +14,12 @@ asciidoc:
   attributes:
     page-nav-header-levels: 1
     server_version: '8.0.0'
-    sdk_current_version: '3.9.1'
+    sdk_current_version: '3.9.2'
     sdk_dot_minor: '3.9'
     sdk_dot_major: '3.x'
     version-server: '7.6'
     version-common: '8.0'
+    java_latest_lts_version: '25'
     name_platform: 'Java'
     name-sdk: Java SDK
     sdk_api: '3.8'

modules/concept-docs/pages/querying-your-data.adoc

@@ -69,7 +69,7 @@ Fuzzy search with text or a variety of other data:
 * CIDR notation
 * Geospatial data 
 
-Searches use indexes created against data at the Scope or the budket level.
+Searches use indexes created against data at the Scope or the bucket level.
 
 
 === Vector Search
@@ -145,7 +145,7 @@ For low latency range queries, it is recommended that you use SQL++ with the nec
 
 From Couchbase Server 7.6 onwards,
 CRUD operations (such as `CREATE`, `INSERT`, and `SELECT`) and `JOIN` can be performed against the Query Service without an index (primary or secondary).
-This uses a xref:server:learn:services-and-indexes:indexes/query-without-index.adoc#sequential-scans[sequential scan], relying on a KV range scan to deliver the keys.
+This uses a xref:server:learn:services-and-indexes/indexes/query-without-index.adoc#sequential-scans[sequential scan], relying on a KV range scan to deliver the keys.
 
 Sequential scans are best suited to small collections where key order is unimportant, or where the overhead of maintaining an index can't be justified.
 For larger collections and greater performance, define the appropriate indexes to speed up your queries.
@@ -163,7 +163,7 @@ Read on to learn more about the Query and Index services.
 // e N1QL (Non-First Normal Form Query Language)
 // and link book?
 
-If you are familiar with SQL, Couhbase's {sqlpp} dialect will hold few surprises.
+If you are familiar with SQL, Couchbase's {sqlpp} dialect will hold few surprises.
 Combining semi-flexible schema with SQL works well in a lot of use cases, but do remember that our Data Service is even faster if you do already know the keys.
 
 

modules/hello-world/pages/start-using-sdk.adoc

@@ -93,7 +93,7 @@ For the example code below to run, you'll need the username and password of the
 * The Java SDK is tested against LTS versions of Oracle JDK and OpenJDK -- 
 see the xref:project-docs:compatibility.adoc#jdk-compat[compatibility docs].
 +
-https://adoptium.net/[OpenJDK 21 with HotSpot JVM] is recommended.
+https://adoptium.net/[OpenJDK {java_latest_lts_version} with HotSpot JVM] is recommended.
 
 The code examples also assume:
 
@@ -134,7 +134,7 @@ In production, Couchbase strongly recommends setting up users with more granular
 
 == Installation
 
-We recommend running the latest Java LTS version (i.e. at the time of writing JDK 21) with the highest patch version available.
+We recommend running the latest Java LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available.
 // Other supported Java versions will work, too.
 Couchbase publishes all stable artifacts to https://central.sonatype.com/namespace/com.couchbase.client[Maven Central].
 
@@ -625,7 +625,7 @@ include:devguide::example$StartUsing.java[tags=start-using,indent=0]
 
 == Quick Installation
 
-We recommend running the latest Java LTS version (i.e. at the time of writing JDK 21) with the highest patch version available.
+We recommend running the latest Java LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available.
 // Other supported Java versions will work, too.
 Couchbase publishes all stable artifacts to https://central.sonatype.com/namespace/com.couchbase.client[Maven Central].
 

modules/hello-world/pages/student-record-developer-tutorial.adoc

@@ -17,8 +17,8 @@ If you wish to use a standalone or Docker installation of Couchbase, see the xre
 
 * Before starting this tutorial, you must have a Couchbase Capella account. 
 If you do not have one already, xref:cloud:get-started:create-account.adoc[Create an Account]. 
-* Install the Java Software Development Kit (JDK) -- Couchbase JVM SDKs are compatible with version 8, 11, 17, or 21.
-** The recommended version is the latest Java LTS release, which is currently https://adoptium.net/en-GB/[JDK 21].
+* Install the Java Software Development Kit (JDK) -- Couchbase JVM SDKs are compatible with LTS versions of Java.
+** The recommended version is the latest Java LTS release, which is currently https://adoptium.net/[JDK {java_latest_lts_version}].
 Ensure you install the highest available patch for the LTS version. 
 * Install Apache Maven (version 3+)
 

modules/howtos/pages/distributed-acid-transactions-from-the-sdk.adoc

@@ -405,6 +405,6 @@ include::{version-common}@sdk:shared:partial$acid-transactions.adoc[tag=config]
 
 == Additional Resources
 
-* Learn more about xref:concept-docs:transactions.adoc[Distributed ACID Transactions].
-
+* Learn more about xref:server:learn:data/transactions.adoc[Distributed ACID Transactions].
+* Learn more about xref:concept-docs:transactions.adoc[Distributed ACID Transactions with the Java SDK].
 * Check out the SDK https://docs.couchbase.com/sdk-api/couchbase-java-client/com/couchbase/client/java/transactions/package-summary.html[API Reference].

modules/howtos/pages/observability-metrics.adoc

@@ -148,7 +148,9 @@ receivers:
   otlp:
     protocols:
       grpc:
+        endpoint: '0.0.0.0:4317'
       http:
+        endpoint: '0.0.0.0:4318'
 
 exporters:
   logging:

modules/project-docs/pages/compatibility.adoc

@@ -10,7 +10,8 @@ Plus notes on Cloud, networks, and AWS Lambda.
 {description}
 
 
-The {sdk_dot_minor} SDK requires Java 8 or later to be installed, _Java 21 is recommended_.
+The {sdk_dot_minor} SDK requires Java 8 or later to be installed.
+_Java {java_latest_lts_version} is recommended_.
 
 
 
@@ -21,11 +22,12 @@ The {sdk_dot_minor} SDK requires Java 8 or later to be installed, _Java 21 is re
 
 The {name-sdk} is tested with Oracle JDK and OpenJDK.
 Other JDK implementations might work but are not tested and are unsupported.
-We recommend running the latest LTS version (i.e. at the time of writing JDK 21) with the highest patch version available.
+We recommend running the latest LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available.
 
 The following JDK releases are supported:
 
-* https://adoptium.net/[OpenJDK 21 with HotSpot JVM] (recommended)
+* https://adoptium.net/[OpenJDK 25 with HotSpot JVM] (recommended)
+* https://adoptium.net/[OpenJDK 21 with HotSpot JVM]
 * https://adoptium.net/[OpenJDK 17 with HotSpot JVM]
 * https://www.oracle.com/java/technologies/downloads/#jdk17[Oracle JDK 17]
 * https://adoptium.net/[OpenJDK 11] (Hotspot recommended) or https://www.oracle.com/java/technologies/downloads/#jdk11[Oracle JDK 11]
@@ -161,7 +163,7 @@ It is best to upgrade either the SDK or the Couchbase version you are using.
 | *✔*
 |===
 
-Note the https://www.couchbase.com/support-policy[End of Life dates^] for Couchbase Server and SDK versions.
+Note the https://www.couchbase.com/support-policy/EOL/[End of Life dates^] for Couchbase Server and SDK versions.
 See the notes there for Support details.
 
 === Capella Compatibility

modules/project-docs/pages/migrating-sdk-code-to-3.n.adoc

@@ -46,7 +46,7 @@ The Java SDK 3.x is available for download from the same resources as the previo
 In addition, a `zip` file is available with the required jars. 
 Please see the xref:sdk-release-notes.adoc[Release Notes] for up-to-date information.
 
-IMPORTANT: Java SDK 3.x has a minimum required Java version of 8, although we recommend running the latest LTS version (i.e. at the time of writing JDK 21) with the highest patch version available.
+IMPORTANT: Java SDK 3.x has a minimum required Java version of 8, although we recommend running the latest LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available.
 
 Note that the transitive dependency list has changed. 
 As a refresher, Java SDK 2 depended on the following artifacts:

modules/project-docs/pages/sdk-full-installation.adoc

@@ -28,7 +28,7 @@ The underlying OS normally makes no difference, but library incompatibilities in
 
 At least Java 8 is required for current releases;
 see the xref:project-docs:compatibility.adoc#jdk-compat[Compatibility] section for details.
-We recommend running the latest Java LTS version (i.e. at the time of writing JDK 21) with the highest patch version available.
+We recommend running the latest Java LTS version (i.e. at the time of writing JDK {java_latest_lts_version}) with the highest patch version available.
 
 Couchbase publishes all stable artifacts to https://central.sonatype.com/namespace/com.couchbase.client[Maven Central].
 The latest version of the {sdk_dot_minor} SDK is https://central.sonatype.com/artifact/com.couchbase.client/java-client/{sdk_current_version}/jar[{sdk_current_version}].
@@ -51,7 +51,7 @@ For https://maven.apache.org[Maven], you can insert the following into the depen
         <version>{sdk_current_version}</version>
     </dependency>
 ----
-Refer to the https://maven.apache.org/guides/introduction/introduction-to-the-pom.html/[Maven Documentation] for more information regarding the structure of the `pom.xml` file.
+Refer to the https://maven.apache.org/guides/introduction/introduction-to-the-pom.html[Maven Documentation] for more information regarding the structure of the `pom.xml` file.
 --
 Gradle::
 +

modules/project-docs/pages/sdk-release-notes.adoc

@@ -45,6 +45,41 @@ echo metrics-micrometer ; grep '<version>' $src/metrics-micrometer/pom.xml | hea
 ////
 
 
+=== Version 3.9.2 (10 October 2025)
+
+This is the second maintenance release of the 3.9 series.
+
+https://packages.couchbase.com/clients/java/3.9.2/Couchbase-Java-Client-3.9.2.zip[Download] |
+https://docs.couchbase.com/sdk-api/couchbase-java-client-3.9.2/index.html[API Reference] |
+http://docs.couchbase.com/sdk-api/couchbase-core-io-3.9.2/[Core API Reference]
+
+The supported and tested dependencies for this release are:
+
+* io.projectreactor:**reactor-core:3.6.9**
+* org.reactivestreams:**reactive-streams:1.0.4**
+
+Optional artifacts on top of this SDK version are tested for the following compatibilities:
+
+.Optional Artifact Version Compatibility
+[options="header"]
+|=======================
+| Artifact                  | Couchbase Version | Built Against              | API Stability
+| `tracing-opentelemetry`   | 3.9.2             | OpenTelemetry 1.31.0       | Committed
+| `tracing-opentracing`     | 3.9.2             | OpenTracing 0.33.0         | Committed
+| `metrics-opentelemetry`   | 3.9.2             | OpenTelemetry 1.31.0       | Volatile
+| `metrics-micrometer`      | 3.9.2             | Micrometer 1.12.9          | Volatile
+|=======================
+
+==== Improvements
+
+* https://couchbasecloud.atlassian.net/browse/JVMCBC-1694[JVMCBC-1694]:
+Updated `Netty` to `4.1.127`.
+
+* https://couchbasecloud.atlassian.net/browse/JCBC-2204[JCBC-2204]:
+Added an `io.configNotifications` client setting. 
+If advised by Couchbase Technical Support, set this to false to disable server-initiated cluster topology change notifications.
+
+
 === Version 3.9.1 (5 September 2025)
 
 This is the first maintenance release of the 3.9 series.