All Products
Search

This Product

    ApsaraDB for MongoDB:Upgrade versi utama database

    Document Center

    ApsaraDB for MongoDB:Upgrade versi utama database

    Last Updated:Sep 10, 2026

    Topik ini menjelaskan jalur peningkatan versi utama yang didukung untuk instans ApsaraDB for MongoDB dan prosedur peningkatannya. Saat Anda melakukan upgrade versi utama, sistem secara otomatis meningkatkan ke versi minor terbaru yang tersedia dalam versi utama tersebut.

    Hal-hal yang Perlu Diperhatikan

    • Persyaratan protokol: Untuk meng-upgrade versi utama instans kluster sharded, instans tersebut harus menggunakan MongoDB Protocol.

    • Disk space: Sebelum upgrade versi utama database, kami menyarankan agar penggunaan disk instans tidak melebihi 90%. Proses upgrade menulis file sementara. Jika ruang disk yang tersedia tidak mencukupi—misalnya kurang dari 20% dari total kapasitas disk—upgrade dapat gagal atau menyebabkan kegagalan instans. Jika ruang disk yang tersedia tidak memenuhi persyaratan, lakukan scale up disk terlebih dahulu. Mulai proses upgrade hanya setelah ruang disk yang tersedia mencapai minimal 20% dari total kapasitas disk.

    • Proses dan dampak upgrade:

      • Restart otomatis: Upgrade dilakukan secara rolling dan secara otomatis me-restart instans dua hingga tiga kali. Kami menyarankan untuk melakukan upgrade selama jam sepi dan memastikan aplikasi Anda memiliki mekanisme reconnect.

      • Dampak kinerja: Mulai dari MongoDB 5.0, writeConcern default berubah dari {w:1} menjadi {w:majority}. Jika Anda meng-upgrade versi utama instans dari 4.4 ke 5.0, Anda mungkin mengalami penurunan signifikan pada kinerja write.

        Catatan

        • Untuk upgrade multi-versi, seperti dari v3.0 ke v4.2, sistem melakukan upgrade secara berurutan melalui setiap versi antara. Terjadi disconnection sementara setelah setiap peningkatan versi.

        • Kami menyarankan agar aplikasi di lingkungan produksi terhubung ke database menggunakan Connection String URI.

          Menggunakan Connection String URI untuk terhubung ke instans memastikan node yang terhubung selalu merupakan node primary. Hal ini mencegah operasi baca-tulis aplikasi Anda terpengaruh oleh failover. Untuk informasi lebih lanjut tentang cara terhubung ke database menggunakan Connection String URI, lihat Connect to a replica set instance atau Connect to a sharded cluster instance.

    • Status balancer: Selama upgrade instans kluster sharded, balancer dinonaktifkan dan kemudian diaktifkan kembali setelah upgrade selesai.

    • Downgrade versi: Anda tidak dapat menurunkan spesifikasi versi utama setelah upgrade.

    • Backup dan pemulihan: Setelah Anda meng-upgrade versi utama database, Anda tidak dapat memulihkan data ke instans ApsaraDB for MongoDB dari backup versi utama sebelumnya. Anda dapat mengunduh file backup dan memulihkan data tersebut ke database yang dikelola sendiri. Untuk informasi lebih lanjut tentang cara memulihkan data backup ke database yang dikelola sendiri, lihat Restore data from a cloud disk backup atau Restore data from a local disk backup.

    • Durasi upgrade: Durasi upgrade bergantung pada faktor-faktor seperti volume data, jumlah database dan tabel, serta rentang versi. Perkiraan berikut hanya sebagai referensi, karena waktu aktual dapat bervariasi.

      • Instans dengan cloud disk: Sekitar 15 menit.

      • Instans dengan local disk: Untuk upgrade ke versi adjacent, proses upgrade memakan waktu beberapa menit, mirip dengan restart instans.

      • Upgrade versi adjacent, seperti dari MongoDB 3.4 ke MongoDB 4.0, biasanya memakan waktu 1 hingga 5 menit. Proses ini memicu dua hingga tiga restart, dan setiap restart menyebabkan disconnection sementara sekitar 30 detik. Durasi tidak berkaitan dengan penggunaan disk. Lakukan upgrade selama jam sepi dan pastikan aplikasi memiliki mekanisme reconnect.

    Jalur upgrade yang didukung

    • Anda dapat meng-upgrade versi utama database di ApsaraDB for MongoDB console. Namun, versi target yang tersedia bervariasi berdasarkan arsitektur instans, tipe instans, dan versi saat ini. Detailnya adalah sebagai berikut:

      Architecture

      Instance type

      Current major version

      Available upgrade versions

      Standalone architecture

      General-purpose with cloud disk

      MongoDB 4.0

      No higher major version is available for upgrade.

      General-purpose with cloud disk

      MongoDB 3.4

      Supports upgrade to MongoDB 4.0.

      Replica set architecture

      • General-purpose with cloud disk

      • Dedicated with cloud disk

      MongoDB 8.0

      MongoDB 8.3

      MongoDB 7.0

      MongoDB 8.0

      MongoDB 6.0

      MongoDB 7.0

      MongoDB 5.0

      MongoDB 6.0

      MongoDB 4.4

      MongoDB 5.0

      When you upgrade an instance from v4.4 to v5.0, the default writeConcern changes from {w:1} to {w:majority}. This may cause a decrease in write performance and an increase in write latency. Confirm this impact is acceptable before you upgrade.

      • General-purpose with local disk

      • Dedicated with local disk

      • Dedicated Physical Server

      MongoDB 4.2

      In-place upgrade is not supported.

      To upgrade the major version, you can create a new instance and use it to replace the original instance.

      MongoDB 4.0

      MongoDB 4.2

      MongoDB 3.4

      • MongoDB 4.0

      • MongoDB 4.2

      MongoDB 3.2

      MongoDB 3.0

      Sharded cluster architecture

      Dedicated with cloud disk

      MongoDB 8.0

      MongoDB 8.3 (Submit a ticket to apply)

      MongoDB 7.0

      MongoDB 8.0

      MongoDB 6.0

      MongoDB 7.0

      MongoDB 5.0

      MongoDB 6.0

      MongoDB 4.4

      MongoDB 5.0

      When you upgrade an instance from v4.4 to v5.0, the default writeConcern changes from {w:1} to {w:majority}. This may cause a decrease in write performance and an increase in write latency. Confirm this impact is acceptable before you upgrade.

      • General-purpose with local disk

      • Dedicated with local disk

      • Dedicated Physical Server

      MongoDB 4.2

      In-place upgrade is not supported.

      To upgrade the major version, you can create a new instance and use it to replace the original instance.

      MongoDB 4.0

      MongoDB 4.2

      MongoDB 3.4

      • MongoDB 4.0

      • MongoDB 4.2

      MongoDB 3.2

      MongoDB 3.0

    • Jika Anda perlu meng-upgrade versi utama lintas arsitektur atau tipe penyimpanan yang berbeda, pertama-tama buat instans dengan versi utama target, lalu gunakan Data Transmission Service (DTS) untuk migrasi data dari sumber ke instans baru tersebut.

      Lihat topik berikut untuk instruksi migrasi data:

    Tes kompatibilitas

    Sebelum meng-upgrade versi utama, lakukan tes kompatibilitas.

    • Tes upgrade versi utama database tidak dipengaruhi oleh apakah instans menggunakan zona tunggal atau multi-zona. Instans uji hanya perlu memiliki wilayah, VPC, dan spesifikasi instans yang sama dengan instans yang akan di-upgrade.

    • Periksa kompatibilitas driver client sebelum upgrade. Misalnya, saat Anda meng-upgrade dari MongoDB 3.4 ke MongoDB 4.0 dan menggunakan konfigurasi koneksi Spring XML, kami menyarankan agar Anda meng-upgrade driver ke versi 4.11.2. Anda dapat mempertahankan pengaturan parameter yang ada seperti replica-set, socket-timeout, dan lainnya. Jika Anda masih menggunakan driver versi lama seperti 3.3, upgrade ke versi 3.6 atau lebih baru untuk memastikan dukungan penuh terhadap fitur-fitur baru.

    1. Tinjau catatan rilis untuk setiap versi utama dalam jalur upgrade Anda dan perbarui kode client Anda untuk memastikan kompatibilitas.

    2. (Opsional) Gunakan pemulihan data untuk menguji kompatibilitas versi utama.

      Penting

      Pemulihan data menimbulkan biaya tambahan.

      1. Gunakan data restoration untuk membuat instans baru dengan versi utama yang sama dengan instans saat ini.

      2. Upgrade versi utama instans baru tersebut.

      3. Uji client yang telah diperbarui terhadap instans baru untuk memeriksa adanya masalah kompatibilitas.

        Jika muncul masalah kompatibilitas, gunakan pesan error untuk debugging dan modifikasi kode client Anda.

      4. Setelah pengujian selesai, release instans baru tersebut.

    Prosedur

    1. Masuk ke ApsaraDB for MongoDB console.

    2. Di panel navigasi sebelah kiri, klik Replica Set Instances atau Sharded Cluster Instances sesuai arsitektur instans.

    3. Di pojok kiri atas halaman, pilih kelompok sumber daya dan wilayah tempat instans Anda berada.

    4. Klik ID instans target, atau klik Manage di kolom Actions untuk instans tersebut.

    5. Di bagian Specification Information, arahkan kursor ke Upgrade Database Version dan klik versi utama target.

    6. Di kotak dialog Upgrade Database Version, klik Confirm.

    Catatan

    Setelah upgrade selesai, jika konsol masih menampilkan bahwa upgrade sedang berlangsung, refresh halaman browser Anda untuk melihat status terbaru.