Docs Menu
Docs Home
/
MongoDB Ops Manager
/
Ops Manager のインストール

MongoDB Ops Managerアップグレード

項目一覧

  • アップグレード パス
  • Considerations
  • 前提条件
  • 手順
  • トラブルシューティング

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

アップグレード パス

警告

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

MongoDB Ops Manager 6.0 はMongoDB 3.4 をサポートしていません。 MongoDB 3.4 またはそれ以前のバージョンを使用していて、 MongoDB Ops Manager 6.0 にアップグレードする場合は、少なくともMongoDB 3.6 にアップグレードする必要があります。 ただし、MongoDB 6.0 にアップグレードする前に、少なくとも 4.0MongoDB Ops Manager にアップグレードすることをお勧めします。

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

重要

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

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

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

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

注意

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

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

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

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

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

5.0.x

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

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

4.4.x

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

重要: MongoDB Ops Managerバージョン 4.4.13 MongoDB Ops ManagerAPIは、アップグレード中に 書き込みの インスタンスを再度有効にするバグを修正します。

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

4.2.x

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

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

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

4.0.x

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

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

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

3.6.x
v4.0 アップグレード チュートリアルを使用して、 MongoDB Ops Manager 3.6.x からバージョン 4.0.x にアップグレードします。
3.4.x
v3.6 アップグレード チュートリアルを使用して、 MongoDB Ops Manager 3.4.x からバージョン 3.6.x にアップグレードします。
2.x またはそれ以前
.x またはそれ以前からアップグレードするには、 v3.4 アップグレード チュートリアル を使用します。MongoDB Ops Manager2

警告

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

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

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

Considerations

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

接続文字列

アップグレード手順中に AppDB に接続するときは、標準の接続文字列を使用します。 DNS SRV 接続文字列を使用するとアップグレードが失敗する可能性があります。

バッキング データベース

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

注意

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

互換性のある MongoDB ツール

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

MongoDB Ops Manager 6.0.x をローカル モードで実行する場合は、互換性のあるバージョンのMongoDB Tools TGZ パッケージをダウンロードし、versions ディレクトリにインストールする必要があります。

MongoDB Ops Managerサーバーのバージョン
互換性のある MongoDB Database Tools バージョン

MongoDB Tools の古いバージョンにアクセスするには、ダウンロード ページの [アーカイブされたリリース] をクリックします。

Ops Manager プラットフォームのサポート

MongoDB Ops ManagerでDebian11 を実行するためのサポートを追加します。

アラート

  • SNMP アラートを廃止します。Ops Manager 7.0.0 には SNMP アラートは含まれません。

オートメーション プラットフォームのサポート

  • ARM64/aarch64 アーキテクチャ上の RedHat Enterprise Linux バージョン 8 および Amazon Linux 2 での配置のオートメーションのサポートを追加します。

  • Debian 9 および RedHat Enterprise Linux 6 での配置の自動化のサポートを廃止します。

オートメーション サポートの変更

MongoDB 3.4配置の自動化のサポートを廃止します。

前提条件

ハードウェアとソフトウェアの要件

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

警告

本番環境障害の可能性

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

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

管理者の特権

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

MongoDB からのソフトウェアのダウンロード

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

ローカル モードで実行するためのソフトウェアをダウンロード

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

プラットフォームの互換性

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

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

手順

注意

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

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

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

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

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

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

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

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

MongoDB 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 を繰り返します。

  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 を繰り返します。

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

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

    <install_dir>/bin/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

MongoDB Ops Managerパッケージの最新バージョンをダウンロードします。

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

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

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

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

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

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

2

最初に実行中のMongoDB Ops Managerインスタンスを停止します。

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

sudo service mongodb-mms stop
3

アップグレードするホストにMongoDB Ops Managerパッケージをインストールします。

注意

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

MongoDB Ops Manager 4.4 インストールで複数のMongoDB Ops Managerホストが同じアプリケーション データベースを指している場合、このMongoDB Ops Manager配置は高可用性で実行されます。 高可用性のMongoDB Ops Manager配置の 1 つのMongoDB 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ファイルに再適用する必要があります。

    警告

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

    MongoDB Ops Manager 4.1 および 4.2 へのアップグレードにより、JAVA_MMS_UI_OPTS パラメータから -d64 フラグが削除されました。

  4. MongoDB Ops Manager 4.4.11 にアップグレードすると、 MongoDB Ops Manager では、使用する/opt/mongodb/mms/conf/conf-mms.propertiesファイルのバージョンを選択するよう求められます。 MongoDB Ops Managerを手動で再構成する必要がないようにするには、現在の ファイルを選択します。 詳細については、 4.4.11 リリースノート を参照してください。

4

