Skip to content

Commit 3209980

Browse files
committed
descirbe semi-automated procedure
1 parent 73f21da commit 3209980

File tree

1 file changed

+21
-0
lines changed

1 file changed

+21
-0
lines changed

modules/ROOT/pages/clustering/setup/discovery.adoc

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -558,6 +558,27 @@ As such, ensure that `dbms.cluster.discovery.version=V2_ONLY`, and that `dbms.cl
558558
are set as required, so that the servers start with v2 running on the next restart.
559559
====
560560

561+
[[discovery-v1-to-v2-semi-automated-procedure]]
562+
=== Semi-automated procedure
563+
564+
Another way to migrate from Discovery Service `V1` to `V2` is to use a semi-automated procedure, which simplifies the migration process
565+
It automates the approach described in the xref:clustering/setup/discovery.adoc#_using_procedures[previous section].
566+
567+
. Make sure that server side routing is enabled as detailed in xref:https://neo4j.com/docs/operations-manual/current/clustering/setup/routing/#clustering-routing[Server-side routing] section
568+
. For all the servers, ensure that new settings are updated to the configuration as detailed the xref:clustering/setup/discovery.adoc#_preparation[Preparation] section.
569+
. Connect to any server using server-side routing
570+
+
571+
[source,cypher]
572+
----
573+
./cypher-shell -a neo4j://localhost:7691 -d system
574+
----
575+
. Run the following procedure three times to move all members from `V1_ONLY` to `V2_ONLY`. If the procedure fails, read the error message and resolve the issue manually.
576+
One possible reason for failure is that some members might have had inconsistent `dbms.cluster.discovery.version` settings initially.
577+
Refer to the previous section for guidance on debugging and fixing issues.
578+
[source,cypher]
579+
----
580+
CALL internal.dbms.cluster.moveToNextDiscoveryVersion();
581+
----
561582

562583

563584
== Monitoring the progress and metrics

0 commit comments

Comments
 (0)