MongoDB Ops Managerアップグレード
このチュートリアルでは、既存の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 以降のすべてのアップグレードでは、 同じ手順を使用します。 上位のバージョンにアップグレードするには、まずこの手順で初期バージョンの利用可能な最新パッチにアップグレードし、次に手順を再度使用して次のバージョンにアップグレードする必要があります。 次の表に、特定のバージョンのアップグレード手順に関連する追加情報がある場合は、まずそれを確認してください。
重要
ライブ移行（プッシュ）: MongoDB Ops Manager によって管理または監視されるソース配置では非推奨またはサポート対象外
配置が Ops Manager によって管理または監視される MongoDB 6.0 以降のバージョンを実行するソース配置の場合、ライブ移行（プッシュ）はサポートされません。
配置が Ops Manager によって管理または監視される MongoDB 5.0 以前のバージョンを実行するソース配置の場合、ライブ移行（プッシュ）は非推奨です。
MongoDB 6.0 .+ を実行しているソース配置の場合、 配置が Cloud Manager によって監視されている場合は、ライブ移行（プッシュ）がサポートされます。 詳細については、「 Cloud Manager によって監視されている MongoDB クラスターの Atlas へのライブ移行 」を参照してください。
以下の表は、すべてのバージョンのアップグレードパスを示しています。
既存のバージョン | アップグレード パス |
|---|---|
7.0.x | この手順 を使用して、 MongoDB Ops Manager7.0.x から の最新の利用可能なパッチ バージョンにアップグレードします。7.0 |
6.0.x | MongoDB Ops Manager 6.0.x から 6.0 の最新の利用可能なパッチ バージョンにアップグレードします。 次に、利用可能な最新バージョンの7.0にアップグレードします。 両方のアップグレードでこの手順を使用します。 |
5.0.x | MongoDB Ops Manager 5.0.x から 5.0 の最新の利用可能なパッチ バージョンにアップグレードします。 次に、利用可能な最新バージョンの6.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を 6.0 から 7.0 にアップグレードする前に、次の考慮事項を確認してください。
バッキング データベース
MongoDB Ops Manager 7.0.0 には、少なくとも バッキング データベースにMongoDB 6.0.0 が必要です。MongoDB Ops Manager
注意
バッキング データベースの MongoDBバージョンは、MongoDB Ops ManagerMongoDB Ops Manager のバージョンよりもそれ以降にすることはできません。
互換性のある MongoDB ツール
MongoDB Ops ManagerがMongoDB Tools を管理している場合、 MongoDB Ops MongoDB Ops Managerをアップグレードするとツールのバージョンもアップグレードされます。
MongoDB Ops Manager 7.0.x をローカル モードで実行する場合は、互換性のあるバージョンのMongoDB Tools TGZ パッケージをダウンロードし、versions ディレクトリにインストールする必要があります。
MongoDB Tools の古いバージョンにアクセスするには、ダウンロード ページの [アーカイブされたリリース] をクリックします。
MongoDB Ops Managerおよびオートメーション プラットフォームのサポート
MongoDB Ops ManagerMongoDB AgentDebian10 の および のサポートを削除します。
MongoDB Ops ManagerMongoDB AgentUbuntu18.04 LTS の と のサポートを削除します。
重要
MongoDB Ops Manager 7.0 では、 RedHat Enterprise Linux 7、 SUSE Linux Enterprise Server 12、 Ubuntu 20.04 LTS のサポートが廃止されます。
オートメーション サポートの変更
MongoDB バージョン 4.0 以前の自動化、モニタリング、バックアップのサポートを廃止します。 MongoDB Ops Managerは、 MongoDB 4.2 以降を実行するデータベースのみを管理できます。
SNMPアラートのサポートを廃止します。
代わりにMongoDB Ops Managerを使用してクラスターを監視できます。 その他のアラート オプションの詳細については、「サードパーティ サービスの統合 」を参照してください。
シャーディングされたコレクションの管理 UI のサポートを廃止します。
UI を通じてコレクションをシャーディングする機能、シャーディングされたクラスター バランサーを管理する機能、シャーディングされたゾーンを管理する機能を排除します。
mongoshを使用すると、コマンドラインからシャーディングされたクラスターを完全に制御できます。
移行
のMongoDB Cloud Migration ServiceMongoDB Ops Manager のサポートを廃止します。プッシュベースの移行を使用して MongoDB Atlas に配置を移行する必要がある場合は、MongoDB Cloud Manager の クラウド移行サービス を使用できます。
ユーザー インターフェース
Internet Explorer 11 のサポートを廃止します。
構成設定の変更
mms.userSvcClass設定のアプリケーション データベース認証方法を表す許容値をcom.xgen.svc.mms.svc.user.UserSvcDbからcom.xgen.cloud.user._private.svc.UserSvcDbに更新します。重要
古い許容値である
com.xgen.svc.mms.svc.user.UserSvcDbを使用すると、MongoDB Ops Manager インスタンスはプレフライト チェック中に起動しません。
前提条件
ハードウェアとソフトウェアの要件
サーバーはMongoDB Ops Managerのシステム要件 を満たしている必要があります。
警告
本番環境障害の可能性
以下の構成に失敗すると、 MongoDB Ops Managerインスタンスが本番環境で失敗する可能性があります。
MongoDB Ops Managerは、 MongoDB Ops Managerシステム要件 ごとにホストします。
MongoDB マニュアルのプロダクション ノートに記載されている MongoDB ホスト。 MongoDBMongoDB のMongoDB Ops Manager インスタンスには、次のものが含まれます。
バッキング データベースが MMAPv 1ストレージ エンジンを実行している場合、アップグレード プロセスは失敗します。 MongoDB Ops Managerは、これらのバッキング データベースのストレージ エンジンをWiredTigerにアップグレードするように促します。
管理者の特権
アップグレードを実行するサーバーに対する管理者特権が必要です。
MongoDB からのソフトウェアのダウンロード
ソフトウェアをダウンロードするには、カスタマー ダウンロード ページにあるダウンロード リンクをクリックします。 MongoDB は、そのページのURLをカスタマーに提供します。
このリンクにアクセスできない場合は、 ソフトウェアの現在の評価コピーの ダウンロード ページMongoDB Ops Manager にアクセスしてください。
MongoDB Ops Managerソフトウェアの以前のバージョンが必要な場合は、 Release Archive にアクセスしてください。
ローカル モードで実行するためのソフトウェアをダウンロード
MongoDB Ops Managerをローカル モードで実行する場合は、 MongoDBソフトウェアをバージョン ライブラリ ディレクトリにダウンロードします。 必要なソフトウェアには、次のものが含まれます。
インストールする MongoDB CommunityまたはEnterpriseのすべてのバージョン
MongoDB ツール. MongoDB Tools のバージョンは、 MongoDB Ops Managerのリリースノートに記載されているバージョンと互換性のあるMongoDB Ops Manager Ops Manager のバージョンと一致する必要があります。
プラットフォームの互換性
MongoDB Ops Managerをアップグレードする前に、以下を確認してください。
MongoDB Ops Managerを提供するホストのプラットフォームは5.0 と互換性があります。
MongoDB配置を管理するMongoDBエージェントは、 MongoDB Ops Manager 5.0 と互換性があります。
MongoDB Ops Manager エージェントを提供するホストのプラットフォームは、エージェントと互換性があります。
BI Connector を使用する場合は、 MongoDB を 4.0 以降にアップグレードします。
ホストのプラットフォームをアップグレードした場合は、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インスタンスを再起動します。
バックアップデーモンを手動で停止します。
バックアップデーモンを手動で停止する方法
バックアップデーモンを提供する最初のホストにログインします。
次のコマンドを発行します:
sudo service mongodb-mms-backup-daemon stop バックアップデーモンがシャットダウンしていることを確認します。
ps -ef | grep mongodb-mms-backup-daemon バックアップデーモンが引き続き実行される場合は、次のコマンドを発行します。
sudo /etc/init.d/mongodb-mms-backup-daemon stop 他のバックアップデーモン ホストごとにステップ 2 から 3 を繰り返します。
バックアップデーモンを提供する最初のホストにログインします。
次のコマンドを発行します:
sudo service mongodb-mms-backup-daemon stop バックアップデーモンがシャットダウンしていることを確認します。
ps -ef | grep mongodb-mms-backup-daemon バックアップデーモンが引き続き実行される場合は、次のコマンドを発行します。
sudo /etc/init.d/mongodb-mms-backup-daemon stop 他のバックアップデーモン ホストごとにステップ 2 から 3 を繰り返します。
バックアップデーモンを提供する最初のホストにログインします。
次のコマンドを発行します:
<install_dir>/bin/mongodb-mms-backup-daemon stop バックアップデーモンがシャットダウンしていることを確認します。
ps -ef | grep mongodb-mms-backup-daemon バックアップデーモンが引き続き実行される場合は、次のコマンドを発行します。
sudo /etc/init.d/mongodb-mms-backup-daemon stop 他のバックアップデーモン ホストごとにステップ 2 から 3 を繰り返します。
MongoDB Ops Managerアプリケーションを高可用性構成で実行している場合は、一度に 1 つのMongoDB Ops Managerホストでこの手順を完了します。
deb パッケージを使用してインストールされたホスト上のMongoDB Ops Managerアプリケーションをアップグレードするには、次の手順に従います。
MongoDB Ops Managerパッケージの最新バージョンをダウンロードします。
ご希望のブラウザを開き、 MongoDB.comの MongoDB Download Centerにアクセスします。
MongoDB.com から起動する場合は、 ProductsをクリックしますOps Manager Try it now 。
Platformsドロップダウン メニューから [ Ubuntu 22.04 ] をクリックします。
Packagesドロップダウン メニューから、x86_64 アーキテクチャの [ DEB ] をクリックします。
[Download] をクリックします。
ダウンロードしたパッケージの名前は
mongodb-mms-<version>.x86_64.debで、<version>はバージョン番号です。
アップグレードするホストに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アプリケーションとバックアップデーモンの各ホストに
.debパッケージをインストールします。 次のコマンドを発行します。ここで、<version>は.debパッケージのバージョンです。sudo dpkg -i mongodb-mms_<version>_x86_64.deb 現在インストールされているバージョンの
mms.confを上書きするかどうかを確認するプロンプトが表示されたら、Yと入力して既存のファイルを置き換える必要があります。が使用 するポートまたは JVM 設定を変更MongoDB Ops Manager した場合は、 がアップグレードされた後に、それらの変更を
mms.confMongoDB Ops Managerファイルに再適用する必要があります。警告
mms.confファイル内のJVM引数にパスワードやシークレットを追加しないでください。 MongoDB Ops Managerは、診断アーカイブでプレーンテキストとしてこれらを公開します。MongoDB Ops Manager 4.1 および 4.2 へのアップグレードにより、
JAVA_MMS_UI_OPTSパラメータから-d64フラグが削除されました。MongoDB Ops Manager 4.4.11 にアップグレードすると、 MongoDB Ops Manager では、使用する
/opt/mongodb/mms/conf/conf-mms.propertiesファイルのバージョンを選択するよう求められます。 MongoDB Ops Managerを手動で再構成する必要がないようにするには、現在の ファイルを選択します。 詳細については、 4.4.11 リリースノート を参照してください。
アップグレードされたホストでMongoDB Ops Managerを起動します。
sudo service mongodb-mms start
注意
MongoDB Ops Managerの高可用性インスタンスでは、バックアップデーモンはすべてのノードがアップグレードされるのを待機してから起動します。
アップグレードされたMongoDB Ops Managerホストが再起動後にログインします。 ログインが成功すると、アップグレードは成功します。
すべてのエージェントを更新します。
アップグレードが完了したら、 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アプリケーションをアップグレードするには、次の手順に従います。
最初に実行中のMongoDB Ops Managerインスタンスを停止します。
RHEL、CentOS では、SUSE12 systemd を使用する ホスト 、次のコマンドを発行して、 アプリケーションを停止します。MongoDB Ops Manager
sudo service mongodb-mms stop
SysVInitを使用するプラットフォームの場合は、次のコマンドを発行します。
sudo /etc/init.d/mongodb-mms stop
MongoDB Ops Managerパッケージの最新バージョンをダウンロードします。
ご希望のブラウザを開き、 MongoDB.comのMongoDB Download Centerにアクセスします。
MongoDB.com から起動する場合は、 ProductsをクリックしますOps Manager Try it now 。
Platformsドロップダウン メニューから、次のいずれかのオプションをクリックします。
Red Hat + CentOS 7, 8, 9 / SUSE 12 + 15 / Amazon Linux 2, Amazon Linux 2023
Packages ドロップダウン メニューから RPM をクリックします。
[Download] をクリックします。
ダウンロードしたパッケージの名前は
mongodb-mms-<version>.x86_64.rpmで、<version>はバージョン番号です。
アップグレードする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
警告
rpm MongoDB Ops Managerバージョン 6.0.0、6.0.1、および 6.0.2 の パッケージに誤ったバージョン情報が含まれており、標準アップグレードが失敗する可能性があります。 これらのバージョンのいずれかからバージョン 6.0.3 以降にアップグレードする場合は、 --forceフラグを使用してパッケージをアップグレードします。
sudo rpm -Uvh --force 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は、診断アーカイブでプレーンテキストとしてこれらを公開します。
ファイルをシンボリック リンクで置き換えinit
次の既存のファイルは、RPM を使用したMongoDB Ops Manager 4.2 インストールのアップグレードをブロックします。
/etc/init.d/mongodb-mms/etc/init.d/mongodb-mms-backup-daemon
アップグレードを完了するには、以下の手順を行います。
次のコマンドを発行して、古い
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 sudo mv /etc/init.d/mongodb-mms /etc/init.d/mongodb-mms-6.0 sudo mv /etc/init.d/mongodb-mms-backup-daemon /etc/init.d/ mongodb-mms-backup-daemon-6.0 次のコマンドを発行して、 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
アップグレードされたホストで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 で一時的に一時停止することがあります。
すべてのエージェントを更新します。
アップグレードが完了したら、 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 システムをアップグレードするには、この手順を使用します。
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
Versions Directoryが<install_dir>にある場合はバックアップします。
cp -a <install_dir>/mongodb-releases ~/mms_versions.backup
また、 MongoDB Ops ManagerがMongoDB Ops Managerのバッキング データベースとユーザー認証情報を暗号化および復号化するために使用する gen.key ファイルもバックアップする必要があります。 MongoDB Ops Managerでは、高可用性のMongoDB Ops Manager配置の一部であるすべてのサーバーで同一の gen.key ファイルが必要です。
MongoDB Ops Managerパッケージの最新バージョンをダウンロードします。
ご希望のブラウザを開き、 MongoDB.comのMongoDB Download Centerにアクセスします。
MongoDB.com から起動する場合は、 ProductsをクリックしますOps Manager Try it now 。
[ Versionドロップダウン メニューから、提供されている安定バージョンのいずれかをクリックします。
Platformドロップダウン メニューから、次のいずれかのオプションをクリックします。
Red Hat + CentOS 7, 8, 9 / SUSE 12 + 15 / Amazon Linux 2, Amazon Linux 2023
Debian 9, 10, 11 / Ubuntu 18.04
Package ドロップダウン メニューから tar.gz をクリックします。
[Download] をクリックします。
ダウンロードしたパッケージの名前は
mongodb-mms-<version>.x86_64.tar.gzで、<version>はバージョン番号です。
アップグレードする各ホストに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
重要
古いバージョンと同じディレクトリに新しいバージョンをインストールするには、次の手順に従います。
現在のインストール ディレクトリの名前を変更します。
mv <install_dir> <install_dir_old> 古いディレクトリの元の名前で新しいディレクトリを作成します。
mkdir <install_dir>
これにより、空のインストール ディレクトリとコード ライブラリの競合が回避されます。
各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
以前にVersions Directoryをバックアップした場合は、 <install_dir > に復元します。
cp -a ~/mms_versions.backup <install_dir>/mongodb-releases.
注意
MongoDB Ops Managerの高可用性インスタンスでは、バックアップデーモンはすべてのノードがアップグレードされるのを待機してから起動します。
任意。 各MongoDB 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 フラグが削除されました。
すべてのエージェントを更新します。
アップグレードが完了したら、 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-mmsmms.confconf-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-mmsmms.confconf-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-mmsmms.confconf-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 は を使用します。この警告は無視しても問題ありません。