Migrating data to Yandex StoreDoc

To migrate your data to Yandex StoreDoc, transfer the data, write-lock the old database, and transfer the load to the target cluster in Yandex Cloud.

There are two ways to migrate data from a third-party source cluster to a Yandex StoreDoc target cluster:

• Transferring data using Yandex Data Transfer.

  This migration method allows you to:

  • Migrate the database without interrupting user service.
  • Migrate from older Yandex StoreDoc versions to newer versions.
  • Go without creating an intermediate VM or granting online access to your Yandex StoreDoc target cluster.

  To use this migration method, allow connecting to the source cluster from the internet.

  To learn more, see Problems addressed by Yandex Data Transfer.

• Migrating a database using a dump.

  A dump is a set of files using which you can restore the state of a database. To migrate data to a Yandex StoreDoc cluster, create a database dump using mongodump and restore it in the target cluster using mongorestore. To achieve a full dump, switch the source cluster to read-only before you create it.

Required paid resourcesRequired paid resources

The cost of transferring data with Yandex Data Transfer includes:

• Yandex StoreDoc target cluster fee: using computing resources allocated to hosts, and its disk space (see Yandex StoreDoc pricing).
• Fee for using public IP addresses if public access is enabled for cluster hosts (see Virtual Private Cloud pricing).
• Per-transfer fee: using computing resources and the number of transferred data rows (see Data Transfer pricing).

The cost of transferring data using a database dump includes:

• Yandex StoreDoc target cluster fee: Using computing resources allocated to hosts, and its disk space (see Yandex StoreDoc pricing).
• Fee for using public IP addresses if public access is enabled for cluster hosts (see Virtual Private Cloud pricing).
• When creating a VM to download a dump: Fee for using the computing resources, storage, OS (for specific operating systems), and, optionally, public IP address (see Compute Cloud pricing).

Getting startedGetting started

Create a Yandex StoreDoc target cluster with the computing capacity and storage size appropriate for the environment where the migrated database is deployed.

The database name in the target cluster must be the same as the source database name.

Migrating data using Yandex Data TransferMigrating data using Yandex Data Transfer

1. Prepare the source cluster.

2. Prepare the target cluster.

3. Create a source endpoint with the following parameters:

   • Database type: MongoDB

   • Endpoint parameters → Connection settings: Custom installation

     Specify the parameters for connecting to the source cluster.

   Note

   The service does not support transferring Time Series collections, so you should exclude these collections in the endpoint settings.

4. Create a target endpoint with the following parameters:

   • Database type: MongoDB

   • Endpoint parameters → Connection settings: Managed Service for MongoDB cluster

     Specify the ID of the target cluster.

5. Create a transfer of the Snapshot and increment type that will use the created endpoints.

   To make large collections (over 1 GB) copy more quickly, enable parallel copy in the transfer settings. Specify two or more workers. The collection will split into the specified number of parts that will be copied concurrently.

   For parallel copy to work, the data type in the _id field should be the same for all documents in a collection. If a transfer discovers a type mismatch, the collection will not be partitioned but transferred in a single thread instead. If needed, remove documents with mismatched data types from the collection before starting a transfer.

   Note

   If a document with a different data type is added to a collection after a transfer starts, the transfer will move it at the replication stage after the parallel copy operation is completed. However, when re-enabled, the transfer will not be able to partition a collection because the _id field's type requirement will not be met for some of the documents in the collection.

6. Activate the transfer.

7. Wait for the transfer status to change to Replicating.

8. Switch the source cluster to read-only and transfer the load to the target cluster.

9. On the transfer monitoring page, wait for the Maximum data transfer delay metric to decrease to zero. This means that all changes that occurred in the source cluster after data copying was completed are transferred to the target cluster.

10. Deactivate the transfer and wait for its status to change to Stopped.

    For more information about transfer statuses, see Transfer lifecycle.

11. Delete the stopped transfer.

12. Delete endpoints for both the source and target.

