自己管理型レプリカセットノードのメンテナンスの実行

項目一覧

Overview

手順

Overview

レプリカセットにより、メンテナンスウィンドウの大部分が MongoDB 配置を利用可能な状態に保つことができます。

このドキュメントでは、レプリカセットの各ノードのメンテナンスを実行するための基本的な手順について説明します。さらに、この特定のシーケンスは、プライマリが使用できない時間を最小限に抑え、配置全体への影響を制御するようにします。

これらの手順は、特に MongoDB の最新バージョンへのアップグレードなどの手順の一般的なレプリカセット操作の基準として使用します。

手順

レプリカセットの各ノードに対して、セカンダリノードから始まり、プライマリで終了するまでに次の一連のイベントが実行されます。

mongodインスタンスをスタンドアロンとして再起動します。
スタンドアロンインスタンスでタスクを実行します。
mongodインスタンスをレプリカセットのノードとして再起動します。

セカンダリを停止します。

mongoshで、 mongodインスタンスをシャットダウンします。

db.shutdownServer()

セカンダリを別のポートでスタンドアロンとして再起動します。

オペレーティングシステムの shell プロンプトで、 mongodをスタンドアロンインスタンスとして再起動します。

構成ファイルを使用している場合は、次の構成を更新します。

replication.replSetName オプションをコメントアウトします。
net.portを別のポートに変更します。元のポート設定をコメントとして書き留めておきます。
setParameterセクションでパラメータdisableLogicalSessionCacheRefreshをtrueに設定します。
mongodがシャードまたはコンフィギュレーションサーバーのノードである場合は、次の操作も行う必要があります。
- sharding.clusterRole オプションをコメントアウトします。
- セクションでパラメータskipShardingConfigurationChecks をtrue setParameterに設定します。

たとえば、メンテナンスのためにシャード/コンフィギュレーションサーバーのレプリカセットノードのメンテナンスを実行する場合、更新された構成ファイルには次の例のような内容が含まれます。

net:
   bindIp: localhost,<hostname(s)|ip address(es)>
   port: 27218
#   port: 27018
#replication:
#   replSetName: shardA
#sharding:
#   clusterRole: shardsvr
setParameter:
   skipShardingConfigurationChecks: true
   disableLogicalSessionCacheRefresh: true

コマンドラインオプションを使用する場合は、次の構成更新を行って再起動します。

--replSetNameを削除します。
--portを別のポートに変更します。
--setParameterオプションでパラメータdisableLogicalSessionCacheRefreshをtrueに設定します。
mongodがシャードまたはコンフィギュレーションサーバーのノードである場合は、次の操作も行う必要があります。
- シャードノードの場合は--shardsvrを削除し、コンフィギュレーションサーバーノードの場合は--configsvrを削除します。
- セクションでパラメータskipShardingConfigurationChecks をtrue setParameterに設定します。

たとえば、シャーディングされたクラスターの一部ではないレプリカセットノードを再起動するには、次のようにします。

mongod --port 27218 --dbpath /srv/mongodb --bind_ip localhost,<hostname(s)|ip address(es)> --setParameter disableLogicalSessionCacheRefresh=true

たとえば、メンテナンスのためにシャード/コンフィギュレーションサーバーのレプリカセットノードを再起動するには、次の手順を実行します。

mongod --port 27218 --dbpath /srv/mongodb --bind_ip localhost,<hostname(s)|ip address(es)> --setParameter skipShardingConfigurationChecks=true --setParameter disableLogicalSessionCacheRefresh=true

警告

インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティチェックリスト」を参照してください。最低限、認証を有効化し、ネットワークインフラストラクチャの強化を検討してください。

レプリカセットメンバーをスタンドアロンインスタンスとして再起動する場合でも、常に同じユーザーでmongodを起動します。

セカンダリでメンテナンス操作を実行します。

ノードがスタンドアロンである間は、 mongoshを使用してメンテナンスを実行します。

mongo --port 27218

重要

ノードがスタンドアロンである間は、このノードに書込み (write) は複製されず、このノードへの書込み (write) はレプリカセットの他のノードに複製されることもありません。

このスタンドアロンでの書込みが、レプリカセットに再び追加されたときにノードに適用される oplog の書込みと競合しないことを確認します。

`mongod`レプリカセットのノードとしてを再起動します。

すべてのメンテナンスタスクを実行した後、次の手順で、 mongodをレプリカセットのノードとして通常のポートで再起動します。

mongoshから、メンテナンス完了後にスタンドアロンサーバーをシャットダウンします。

use admin
db.shutdownServer()

mongodインスタンスを元の構成のレプリカセットメンバーとして再起動します。つまり、スタンドアロンとして起動する際に行った構成変更を元に戻します。

Tip

disableLogicalSessionCacheRefresh パラメーターは必ず削除してください。

シャードノードまたはコンフィギュレーションサーバーノードの場合は、 skipShardingConfigurationChecksパラメータを必ず削除してください。

起動したら、 mongoshを再起動されたインスタンスに接続します。

セカンダリがプライマリに追いつくのに時間がかかります。 mongoshから、次のコマンドを使用して、ノードがRECOVERING状態からSECONDARY状態に追いついたことを確認します。

rs.status()

最後にプライマリのメンテナンスを実行します。

すべてのセカンダリのメンテナンスタスクが完了した後にプライマリのメンテナンスを実行するには、 mongoshをプライマリに接続し、 rs.stepDown()を使用してプライマリを降格し、セカンダリの 1 つが新しいプライマリに選出されるようにします。 5 分間、ノードが再度プライマリに選出されないようにするには、 300秒の待機期間を指定します。
```
rs.stepDown(300)
```
プライマリが降格すると、レプリカセットは新しいプライマリを選択します。
mongodをスタンドアロンインスタンスとして再起動し、次の構成更新を行います。

構成ファイルを使用している場合は、次の構成を更新します。

replication.replSetName オプションをコメントアウトします。
net.portを別のポートに変更します。元のポート設定をコメントとして書き留めておきます。
--setParameterオプションでパラメータdisableLogicalSessionCacheRefreshをtrueに設定します。
mongodがシャードまたはコンフィギュレーションサーバーのノードである場合は、次の操作も行う必要があります。
- sharding.clusterRole オプションをコメントアウトします。
- セクションでパラメータskipShardingConfigurationChecks をtrue setParameterに設定します。

net:
   bindIp: localhost,<hostname(s)|ip address(es)>
   port: 27218
#   port: 27018
#replication:
#   replSetName: shardA
#sharding:
#   clusterRole: shardsvr
setParameter:
   skipShardingConfigurationChecks: true
   disableLogicalSessionCacheRefresh: true

警告

コマンドラインオプションを使用する場合は、次の構成更新を行います。

--replSetNameを削除します。
--portを別のポートに変更します。
--setParameterオプションでパラメータdisableLogicalSessionCacheRefreshをtrueに設定します。
mongodがシャードまたはコンフィギュレーションサーバーのノードである場合は、次の操作も行う必要があります。
- シャードノードの場合は--shardsvrを削除し、コンフィギュレーションサーバーノードの場合は--configsvrを削除します。
- セクションでパラメータskipShardingConfigurationChecks をtrue setParameterに設定します。

たとえば、シャーディングされたクラスターの一部ではないレプリカセットノードを再起動するには、次のようにします。

mongod --port 27218 --dbpath /srv/mongodb --bind_ip localhost,<hostname(s)|ip address(es)> --setParameter disableLogicalSessionCacheRefresh=true

たとえば、メンテナンスのためにシャード/コンフィギュレーションサーバーのレプリカセットノードを再起動するには、次の手順を実行します。

mongod --port 27218 --dbpath /srv/mongodb --bind_ip localhost,<hostname(s)|ip address(es)> --setParameter skipShardingConfigurationChecks=true --setParameter disableLogicalSessionCacheRefresh=true

警告

スタンドアロンになったでメンテナンスタスクを実行します。
重要
ノードがスタンドアロンである間は、このノードに書込み (write) は複製されず、このノードへの書込み (write) はレプリカセットの他のノードに複製されることもありません。
このスタンドアロンでの書込みが、レプリカセットに再び追加されたときにノードに適用される oplog の書込みと競合しないことを確認します。
すべてのメンテナンスタスクを実行した後、 mongodインスタンスを元の構成のレプリカセットメンバーとして再起動します。つまり、スタンドアロンとして起動する際に行った構成変更を元に戻します。
Tip
disableLogicalSessionCacheRefresh パラメーターは必ず削除してください。
シャードノードまたはコンフィギュレーションサーバーノードの場合は、 skipShardingConfigurationChecksパラメータを必ず削除してください。

戻る

oplogサイズの変更

プライマリの強制