Vérifier featureCompatibilityVersion (fCV) et la séquence de mise à niveau majeure

Commande

// 1) Current fCV (must be the same on all members; targetVersion appears if a transition is incomplete):
db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 })
// 2) Upgrade binaries in a rolling fashion (secondaries -> stepDown -> old primary); fCV stays old
db.version()
// 3) After the observation period, raise fCV on the primary (on mongos in a sharded cluster):
db.adminCommand({ setFeatureCompatibilityVersion: "7.0", confirm: true })
// 4) If a rollback is needed, fCV is lowered BEFORE the binaries:
db.adminCommand({ setFeatureCompatibilityVersion: "6.0", confirm: true })

Ce que fait la commande

Affiche le fCV en vigueur ; donne l'ordre dans lequel s'effectuent la mise à niveau des binaires et celle du fCV, qui sont des étapes distinctes.

Quand l'utiliser

Lors de la planification d'une mise à niveau de version majeure (par ex. 6.0 -> 7.0), quand de nouvelles fonctionnalités sont indisponibles après une mise à niveau, ou avant de passer à la majeure suivante.

Attention

Les versions majeures ne peuvent pas être sautées : pour 5.0 -> 7.0, passez d'abord en 6.0 et réglez le fCV sur 6.0. Une fois le fCV relevé, les fichiers de données peuvent passer au nouveau format et le retour arrière des binaires devient plus difficile ; ne relevez le fCV qu'après plusieurs jours de fonctionnement sans problème de la nouvelle version. Le retour arrière des binaires n'est pas officiellement pris en charge en 7.0+ Community ; fondez le plan de repli sur une sauvegarde. Vérifiez la compatibilité des drivers avant la mise à niveau.