AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

MongoDB Ops Managerアップグレード

このチュートリアルでは、既存のMongoDB Ops Managerインストールをアップグレードする方法について説明します。

警告

マネージド データベースからMongoDB 4.4以降へのアップグレード

MongoDB Ops Manager 8.0 はMongoDB 4.2 以前をサポートしていません。 MongoDB 4.2 またはそれ以前のバージョンを使用していて、 MongoDB Ops Manager 8.0 にアップグレードする場合は、少なくともMongoDB 4.4 にアップグレードする必要があります。 少なくともMongoDB 4.4 にアップグレードしない場合、 MongoDB Ops Manager は事前のチェックに失敗し、起動しません。少なくともMongoDB 4.4 にアップグレードした後、 少なくともMongoDB 6 にアップグレードすることを推奨します。0 MongoDB Ops Manager 8.0 にアップグレードする前に

既存の Ops Manager インストールのバージョンによって、Ops Manager 6.0 以降にアップグレードするために必要なアップグレード パスが決まります。

重要

  • MongoDB Ops Manager 6.0 以降のインストールで、複数のMongoDB Ops Managerホストが同じアプリケーション データベースを指している場合は、モニタリング ダウンタイムを発生させずにMongoDB Ops Managerをアップグレードできます。 このアップグレード中、 MongoDB Ops Managerはアップグレード モードと呼ばれる状態になります。 詳細については、「アップグレード モード 」を参照してください。

  • アップグレードを成功させるには、既存のバージョンのアップグレード パスに従って、必要なデータベース移行を実行する必要があります。

  • データを保護するため、Ops Manager はバージョン 1.8.x および 2.0.x からバージョン 6.0 以降への直接アップグレードの開始を拒否します。

  • MongoDB Ops Managerではサポートされているダウングレード パスはありません。

注意

Ops Manager6.0 バージョン.x 以降のすべてのアップグレードは同じ手順を使用します。上位のバージョンにアップグレードするには、まずこの手順で初期バージョンの利用可能な最新パッチにアップグレードし、次に手順を再度使用して次のバージョンにアップグレードする必要があります。次の表に、特定のバージョンのアップグレード手順に関連する追加情報がある場合は、まずそれを確認してください。

重要

ライブ移行(プッシュ): MongoDB Ops Manager によって管理または監視されるソース配置では非推奨またはサポート対象外

  • 配置が Ops Manager によって管理または監視される MongoDB 6.0 以降のバージョンを実行するソース配置の場合、ライブ移行(プッシュ)はサポートされません。

  • 配置が Ops Manager によって管理または監視される MongoDB 5.0 以前のバージョンを実行するソース配置の場合、ライブ移行(プッシュ)は非推奨です。

  • 配置がCloud Managerによって監視されるMongoDB.+を実行中ソース配置の場合、ライブ移行(プッシュ)がサポートされます。詳細については、「6.0 Cloud Managerによって監視されているMongoDBクラスターの Atlas へのライブ移行 」を参照してください。

以下の表は、すべてのバージョンのアップグレードパスを示しています。

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

8.0.x

この手順を使用して、Ops Manager.x8.0 から の最新の利用可能なパッチ8.0 バージョンにアップグレードします。

詳細については、「 MongoDB Ops Manager 8.0 リリースノート 」を参照してください。

7.0.x

Ops Manager.x7.0 7.0から の利用可能な最新パッチ バージョンにアップグレードします。次に、利用可能な最新バージョンの8.0 にアップグレードします。両方のアップグレードでこの手順を使用します。

詳細については、「 MongoDB Ops Manager 7.0 リリースノート 」を参照してください。

6.0.x

Ops Manager.x6.0 6.0から の利用可能な最新パッチ バージョンにアップグレードします。次に、利用可能な最新バージョンの7.0 にアップグレードします。両方のアップグレードでこの手順を使用します。

詳細については、「 MongoDB Ops Manager 6.0 リリースノート 」を参照してください。

5.0.x

Ops Manager.x5.0 5.0から の利用可能な最新パッチ バージョンにアップグレードします。次に、利用可能な最新バージョンの6.0 にアップグレードします。両方のプロセスでこの手順を使用します。

詳細については、「 MongoDB Ops Manager 5.0 リリースノート 」を参照してください。

4.4.x

Ops Manager.x4.4 4.4から の利用可能な最新パッチ バージョンにアップグレードします。次に、利用可能な最新バージョンの5.0 にアップグレードします。両方のプロセスでこの手順を使用します。

重要: Ops Manager バージョン4.4.13 では、アップグレード中にAPI書き込みの Ops Manager インスタンスが再度有効になるバグが修正されます。

詳しくは以下を参照してください。

4.2.x

