ApsaraDB for MongoDB：Upgrade versi utama database

Tindakan Pencegahan

• Persyaratan protokol: Untuk melakukan upgrade versi utama database pada instans kluster sharded, Protocol Type instans tersebut harus berupa MongoDB Protocol.

• Metode upgrade dan dampaknya:

  • Restart otomatis:
    Upgrade dilakukan secara berurutan pada setiap node. Selama proses upgrade, instans akan direstart secara otomatis sebanyak 2–3 kali. Lakukan upgrade pada jam sepi dan pastikan aplikasi Anda memiliki mekanisme reconnect.

  • Dampak performa (MongoDB 4.4 → 5.0):
    Mulai MongoDB 5.0, write concern default berubah dari {w:1} menjadi {w:majority}. Jika Anda melakukan upgrade dari versi 4.4 ke 5.0, Anda mungkin mengalami peningkatan latency write, penurunan throughput write, dan replikasi lag yang lebih tinggi pada beban kerja dengan aktivitas write yang intensif.

    Catatan

    • Saat Anda melakukan upgrade lintas versi utama, sistem akan melakukan upgrade secara bertahap. Misalnya, untuk upgrade dari versi 3.0 ke 4.2, sistem akan melalui setiap versi perantara alih-alih langsung ke 4.2. Setiap upgrade bertahap menyebabkan disconnection sementara.

    • Hubungkan aplikasi di lingkungan produksi Anda ke database menggunakan ConnectionStringURI.

      Penggunaan ConnectionStringURI memastikan bahwa aplikasi selalu terhubung ke node primary. Hal ini mencegah gangguan akibat pergantian primary/secondary terhadap operasi baca dan tulis aplikasi. Untuk informasi lebih lanjut tentang cara menghubungkan ke database menggunakan ConnectionStringURI, lihat Connect to a replica set instance atau Connect to a sharded cluster instance.

• Status balancer: Untuk kluster sharded, balancer secara otomatis dinonaktifkan selama upgrade dan diaktifkan kembali setelah proses selesai.

• Rollback versi: Upgrade versi utama tidak dapat dikembalikan. Setelah Anda melakukan upgrade versi utama database, Anda tidak dapat menurunkan spesifikasi versinya.

• Kompatibilitas backup: Setelah upgrade versi utama, Anda tidak dapat memulihkan backup dari versi sebelumnya ke instans ApsaraDB for MongoDB. Anda dapat mengunduh file backup tersebut dan memulihkan datanya 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: Waktu yang dibutuhkan untuk upgrade bergantung pada faktor-faktor seperti volume data, jumlah database dan koleksi, serta rentang versi. Durasi aktual dapat bervariasi.

  • Instans cloud disk: Upgrade memerlukan waktu sekitar 15 menit.

  • Instans local disk: Waktu yang dibutuhkan untuk upgrade ke versi utama berikutnya mirip dengan waktu restart instans (biasanya beberapa menit).

Versi utama yang didukung

Pengujian kompatibilitas sebelum upgrade (disarankan)

Sebelum melakukan upgrade versi utama database, lakukan langkah-langkah berikut untuk menguji kompatibilitas.

1. Tinjau perubahan yang memutus kompatibilitas:
   Periksa MongoDB major version upgrade notes untuk masalah kompatibilitas antara versi saat ini dan versi target Anda.

2. Uji dengan clone (opsional tetapi disarankan):
   Uji kompatibilitas antara versi utama database yang berbeda menggunakan pemulihan data.

   Penting

   Pengujian dengan instans clone akan menimbulkan biaya tambahan.

   a. Buat instans baru dengan memulihkan dari backup. Instans baru tersebut menjalankan versi utama database yang sama.
   b. Lakukan upgrade versi utama database pada instans baru tersebut.
   c. Jalankan aplikasi Anda terhadap clone yang telah di-upgrade.
   Pantau adanya masalah kompatibilitas. Jika terjadi masalah, periksa dan modifikasi kode client berdasarkan pesan error hingga semua masalah terselesaikan.
   d. Hapus instans uji setelah selesai.

Upgrade instans Anda

1. Login ke ApsaraDB for MongoDB console.

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

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

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

5. Di bagian Specification Information, arahkan kursor ke Update Minor Version dan klik versi utama target dari dropdown.

   Jika Update Minor Version tidak terlihat, instans Anda mungkin tidak mendukung upgrade versi utama in-place. Untuk melakukan upgrade, buat instans baru dengan versi utama yang lebih tinggi dan gunakan Data Transmission Service (DTS) untuk memigrasikan data.

6. Pilih waktu upgrade:

   • Effective Immediately – Mulai upgrade sekarang.

   • Effective Within Maintenance Window – Mulai selama jendela pemeliharaan (default: 02:00–06:00).

7. Klik OK untuk mengonfirmasi.