ダウングレード8.3 シャーディングされたクラスターから8.0

バックアップの作成

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

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

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

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

リシャーディング操作が進行中でないことを確認する

リシャーディング操作が正常に完了したことを確認します。 プライマリ フェイルオーバーが原因で最近のリシャーディング操作が失敗した場合は、シャーディングされたクラスターのfeatureCompatibilityVersionをダウングレードする前に、まず cleanupReshardCollectionコマンドを実行する必要があります。

シャーディングされたクラスターのfeatureCompatibilityVersionをダウングレードするときにリシャーディング操作がまだ実行中の場合、リシャーディング操作は完了しません。

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

シャーディングされたクラスターの FCV をダウングレードするには:

1. 最初の同期が進行中でないことを確認します。 最初の同期の進行中にsetFeatureCompatibilityVersionコマンドを実行すると、最初の同期がリスタートされます。

2. レプリカセット構成にnewlyAddedフィールドがないノードがないことを確認します。 これを確認するには、レプリカセット内の各ノードで次のコマンドを実行します。

   use local
   db.system.replset.find( { "members.newlyAdded" : { $exists : true } } );

   newlyAddedフィールドは、最初の同期の実行中とその直後にのみ、ノードのレプリカセット構成ドキュメントにのみ表示されます。

3. レプリカセット ノードがROLLBACKまたはRECOVERING状態になっていないことを確認します。

4. mongoshを使用してmongosインスタンスに接続します。

5. featureCompatibilityVersionを"8.0"にダウングレードします。

   重要

   バイナリ バージョンをダウングレードする前に、下位互換性のない機能をすべて削除していることを確認してください。続行する前に、必ずアップグレード パスを評価してください。

   db.adminCommand( { setFeatureCompatibilityVersion: "8.0", confirm: true } )

   setFeatureCompatibilityVersionコマンドは内部システム コレクションへの書込みを実行し、冪等です。 コマンドが正常に完了しない場合は、 mongosインスタンスでコマンドを再試行してください。

   注意

   トラブルシューティング

   • setFeatureCompatibilityVersionがシャーディングされたクラスターで実行されている場合、チャンクの移行、分割、マージはConflictingOperationInProgressで失敗する可能性があります。

   • setFeatureCompatibilityVersionがManualInterventionRequiredエラーで失敗し、クラスターが最近 再シャーディング操作 を実行していて、選挙が原因で失敗した場合は、 setFeatureCompatibilityVersionを再度実行する前にcleanupReshardCollectionコマンドを実行する必要があります。

6. レプリカセットのすべてのノードに更新されたfeatureCompatibilityVersionが適用されていることを確認するには、各レプリカセット ノードに接続し、 featureCompatibilityVersionを確認します。

   Tip

   アクセス制御

   アクセス制御が有効になっているシャーディングされたクラスターの場合、シャード レプリカセット メンバーでadminCommandを実行するには、シャード ローカル ユーザーとしてメンバーに接続する必要があります。

   db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

   出力を非表示

   "featureCompatibilityVersion" : { "version" : "8.0" }

   いずれかのノードが"8.3"のfeatureCompatibilityVersionを返す場合は、続行する前にノードがバージョン"8.0"を返すまで待機します。

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

最新の 8.0 バイナリをダウンロード

パッケージマネージャーまたは手動ダウンロードのいずれかを使用して、8.0 の最新リリースを取得します。パッケージマネージャーを使用する場合は、8.0 バイナリの新しいリポジトリを追加してから、実際のダウングレード プロセスを実行します。

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

8.3 バイナリをダウンロードした 8.0 バイナリに置き換え

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

mongod --version

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

バランサーを無効にする

バランサーを無効にするには、 mongoshをシャーディングされたクラスター内のmongosインスタンスに接続し、次のコマンドを実行します。

sh.stopBalancer()

バランサーが無効になっていることを確認するには、次のコマンドを実行します。

sh.getBalancerState()

バランサーが無効になっている場合、sh.getBalancerState() は を返します。false

バランサーを無効にする方法の詳細については、「 バランサーを無効にする 」を参照してください。

ダウングレード mongos

1. mongosを停止するには、次のコマンドを実行します。

   db.shutdownServer()

2. 8.0 バイナリを使用して mongos を再起動します。

各シャードを一度に 1 つずつダウングレード