アップグレードされたホストでMongoDB Ops Managerを起動します。

sudo service mongodb-mms start

注意

MongoDB Ops Managerの高可用性インスタンスでは、バックアップデーモンはすべてのノードがアップグレードされるのを待機してから起動します。

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

5

[任意] MongoDB Ops Manager高可用性配置内の他のすべてのMongoDB Ops Managerホストに対して、前述の手順を繰り返します。

注意

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

6

すべてのエージェントを更新します。

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

[ Update All Agentsをクリックし、変更を確定します。

重要

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

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

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

1

最初に実行中のMongoDB Ops Managerインスタンスを停止します。

RHEL、CentOS では、SUSE12 systemd を使用する ホスト 、次のコマンドを発行して、 アプリケーションを停止します。MongoDB Ops Manager

sudo service mongodb-mms stop

SysVInitを使用するプラットフォームの場合は、次のコマンドを発行します。

sudo /etc/init.d/mongodb-mms stop
2

MongoDB Ops Managerパッケージの最新バージョンをダウンロードします。

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

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

  2. Platformsドロップダウン メニューから、次のいずれかのオプションをクリックします。

    • Red Hat + CentOS 7, 8 / SUSE 12 + 15 / Amazon Linux 2

  3. Packages ドロップダウン メニューから RPM をクリックします。

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

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

3

アップグレードするMongoDB Ops ManagerホストにMongoDB Ops Managerパッケージをインストールします。

注意

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

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

アップグレードされたMongoDB Ops Managerホストに .rpm パッケージをインストールするには、次のコマンドを実行します。ここで、<version> はMongoDB Ops Managerのバージョンです。

sudo rpm -Uvh mongodb-mms-<version>.x86_64.rpm

MongoDB Ops Manager 5.0.x にアップグレードすると、 MongoDB Ops Manager は現在の/opt/mongodb/mms/conf/conf-mms.propertiesファイルを保持します。 MongoDB Ops Manager は、このバージョンでインストールされたconf-mms.propertiesを/opt/mongodb/mms/conf/conf-mms.properties.rpmnewとして保存します。

警告

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

4

ファイルをシンボリック リンクで置き換えinit

次の既存のファイルは、RPM を使用したMongoDB Ops Manager 4.2 インストールのアップグレードをブロックします。

  • /etc/init.d/mongodb-mms

  • /etc/init.d/mongodb-mms-backup-daemon

アップグレードを完了するには、以下の手順を行います。

  1. 次のコマンドを発行して、古いinitファイルを移動します。

    sudo mv /etc/init.d/mongodb-mms /etc/init.d/mongodb-mms-5.0
    sudo mv /etc/init.d/mongodb-mms-backup-daemon /etc/init.d/        mongodb-mms-backup-daemon-5.0

  2. 次のコマンドを発行して、 MongoDB Ops Managerファイルを init ファイルにシンボリック リンクします。

    sudo ln -s /opt/mongodb/mms/bin/mongodb-mms /etc/init.d/mongodb-mms
    sudo ln -s /opt/mongodb/mms/bin/mongodb-mms-backup-daemon /etc/init.d/mongodb-mms-backup-daemon
5

アップグレードされたホストでMongoDB Ops Managerを起動します。

RHEL または CentOS12 では、 systemd を使用する SUSE ホスト 、次のコマンドを発行します。

sudo service mongodb-mms start

SysVInitを使用するプラットフォームの場合は、次のコマンドを発行します。

sudo /etc/init.d/mongodb-mms start

注意

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

6

[任意] MongoDB Ops Manager高可用性配置内の他のすべてのMongoDB Ops Managerホストに対して、前述の手順を繰り返します。

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

ログインが成功した場合は、高可用性MongoDB Ops Manager配置の次のホストでこれらの手順を繰り返します。

7

すべてのエージェントを更新します。

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

[ Update All Agentsをクリックし、変更を確定します。

重要

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

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

debまたはrpmパッケージを使用していない Linux システムをアップグレードするには、この手順を使用します。

1

最初に実行中のMongoDB Ops Managerインスタンスを停止します。

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

<install_dir>/bin/mongodb-mms stop
2

MongoDB Ops Managerホスト上の構成ファイルをバックアップします。

アップグレードするMongoDB Ops Managerホストで、既存の構成ファイルとログをインストール ディレクトリ以外のディレクトリにバックアップします。

重要

この手順の後半では、バックアップされた<install_dir>/conf/conf-mms.propertiesファイルが必要です。

例

次のコマンドを使用すると、構成ファイルとログをホームページ ディレクトリにバックアップできます。

cp -a <install_dir>/conf ~/mms_conf.backup
cp -a <install_dir>/logs ~/mms_logs.backup

また、 MongoDB Ops ManagerがMongoDB Ops Managerのバッキング データベースとユーザー認証情報を暗号化および復号化するために使用する gen.key ファイルもバックアップする必要があります。 MongoDB Ops Managerでは、高可用性のMongoDB Ops Manager配置の一部であるすべてのサーバーで同一の gen.key ファイルが必要です。

3

MongoDB Ops Managerパッケージの最新バージョンをダウンロードします。

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

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

  2. [ Versionドロップダウン メニューから、提供されている安定バージョンのいずれかをクリックします。

  3. Platformドロップダウン メニューから、次のいずれかのオプションをクリックします。

    • Red Hat + CentOS 7, 8 / SUSE 12 + 15 / Amazon Linux 2

    • Debian 9, 10, 11 / Ubuntu 18.04

  4. Package ドロップダウン メニューから tar.gz をクリックします。

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

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

4

アップグレードする各ホストにMongoDB Ops Managerパッケージをインストールします。

注意

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

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

MongoDB Ops Managerをインストールするディレクトリに移動します。 アーカイブをそのディレクトリに抽出します。

tar -zxf mongodb-mms-<version>.x86_64.tar.gz

重要

古いバージョンと同じディレクトリに新しいバージョンをインストールするには、次の手順に従います。

  1. 現在のインストール ディレクトリの名前を変更します。

    mv <install_dir> <install_dir_old>

  2. 古いディレクトリの元の名前で新しいディレクトリを作成します。

    mkdir <install_dir>

これにより、空のインストール ディレクトリとコード ライブラリの競合が回避されます。

5

各MongoDB Ops Managerホストで、バックアップされたログと構成ファイルをMongoDB Ops Managerのインストール ディレクトリに復元します。

すべてのログファイルを復元する必要があります。 構成ファイルはすべて復元する必要はありませんが、すべて復元する必要があります。 復元:

conf-mms.properties
このMongoDB Ops Manager 配置の 設定 。
gen.key
この MongoDB Ops Manager 配置の バッキング データベース の 暗号化のキー 。

例

次のコマンドは、ホームページ ディレクトリから構成ファイルとログを復元します。

cp -a ~/mms_logs.backup <install_dir>/logs
cp -a ~/mms_conf.backup/conf-mms.properties <install_dir>/conf/conf-mms.properties
cp -a ~/mms_conf.backup/gen.key <install_dir>/conf/gen.key

注意

MongoDB Ops Managerの高可用性インスタンスでは、バックアップデーモンはすべてのノードがアップグレードされるのを待機してから起動します。

6

任意。各MongoDBMongoDB Ops Manager Ops Managerサーバーで、必要な変更をバックアップのmms.conf ファイルにマージします。

mms.confファイルはポートとJVMの構成設定が含まれているため、カスタマイズされることはほとんどありません。 が使用 するポート または JVM MongoDB Ops Manager設定を変更した場合は、 がアップグレードされた後に、バックアップmms.conf コピーからMongoDB Ops Manager ファイルにそれらの変更を再適用する必要があります。

警告

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

MongoDB Ops Manager 4.1 および 4.2 へのアップグレードにより、JAVA_MMS_UI_OPTS パラメータから -d64 フラグが削除されました。

7

アップグレードされたホストでMongoDB Ops Managerを起動します。

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

<install_dir>/bin/mongodb-mms start
8

[任意] MongoDB Ops Manager高可用性配置内の他のすべてのMongoDB Ops Managerホストに対して、前述の手順を繰り返します。

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

ログインが成功した場合は、高可用性MongoDB Ops Manager配置の次のホストでこれらの手順を繰り返します。

9

すべてのエージェントを更新します。

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

[ Update All Agentsをクリックし、変更を確定します。

重要

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

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

トラブルシューティング

認識されない VM オプション

プレフライト チェック出力またはスタートアップ ログには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バージョンで構成ファイルに新しいプロパティが必要な場合は、アップグレード時に ファイルに追加する必要があります。

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

例

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

認識されない VM オプション

プレフライト チェック出力またはスタートアップ ログには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バージョンで構成ファイルに新しいプロパティが必要な場合は、アップグレード時に ファイルに追加する必要があります。

認識されない VM オプション

プレフライト チェック出力またはスタートアップ ログには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バージョンで構成ファイルに新しいプロパティが必要な場合は、アップグレード時に ファイルに追加する必要があります。

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

例

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

不正なリフレクション アクセス

この警告は、 ガイド ライブラリ のバージョンによって表示されます MongoDB Ops Manager は を使用します。この警告は無視しても問題ありません。

戻る

HTTP proxyを介して送信トラフィックを渡す

次へ

MongoDB Ops Managerパッケージの整合性を検証