重要
MongoDB 8.3 は最新のマイナー リリースです。MongoDB 8.2 以降では、特定のユースケースに合わせてオンプレミス配置（Community と EA）でマイナー リリースを利用できます。詳細については、 MongoDB のバージョン管理 を参照してください。
オンプレミスでサポートされている最新のMongoDBバージョンをインストールするには、インストール手順を参照してください。
MongoDB 8.3 にアップグレードする前に、前提条件を含むこのドキュメントを検討してください。
8.3 へのアップグレードに関するガイダンスが必要な場合は、MongoDBプロフェッショナル サービスがアップグレード サポートを提供して、 MongoDBアプリケーションを中断することなくスムーズに移行できるようにします。
アップグレードの推奨事項とチェックリスト
アップグレードの際には、次の点を考慮してください。
アップグレード バージョン パス
既存の MongoDB デプロイを8.3にアップグレードするには、 8.0シリーズのリリースを実行している必要があります。
マイナー バージョンからアップグレードする場合、最終的に 8.3 にアップグレードされるまで、マイナー リリースを順次アップグレードする必要があります。
ドライバーの互換性を確認
MongoDB をアップグレードする前に、MongoDB 8.3の互換性があるドライバーを使用していることを確認してください。 MongoDB 8.3との互換性を確認するには、特定のドライバーのドライバー のドキュメントを参照してください。
互換性のないドライバーでアップグレードを実行した場合、予期しないまたは未定義の動作が発生する可能性があります。
事前対策
アップグレードを開始する前に、ドキュメント「 MongoDB 8.3での互換性の変更 」で、ご利用のアプリケーションとデプロイが MongoDB 8.3と互換性があることを確認してください。 アップグレードを開始する前に、お使いの環境の互換性の問題を解決してください。
MongoDB をアップグレードする際は、アップグレードを本番環境にデプロイする前に、必ずアプリケーションをステージング環境でテストします。
ダウングレードの検討事項
MongoDB 8.3 以降では、 MongoDBのバージョンをその前のマイナーまたはメジャー バージョンにダウングレードできます。
MongoDB は 1 つのバージョンのダウングレードのみをサポートします。現在のリリースより数バージョン前のリリースにダウングレードすることはできません。
例、8.0 の配置を 7.0 にダウングレードできます。ただし、7.0 配置から 6.0 配置へのさらなるダウングレードはサポートされていません。
詳しくは、「 8.3から8.2へのダウングレード 」を参照してください。
前提条件
機能の互換性バージョン
8.2 インスタンスでは、featureCompatibilityVersion を "8.2" に設定する必要があります。featureCompatibilityVersionを確認するには、次のコマンドを実行します。
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
"featureCompatibilityVersion" : { "version" : "8.2" }
詳細については、db.adminCommand() を参照してください。
レプリカセットへの変更を検討する
アップグレードする前に、スタンドアロン環境をレプリカセットに変換することを検討してください。レプリカセットは、MongoDB におすすめの配置構成です。
ダウンロード8.3 バイナリ
パッケージ マネージャーの使用
MongoDB を MongoDB apt 、 yum 、 dnf 、またはzypperリポジトリからインストールした場合、パッケージ マネージャーを使用して8.3にアップグレードする必要があります。
Linuxシステムの場合は、8.3 のインストール手順を参照してください。新しいリリース用にリポジトリを追加して、実際にアップグレードする必要があります。
手動
パッケージ マネージャーを使用して MongoDB をインストールしていない場合は、 MongoDB ダウンロード センターから MongoDB バイナリを手動でダウンロードできます。
詳しくは、 8.3インストール手順を参照してください。
アップグレード手順
下位互換性のない 8.3 機能を有効にする
この時点で、 8.2と互換性のない8.3機能を使わずに8.3バイナリを実行できます。
これらの 8.3 機能を有効にするには、機能の互換性バージョン（FCV）を 8.3 に設定します。また、confirm を true に設定する必要があります。
Tip
下位互換性のないこうした機能を有効にすると、ダウングレード前に保持されていた下位互換性のない機能をすべて削除する必要があるため、ダウングレード プロセスが複雑になる場合があります。
ダウングレードの可能性を最小限に抑えるには、アップグレード後、バーンイン期間中にこれらの機能を有効にせずにデプロイを運用することをお勧めします。ダウングレードの可能性を最小限に抑えられたと確信できたら、これらの機能を有効にします。
以下のように、admin データベースに対して setFeatureCompatibilityVersion コマンドを実行します。
db.adminCommand( { setFeatureCompatibilityVersion: "8.3", confirm: true } )
confirm の値を true に設定すると、操作を続行できます。confirm パラメータを省略するか、confirm に true 以外の値を設定すると、コマンドは失敗し、機能の互換性バージョンの変更に関する警告が返されます。
このコマンドは、内部 システムコレクションへの書込みを実行する必要があります。コマンドが正常に完了しない場合は、操作が冪等であるため、安全にコマンドを再試行できます。
トラブルシューティング
mongod が終了した場合、 MongoDB はエラー コードを返します。アップグレードに関する問題をトラブルシューティングするには、エラー コード または 自己管理型配置の終了コードとステータス を参照してください。
アップグレード後にスタートアップの問題が発生した場合は、 MongoDBサポート にお問い合わせください。
追加のアップグレード手順
レプリカセットをアップグレードするには、「 8.2 レプリカセットを 8.3 にアップグレードする 」を参照してください。
シャーディングされたクラスターをアップグレードするには、 8.2 のクラスターを8.3 にアップグレードする を参照してください。