1. シャードのセカンダリ ノードを一度に 1 つずつダウングレードします。

   1. ノードをシャットダウンします。

      mongodプロセスをシャットダウンするには、 mongoshを使用して配置に接続し、次のコマンドを実行します。

      db.adminCommand( { shutdown: 1 } )

   2. ノードを再起動します。

      mongodプロセスを開始するには、次のコマンドを実行します。

      mongod --dbpath </path-to-data-folder>

   3. ノードがSECONDARY状態になるまで待ちます。

      次のセカンダリをダウングレードする前に、ノードがSECONDARY状態に回復するまで待ちます。 メンバーの状態を確認するには、rs.status() mongoshで メソッドを使用します。

   4. 前の手順を繰り返して、各セカンダリ ノードをダウングレードします。

2. シャード アービタ（存在する場合）をダウングレードします。

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

   シャーディングされたクラスターのアービタノードをダウングレードします。

   1. ノードをシャットダウンします。

      アービタをシャットダウンするには、 mongoshを使用してアービタに接続し、次のコマンドを実行します。

      db.adminCommand( { shutdown: 1 } )

   2. アービタ データ ディレクトリの内容を削除します。

      アービタmongodのデータディレクトリを見つけるには、 storage.dbPath構成設定または--dbpathコマンドライン オプションのいずれかを確認します。

      次のコマンドを実行します:

      rm -rf /path/to/mongodb/datafiles/*

   3. アービタを再起動します。

      mongodプロセスを開始するには、次のコマンドを実行します。

      mongod --dbpath </path-to-mongodb-datafiles>

   4. ノードがARBITER状態になるまで待ちます。

      プライマリをダウングレードする前に、ノードがARBITER状態に回復するまで待ちます。 メンバーの状態を確認するには、rs.status() mongoshで メソッドを使用します。

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

   1. プライマリを降格します。

      mongoshでは、 rs.stepDown()を使用してプライマリを降格し、新しいプライマリの選挙を開始します。

      rs.stepDown()

   2. プライマリが降格したことを確認します。

      次のコマンドを実行します:

      rs.status()

      プライマリが降格し、別のノードがPRIMARY状態になったことを確認します。

   3. 以前のプライマリ ノードをシャットダウンします。

      以前のプライマリをシャットダウンするには、 mongoshを使用して配置に接続し、次のコマンドを実行します。

      db.adminCommand( { shutdown: 1 } )

   4. 8.0バイナリを使用してmongodを再起動します。

      mongodプロセスを開始するには、次のコマンドを実行します。

      mongod --dbpath </path-to-mongodb-datafiles>

   5. 残りのシャードに対して を繰り返します。

コンフィギュレーションサーバー をダウングレード

1. コンフィギュレーションサーバー レプリカセット（CSRS）のシャードのセカンダリ ノードを一度に 1 つずつダウングレードします。

   1. セカンダリをシャットダウンします。

      セカンダリに接続し、次のコマンドを実行します。

      db.adminCommand( { shutdown: 1 } )

   2. ノードを再起動します。

      mongodプロセスを開始するには、次のコマンドを実行します。

      mongod --dbpath </path-to-data-folder>

   3. ノードがSECONDARY状態になるまで待ちます。

      次のセカンダリをダウングレードする前に、ノードがSECONDARY状態に回復するまで待ちます。 メンバーの状態を確認するには、rs.status() mongoshで メソッドを使用します。

   4. 前の手順を繰り返して、各セカンダリ ノードをダウングレードします。

2. コンフィギュレーションサーバーのプライマリをダウングレードします。

   1. プライマリを降格します。

      mongoshで、 rs.stepDown()を実行してプライマリを降格し、新しいプライマリの選挙を開始します。

      rs.stepDown()

   2. プライマリが降格したことを確認します。

      次のコマンドを実行します:

      rs.status()

      プライマリが降格し、別のノードがPRIMARY状態になったことを確認します。

   3. 以前のプライマリ ノードをシャットダウンします。

      以前のプライマリをシャットダウンするには、 mongoshを使用して配置に接続し、次のコマンドを実行します。

      db.adminCommand( { shutdown: 1 } )

   4. 8.0バイナリを使用してmongodを再起動します。

      mongodプロセスを開始するには、次のコマンドを実行します。

      mongod --dbpath </path-to-mongodb-datafiles>

バランサーを再度有効にする

シャーディングされたクラスターのすべてのコンポーネントをダウングレードした後、 mongosに接続し、次のコマンドを実行してバランサーを再度有効にします。

sh.startBalancer()

sh.startBalancer()メソッド も、シャーディングされたクラスターの自動分割を有効にします。