Migrasi database yang dikelola sendiri ke instans mandiri menggunakan alat MongoDB - ApsaraDB for MongoDB

Gunakan alat-alat berikut untuk memigrasikan database MongoDB yang dikelola sendiri dari server on-premises atau instance ECS ke instance ApsaraDB for MongoDB.

Untuk migrasi tanpa downtime dari database MongoDB mandiri yang dikelola sendiri ke cloud, gunakan Data Transmission Service (DTS). Untuk informasi selengkapnya, lihat Migrasi penuh dari ApsaraDB for MongoDB (arsitektur mandiri) ke ApsaraDB for MongoDB (semua arsitektur).

Untuk informasi tentang solusi skenario migrasi atau sinkronisasi data lainnya, lihat Migrasi dan sinkronisasi data.

Prasyarat

Pastikan versi alat mongodump dan mongorestore sesuai dengan versi database MongoDB yang dikelola sendiri Anda. Untuk petunjuk instalasi, lihat dokumentasi resmi Install MongoDB.

Catatan
Sebagai alternatif, Anda dapat menjalankan perintah mongodump dan mongorestore di server yang menghosting database yang dikelola sendiri tanpa menginstalnya secara terpisah.
Untuk memastikan kompatibilitas, database MongoDB yang dikelola sendiri Anda harus menggunakan versi 3.0 atau lebih baru.

Catatan
Untuk informasi tentang mesin penyimpanan yang didukung oleh ApsaraDB for MongoDB, lihat Versi dan mesin penyimpanan. Jika Anda melakukan migrasi antarversi atau antarmesin penyimpanan yang berbeda, pastikan kompatibilitasnya sebelum memulai.
Instans mandiri tujuan harus memiliki kapasitas penyimpanan yang lebih besar daripada ruang yang digunakan oleh database yang dikelola sendiri. Jika kapasitas penyimpanan tidak mencukupi, Anda dapat menambahkannya. Untuk informasi selengkapnya, lihat Ubah konfigurasi instans.

Catatan penggunaan

Proses ini melakukan migrasi data penuh. Untuk memastikan konsistensi data, hentikan semua layanan terkait dan operasi tulis pada database yang dikelola sendiri sebelum memulai migrasi.
Jika Anda sebelumnya telah melakukan backup database menggunakan perintah mongodump, pindahkan file backup dari folder dump ke direktori lain dan pastikan folder dump kosong. Jika tidak, file backup yang ada akan ditimpa.
Jalankan perintah mongodump dan mongorestore di server yang menghosting database MongoDB yang dikelola sendiri, bukan dari dalam lingkungan mongo shell.

Langkah 1: Backup database yang dikelola sendiri

Di server yang menghosting database yang dikelola sendiri, jalankan perintah berikut untuk melakukan backup semua database.
```
mongodump --host <mongodb_host> --port <port>  -u <username>  --authenticationDatabase  <database>
```
Catatan
- <mongodb_host>: Alamat server database MongoDB yang dikelola sendiri Anda. Anda dapat menggunakan 127.0.0.1 jika menjalankan perintah di server database.
- <port>: Nomor port layanan database. Nilai default-nya adalah 27017.
- <username>: Akun untuk database yang dikelola sendiri, misalnya test.
- <database>: Database otentikasi tempat akun pengguna tersebut berada.
Contoh:
```
mongodump --host 127.0.0.1 --port 27017 -u test --authenticationDatabase admin
```
Saat CLI menampilkan prompt Enter password:, masukkan password akun database dan tekan Enter untuk memulai backup.

Catatan
Karakter password disembunyikan saat Anda memasukkannya.

Setelah backup selesai, data dari database yang dikelola sendiri disimpan ke folder dump di direktori saat ini.

Langkah 2: Migrasi data ke Alibaba Cloud

Dapatkan titik akhir node primary dari instance ApsaraDB for MongoDB.

Masuk ke Konsol ApsaraDB for MongoDB.
Di pojok kiri atas halaman, pilih wilayah tempat instans berada.
Di panel navigasi sebelah kiri, klik Replica Set Instances.
Temukan instans target dan klik ID instans tersebut.

Di panel navigasi sebelah kiri, klik Database Connections untuk melihat detail koneksi.

Di halaman informasi koneksi, bagian VPC dan koneksi publik menampilkan titik akhir untuk node primary (misalnya, dds-<instanceID>.mongodb.rds.aliyuncs.com:3717, dengan titik akhir publik mencantumkan akhiran -pub) dan ConnectionStringURI (misalnya, mongodb://root:****@<endpoint>/admin). Gunakan titik akhir node primary untuk migrasi.

Tabel 1. Titik akhir koneksi
Jenis titik akhir	Deskripsi	Skenario
VPC endpoint	Virtual Private Cloud (VPC) adalah lingkungan jaringan terisolasi yang menyediakan keamanan dan performa lebih tinggi dibandingkan jaringan klasik.	Gunakan ini ketika database MongoDB yang dikelola sendiri Anda dideploy di Instance ECS. Catatan Instance ECS dan instance ApsaraDB for MongoDB harus berada di wilayah dan VPC yang sama.
public endpoint	Karena alasan keamanan, titik akhir publik tidak diaktifkan secara default. Anda harus mengajukan permohonan terlebih dahulu. Untuk informasi selengkapnya, lihat Ajukan titik akhir publik.	Gunakan ini ketika database MongoDB yang dikelola sendiri Anda dideploy di server on-premises.

Tambahkan alamat IP server database yang dikelola sendiri ke daftar putih instance ApsaraDB for MongoDB. Untuk informasi selengkapnya, lihat Konfigurasi daftar putih.
Catatan
- Jika Anda terhubung ke instance ApsaraDB for MongoDB melalui VPC, tambahkan alamat IP pribadi instance ECS yang menghosting database yang dikelola sendiri ke daftar putih.
- Jika Anda terhubung ke instance ApsaraDB for MongoDB menggunakan titik akhir publik, tambahkan alamat IP publik server on-premises yang menghosting database yang dikelola sendiri ke daftar putih.
Di server yang menghosting database yang dikelola sendiri, jalankan perintah berikut untuk memulihkan data ke instance ApsaraDB for MongoDB.
```
mongorestore --host <Primary_host>  -u <username> --authenticationDatabase <database> <Backup directory>
```
Catatan
- <Primary_host>: Titik akhir node primary untuk instance ApsaraDB for MongoDB Anda.
- <username>: Akun database untuk instance ApsaraDB for MongoDB. Akun awal adalah root.
- <database>: Database otentikasi. Jika Anda menggunakan akun root, database ini adalah admin.
- <Backup directory>: Direktori tempat file backup disimpan. Direktori default-nya adalah dump.
Contoh:

Akun database adalah test, dan database otentikasinya adalah admin.
```
mongorestore --host dds-bp19f409d7512****-pub.mongodb.rds.aliyuncs.com:3717 -u test --authenticationDatabase admin dump
```
Saat CLI menampilkan prompt Enter password:, masukkan password akun database ApsaraDB for MongoDB dan tekan Enter. Proses pemulihan data dimulai.
Catatan
- Karakter password disembunyikan saat Anda memasukkannya.
- Jika Anda lupa password akun root, Anda dapat mengaturnya ulang. Untuk informasi selengkapnya, lihat Atur ulang password.

Setelah migrasi data selesai, alihkan layanan Anda ke instance ApsaraDB for MongoDB saat siap.

Langkah selanjutnya

Setelah migrasi database selesai, hubungkan ke instance ApsaraDB for MongoDB untuk mengelola database dan akun.