Ops Manager.x4.2 4.2から の利用可能な最新パッチ バージョンにアップグレードします。次に、利用可能な最新バージョンの4.4 にアップグレードします。両方のプロセスでこの手順を使用します。

TLS が意図せず一時的に無効になるのは、4.2.24 4.2.24より前のバージョンにアップグレードする場合です。この結果を回避するには、まず 以降にアップグレードします。

詳しくは以下を参照してください。

4.0.x

v4.2 アップグレード チュートリアルを使用して、Ops Manager..x4 042からバージョン..24 以降にアップグレードします。次に、この手順を使用して、利用可能な最新バージョンの. にアップグレードします。42

TLS が意図せず一時的に無効になるのは、4.2.24 4.2.24より前のバージョンにアップグレードする場合です。この結果を回避するには、まず 以降にアップグレードします。

詳しくは以下を参照してください。

3.6.x

v4.0 アップグレード チュートリアルを使用して、Ops Manager..x3 640からバージョン..x にアップグレードします。

3.4.x

v3.6 アップグレード チュートリアルを使用して、Ops Manager..x3 436からバージョン..x にアップグレードします。

2.x またはそれ以前

3.4Ops Manager.x2 またはそれ以前のバージョンからアップグレードするには、 v アップグレード チュートリアルを使用します。

警告

既存の設定と可用性を維持するには、現在のMongoDB Ops Managerインスタンスで以下をバックアップします。

  • conf-mms.properties およびgen.keyファイルを安全な場所に。 conf-mms.propertiesは MongoDB Ops Manager インスタンスの設定を保存します。 gen.keyは、Ops Manager のバッキング データベースとユーザー認証情報を暗号化および復号化するための詳細を提供します。 MongoDB Ops Managerは、アップグレード プロセスの一環としてこれらのファイルを削除する場合があります。

追加の予防策として、 を使用してアプリケーションmongodump データベースのバイナリ エクスポートを作成すること。アプリケーション データベースでは公式にサポートされているバックアップ方法は存在しません。アップグレードが失敗した場合は、Ops Manager バージョンに関する問題を修正するためにMongoDBサポート に問い合わせてください。

MongoDB Ops Managerを 7.0 から 8.0 にアップグレードする前に、次の考慮事項を確認してください。

MongoDB Ops Manager 8.0.0 には、少なくともMongoDB6.0.0 MongoDB Ops Managerバッキング データベースに 以上の が必要です。

注意

バッキング データベースの MongoDBバージョンは、MongoDB Ops ManagerMongoDB Ops Manager のバージョンよりもそれ以降にすることはできません。

MongoDB Ops ManagerがMongoDB Tools を管理している場合、MongoDB Ops Managerをアップグレードするとツールのバージョンも自動的にアップグレードされます。

Ops8.0 Manager.x を ローカルモードで実行する場合は、 ディレクトリにリストされているmongoshの最新バージョンとMongoDB Database Tools Database Tools TGZパッケージバージョンをダウンロードしてインストールする必要があります。versions

ダウンロード ページには、最新のDatabase Toolsリリースのみが提供されています。互換性のあるバージョンをダウンロードするには、アーカイブされたリリースを参照してください。

  • RedHat Enterprise Linux 7 の Ops Manager サポートを削除します。

  • SUSE Linux Enterprise Server 12 の Ops Manager サポートを削除します。

  • Ubuntu 20.04 LTS の Ops Manager サポートを削除します。

重要

  • Amazon Linux v2 LTS の Ops Manager サポートを廃止します。

  • Debian 11 の Ops Manager サポートを廃止します。

  • MongoDBバージョン4.2以前の自動化、モニタリング、バックアップのサポートを廃止します。 MongoDB Ops Managerは、 MongoDB 4.4 以上を実行するデータベースのみを管理できます。

重要

  • MongoDBバージョン5.0以前の自動化、モニタリング、バックアップのサポートを廃止します。

サーバーはMongoDB Ops Managerのシステム要件 を満たしている必要があります。

警告

本番環境障害の可能性

以下の構成に失敗すると、 MongoDB Ops Managerインスタンスが本番環境で失敗する可能性があります。

アップグレード プロセスを開始する前に、データを保持しているすべてのメンバーが実行中いることを確認してください。レプリカセットメンバーのステータスを確認するには、 を実行します。replSetGetStatus

バッキング データベースが MMAPv 1ストレージ エンジンを実行している場合、アップグレード プロセスは失敗します。 MongoDB Ops Managerは、これらのバッキング データベースのストレージ エンジンをWiredTigerにアップグレードするように促します。

アップグレードを実行するサーバーに対する管理者特権が必要です。

