Docs Menu

スタンドアロンの 5.0 へのアップグレード

このチュートリアルを使用して、 MongoDB 4.4から MongoDB 5.0にアップグレードします。 同じリリース シリーズ内の新しいパッチ リリースにアップグレードするには、「 MongoDB の最新の自己管理型パッチ リリースへのアップグレード 」を参照してください。

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

次の手順では、スタンドアロンの mongod のバージョンを 4.4 から 5.0 にアップグレードする手順を概説します。

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

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

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

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

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

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

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

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

MongoDB 7.0 以降では、デプロイ済みのバイナリ バージョンをダウングレードするには、サポートによる支援が必要です。

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

スタンドアロンの mongod をアップグレードする前に、「5.0 のパフォーマンスに関する注意事項」で、5.0 にアップグレードした際に考えられるパフォーマンスへ影響について確認してください。

TTL 構成が有効であることを確認します。アップグレードする前に、expireAfterSecondsNaN に設定されている TTL インデックスを削除または修正してください。MongoDB 5.0 以降では、expireAfterSecondsNaN に設定すると、expireAfterSeconds0 に設定するのと同じ効果があります。詳しくは、「expireAfterSeconds に設定した場合の NaN TTL の動作」を参照してください。

アップグレードする前に、mongod インスタンスが正常にシャットダウンされていることを確認してください。

4.4 インスタンスの featureCompatibilityVersion"4.4" に設定されている必要があります。featureCompatibilityVersion を確認するには、次のコマンドを実行します。

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

この操作では、"featureCompatibilityVersion" : { "version" : "4.4" } を含む結果が返されます。

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

db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )

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

アップグレードする前に、スタンドアロン環境をレプリカセットに変更することを検討してください。レプリカセットは、MongoDB におすすめのデプロイ構成です。

MongoDB を MongoDB の aptyumdnfzypper のいずれかのリポジトリからインストールした場合、5.0 へのアップグレードにはパッケージ マネージャーを使用する必要があります。

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

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

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

1

mongodインスタンスをシャットダウンします。既存のバイナリを 5.0 mongod バイナリに置き換えます。

5.0 mongod を使用してデプロイを再起動します。

2

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

これらの 5.0 の機能を有効にするには、機能の互換性バージョン(FCV)を 5.0 に設定します。

Tip

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

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

以下のように、admin データベースに対して setFeatureCompatibilityVersion コマンドを実行します。

db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )

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

注意

アップグレードが完了すると、インデックス サイズが大幅に増加する可能性があります。 インデックスのサイズを表示するには、 dbStats.indexSizeを参照してください。 インデックス サイズが増加するのは、インデックス キーに保存されている時間枠に関連するデータが原因です。

アップグレード後にインデックスが大幅に大きくなり、インデックス サイズを小さくしたい場合は、MongoDB の技術サポート担当者に問い合わせて、解決策について考えてください。