Docs Menu
Docs Home
/
データベース マニュアル
/ / /

レプリカセットを 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.0を実行中である必要があります。7.0レプリカセットを8.0 シリーズ以前からアップグレードするには、まずレプリカセットのすべてのノードを最新の シリーズ リリースにアップグレードしてから、次にMongoDB.8 0から8 {2 にアップグレードする手順に従います。.

8.0レプリカセットでは、 featureCompatibilityVersion"8.0"に設定する必要があります。

レプリカセットのすべてのノード featureCompatibilityVersion"8.0"に設定されていることを確認するには、各レプリカセット ノードに接続し、featureCompatibilityVersionを確認します。

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

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

featureCompatibilityVersionを設定または更新するには、プライマリで次のコマンドを実行します。データを保持するノードの過半数が利用可能である必要があります。

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

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

replSetGetStatus コマンドを発行して、レプリカセット ノードが ROLLBACK または RECOVERING 状態になっていないことを確認します。

db.adminCommand( { replSetGetStatus: 1 } )

にアップグレードする際に、時系列コレクションではない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 } }
]
}
)

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

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

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

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

MongoDB 8.0から8.2へのアップグレードは、「ローリング」アップグレードを利用することで、他のノードが利用可能である間に個別にアップグレードを行いダウンタイムを最小限に抑えることができます。

1

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

db.adminCommand( { shutdown: 1 } )
2

レプリカセットのセカンダリノードを一度に 1 つずつアップグレードします。

  1. 8.0バイナリを8.2バイナリに置き換えます。

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

3

mongoshをプライマリに接続し、 rs.stepDown()を使用してプライマリを降格し、新しいプライマリの選挙を強制します。

4

rs.status() でプライマリが降格し、別のノードが PRIMARY 状態になったことが示されたら、降格したプライマリをアップグレードします。

  1. ステップダウンしたプライマリをシャットダウンし、 mongodバイナリを8.2バイナリに置き換えます。

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

5

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

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

Tip

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

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

Tip

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

プライマリノードの admin データベースでsetFeatureCompatibilityVersionコマンドを実行します。

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

featureCompatibilityVersion (FCV) : "8.2 " に設定します暗黙的に を実行して構成ドキュメントにreplSetReconfig termフィールドを追加し、新しい構成がレプリカセットノードの過半数に伝播するまでブロックします。

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

戻る

スタンドアロン

項目一覧