ソフトウェアをダウンロードするには、カスタマー ダウンロード ページにあるダウンロード リンクをクリックします。 MongoDB は、そのページのURLをカスタマーに提供します。

  • このリンクにアクセスできない場合は、Ops Manager ソフトウェアの現在の評価コピーのダウンロード ページにアクセスしてください。

  • MongoDB Ops Managerソフトウェアの以前のバージョンが必要な場合は、 Release Archive にアクセスしてください。

MongoDB Ops Managerをローカル モードで実行する場合は、 MongoDBソフトウェアをバージョン ライブラリ ディレクトリにダウンロードします。 必要なソフトウェアには、次のものが含まれます。

MongoDB Ops Managerをアップグレードする前に、以下を確認してください。

ホストのプラットフォームをアップグレードした場合は、MongoDB Agent をアップグレードする 前にMongoDB 、MongoDB Ops Manager Agent をアップグレードしてください。

注意

Ops Manager9.0 では、新しい配置に対してBI Connector はデフォルトで無効になっています。 BI Connector は 9 月30 日のサポート終了に伴い、2026 でサポートが終了しましたが、既存のBI Connector インスタンスは引き続き Ops Manager で使用可能で管理可能です。 MongoDB、代わりにSQLインターフェイスを使用することを推奨しています。

注意

高可用性アプリケーションのアップグレードモード

MongoDB Ops Manager 4.2 以降のインストールで、複数のMongoDB Ops Managerホストが同じアプリケーション データベースを指している場合は、モニタリング ダウンタイムを発生させずにMongoDB Ops Managerをアップグレードできます。 このアップグレード中、 MongoDB Ops Managerはアップグレード モードと呼ばれる状態になります。 このモードでは、アップグレード プロセス全体で次のメリットが得られます。

  • アラートとモニタリングの動作

  • MongoDB Ops Manager インスタンスはライブのまま

  • MongoDB Ops Managerアプリケーションは読み取り専用モードでアクセスできます

  • データの書き込みまたは削除が無効になっている Ops Manager API

すべてのMongoDB Ops Manager ホストがアップグレードされ再起動されるまで、 インスタンスは アップグレード モード MongoDB Ops Managerのままになります。

一度に複数のMongoDB Ops Managerホストをアップグレードしないでください。

Ops Manager が アップグレードモードになると、バックアップデーモンは自分自身を停止しようとします。デーモンが 長時間のバックアップジョブの途中にある場合、このプロセスは失敗する可能性があります。この場合は、次のいずれかの操作を行います。

  • バックアップデーモンがジョブを完了したら、最初のMongoDB Ops Managerインスタンスを再起動します。

  • バックアップデーモンを手動で停止します。

バックアップデーモンを手動で停止する方法

  1. バックアップデーモンを提供する最初のホストにログインします。

  2. 次のコマンドを発行します:

    sudo service mongodb-mms-backup-daemon stop
  3. バックアップデーモンがシャットダウンしていることを確認します。

    ps -ef | grep mongodb-mms-backup-daemon

    バックアップデーモンが引き続き実行される場合は、次のコマンドを発行します。

    sudo /etc/init.d/mongodb-mms-backup-daemon stop
  4. 他のバックアップデーモン ホストごとにステップ 2 から 3 を繰り返します。

MongoDB Ops Managerアプリケーションを高可用性構成で実行している場合は、一度に 1 つのMongoDB Ops Managerホストでこの手順を完了します。

deb パッケージを使用してインストールされたホスト上のMongoDB Ops Managerアプリケーションをアップグレードするには、次の手順に従います。

1
  1. ご希望のブラウザを開き、 MongoDB.comのMongoDB Download Centerにアクセスします。

    MongoDB.com から起動する場合は、 ProductsをクリックしますOps Manager Try it now 。

  2. Platformsドロップダウン メニューから [ Ubuntu 22.04, 24.04 ] をクリックします。

  3. Packagesドロップダウン メニューから、x86_64 アーキテクチャの [ DEB ] をクリックします。

  4. [Download] をクリックします。

    ダウンロードしたパッケージの名前はmongodb-mms-<version>.x86_64.debで、 <version>はバージョン番号です。

2

次のコマンドを発行して、Ops Manager アプリケーションを停止します。

sudo service mongodb-mms stop
3

注意

高可用性MongoDB Ops Managerアプリケーションのアップグレード モード

