このチュートリアルでは、既存の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 にアップグレードする前に
既存のMongoDB Ops Managerインストールのバージョンによって、MongoDB Ops Manager 6.0以降にアップグレードするために必要なアップグレードパスが決まります。
重要
MongoDB Ops Manager 6.0 以降のインストールで、複数のMongoDB Ops Managerホストが同じアプリケーション データベースを指している場合は、モニタリング ダウンタイムを発生させずにMongoDB Ops Managerをアップグレードできます。 このアップグレード中、 MongoDB Ops Managerはアップグレード モードと呼ばれる状態になります。 詳細については、「アップグレード モード 」を参照してください。
アップグレードを成功させるには、既存のバージョンのアップグレード パスに従って、必要なデータベース移行を実行する必要があります。
データを保護するため、MongoDB Ops Managerは、バージョン1.8.xおよび2.0.xからバージョン6.0以降への直接アップグレードの開始を拒否します。
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 Manager API書き込みの インスタンスが再度有効になるバグを修正します。 詳しくは以下を参照してください。 |
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 Managerをアップグレードするとツールのバージョンも自動的にアップグレードされます。
MongoDB Ops8.0 Manager.x を ローカル モード で実行する場合は、 データベースversions ツールの互換性テーブル に記載されている最新バージョンの mongosh と MongoDB Database Tools TGZ パッケージ をダウンロードして ディレクトリにインストールする必要があります。
ダウンロード ページでは、最新の Database 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をホストするプラットフォームは、9.0と互換性があります。
お客様の MongoDB 配置を管理する MongoDB エージェントは、Ops Manager 9.0 と互換性があります。
MongoDB Ops Manager エージェントを提供するホストのプラットフォームは、エージェントと互換性があります。
BI Connector を使用する場合は、 MongoDBを6.0以降にアップグレードします。
ホストのプラットフォームをアップグレードした場合は、MongoDB Agent をアップグレードする 前にMongoDB 、MongoDB Ops Manager Agent をアップグレードしてください。
注意
Ops Manager 9.0 では、BI Connector は新しい配置に対してデフォルトで無効になっています。BI Connectorは30年2026月日にサポート終了となりましたが、既存のBI Connectorインスタンスは引き続きMongoDB Ops Managerで利用および管理できます。MongoDBでは、代わりにSQL Interfaceを使用することを推奨しています。
手順
注意
高可用性アプリケーションのアップグレードモード
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ダウンロードする センターに移動します。
Platformsドロップダウン メニューから [ Debian 12, 13 / Ubuntu 22.04, 24.04 ] をクリックします。
Packagesドロップダウン メニューから、x86_64 アーキテクチャの [ DEB ] をクリックします。
[Download] をクリックします。
ダウンロードしたパッケージの名前は
mongodb-mms-<version>.x86_64.debで、<version>はバージョン番号です。
アップグレードするホストにMongoDB Ops Managerパッケージをインストールします。
注意
高可用性MongoDB Ops Managerアプリケーションのアップグレード モード
複数のMongoDB Ops Managerホストが同じアプリケーションデータベースを指すMongoDB Ops Manager 6.0インストールがある場合、このMongoDB Ops Managerの配置は高可用性で実行されます。高可用性のOps Manager配置の1つのOps Managerホストするをアップグレードした後、その配置はアップグレードモードに入ります。
MongoDB Ops Managerアプリケーションとバックアップデーモンの各ホストに
.debパッケージをインストールします。 次のコマンドを発行します。ここで、<version>は.debパッケージのバージョンです。sudo dpkg -i mongodb-mms_<version>_x86_64.deb現在インストールされているバージョンの
mms.confを上書きするかどうかを確認するプロンプトが表示されたら、Yと入力して既存のファイルを置き換える必要があります。MongoDB Ops Manager 6.0 にアップグレードする場合、MongoDB Ops Manager は、使用する
/opt/mongodb/mms/conf/conf-mms.propertiesファイルのバージョンを選択するように求めます。MongoDB Ops Manager を手動で再設定する必要がないようにするには、現在のファイルを選択します。
[任意] MongoDB Ops Manager高可用性配置内の他のすべてのMongoDB Ops Managerホストに対して、前述の手順を繰り返します。
MongoDB Ops Manager は、すべてのホストがアップグレードされるまで、アップグレードモードのままになります。高可用性構成 の場合、これは次のことを意味します。
アップグレードがクラスター全体で完了するまで、ホストが完全に使用できない場合があります。最初のホストのアップグレードが予想よりも長い時間がかかる場合は、他のホストのアップグレードを続行します。
アップグレードが中断される可能性があるため、停止していると思われるプロセスを停止したりキャンセルしたりしないでください。
MongoDB Ops Manager がスタートアップ中に生成するログが
Starting pre-flight checksで一時停止されることがありますが、 MongoDB Ops Manager はすべてのサーバーを同じバージョンにアップグレードします。マルチバージョンアップグレードの場合は、メジャーバージョンをスキップしないでください 。クラスター内の各ノードを、一度に各メジャー リリースの最後のマイナー バージョンに 1 つずつアップグレードする必要があります。例、6.0.26 から 8.0.3 にアップグレードするには、各ノードで次の手順を実行します。
ノード（6.0.26を実行中）でサービスを停止します。
7.0.x の最新のマイナー バージョンにアップグレードします。
次のノードに移動する前に、アップグレードされたホストを起動します。
他のすべてのノードに対して繰り返します。
このプロセスを繰り返して、各ノードを 7.0.x から 8.0.3 にアップグレードします。
すべてのエージェントを更新します。
アップグレードが完了したら、 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をプロビジョニングまたは更新するというステートメントとして解釈しないでください。
rpm パッケージを使用してインストールされたホスト上のMongoDB Ops Managerアプリケーションをアップグレードするには、次の手順に従います。
最初に実行中のMongoDB Ops Managerインスタンスを停止します。
RHEL、 CentOS、 SUSE ホストで12 systemd を使用する SUSE ホストでは、次のコマンドを発行してMongoDB Ops Managerアプリケーションを停止します。
sudo service mongodb-mms stopSysVInitを使用するプラットフォームの場合は、次のコマンドを発行します。
sudo /etc/init.d/mongodb-mms stopMongoDB Ops Managerパッケージの最新バージョンをダウンロードします。
お好みのブラウザを開き、MongoDBダウンロードする センターに移動します。
Platformsドロップダウン メニューから、次のいずれかのオプションをクリックします。
- RHEL 8, 9, 10 / SUSE 15, 16 / 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ホストが同じアプリケーションデータベースを指すMongoDB Ops Manager 6.0インストールがある場合、このMongoDB Ops Managerの配置は高可用性で実行されます。高可用性のOps Manager配置の1つの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.rpmMongoDB 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 は、診断アーカイブ内でそれらをプレーン テキストとして表示します。
アップグレードされたホストでMongoDB Ops Managerを起動します。
RHEL 、 CentOS、 SUSE ホストで12 systemd を使用する SUSE ホストで、次のコマンドを発行します。
sudo service mongodb-mms startSysVInitを使用するプラットフォームの場合は、次のコマンドを発行します。
sudo /etc/init.d/mongodb-mms start注意
Ops Manager の高可用性インスタンスでは、Ops Manager サービスのスタートアップは、すべてのサーバーがアップグレードするのを待機してから開始します。
すべてのエージェントを更新します。
アップグレードが完了したら、 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をプロビジョニングまたは更新するというステートメントとして解釈しないでください。
debまたはrpmパッケージを使用していない Linux システムをアップグレードするには、この手順を使用します。
MongoDB Ops Managerホスト上の構成ファイルをバックアップします。
アップグレードするMongoDB Ops Managerホストで、既存の構成ファイルとログをインストール ディレクトリ以外のディレクトリにバックアップします。
重要
この手順の後半では、バックアップされた<install_dir>/conf/conf-mms.propertiesファイルが必要です。
例
次のコマンドを使用すると、構成ファイルとログをホームページ ディレクトリにバックアップできます。
cp -a <install_dir>/conf ~/mms_conf.backupcp -a <install_dir>/logs ~/mms_logs.backupVersions 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ダウンロードする センターに移動します。
[ Versionドロップダウン メニューから、提供されている安定バージョンのいずれかをクリックします。
Platformドロップダウン メニューから、次のいずれかのオプションをクリックします。
RHEL 8, 9, 10 / SUSE 15, 16 / Amazon Linux 2023
Debian 12, 13 / Ubuntu 22.04, 24.04
Package ドロップダウン メニューから tar.gz をクリックします。
[Download] をクリックします。
ダウンロードしたパッケージの名前は
mongodb-mms-<version>.x86_64.tar.gzで、<version>はバージョン番号です。
アップグレードする各ホストにMongoDB Ops Managerパッケージをインストールします。
注意
高可用性MongoDB Ops Managerアプリケーションのアップグレード モード
複数のMongoDB Ops Managerホストが同じアプリケーションデータベースを指すMongoDB Ops Manager 6.0インストールがある場合、このMongoDB Ops Managerの配置は高可用性で実行されます。高可用性のOps Manager配置の1つの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>/logscp -a ~/mms_conf.backup/conf-mms.properties <install_dir>/conf/conf-mms.propertiescp -a ~/mms_conf.backup/gen.key <install_dir>/conf/gen.key以前にVersions Directoryをバックアップした場合は、 <install_dir > に復元します。
cp -a ~/mms_versions.backup <install_dir>/mongodb-releases.注意
Ops Manager の高可用性インスタンスでは、Ops Manager サービスのスタートアップは、すべてのサーバーがアップグレードするのを待機してから開始します。
任意。各 Ops Managerサーバーで、必要な変更をバックアップの mms.confファイルにマージします。
mms.confファイルにはポートとJVMの構成設定が含まれているため、カスタマイズされることはほとんどありません。MongoDB Ops Manager が使用する ポート または JVM 設定を変更した場合、MongoDB Ops Manager の㌨ップグレード後、バックアップ コピーからその変更を mms.conf ファイルに再適用する必要があります。
警告
mms.conf ファイルの JVM 引数にパスワードやシークレットを追加しないでください。MongoDB Ops Manager は、診断アーカイブ内でそれらをプレーン テキストとして表示します。
MongoDB Ops Manager 6.0 へのアップグレードにより、JAVA_MMS_UI_OPTS パラメータから -d64 フラグが削除されました。
すべてのエージェントを更新します。
アップグレードが完了したら、 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をプロビジョニングまたは更新するというステートメントとして解釈しないでください。
トラブルシューティング
認識されない 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ドライバー で導入された新しいパラメータを含めるように の値を更新します。デフォルトでは 、このドライバーは再試行可能な読み取りと 再試行可能な書込み を有効にします。読み取りと書込みを再試行するようにカスタム ロジックを設定すると、試行に時間がかかりすぎる可能性があります。これらのデフォルト値を無効にするには、次の内容を接続文字列に追加します。
例
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ドライバー で導入された新しいパラメータを含めるように の値を更新します。デフォルトでは 、このドライバーは再試行可能な読み取りと 再試行可能な書込み を有効にします。読み取りと書込みを再試行するようにカスタム ロジックを設定すると、試行に時間がかかりすぎる可能性があります。これらのデフォルト値を無効にするには、次の内容を接続文字列に追加します。
例
MongoDB ://SERVER:port/?maxPoolSize=150+retryWrites=false_retryReads=false
不正なリフレクション アクセス
この警告は、MongoDB Ops Manager が使用する Guice ライブラリ のバージョンに基づき表示されます。この警告は無視しても問題ありません。