Migrating a database using a dumpMigrating a database using a dump

Sequence of actions:

1. Create a dump of the database you want to migrate using mongodump.
2. If necessary, create a VM in Compute Cloud to restore the database from a dump in the Yandex Cloud infrastructure.
3. Restore data from the dump in the cluster using mongorestore.

Create a dumpCreate a dump

You can create a database dump using mongodump. For more information about this utility, see the MongoDB documentation.

1. Install mongodump and other utilities for working with MongoDB. Example for Ubuntu 20.04 LTS:

   wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -
   echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list
   sudo apt update
   sudo apt install mongodb-org-shell mongodb-org-tools
   

   Instructions for other platforms, as well as more information about installing utilities, can be found on the Install MongoDB page.

2. Before creating a dump, we recommend switching the DBMS to "read-only" to avoid losing data that might appear while the dump is created.

3. Create a database dump:

   mongodump --host <DBMS_server_address> \
             --port <port> \
             --username <username> \
             --password "<password>" \
             --db <DB_name> \
             --out ~/db_dump
   

   If you have access to multiple processor cores to create a dump, specify the -j flag with the number of cores available to you:

   mongodump --host <DBMS_server_address> \
             --port <port> \
             --username <username> \
             --password "<password>" \
             -j <number_of_cores> \
             --db <DB_name> \
             --out ~/db_dump
   

4. Archive the dump:

   tar -cvzf db_dump.tar.gz ~/db_dump
   

(Optional) Create a VM to download a dump(Optional) Create a VM to download a dump

You will need an intermediate VM in Yandex Compute Cloud if:

• Your Yandex StoreDoc cluster is not accessible from the internet.
• Your hardware or connection to the cluster in Yandex Cloud is not very reliable.

To prepare the virtual machine to restore the dump:

1. In the management console, create a new VM from an Ubuntu 20.04 LTS image. The required amount of RAM and processor cores depends on the amount of data to migrate and the required migration speed.

   The minimum configuration (1 core, 2 GB RAM, 10 GB disk space) should be sufficient to migrate a database up to 1 GB in size. The larger the database, the more disk storage (at least twice the size of the database) and RAM you need for migration.

   The VM instance must be in the same network and availability zone as the Yandex StoreDoc cluster master host. The VM must be also assigned an external IP address so that you can upload the dump file from outside Yandex Cloud.

2. Install the MongoDB client and additional utilities for working with the DBMS:

   wget -qO - https://www.mongodb.org/static/pgp/server-4.4.asc | sudo apt-key add -
   echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list
   sudo apt update
   sudo apt install mongodb-org-shell mongodb-org-tools
   

3. Move the DB dump from your server to the VM. For example, you can use scp:

   scp ~/db_dump.tar.gz <VM_username>@<VM_public_address>:/tmp/db_dump.tar.gz
   

4. Unpack the dump on the virtual machine:

   tar -xzf /tmp/db_dump.tar.gz
   

As a result, you will get a VM with a database dump that is ready to be restored to the Yandex StoreDoc cluster.

Recover dataRecover data

Use the mongorestore utility to restore your DB dump.

• If you restore a dump from the VM in Yandex Cloud:

  mongorestore --host <DBMS_server_address> \
               --port <port> \
               --username <username> \
               --password "<password>" \
               -j <number_of_streams> \
               --authenticationDatabase <DB_name> \
               --nsInclude '*.*' /tmp/db_dump
  

• If you restore from a dump stored on a server outside Yandex Cloud, SSL parameters must be explicitly set for mongorestore:

  mongorestore --host <DBMS_server_address> \
               --port <port> \
               --ssl \
               --sslCAFile <certificate_file_path> \
               --username <username> \
               --password "<password>" \
               -j <number_of_streams> \
               --authenticationDatabase <DB_name> \
               --nsInclude '*.*' ~/db_dump
  

• If you want to transfer specific collections, set the --nsInclude and --nsExclude flags, specifying the namespaces to include or exclude for the collections to restore.