2025.05

antora.yml

@@ -1,14 +1,14 @@
 name: operations-manual
 title: Operations Manual
-version: '2025.04'
+version: '2025.05'
 current: true
 start_page: ROOT:index.adoc
 nav:
 - modules/ROOT/content-nav.adoc
 asciidoc:
   attributes:
-    neo4j-version: '2025.04'
-    neo4j-version-minor: '2025.04'
-    neo4j-version-exact: '2025.04.0'
-    neo4j-buildnumber: '2025.04'
-    neo4j-debian-package-version: '1:2025.04.0@'
+    neo4j-version: '2025.05'
+    neo4j-version-minor: '2025.05'
+    neo4j-version-exact: '2025.05.0'
+    neo4j-buildnumber: '2025.05'
+    neo4j-debian-package-version: '1:2025.05.0@'

modules/ROOT/pages/changes-deprecations-removals.adoc

@@ -57,6 +57,7 @@ It is highly recommended to keep it enabled and not to alter it. +
 If you require the _debug.log_ messages in a different format, create an additional Appender since the Neo4j Support team uses the default one.
 For more information, see xref:monitoring/logging.adoc#_default_logging_configuration[Default logging configuration].
 
+
 === Built-in procedures
 
 .See procedures removed in Neo4j 2025.01 without replacement.
@@ -473,6 +474,11 @@ Replaced by: xref:procedures.adoc#procedure_dbms_cluster_secondaryreplicationdis
 | Enterprise Edition
 | Comment
 
+| xref:configuration/configuration-settings.adoc#config_dbms.routing.load_balancing.plugin[`dbms.routing.load_balancing.plugin`]
+| 
+| {check-mark}
+| label:deprecated[Deprecated in 2025.05]
+
 | xref:configuration/configuration-settings.adoc#config_server.db.query_cache_size[`server.db.query_cache_size`]
 | {check-mark}
 | {check-mark}
@@ -512,6 +518,12 @@ Replaced by: xref:procedures.adoc#procedure_dbms_cluster_secondaryreplicationdis
 |===
 ====
 
+=== Logging
+
+Starting from 2025.05, the `failureReason` column of the JSON format query log is deprecated.
+Instead, use the `errorInfo` column.
+For details, refer to xref:monitoring/logging.adoc#_json_format_log_entries[Logging -> JSON format log entries for log type query].
+
 === Neo4j-admin tool
 
 .See all deprecated commands

modules/ROOT/pages/configuration/configuration-settings.adoc

@@ -1689,17 +1689,17 @@ m|+++true+++
 |===
 
 
-[role=label--enterprise-edition]
+[role=label--enterprise-edition label--deprecated-2025.05]
 [[config_dbms.routing.load_balancing.plugin]]
 === `dbms.routing.load_balancing.plugin`
 
 .dbms.routing.load_balancing.plugin
 [frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
 |===
 |Description
-a|The load balancing plugin to use.
+a|Vary the order of the entries in routing tables each time one is produced. This means that different clients should select a range of servers as their first contact, reducing the chance of all clients contacting the same server if alternatives are available. This makes the load across the servers more even.
 |Valid values
-a|A string that specified load balancer plugin exist..
+a|A string.
 |Default value
 m|+++server_policies+++
 |===
@@ -4802,6 +4802,23 @@ m|+++127.0.0.1:6362+++
 |===
 
 
+[role=label--enterprise-edition label--new-2025.05]
+[[config_server.backup.advertised_address]]
+=== `server.backup.advertised_address`
+
+.server.backup.advertised_address
+[frame="topbot", stripes=odd, grid="cols", cols="<1s,<4"]
+|===
+|Description
+a|The advertised address for the backup server. Default is the default advertised address combined with port defined in the backup listen address.
+|Valid values
+a|A socket address in the format of `hostname:port`, `hostname`, or `:port` that is an accessible address. If missing, it is acquired from `server.default_advertised_address`.
+|Default value
+m|+++:0+++
+|===
+
+
+
 [role=label--enterprise-edition]
 [[config_server.backup.store_copy_max_retry_time_per_request]]
 === `server.backup.store_copy_max_retry_time_per_request`

modules/ROOT/pages/monitoring/logging.adoc

@@ -1285,9 +1285,10 @@ Included when xref:configuration/configuration-settings.adoc#config_db.logs.quer
 | annotationData
 | Metadata attached to the transaction.
 
-| failureReason
+| failureReason label:deprecated[Deprecated in 2025.05]
 | Reason for failure.
 Included when applicable.
+Replaced by `errorInfo`.
 
 | errorInfo
 | GQL error information as a JSON object.

modules/ROOT/pages/monitoring/metrics/reference.adoc

@@ -597,6 +597,7 @@ You can limit this memory using JVM settings, but there is never any good reason
 [options="header",cols="<3m,<4"]
 |===
 |Name |Description
-|<prefix>.vm.threads|The total number of live threads including daemon and non-daemon threads. (gauge)
+|<prefix>.vm.threads|The total number of live platform threads including daemon and non-daemon threads. (gauge)
+|<prefix>.vm.threads.virtual|label:new[Introduced in 2025.05]The total number of virtual threads. (gauge)
 |===