シャーディングされたクラスターを 8.2 にアップグレード

重要

MongoDB8.2 は最新のマイナーリリースです。 MongoDB8.2 以降では、特定のユースケースに対応したオンプレミス配置（MongoDB Community と Enterprise）でマイナーリリースを利用できます。詳細については、「 MongoDB のバージョン管理」を参照してください。

オンプレミスでサポートされている最新のMongoDBバージョンをインストールするには、インストール手順を参照してください。

このドキュメントの内容をよく読み、前提条件を十分に確認してから、 MongoDB 8.2にアップグレードしてください。

次の手順では、シャードメンバーである mongod をバージョン 8.0 から 8.2 にアップグレードする手順について説明します。

8.2へのアップグレードに関するガイダンスが必要な場合は、 MongoDB プロフェッショナルサービスがメジャーバージョンアップグレードサポートを提供して、MongoDB アプリケーションを中断することなくスムーズに移行できるようにします。

アップグレードの推奨事項とチェックリスト

アップグレードの際には、次の点を考慮してください。

アップグレードバージョンパス

既存の MongoDB デプロイを8.2にアップグレードするには、 8.0シリーズのリリースを実行している必要があります。

8.0シリーズより前のバージョンの場合、最終的に8.0シリーズになるまで、メジャーリリースを順次アップグレードする必要があります。たとえば、7.0 シリーズを実行している場合、にアップグレードする8.0 前に、まずにアップグレード8 する必要があります。2 。

ドライバーの互換性を確認

MongoDB をアップグレードする前に、MongoDB 8.2の互換性があるドライバーを使用していることを確認してください。 MongoDB 8.2との互換性を確認するには、特定のドライバーのドライバーのドキュメントを参照してください。

互換性のないドライバーでアップグレードを実行した場合、予期しないまたは未定義の動作が発生する可能性があります。

事前対策

アップグレードを開始する前に、ドキュメント「 MongoDB 8.2での互換性の変更」で、ご利用のアプリケーションとデプロイが MongoDB 8.2と互換性があることを確認してください。アップグレードを開始する前に、お使いの環境の互換性の問題を解決してください。

MongoDB をアップグレードする際は、アップグレードを本番環境にデプロイする前に、必ずアプリケーションをステージング環境でテストします。

ダウングレードの検討事項

配置のバイナリバージョンをダウングレードするには、サポートによる支援が必要です。

詳しくは、「 8.2から8.0へのダウングレード」を参照してください。

前提条件

全ノードのバージョン

シャーディングされたクラスターを8.2にアップグレードするには、クラスターのすべてのノードが以上のバージョン8.0である必要があります。アップグレードプロセスでは、クラスターのすべてのコンポーネントがチェックされ、 8.0より前のバージョンを実行しているコンポーネントがある場合は警告が発せられます。

機能の互換性バージョン

8.0のシャーディングされたクラスターでは、 featureCompatibilityVersionを"8.0"に設定する必要があります。

シャーディングされたクラスターのすべてのノードでfeatureCompatibilityVersionが"8.0"に設定されていることを確認するには、各シャードレプリカセットノードと各コンフィギュレーションサーバーレプリカセットノードに接続し、 featureCompatibilityVersionを確認します。

Tip

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

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

すべてのノードは "featureCompatibilityVersion" : { "version" : "8.0" } を含む結果を返す必要があります。

featureCompatibilityVersionを設定または更新するには、 mongosで次のコマンドを実行します。

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

詳細については、setFeatureCompatibilityVersion を参照してください。

レプリカセットノードの状態

シャードとコンフィギュレーションサーバーでは、レプリカセットノードがROLLBACKまたはRECOVERING状態になっていないことを確認します。

db.adminCommand( { replSetGetStatus: 1 } )

`config`データベースのバックアップ

任意ですが推奨します。 予防手段として、シャーディングされたクラスターをアップグレードする前に、 configデータベースのバックアップを取得してください。

無効な system.buckets コレクションの削除

にアップグレードする際に、時系列コレクションではないdrop rename8.2コレクションがある場合は、system.buckets に応じて、アップグレードする前にそれらのコレクションをまたは8 する必要があります。0 }パッチリリース:

MongoDB 8.0.5 以降: アップグレードする前に、時系列コレクションではない system.buckets コレクションを削除する必要はありません。ただし、アップグレードが完了した後に、これらを削除するか、名前を変更する必要があります。
MongoDB 8.0.4 以前: アップグレードする前に、時系列コレクションではない system.buckets コレクションを削除するか、名前を変更する必要があります。すべてのsystem.buckets コレクションは、 8.0.0-8.0.4 のバージョンにアップグレードする前に、有効な時系列オプションを構成する必要があります。

時系列コレクションではない system.buckets コレクションがあるかどうかを判断するには、フィルタを指定した db.getCollectionInfos() メソッドを使用します。

