Changes from Neo4j 5 to 2025.x
|
Important
It is recommended to read the Introduction and Upgrade to a Neo4j 2025 release before continuing. |
The following are the changes that must be reviewed, and potentially addressed as part of upgrading to a Neo4j 2025 release:
Software requirements and Java version
It is recommended to upgrade to a fully supported operating system before upgrading to Neo4j 2025.01.
Neo4j 2025.01 requires Java 21, which is supported from 5.14 onwards.
Java 17 is no longer supported in Neo4j 2025.01.
See Operations Manual → Software requirements for the list of supported operating systems and their Java dependencies.
Major changes
Cluster discovery service
Neo4j provides several mechanisms for cluster members to discover each other and form a cluster based on the configuration and the environment in which the cluster is running, as well as the version of Neo4j being used.
In the 2025.01 release, discovery service v1 is removed. Therefore, transitioning from v1 to v2 must be completed before upgrading to Neo4j 2025.01. For more details, please refer to the Operations Manual → Moving from discovery service v1 to v2.
Other changes
Store format
In Neo4j 2025.01, block format is the default format for all Enterprise Edition databases.
Therefore, it is highly recommended that Enterprise Edition users migrate all databases to block format before upgrading to 2025.01 to ensure the best possible performance.
For details, see Operations Manual → Store formats → Changing the store format of existing databases.
The block format supports token names (including node labels, property keys, and relationship type names) of any length up to the GQL identifier max length of 16,383 characters.
Thus, token names must adhere to this length limit when migrating from aligned to block format.
standard and high_limit formats are deprecated in 5.23 and will be removed in a future release.
For more information, see Operations Manual → Store formats → Format deprecations.
For more information on the available store formats per Neo4j version, see Operations Manual → Store formats.
Deprecations and removals
For the full list of deprecations and breaking changes in Neo4j 2025.x, see the Operations Manual → Deprecations, removals, and changes — Neo4j 2025.x. Depending on how your application interacts with Neo4j, you might need to update your application to work with the new version of Neo4j.