diff --git a/modules/ROOT/pages/managing-instances/instance-actions.adoc b/modules/ROOT/pages/managing-instances/instance-actions.adoc index 82d0ef127..465a70189 100644 --- a/modules/ROOT/pages/managing-instances/instance-actions.adoc +++ b/modules/ROOT/pages/managing-instances/instance-actions.adoc @@ -171,54 +171,60 @@ See xref:managing-instances/backup-restore-export.adoc[Backup, export, restore, == Clone an instance -You can clone an existing instance to create a new instance with the same data. -You can clone across regions, and from Neo4j version 4 to Neo4j latest version. - -There are two options to clone an instance: - -* Clone to a new instance -* Clone to an existing instance - -You can access all the cloning options from the more menu *[...]* on the instance. +You can clone data from an Aura instance to another existing instance or a new instance. [NOTE] ==== -You cannot clone from a Neo4j latest version instance to a Neo4j version 4 instance. +You can move your data to a new region by cloning to a new instance and selecting the required options under *Cloud provider & region*. ==== -== Clone to a new instance +Note that you have to use the Aura console to clone, it is not supported via Aura API. + +The time it takes depends on the amount of data (and factors such as number of indexes and constraints, or the capacity of the destination instance). -. From the more menu (*...*) on the instance you want to clone, select *Clone to* and then *New instance*. -. Set your desired settings for the new instance. -For more information see xref:getting-started/create-instance.adoc[Create an instance]. -. Check the *I accept* box and select *Create*. +You can clone from a Neo4j version 4 instance to an instance running the latest Neo4j version. +You cannot clone from latest Neo4j version to Neo4j version 4. +=== Clone to a new instance + +Cloning to a new instance creates a new destination instance containing a duplicate of the source instance data. + +. From the more menu *[...]* on the source instance select *Clone to* > *New instance.* +. Configure the new instance including the required options under *Cloud provider & region* and confirm with *Create instance*. +For more information, see xref:getting-started/create-instance/[Create an instance]. +. Save the credentials in a safe place and *Continue*. [WARNING] ==== -Make sure that the username and password are stored safely before continuing. -Credentials cannot be recovered afterwards. +Store the username and password securely. +The credentials cannot be recovered. ==== -== Clone to an existing instance +The destination instance progresses through states, including *Overwriting* and *Loading*. +When cloning is complete, the status changes to *Running* and it is ready to use. + +=== Clone to an existing instance -When you clone an instance to an existing instance, the database connection URI stays the same, but the data is replaced with the data from the cloned instance. +The destination instance can be empty or contain data. [WARNING] ==== -Cloning into an existing instance will replace all existing data. +Any data in the destination instance will be overwritten by the source data during cloning. If you want to keep the current data, take a snapshot and export it. ==== -. From the more menu (*...*) on the instance you want to clone, select *Clone to* and then *Existing instance*. -. Select the existing AuraDB instance to clone to from the dropdown menu. -+ -[NOTE] -==== -Existing instances that are not large enough to clone into will not be available for selection. -==== -+ -. Check the *I understand the target instance will be overwritten* box and select *Clone*. +The destination instance connection URI and credentials are not affected. + +Only instances with enough capacity for the cloned data are available for selection. + +. From the more menu *[...]* on the source instance, select *Clone to* > *Existing instance*. +. Select the target AuraDB instance. +. Select the *I understand the target instance will be overwritten* checkbox. +. Select *Clone*. + +When all the steps are completed, the instance will show a *Running* state and is ready to be used. + +If you want to export your RBAC settings, see the tutorial at https://neo4j.com/docs/aura/tutorials/upgrade/#_recreate_users_and_roles_in_neo4j_aura[recreate users and roles in Neo4j Aura]. == Upgrade an instance diff --git a/package-lock.json b/package-lock.json index 7ee49a309..39448b479 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1287,9 +1287,9 @@ } }, "node_modules/fast-copy": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/fast-copy/-/fast-copy-3.0.2.tgz", - "integrity": "sha512-dl0O9Vhju8IrcLndv2eU4ldt1ftXMqqfgN4H1cpmGV7P6jeB9FwpN9a2c8DPGE1Ys88rNUJVYDHq73CGAGOPfQ==", + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/fast-copy/-/fast-copy-3.1.0.tgz", + "integrity": "sha512-IuCOCDFM1F/s4LtG7Bjr3yUUwPHybyhqN74xk2cMYoP51vVeErMy8+6HGFchi/+45lW8uzhs6lBeEqks2GWt6A==", "license": "MIT" }, "node_modules/fast-fifo": { @@ -1330,9 +1330,9 @@ "license": "MIT" }, "node_modules/fastq": { - "version": "1.20.1", - "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz", - "integrity": "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==", + "version": "1.20.3", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.3.tgz", + "integrity": "sha512-XKv5nnLs6nLF71NgiKJLIZFLkPyIEuOselLG7ujZnGrRfQK8HpvY+WqKhAJUAdLomwVHErVS4LfxFlPq0/FTAw==", "license": "ISC", "dependencies": { "reusify": "^1.0.4" @@ -2375,9 +2375,9 @@ } }, "node_modules/qs": { - "version": "6.15.3", - "resolved": "https://registry.npmjs.org/qs/-/qs-6.15.3.tgz", - "integrity": "sha512-O9gl3zCl5h5blw1KGUzQKhA5oUXSl8rwUIM5o0S3nCXMliSvy5Dzx7/DJcI+SwgICv+IneSZwhBh1oSyEHA71A==", + "version": "6.16.0", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.16.0.tgz", + "integrity": "sha512-h6fhOIaRrID2CbEY2fqs+7t+UXZo+MLAnU5gRIq85uFtdiUPCdsApMlHhXogKVM4HM2DVbIjGNTTYH2OcmP1vA==", "dev": true, "license": "BSD-3-Clause", "dependencies": {