6.0 レプリカセットから 5.0 へのダウングレード

項目一覧

ダウングレードパス

アクセス制御
前提条件
ダウングレード手順

ダウングレードを試みる前に、このページの内容を理解してください。

ダウングレードパス

重要

レプリカセットをアップグレードまたはダウングレードする前に、すべてのレプリカセットノードが実行されていることを確認してください。そうしないと、すべてのノードが起動されるまでアップグレードまたはダウングレードは完了しません。

6.0 からダウングレードする必要がある場合は、5.0 の最新パッチリリースにダウングレードします。

MongoDB は 1 つのバージョンのダウングレードのみをサポートします。現在のリリースより数バージョン前のリリースにダウングレードすることはできません。

たとえば、6.0 シリーズの配置を 5.0 シリーズにダウングレードできます。ただし、5.0 シリーズの配置から 4.4 シリーズの配置へのさらなるダウングレードはサポートされていません。

アクセス制御

レプリカセットでアクセス制御が有効になっている場合、ダウングレードユーザーの権限には、データベース全体のインデックスを一覧表示して管理する特権が含まれている必要があります。 rootロールを持つユーザーには必要な特権があります。

前提条件

ダウングレード手順を開始する前に、次の前提条件手順を完了する必要があります。

バックアップの作成

任意ですが推奨します。 データベースのバックアップを作成します。

バックアップの作成方法については、「自己管理型配置のバックアップメソッド」を参照してください。

下位互換性のない機能を削除する

6.0 から 5.0 にダウングレードするには、5.0 と互換性のない 6.0 の機能を削除する必要があります。互換性のない機能のリストと削除方法については、「ダウングレードの考慮事項」を参照してください。

機能の互換性バージョン（fCV）のダウングレード

レプリカセットの fCVをダウングレードするには:

最初の同期が進行中でないことを確認します。最初の同期の進行中にsetFeatureCompatibilityVersionコマンドを実行すると、最初の同期がリスタートされます。
レプリカセット構成にnewlyAddedフィールドがないノードがないことを確認します。これを確認するには、レプリカセット内の各ノードで次のコマンドを実行します。
```
use local
db.system.replset.find( { "members.newlyAdded" : { $exists : true } } );
```
newlyAddedフィールドは、最初の同期の実行中とその直後にのみ、ノードのレプリカセット構成ドキュメントにのみ表示されます。
レプリカセットノードがROLLBACKまたはRECOVERING状態になっていないことを確認します。
プライマリに接続するには、 mongoshを使用します。
featureCompatibilityVersionを"5.0"にダウングレードします。
```
db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )
```
setFeatureCompatibilityVersionコマンドは内部システムコレクションへの書込みを実行し、冪等です。コマンドが正常に完了しない場合は、プライマリでコマンドを再試行してください。
レプリカセットのすべてのノードに更新されたfeatureCompatibilityVersionが適用されていることを確認するには、各レプリカセットノードに接続し、 featureCompatibilityVersionを確認します。
```
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
```
すべてのノードは次の内容を含む結果を返す必要があります。
```
"featureCompatibilityVersion" : { "version" : "5.0" }
```
いずれかのノードが"6.0"のfeatureCompatibilityVersionを返す場合は、続行する前にノードがバージョン"5.0"を返すまで待機します。

返されたfeatureCompatibilityVersion値の詳細については、「 FeatureCompatibilityVersion の取得」を参照してください。

ダウングレード手順

警告

ダウングレード手順に入る前に、遅延レプリカセットノードを含むすべてのレプリカセットノードに前提条件が変更されていることを確認してください。そのためには、ダウングレードする前に、 featureCompatibilityVersionとを確認して、各ノードの互換性のない機能を削除します。

重要

6.0 からダウングレードする必要がある場合は、5.0 の最新パッチリリースにダウングレードします。

6.0 バイナリをダウンロードした 5.0 バイナリに置き換えます。

5.0 バイナリがシステムパスにあることを確認します。バイナリのバージョンを確認するには、次のコマンドを実行します。

mongod --version

コマンド出力に 5.0 シリーズのリリースが表示されるはずです。

レプリカセットのセカンダリノードをダウングレードします。

レプリカセットの各セカンダリノードを 1 つずつダウングレードします。

ノードをシャットダウンします。
mongodプロセスをシャットダウンするには、 mongoshを使用してセカンダリに接続し、次のコマンドを実行します。
```
db.adminCommand( { shutdown: 1 } )
```
ノードを再起動します。
mongodプロセスを開始するには、次のコマンドを実行します。
```
mongod --dbpath </path-to-data-folder>
```
mongodプロセスの開始の詳細については、「 mongodプロセスの開始」を参照してください。
ノードがSECONDARY状態になるまで待ちます。
次のセカンダリをダウングレードする前に、ノードがSECONDARY状態に回復するまで待ちます。メンバーの状態を確認するには、rs.status() mongoshでメソッドを使用します。
ノードがSECONDARYステージに達したら、次のセカンダリをダウングレードします。

アービタレプリカセットノード（存在する場合）をダウングレードします。

レプリカセットにアービタが含まれていない場合は、この手順をスキップします。

レプリカセットのアービタノードをダウングレードします。

ノードをシャットダウンします。
アービタをシャットダウンするには、 mongoshを使用してアービタに接続し、次のコマンドを実行します。
```
db.adminCommand( { shutdown: 1 } )
```
アービタデータディレクトリの内容を削除します。
アービタmongodのデータディレクトリを見つけるには、 storage.dbPath構成設定または--dbpathコマンドラインオプションのいずれかを確認します。
次のコマンドを実行します:
```
rm -rf /path/to/mongodb/datafiles/*
```
アービタを再起動します。
mongodプロセスを開始するには、次のコマンドを実行します。
```
mongod --dbpath </path-to-mongodb-datafiles>
```
mongodプロセスの開始の詳細については、「 mongodプロセスの開始」を参照してください。
ノードがARBITER状態になるまで待ちます。
プライマリをダウングレードする前に、ノードがARBITER状態に回復するまで待ちます。メンバーの状態を確認するには、rs.status() mongoshでメソッドを使用します。

プライマリをダウングレードします。

プライマリを降格します。
mongoshでは、 rs.stepDown()を使用してプライマリを降格し、通常のフェイルオーバー手順を強制します。
```
rs.stepDown()
```
プライマリが降格したことを確認します。
次のコマンドを実行します:
```
rs.status()
```
プライマリが降格し、別のノードがPRIMARY状態になったことを確認します。
以前のプライマリmongodを置き換えて再起動します。
1. ノードをシャットダウンします。
  プライマリのシャットダウンを実行するには、 mongoshを使用してプライマリに接続し、次のコマンドを実行します。
  db.adminCommand( { shutdown: 1 } )
2. 5.0バイナリを使用してmongodを再起動します。
  mongodプロセスを開始するには、次のコマンドを実行します。
  mongod --dbpath </path-to-mongodb-datafiles>
  mongodプロセスの開始の詳細については、「 mongodプロセスの開始」を参照してください。

戻る

スタンドアロン

シャーディングされたクラスター

ダウングレード パス

重要