Add a new page for deprecations, removals, and changes per version

Author: NataliaIvakina

modules/ROOT/content-nav.adoc

@@ -239,6 +239,8 @@
 
 * xref:procedures.adoc[]
 
+* xref:changes-deprecations-removals.adoc[]
+
 * xref:tutorial/index.adoc[]
 //** xref:tutorial/local-causal-cluster.adoc[]
 //** xref:tutorial/causal-backup-restore-db.adoc[]

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

@@ -0,0 +1,289 @@
+:description: Page contains lists of procedures, configuration settings, metrics removed or deprecated in Neo4j 2025. Also, you can find information on changed defaults and new functionality of neo4j-admin commands.
+
+//Check Mark
+:check-mark: icon:check[]
+
+
+[[removals-deprecations-2025-01]]
+= Deprecations, removals, and changes per Neo4j version
+
+== Neo4j 2025.01
+
+=== Removed built-in Neo4j procedures
+
+.See procedures removed in Neo4j 2025.01 without replacement.
+[%collapsible]
+====
+[options=header,cols="3m,1,1"]
+|===
+| Name
+| Community Edition
+| Enterprise Edition
+
+| link:{neo4j-docs-base-uri}/operations-manual/5/procedures/#procedure_dbms_cluster_movetonextdiscoveryversion[`dbms.cluster.moveToNextDiscoveryVersion()`]
+|
+| {check-mark}
+
+| link:{neo4j-docs-base-uri}/operations-manual/5/procedures/#procedure_dbms_cluster_showparalleldiscoverystate[`dbms.cluster.showParallelDiscoveryState()`]
+|
+| {check-mark}
+
+| link:{neo4j-docs-base-uri}/operations-manual/5/procedures/#procedure_dbms_cluster_switchdiscoveryserviceversion[`dbms.cluster.switchDiscoveryServiceVersion()`]
+|
+| {check-mark}
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/procedures/#procedure_dbms_setDatabaseAllocator[`dbms.setDatabaseAllocator()`]
+|
+|{check-mark}
+
+|===
+====
+
+=== Removed Neo4j configuration settings
+
+.See all removed configuration settings in Neo4j 2025.01
+[%collapsible]
+====
+[options=header,cols="4m,2"]
+|===
+|Name
+|Notes
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings/#config_db.cluster.raft.leader_transfer.priority_group[`db.cluster.raft.leader_transfer.priority_group`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_db.logs.query.annotation_data_as_json_enabled[`db.logs.query.annotation_data_as_json_enabled`]
+|label:dynamic[]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_db.tx_state.memory_allocation[`db.tx_state.memory_allocation`]
+|
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_dbms.cluster.catchup.client_inactivity_timeout[`dbms.cluster.catchup.client_inactivity_timeout`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_dbms.cluster.discovery.log_level[`dbms.cluster.discovery.log_level`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_dbms.cluster.discovery.type[`dbms.cluster.discovery.type`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_dbms.cluster.discovery.v2.endpoints[`dbms.cluster.discovery.v2.endpoints`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_dbms.cluster.discovery.version[`dbms.cluster.discovery.version`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_dbms.kubernetes.discovery.v2.service_port_name[`dbms.kubernetes.discovery.v2.service_port_name`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_initial.dbms.database_allocator[`initial.dbms.database_allocator`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_server.cluster.catchup.connect_randomly_to_server_group[`server.cluster.catchup.connect_randomly_to_server_group`]
+|label:enterprise[Enterprise Edition] label:dynamic[]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_server.discovery.advertised_address[`server.discovery.advertised_address`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_server.discovery.listen_address[`server.discovery.listen_address`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_server.groups[`server.groups`]
+|label:enterprise[Enterprise Edition]
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_server.memory.off_heap.block_cache_size[`server.memory.off_heap.block_cache_size`]
+|
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_server.memory.off_heap.max_cacheable_block_size[`server.memory.off_heap.max_cacheable_block_size`]
+|
+
+|link:{neo4j-docs-base-uri}/operations-manual/5/configuration/configuration-settings#config_server.memory.off_heap.transaction_max_size[`server.memory.off_heap.transaction_max_size`]
+|
+
+|===
+====
+
+
+[role=label--enterprise]
+=== Removed Neo4j metrics
+
+.See all removed metrics in Neo4j 2025.01
+[%collapsible]
+====
+[options="header"]
+|===
+|Name
+
+a|**link:{neo4j-docs-base-uri}/operations-manual/5/monitoring/metrics/reference/#raft-core-metrics[Raft core metrics] - replaced accordingly by the link:{neo4j-docs-base-uri}/operations-manual/5/monitoring/metrics/reference/#raft-metrics[Raft metrics]**
+
+|<prefix>.causal_clustering.core.append_index
+
+|<prefix>.causal_clustering.core.commit_index
+
+|<prefix>.causal_clustering.core.applied_index
+
+|<prefix>.causal_clustering.core.term
+
+|<prefix>.causal_clustering.core.tx_retries
+
+|<prefix>.causal_clustering.core.is_leader
+
+|<prefix>.causal_clustering.core.in_flight_cache.total_bytes
+
+|<prefix>.causal_clustering.core.in_flight_cache.max_bytes
+
+|<prefix>.causal_clustering.core.in_flight_cache.element_count
+
+|<prefix>.causal_clustering.core.in_flight_cache.max_elements
+
+|<prefix>.causal_clustering.core.in_flight_cache.hits
+
+|<prefix>.causal_clustering.core.in_flight_cache.misses
+
+|<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.lag
+
+|<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.bytes
+
+|<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.size
+
+|<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.async_put
+
+|<prefix>.causal_clustering.core.raft_log_entry_prefetch_buffer.sync_put
+
+|<prefix>.causal_clustering.core.message_processing_delay
+
+|<prefix>.causal_clustering.core.message_processing_timer
+
+|<prefix>.causal_clustering.core.replication_new
+
+|<prefix>.causal_clustering.core.replication_attempt
+
+|<prefix>.causal_clustering.core.replication_fail
+
+|<prefix>.causal_clustering.core.replication_maybe
+
+|<prefix>.causal_clustering.core.replication_success
+
+|<prefix>.causal_clustering.core.last_leader_message
+
+a|**link:{neo4j-docs-base-uri}/operations-manual/5/monitoring/metrics/reference/#read-replica-metrics[Read Replica metrics] - replaced accordingly by the link:{neo4j-docs-base-uri}/operations-manual/5/monitoring/metrics/reference/#store-copy-metrics[Store copy metrics]**
+
+|<prefix>.causal_clustering.read_replica.pull_updates
+
+|<prefix>.causal_clustering.read_replica.pull_update_highest_tx_id_requested
+
+|<prefix>.causal_clustering.read_replica.pull_update_highest_tx_id_received
+
+|===
+====
+
+=== SSL framework
+
+.See the CBC-based ciphers that are no longer used from Neo4j 2025.01:
+
+* TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
+* TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
+* TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
+* TLS_DHE_RSA_WITH_AES_128_CBC_SHA256
+
+For more details, refer to the page on link:{neo4j-docs-base-uri}/operations-manual/5/security/ssl-framework/#ssl-other-configs[SSL framework] under the Security section.
+
+.Private keys
+
+Versions before Neo4j 5.0 allow keys to be stored with the old PKCS #1 standard.
+You can identify them by the line `-----BEGIN RSA PRIVATE KEY-----` at the beginning of the file.
+While Neo4j 5.0 can load and use those keys, they are considered deprecated and will be removed in a future version.
+
+
+.SSL-related configuration setting (or move it to the section 'Changed default values'?)
+
+Starting from 2025.01, the default value of `dbms.ssl.policy.*.verify_hostname` is changed from `false` to `true`.
+See details in the table link:{neo4j-docs-base-uri}/operations-manual/5/security/ssl-framework/#ssl-configuration[in the table under Configuration section on the page SSL framework].
+
+=== Ports
+
+Port `5000` is no longer used from 2025.01 onwards.
+
+=== Deprecated built-in procedures
+
+.See all deprecated procedures
+[%collapsible]
+====
+[options=header, cols="3m,1,1,3"]
+|===
+| Name
+| Community Edition
+| Enterprise Edition
+| Comment
+
+| link:{neo4j-docs-base-uri}/operations-manual/5/procedures/#procedure_dbms_quarantineDatabase[`dbms.quarantineDatabase()`] label:admin-only[]
+|
+| {check-mark}
+| Replaced by xref:procedures.adoc#procedure_dbms_unquarantineDatabase[`dbms.unquarantineDatabase()`]
+|===
+====
+
+=== Java API
+
+In 2025.01, the deprecated public API is removed.
+
+=== Neo4j configuration settings with changed default values
+
+[options=header, cols="3m,1,1"]
+|===
+| Name
+| Old default value
+| New default value
+
+|`dbms.cypher.infer_schema_parts`
+|`OFF`
+|`MOST_SELECTIVE_LABEL`
+
+|`db.logs.query.annotation_data_format`
+|`CYPHER`
+|`JSON`
+
+|`dbms.databases.seed_from_uri_providers`
+|`S3SeedProvider,CloudSeedProvider`
+|`CloudSeedProvider`
+
+|`server.metrics.csv.rotation.compression`
+|`NONE`
+|`ZIP`
+
+|`server.panic.shutdown_on_panic`
+|`false`
+|`true`
+
+|===
+
+
+=== Changed valid values of configuration settings
+
+The `server.logs.config` is changed to depend on the provided path for the _conf_ directory instead of having the _conf_ directory encoded in the default values.
+
+[options=header, cols="2m,3,3"]
+|===
+| Name
+| Old valid value
+| New valid value
+
+|`server.logs.config`
+|A path. If relative, it is resolved from `server.directories.neo4j_home`.
+|A path. If relative, it is resolved from `server.directories.configuration`.
+|===
+
+=== Renamed configuration settings
+
+`dbms.cluster.discovery.endpoints` => `dbms.cluster.endpoints`
+
+`dbms.kubernetes.service_port_name` => `dbms.kubernetes.discovery.service_port_name`
+
+[role=label--enterprise]
+=== Renamed metric 
+
+In Neo4j 2025.01, the `<prefix>.store.size.total` is renamed to `<prefix>.store.size.full` to be in line with the .
+See the table xref:monitoring/metrics/reference.adoc#db-store-size-metrics[Database store size metrics] for more details.
+
+
+

modules/ROOT/pages/clustering/servers.adoc

@@ -1,13 +1,15 @@
 :description: This section describes how to manage servers in a cluster.
+:page-role: enterprise-edition
+
 [[manage-servers]]
 = Managing servers in a cluster
 
 As described previously, server-management is completely separate from database-management in a clustered environment.
 This section describes how to work with servers in a cluster: adding and removing them, as well as altering their metadata.
 
-
 [[server-states]]
 == Server states
+
 A server can exist in five different states within the DBMS: