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 6にアップグレードすることをお勧めします。 0 MongoDB Ops Manager 8.0 にアップグレードする前に
既存の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バージョン 6.0.x 以降のすべてのアップグレードでは、 同じ手順を使用します。 上位のバージョンにアップグレードするには、まずこの手順で初期バージョンの利用可能な最新パッチにアップグレードし、次に手順を再度使用して次のバージョンにアップグレードする必要があります。 次の表に、特定のバージョンのアップグレード手順に関連する追加情報がある場合は、まずそれを確認してください。
重要
ライブ移行(プッシュ): MongoDB Ops Manager によって管理または監視されるソース配置では非推奨またはサポート対象外
配置が Ops Manager によって管理または監視される MongoDB 6.0 以降のバージョンを実行するソース配置の場合、ライブ移行(プッシュ)はサポートされません。
配置が Ops Manager によって管理または監視される MongoDB 5.0 以前のバージョンを実行するソース配置の場合、ライブ移行(プッシュ)は非推奨です。
MongoDB 6.0 .+ を実行しているソース配置の場合、 配置が Cloud Manager によって監視されている場合は、ライブ移行(プッシュ)がサポートされます。 詳細については、「 Cloud Manager によって監視されている MongoDB クラスターの Atlas へのライブ移行 」を参照してください。
以下の表は、すべてのバージョンのアップグレードパスを示しています。
既存のバージョン | アップグレード パス |
---|---|
8.0.x | この手順 を使用して、 MongoDB Ops Manager8.0.x から の最新の利用可能なパッチ バージョンにアップグレードします。8.0 |
7.0.x | MongoDB Ops Manager 7.0.x から 7.0 の最新の利用可能なパッチ バージョンにアップグレードします。 次に、利用可能な最新バージョンの8.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を 7.0 から 8.0 にアップグレードする前に、次の考慮事項を確認してください。
バッキング データベース
MongoDB Ops Manager 8.0.0 には、少なくともMongoDB6.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 8.0.x をローカル モードで実行する場合は、互換性のあるバージョンのMongoDB Tools TGZ パッケージをダウンロードし、versions
ディレクトリにインストールする必要があります。
MongoDB Tools の古いバージョンにアクセスするには、ダウンロード ページの [アーカイブされたリリース] をクリックします。
Ops Manager プラットフォームのサポート
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インスタンスが本番環境で失敗する可能性があります。
MongoDB Ops Managerは、 MongoDB Ops Managerシステム要件 ごとにホストします。
MongoDB マニュアルのプロダクション ノートに記載されている MongoDB ホスト。 MongoDBMongoDB のMongoDB Ops Manager インスタンスには、次のものが含まれます。
Ops Manager Application Database
各ブロックストア。
アップグレード プロセスを開始する前に、データを保持しているすべてのメンバーが実行中されていることを確認してください。 レプリカセットメンバーのステータスを確認するには、 replSetGetStatus
を実行します。
バッキング データベースが 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.4以降にアップグレードします。
ホストのプラットフォームをアップグレードした場合は、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.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 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の高可用性インスタンスでは、バックアップデーモンはすべてのノードがアップグレードされるのを待機してから起動します。
任意。 各 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-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 は を使用します。この警告は無視しても問題ありません。