DBAtlas · Atlas de operações de banco de dados

Verificar o featureCompatibilityVersion (fCV) e a sequência de upgrade de versão major

MongoDBUpgrade

Comando

// 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 })

O que faz

Mostra o fCV em execução; dá a ordem em que são feitos o upgrade do binário e o upgrade do fCV, que são etapas separadas.

Quando usar

Ao planejar um upgrade de versão major (ex.: 6.0 -> 7.0), quando novos recursos não estão disponíveis após um upgrade ou antes de passar para a próxima major.

Atenção

Versões major não podem ser puladas: para 5.0 -> 7.0, passe primeiro para o 6.0 e defina o fCV como 6.0. Depois que o fCV é elevado, os arquivos de dados podem mudar para o novo formato e o downgrade do binário fica mais difícil; eleve o fCV só depois que a nova versão rodar sem problemas por alguns dias. O downgrade de binário não é oficialmente suportado no 7.0+ Community; baseie o plano de retorno em um backup. Verifique a compatibilidade dos drivers antes do upgrade.

Abrir no DBAtlas →