From 1bca4d5b9051fd6f67979c6616be741a27b75322 Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Wed, 22 Jan 2025 15:29:13 +0000 Subject: [PATCH 1/2] Update the Migrate config page --- .../neo4j-admin/migrate-configuration.adoc | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/modules/ROOT/pages/tools/neo4j-admin/migrate-configuration.adoc b/modules/ROOT/pages/tools/neo4j-admin/migrate-configuration.adoc index 481c39057..c1a77e2ce 100644 --- a/modules/ROOT/pages/tools/neo4j-admin/migrate-configuration.adoc +++ b/modules/ROOT/pages/tools/neo4j-admin/migrate-configuration.adoc @@ -5,6 +5,7 @@ You can use the `migrate-configuration` command to migrate a legacy Neo4j configuration file to the current format. The new version will be written in a target configuration directory. The default location for both the source and target configuration directory is the configuration directory specified by `NEO_CONF` or the default configuration directory for this installation. +Starting with Neo4j 2025.01, the root location of the configuration directory is xref:configuration/configuration-settings.adoc#_server_directories_settings.adoc#config_server.directories.configuration[`server.directories.configuration=conf`]. If the source and target directories are the same, the original configuration files will be renamed. A configuration provided using `--additional-config` option will not be migrated. @@ -57,16 +58,16 @@ The following example shows how to migrate a legacy configuration file to the cu [source, shell, subs="attributes+"] ---- -bin/neo4j-admin server migrate-configuration --from-path=/path/to/legacy/neo4j-enterprise-4.4.10/conf/ --to-path=/path/to/new/neo4j-enterprise-{neo4j-version-exact}/conf/ +bin/neo4j-admin server migrate-configuration --from-path=/path/to/legacy/neo4j-enterprise-4.4.39/conf/ --to-path=/path/to/new/neo4j-enterprise-{neo4j-version-exact}/conf/ ---- .Example output [result] ---- -Keeping original user-logs.xml file at: /neo4j-enterprise-5.1.0/conf/user-logs.xml.old -User logging configuration xml file generated: /neo4j-enterprise-5.1.0/conf/user-logs.xml -Keeping original server-logs.xml file at: /neo4j-enterprise-5.1.0/conf/server-logs.xml.old -Server logging configuration xml file generated: /neo4j-enterprise-5.1.0/conf/server-logs.xml +Keeping original user-logs.xml file at: /neo4j-enterprise-2025.1.0/conf/user-logs.xml.old +User logging configuration xml file generated: /neo4j-enterprise-2025.1.0/conf/user-logs.xml +Keeping original server-logs.xml file at: /neo4j-enterprise-2025.1.0/conf/server-logs.xml.old +Server logging configuration xml file generated: /neo4j-enterprise-2025.1.0/conf/server-logs.xml dbms.directories.import=import MIGRATED -> server.directories.import=import dbms.connector.bolt.enabled=true MIGRATED -> server.bolt.enabled=true dbms.connector.http.enabled=true MIGRATED -> server.http.enabled=true @@ -89,12 +90,12 @@ dbms.jvm.additional=-XX:+UnlockDiagnosticVMOptions MIGRATED -> server.jvm.additi dbms.jvm.additional=-XX:+DebugNonSafepoints MIGRATED -> server.jvm.additional=-XX:+DebugNonSafepoints dbms.jvm.additional=-Dlog4j2.disable.jmx=true MIGRATED -> server.jvm.additional=-Dlog4j2.disable.jmx=true dbms.windows_service_name=neo4j MIGRATED -> server.windows_service_name=neo4j -Keeping original configuration file at: /neo4j-enterprise-5.1.0/conf/neo4j.conf.old +Keeping original configuration file at: /neo4j-enterprise-2025.1.0/conf/neo4j.conf.old ---- [NOTE] ==== -The example output is not to be used to populate a new Neo4j 5 _neo4j.conf_ file. +The example output is not to be used to populate a new Neo4j 2025.01 _neo4j.conf_ file. -The 5.x syntactically correct configuration file can be found at _/path/to/new/neo4j-enterprise-{neo4j-version-exact}/conf/_, where `/path/to/new/neo4j-enterprise-{neo4j-version-exact}/conf/` is the value of `--to-path=`. +The 2025.01 syntactically correct configuration file can be found at _/path/to/new/neo4j-enterprise-{neo4j-version-exact}/conf/_, where `/path/to/new/neo4j-enterprise-{neo4j-version-exact}/conf/` is the value of `--to-path=`. ==== From 8d591f043cf7b30f2d151f7f3310796e347c3c2c Mon Sep 17 00:00:00 2001 From: Reneta Popova Date: Thu, 23 Jan 2025 11:36:01 +0000 Subject: [PATCH 2/2] add the correct output --- .../neo4j-admin/migrate-configuration.adoc | 23 +++++++++++-------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/modules/ROOT/pages/tools/neo4j-admin/migrate-configuration.adoc b/modules/ROOT/pages/tools/neo4j-admin/migrate-configuration.adoc index c1a77e2ce..dfc234c6d 100644 --- a/modules/ROOT/pages/tools/neo4j-admin/migrate-configuration.adoc +++ b/modules/ROOT/pages/tools/neo4j-admin/migrate-configuration.adoc @@ -58,21 +58,23 @@ The following example shows how to migrate a legacy configuration file to the cu [source, shell, subs="attributes+"] ---- -bin/neo4j-admin server migrate-configuration --from-path=/path/to/legacy/neo4j-enterprise-4.4.39/conf/ --to-path=/path/to/new/neo4j-enterprise-{neo4j-version-exact}/conf/ +bin/neo4j-admin server migrate-configuration --from-path=/path/to/legacy/neo4j-enterprise-4.4.39/conf/ --to-path=/path/to/new/neo4j-enterprise-2025.01.0/conf/ ---- .Example output -[result] +[source] ---- -Keeping original user-logs.xml file at: /neo4j-enterprise-2025.1.0/conf/user-logs.xml.old -User logging configuration xml file generated: /neo4j-enterprise-2025.1.0/conf/user-logs.xml -Keeping original server-logs.xml file at: /neo4j-enterprise-2025.1.0/conf/server-logs.xml.old -Server logging configuration xml file generated: /neo4j-enterprise-2025.1.0/conf/server-logs.xml +Keeping original user-logs.xml file at: /path/to/new/neo4j-enterprise-2025.01.0/conf/user-logs.xml.old +User logging configuration xml file generated: /path/to/new/neo4j-enterprise-2025.01.0/conf/user-logs.xml +Keeping original server-logs.xml file at: /path/to/new/neo4j-enterprise-2025.01.0/conf/server-logs.xml.old +Server logging configuration xml file generated: /path/to/new/neo4j-enterprise-2025.01.0/conf/server-logs.xml dbms.directories.import=import MIGRATED -> server.directories.import=import +dbms.tx_state.memory_allocation=ON_HEAP REMOVED dbms.connector.bolt.enabled=true MIGRATED -> server.bolt.enabled=true dbms.connector.http.enabled=true MIGRATED -> server.http.enabled=true dbms.connector.https.enabled=false MIGRATED -> server.https.enabled=false metrics.csv.rotation.compression=zip MIGRATED -> server.metrics.csv.rotation.compression=zip +dbms.jvm.additional=-XX:-UseBiasedLocking REMOVED dbms.jvm.additional=-XX:+UseG1GC MIGRATED -> server.jvm.additional=-XX:+UseG1GC dbms.jvm.additional=-XX:-OmitStackTraceInFastThrow MIGRATED -> server.jvm.additional=-XX:-OmitStackTraceInFastThrow dbms.jvm.additional=-XX:+AlwaysPreTouch MIGRATED -> server.jvm.additional=-XX:+AlwaysPreTouch @@ -80,7 +82,6 @@ dbms.jvm.additional=-XX:+UnlockExperimentalVMOptions MIGRATED -> server.jvm.addi dbms.jvm.additional=-XX:+TrustFinalNonStaticFields MIGRATED -> server.jvm.additional=-XX:+TrustFinalNonStaticFields dbms.jvm.additional=-XX:+DisableExplicitGC MIGRATED -> server.jvm.additional=-XX:+DisableExplicitGC dbms.jvm.additional=-XX:MaxInlineLevel=15 MIGRATED -> server.jvm.additional=-XX:MaxInlineLevel=15 -dbms.jvm.additional=-XX:-UseBiasedLocking MIGRATED -> server.jvm.additional=-XX:-UseBiasedLocking dbms.jvm.additional=-Djdk.nio.maxCachedBufferSize=262144 MIGRATED -> server.jvm.additional=-Djdk.nio.maxCachedBufferSize=262144 dbms.jvm.additional=-Dio.netty.tryReflectionSetAccessible=true MIGRATED -> server.jvm.additional=-Dio.netty.tryReflectionSetAccessible=true dbms.jvm.additional=-Djdk.tls.ephemeralDHKeySize=2048 MIGRATED -> server.jvm.additional=-Djdk.tls.ephemeralDHKeySize=2048 @@ -90,12 +91,16 @@ dbms.jvm.additional=-XX:+UnlockDiagnosticVMOptions MIGRATED -> server.jvm.additi dbms.jvm.additional=-XX:+DebugNonSafepoints MIGRATED -> server.jvm.additional=-XX:+DebugNonSafepoints dbms.jvm.additional=-Dlog4j2.disable.jmx=true MIGRATED -> server.jvm.additional=-Dlog4j2.disable.jmx=true dbms.windows_service_name=neo4j MIGRATED -> server.windows_service_name=neo4j -Keeping original configuration file at: /neo4j-enterprise-2025.1.0/conf/neo4j.conf.old +server.jvm.additional=--add-opens=java.base/java.nio=ALL-UNNAMED RECOMMENDED +server.jvm.additional=--add-opens=java.base/java.io=ALL-UNNAMED RECOMMENDED +server.jvm.additional=--add-opens=java.base/sun.nio.ch=ALL-UNNAMED RECOMMENDED +server.jvm.additional=--enable-native-access=ALL-UNNAMED RECOMMENDED +Keeping original configuration file at: /path/to/new/neo4j-enterprise-2025.01.0/conf/neo4j.conf.old ---- [NOTE] ==== The example output is not to be used to populate a new Neo4j 2025.01 _neo4j.conf_ file. -The 2025.01 syntactically correct configuration file can be found at _/path/to/new/neo4j-enterprise-{neo4j-version-exact}/conf/_, where `/path/to/new/neo4j-enterprise-{neo4j-version-exact}/conf/` is the value of `--to-path=`. +The 2025.01 syntactically correct configuration file can be found at _/path/to/new/neo4j-enterprise-2025.01.0/conf/_, where `/path/to/new/neo4j-enterprise-2025.01.0/conf/` is the value of `--to-path=`. ====