1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
// Tests that manipulating the featureCompatibilityVersion document in admin.system.version changes
// the value of the featureCompatibilityVersion server parameter.
(function() {
"use strict";
const conn = MongoRunner.runMongod({});
assert.neq(null, conn, "mongod was unable to start up");
let adminDB = conn.getDB("admin");
// Initially the featureCompatibilityVersion is latestFCV.
checkFCV(adminDB, latestFCV);
// Updating the featureCompatibilityVersion document changes the featureCompatibilityVersion
// server parameter.
for (let oldVersion of [lastLTSFCV, lastContinuousFCV]) {
// Fully downgraded to oldVersion.
assert.commandWorked(adminDB.system.version.update({_id: "featureCompatibilityVersion"},
{$set: {version: oldVersion}}));
checkFCV(adminDB, oldVersion);
// Upgrading to latest.
assert.commandWorked(
adminDB.system.version.update({_id: "featureCompatibilityVersion"},
{$set: {version: oldVersion, targetVersion: latestFCV}}));
checkFCV(adminDB, oldVersion, latestFCV);
// Downgrading to oldVersion.
assert.commandWorked(adminDB.system.version.update(
{_id: "featureCompatibilityVersion"},
{$set: {version: oldVersion, targetVersion: oldVersion, previousVersion: latestFCV}}));
checkFCV(adminDB, oldVersion, oldVersion);
// When present, "previousVersion" will always be the latestFCV.
assert.writeErrorWithCode(adminDB.system.version.update({_id: "featureCompatibilityVersion"},
{$set: {previousVersion: oldVersion}}),
4926901);
checkFCV(adminDB, oldVersion, oldVersion);
// Downgrading FCV must have a 'previousVersion' field.
assert.writeErrorWithCode(adminDB.system.version.update({_id: "featureCompatibilityVersion"},
{$unset: {previousVersion: true}}),
4926902);
checkFCV(adminDB, oldVersion, oldVersion);
// Reset to latestFCV.
assert.commandWorked(adminDB.system.version.update(
{_id: "featureCompatibilityVersion"},
{$set: {version: latestFCV}, $unset: {targetVersion: true, previousVersion: true}}));
checkFCV(adminDB, latestFCV);
}
if (lastLTSFCV !== lastContinuousFCV) {
// Test that we can update from last-lts to last-continuous when the two versions are not equal.
// This upgrade path is exposed to users through the setFeatureCompatibilityVersion command with
// fromConfigServer: true.
assert.commandWorked(adminDB.system.version.update(
{_id: "featureCompatibilityVersion"},
{$set: {version: lastLTSFCV, targetVersion: lastContinuousFCV}}));
checkFCV(adminDB, lastLTSFCV, lastContinuousFCV);
// Reset to latestFCV.
assert.commandWorked(adminDB.system.version.update(
{_id: "featureCompatibilityVersion"},
{$set: {version: latestFCV}, $unset: {targetVersion: true, previousVersion: true}}));
checkFCV(adminDB, latestFCV);
}
// Updating the featureCompatibilityVersion document with an invalid version fails.
assert.writeErrorWithCode(
adminDB.system.version.update({_id: "featureCompatibilityVersion"}, {$set: {version: "3.2"}}),
4926900);
checkFCV(adminDB, latestFCV);
// Updating the featureCompatibilityVersion document with an invalid targetVersion fails.
assert.writeErrorWithCode(adminDB.system.version.update({_id: "featureCompatibilityVersion"},
{$set: {targetVersion: lastLTSFCV}}),
4926904);
checkFCV(adminDB, latestFCV);
assert.writeErrorWithCode(adminDB.system.version.update({_id: "featureCompatibilityVersion"},
{$set: {targetVersion: lastContinuousFCV}}),
4926904);
checkFCV(adminDB, latestFCV);
assert.writeErrorWithCode(adminDB.system.version.update({_id: "featureCompatibilityVersion"},
{$set: {targetVersion: latestFCV}}),
4926904);
checkFCV(adminDB, latestFCV);
// Setting an unknown field.
assert.writeErrorWithCode(adminDB.system.version.update({_id: "featureCompatibilityVersion"},
{$set: {unknownField: "unknown"}}),
40415);
checkFCV(adminDB, latestFCV);
MongoRunner.stopMongod(conn);
}());
|