db.getCollectionInfos(
   {
      $and: [
         { name: { $regex: /^system\.buckets/ } },
         { 'options.timeseries': { $exists: false } }
      ]
   }
)

ダウンロード8.2 バイナリ

パッケージマネージャーの使用

MongoDB を MongoDB apt 、 yum 、 dnf 、またはzypperリポジトリからインストールした場合、パッケージマネージャーを使用して8.2にアップグレードする必要があります。

Linux システムの場合は、 8.2のインストール手順を参照してください。新しいリリース用にリポジトリを追加して、実際にアップグレードを行う方法を解説しています。

ダウンロード8.2 手動でバイナリ化

パッケージマネージャーを使用して MongoDB をインストールしていない場合は、 MongoDB ダウンロードセンターから MongoDB バイナリを手動でダウンロードできます。

詳しくは、 8.2インストール手順を参照してください。

アップグレード手順

バランサーを無効にします。

mongoshmongosシャーディングされたクラスター内のsh.stopBalancer() インスタンスに接続し、を実行してバランサーを無効にします。

sh.stopBalancer()

注意

移行が進行中の場合、システムは進行中の移行を完了してから、バランサーを停止します。 sh.isBalancerRunning()を実行して、バランサーの現在の状態を確認できます。

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

sh.getBalancerState()

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

コンフィギュレーションサーバーをアップグレードします。

レプリカセットのセカンダリノードを一度に 1 つずつアップグレードします。
1. セカンダリインスタンスをシャットダウンします。
  mongodプロセスをシャットダウンするには、 mongoshを使用してクラスターノードに接続し、次のコマンドを実行します。
  db.adminCommand( { shutdown: 1 } )
2. 8.0バイナリを8.2バイナリに置き換えます。
3. 8.2バイナリを起動します。
  --configsvr 、 --replSet 、 --portを使用して8.2バイナリを起動します。配置で使用されるその他のオプションを含めます。
  mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>
  構成ファイルを使用している場合は、ファイルを更新してsharding.clusterRole: configsvr 、 replication.replSetName 、 net.port 、 net.bindIpを指定してから、 8を起動します。 2 バイナリ:
  sharding: clusterRole: configsvr replication: replSetName: <string> net: port: <port> bindIp: localhost,<ip address> storage: dbpath: <path>
  配置に適したその他の設定を含めます。
4. 次のセカンダリノードをアップグレードする前に、ノードがSECONDARY状態に回復するまで待機します。
  メンバーの状態を確認するには、rs.status() でmongosh を発行します。
レプリカセットのプライマリを降格します。
1. mongoshをプライマリに接続し、 rs.stepDown()を使用してプライマリを降格し、新しいプライマリの選出を強制します。
  rs.stepDown()
2. 降格したプライマリをシャットダウンします。
  rs.status()でプライマリが降格し、別のノードがPRIMARY状態になったことが示されたら、降格したプライマリをシャットダウンします。
  降格したプライマリをシャットダウンするには、 mongoshを使用してプライマリに接続し、次のコマンドを実行します。
  db.adminCommand( { shutdown: 1 } )
3. mongodバイナリを8.2バイナリに置き換えます。
4. 8.2バイナリを起動します。
  --configsvr 、 --replSet 、 --port 、 --bind_ipオプションを使用して8.2を起動します。以前の配置で使用された任意のコマンドラインオプションを含めます。
  mongod --configsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>
  構成ファイルを使用している場合は、ファイルを更新してsharding.clusterRole: configsvr 、 replication.replSetName 、 net.port 、 net.bindIpを指定してから、 8を起動します。 2 バイナリ:
  sharding: clusterRole: configsvr replication: replSetName: <string> net: port: <port> bindIp: localhost,<ip address> storage: dbpath: <path>
  配置に適したその他の構成を含めます。

シャードをアップグレードします。

シャードを一度に 1 つずつアップグレードします。

各シャードレプリカセット:

レプリカセットのセカンダリノードを一度に 1 つずつアップグレードします。
1. セカンダリインスタンスをシャットダウンします。
  mongodプロセスをシャットダウンするには、 mongoshを使用してクラスターノードに接続し、次のコマンドを実行します。
  db.adminCommand( { shutdown: 1 } )
2. 8.0バイナリを8.2バイナリに置き換えます。
  --shardsvr 、 --replSet 、 --port 、 --bind_ipオプションを使用して8.2バイナリを起動します。配置に適した追加のコマンドラインオプションを含めます。
  mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>
  構成ファイルを使用している場合は、ファイルを更新してsharding.clusterRole: shardsvr 、 replication.replSetName 、 net.port 、 net.bindIpを含めてから、 8を起動します。 2 バイナリ:
  sharding: clusterRole: shardsvr replication: replSetName: <string> net: port: <port> bindIp: localhost,<ip address> storage: dbpath: <path>
  配置に適したその他の構成を含めます。