同じアプリケーション データベースを指している複数の Ops Manager ホストを持つ Ops Manager インストールがある場合、この Ops Manager 配置は高可用性で実行されます。高可用性の Ops Manager 配置の 16.0 つの Ops Manager ホストをアップグレードすると、その配置はアップグレード モードになります。

  1. MongoDB Ops Managerアプリケーションとバックアップデーモンの各ホストに .deb パッケージをインストールします。 次のコマンドを発行します。ここで、 <version>は.debパッケージのバージョンです。

    sudo dpkg -i mongodb-mms_<version>_x86_64.deb
  2. 現在インストールされているバージョンのmms.confを上書きするかどうかを確認するプロンプトが表示されたら、 Yと入力して既存のファイルを置き換える必要があります。

  3. が使用 するポートまたは JVM 設定を変更MongoDB Ops Manager した場合は、 がアップグレードされた後に、それらの変更をmms.conf MongoDB Ops Managerファイルに再適用する必要があります。

    警告

    ファイル内のJVM引数にパスワードやシークレットを追加しないでください。 mms.confOps Manager は、診断アーカイブでプレーンテキストとしてこれらを公開します。

  4. Ops Manager 6.0 にアップグレードする際、Ops Manager は使用する /opt/mongodb/mms/conf/conf-mms.propertiesファイルのバージョンを選択するよう求めます。 Ops Manager を手動で再設定する必要がないようにするには、現在のファイルを選択します。

4
sudo service mongodb-mms start

注意

Ops Manager の高可用性インスタンスでは、Ops Manager サービスのスタートアップは、すべてのサーバーがアップグレードするのを待機してから開始します。

アップグレードされたMongoDB Ops Managerホストが再起動後にログインします。 ログインが成功すると、アップグレードは成功します。

5

MongoDB Ops Manager は、すべてのホストがアップグレードされるまで、アップグレードモードのままになります。高可用性構成 の場合、これは次のことを意味します。

  • アップグレードがクラスター全体で完了するまで、ホストが完全に使用できない場合があります。最初のホストのアップグレードが予想よりも長い時間がかかる場合は、他のホストのアップグレードを続行します。

  • アップグレードが中断される可能性があるため、停止していると思われるプロセスを停止したりキャンセルしたりしないでください。

  • MongoDB Ops Manager がスタートアップ中に生成するログが Starting pre-flight checks で一時停止されることがありますが、 MongoDB Ops Manager はすべてのサーバーを同じバージョンにアップグレードします。

  • マルチバージョンアップグレードの場合は、メジャーバージョンをスキップしないでください 。クラスター内の各ノードを、一度に各メジャー リリースの最後のマイナー バージョンに 1 つずつアップグレードする必要があります。例、6.0.26 から 8.0.3 にアップグレードするには、各ノードで次の手順を実行します。

    1. ノード(6.0.26を実行中)でサービスを停止します。

    2. 7.0.x の最新のマイナー バージョンにアップグレードします。

    3. 次のノードに移動する前に、アップグレードされたホストを起動します。

    4. 他のすべてのノードに対して繰り返します。

    5. このプロセスを繰り返して、各ノードを 7.0.x から 8.0.3 にアップグレードします。

6

アップグレードが完了したら、 MongoDB Ops Managerインスタンスにログインします。 MongoDB Ops Manager にOne or more agents are out of dateと表示されるバナーが表示されます。

[ Update Software Componentsをクリックし、変更を確定します。

重要

MongoDB Ops ManagerがMongoDB Tools を管理している場合、ツールのバージョンは エージェントを使用してアップグレードされます。

Ops Manager 9.0 では、 BI Connector はデフォルトで無効になっています。 MongoDB Agent の更新手順を、Ops Manager が新しい配置用のBI Connector をプロビジョニングまたは更新するステートメントと解釈しないでください。

プレフライト チェック出力またはスタートアップ ログにはUnrecognized VM option 'UseParNewGC'のようなエラーが含まれている必要があります。 このエラーは、次のファイルのいずれかが編集されている場合に発生することがあります。

  • /etc/rc.d/init.d/mongodb-mms

  • mms.conf

  • conf-mms.properties

この問題を解決するには、構成ファイルから-XX:+UseParNewGCを削除します。

Linuxションとローカル構成によっては、 MongoDB Ops Managerはアップグレード時に構成ファイルに加えた変更を置き換える場合があります。 MongoDB Ops Manager 5.0 以降では、RPM パッケージを使用する場合、 MongoDB Ops Managerはアップグレード時に構成ファイルを更新しなくなりました。 新しいMongoDB Ops Managerバージョンで構成ファイルに新しいプロパティが必要な場合は、アップグレード時に ファイルに追加する必要があります。

mongo.mongoUriアップグレードするときは、 MongoDB Javaドライバーで導入された新しいパラメータを含めるように の値を更新してください。デフォルトでは 、このドライバーは再試行可能な読み取りと 再試行可能な書込み を有効にします。読み取りと書込みを再試行するようにカスタム ロジックを設定すると、試行に時間がかかりすぎる可能性があります。これらのデフォルト値を無効にするには、次の内容を接続文字列に追加します。

例

MongoDB ://SERVER:port/?maxPoolSize=150+retryWrites=false_retryReads=false

この警告は、MongoDB Ops Manager が使用する Guice ライブラリ のバージョンに基づき表示されます。この警告は無視しても問題ありません。