3. 次のセカンダリノードをアップグレードする前に、ノードがSECONDARY状態に回復するまで待機します。
  メンバーの状態を確認するには、rs.status() でmongosh を発行します。
4. セカンダリノードごとに繰り返します。
レプリカセットのプライマリを降格します。
mongoshをプライマリに接続し、 rs.stepDown()を使用してプライマリを降格し、新しいプライマリの選出を強制します。
```
rs.stepDown()
```
降格したプライマリをアップグレードします。
rs.status()でプライマリが降格し、別のノードがPRIMARY状態になったことが示されたら、降格したプライマリをアップグレードします。
1. 降格したプライマリをシャットダウンします。
  降格したプライマリをシャットダウンするには、 mongoshを使用してレプリカセットノードに接続し、次のコマンドを実行します。
  db.adminCommand( { shutdown: 1 } )
2. mongodバイナリを置き換えます。 8.2バイナリ。
3. 8.2バイナリを起動します。
  --shardsvr 、 --replSet 、 --port 、 --bind_ipオプションを使用して8.2バイナリを起動します。配置に適した追加のコマンドラインオプションを含めます。
  mongod --shardsvr --replSet <replSetName> --port <port> --dbpath <path> --bind_ip localhost,<ip address>
  構成ファイルを使用している場合は、ファイルを更新してsharding.clusterRole: shardsvr 、 replication.replSetName 、 net.port 、 net.bindIpを指定してから、 8を起動します。 2 バイナリ:
  sharding: clusterRole: shardsvr replication: replSetName: <string> net: port: <port> bindIp: localhost,<ip address> storage: dbpath: <path>
  配置に適したその他の構成を含めます。

`mongos`インスタンスをアップグレードします。

各mongosインスタンスを8.2バイナリで置き換え、再起動します。配置に適したその他の構成を含めます。

注意

シャーディングされたクラスターメンバーが異なるホスト上で実行されている場合、またはリモートクライアントがシャーディングされたクラスターに接続する場合は、 --bind_ipオプションを指定する必要があります。

mongos --configdb csReplSet/<rsconfigsver1:port1>,<rsconfigsver2:port2>,<rsconfigsver3:port3> --bind_ip localhost,<ip address>

バランサーを再度有効にします。

mongoshを使用してクラスター内のmongosに接続し、 sh.startBalancer()を実行してバランサーを再度有効にします。

sh.startBalancer()

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

下位互換性のない8.2機能を有効にします。

この時点で、 8.0と互換性のない8.2機能を使わずに8.2バイナリを実行できます。

これらの 8.2 機能を有効にするには、機能の互換性バージョン（FCV）を 8.2 に設定します。7.0 以降にアップグレードする場合は、confirm を true に設定する必要があります。

Tip

下位互換性のないこうした機能を有効にすると、ダウングレード前に保持されていた下位互換性のない機能をすべて削除する必要があるため、ダウングレードプロセスが複雑になる場合があります。

ダウングレードの可能性を最小限に抑えるには、アップグレード後、バーンイン期間中にこれらの機能を有効にせずにデプロイを運用することをお勧めします。ダウングレードの可能性を最小限に抑えられたと確信できたら、これらの機能を有効にします。

mongosインスタンスで、 adminデータベースでsetFeatureCompatibilityVersionコマンドを実行します。

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

featureCompatibilityVersion (FCV) : "8.2 " に設定しますreplSetReconfig暗黙的に各シャードでを実行し、シャードレプリカ構成ドキュメントにterm フィールドを追加します。

コマンドは、新しい構成がレプリカセットノードの大部分に伝播するまで完了しません。

このコマンドは、内部システムコレクションへの書込みを実行する必要があります。何らかの理由でコマンドが正常に完了しない場合は、操作が冪等であるため、安全にコマンドを再試行できmongos 。

注意

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

シャードに存在する孤立したドキュメントは、 setFeatureCompatibilityVersionを8.2に設定するとクリーンアップされます。クリーンアッププロセス:

アップグレードの完了をブロックしません。
レート制限されています。孤立したドキュメントのクリーンアップ中にパフォーマンスへの潜在的な影響を軽減するには、「範囲削除によるパフォーマンスへの影響を軽減する」を参照してください。

警告

mongos FCV の互換性

mongosmongodバイナリは、機能の互換性バージョン（FCV）がよりも大きいmongos インスタンスに接続できません。例、 MongoDB 8 は接続できません。0 バージョンmongos 8から.2FCV 8が. に設定されているシャーディングされたクラスター。2ただし、 MongoDB 8 を接続することは可能です。0 バージョンmongos 8から.2FCV 8が. に設定されているシャーディングされたクラスター。0

追加のアップグレード手順

スタンドアロンをアップグレードするには、「スタンドアロンの8.2へのアップグレード」を参照してください。
レプリカセットをアップグレードするには、「レプリカセットを8.2にアップグレードする」を参照してください。

戻る

レプリカセット

8.2から8.0へのダウングレード

重要