説明
Perforce Helix Coreのフェイルオーバー機能を使用したHA環境構築の手順を説明しています
...
本構築作業の条件は以下の通りです
マスター | スタンバイ | Perforce super user | |
サーバ名 | master | standby | super |
ServerID | master | standby | レプリケーション用ユーザ名 |
Option | - | mandatory | service |
server-service | commit-server | standby | |
IP | 192.168.56.114 | 192.168.56.115 | |
Port | 1666 | 1666 | |
P4ROOT | /master | /standby |
構築手順
１．スタンバイサーバのサーバ仕様作成
...
【マスタサーバで作業します】
① p4コマンドで“standby”というスタンバイサーバのサーバ仕様を作成します
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 -u super -p master-server:port server standby |
...
-serverID |
...
192.168.56.114:1666 server standby |
...
② 設定を修正・追加します
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
ServerID: standby |
...
standby ●standard（default）を上書き |
...
nomandatory ●変更しない※新規サーバはmandatoryにできません。後で変更します |
...
master ●一行追記する(マスタサーバのserver ID) |
...
| 情報 | ||
|---|---|---|
| ||
startup.1=journalcopy -i 1 …… 起動時にjournalcopy（マスタサーバのjournalをスタンバイに移送）を実行 |
...
２．サービスユーザの作成と設定【マスタサーバで作業します】
① p4コマンドで“service”というレプリケーション用サービスユーザを作成します
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 -u super -p master-server:port user -f service |
...
-user |
２．設定を修正・追加します
赤文字部分が修正箇所です② 設定を修正・追加します
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
User: service |
...
service ●一行追記する |
３．サービスユーザ ③ サービスユーザ “service” のパスワードを設定します
実行コマンド
p4
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 -u super -p master-server:port passwd service-user |
...
例：p4 -u super -p 192.168.56.114:1666 passwd service |
...
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Enter new password: （任意のパスワードを入力します） |
４．サービスユーザ ④ サービスユーザ “service” のアクセスレベルの設定を追加します
実行コマンド
p4 protect 表示例）
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 protect |
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
write user * * //... |
...
【マスタサーバで作業します】
１．スタンバイサーバ用のチェックポイントファイルを作成します
作成したチェックポイントファイル名は“checkpoint”としています
...
●一行追加する |
３．チェックポイントの作成と移動【マスタサーバで作業します】
① スタンバイサーバ用のチェックポイントファイルを作成します
作成したチェックポイントファイル名は“checkpoint”としています
チェックポイントファイル(ファイル名：checkpoint.ckp.1)が作成されます
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 -u super -p master-server:port admin |
...
checkpoint filename |
チェックポイントファイル(ファイル名：checkpoint.ckp.1)が作成されます
２．チェックポイントファイルを転送します
FTPツール② チェックポイントファイルを転送します
FTPツール(任意)を使用して、スタンバイサーバへチェックポイントファイル(checkpoint.ckp.1)を転送します。
※このマニュアルではスタンバイサーバの ※このマニュアルではスタンバイサーバの /tmp に格納しています
４．スタンバイサーバの設定
【スタンバイサーバでの作業です】
１～４の作業については、サーバ構築方法によって対応が異なります。実環境をご確認の上、必要に応じて作業してください。
１．P4ROOT用のディレクトリ “standby” を作成します ※既にルートフォルダを作成済みであれば、作業不要です
実行コマンド
mkdir /standby
２．作成したディレクトリのownerを“root”から“perforce”に変更します ※ownerがperforceであれば作業不要です
実行コマンド
chown
４．スタンバイサーバの設定【スタンバイサーバでの作業です】
| 情報 |
|---|
①～④の作業については、サーバ構築方法によって対応が異なります。実環境をご確認の上、必要に応じて作業してください。 |
① P4ROOT用のディレクトリ “standby” を作成します
※既にルートフォルダを作成済みであれば、作業不要です
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
mkdir /$P4ROOT |
② 作成したディレクトリのownerを“root”から“perforce”に変更します
※ownerがperforceであれば作業不要です
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
chown perforce:perforce -R /$P4ROOT/ |
３．FTP転送したチェックポイントファイルを$P4ROOTへ移動します ※$P4ROOTへ転送済みであれば作業不要です
実行コマンド
mv ③ FTP転送したチェックポイントファイル(checkpoint.ckp.1)を$P4ROOT(ここでは /standby)へ移動します
※$P4ROOTへ転送済みであれば作業不要です
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
mv /転送場所/filename /$P4ROOT/ |
...
４．チェックポイントファイルのownerを“root”から“perforce”に変更します
※ownerがperforceであれば、作業不要です
実行コマンド
chown perforce:perforce filename
５．Perforceサービスを停止します
実行コマンド
p4dctl stop server-name
コマンド例）
p4dctl stop standby
...
例：mv /tmp/checkpoint.ckp.1 /standby/ |
...
④ チェックポイントファイルのownerを“root”から“perforce”に変更します
※ownerがperforceであれば、作業不要です
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
chown perforce:perforce filename |
⑤ Perforceサービスを停止します
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4dctl stop server-name |
⑥ 不要なファイルを削除します
構築したスタンバイサーバに存在するデータベース等を削除します
$P4ROOTに移動し、以下のファイルを削除します
・ファイル名が[db.]で始まるファイル(データベース)すべて
・server.locksフォルダ：フォルダごと削除
実行コマンド例
rm
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
rm -f db.* |
7．ServerIDを指定します⑦ ServerIDを指定します
サーバ“standby”のserverIDを“standby”に指定します
※既に指定されている場合は作業不要です 実行コマンド
p4d
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4d -r /$P4ROOT -xD standby-serverID |
...
8．チェックポイントファイルを展開します。※ownerが“perforce”になるように展開してください。
...
-xD standby |
⑧ チェックポイントファイルを展開します。※ownerが“perforce”になるように展開してください。
コマンド実行後、db.ファイルが作成されたことを確認します
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4d -r /$P4ROOT/ - |
...
jr filename |
...
または |
...
sudo -u perforce p4d -r /$P4ROOT - |
...
実行後、db.ファイルが作成されたことを確認します
9．Perforceサービスを開始します
実行コマンド
p4dctl start server-name
コマンド例
p4dctl start standby
５．レプリケーションの設定と確認
【スタンバイサーバでの作業です】
１．ユーザ“service”が使用するレプリケーション用チケットを作成します
...
jr filename |
⑨ Perforceサービスを開始します
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4dctl start server-name |
５．レプリケーションの設定と確認【スタンバイサーバでの作業です】
① ユーザ“service”が使用するレプリケーション用チケットを作成します
※"/standby/.p4tickets"はサーバ仕様作成時(手順1-②)に指定した場所を入力します。
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 -p master_server:port -u service -E "P4TICKETS=/standby/.p4tickets" login |
...
例：p4 -p 192.168.56.114:1666 -u service -E "P4TICKETS=/standby/.p4tickets" |
...
２．レプリケーション用チケットの確認をします
...
login |
② レプリケーション用チケットの確認をします
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
ls -la /standby/.p4tickets |
...
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
-r--------. 1 perforce perforce 53 10月 10 16:48 /standby/.p4tickets |
３．レプリケーションの確認をします
実行コマンド
p4 ③ レプリケーションの確認をします
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 -u super -p standby_server:port pull -lj |
...
例：p4 -u super -p 192.168.56.115:1666 pull -lj |
...
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Current replica journal state is: Journal 1, Sequence 8403. |
| 注意 | ||
|---|---|---|
| ||
※大規模なサイトの場合、同期に時間がかかる場合がありますので、時間をおいて再度コマンドを実行してください。 |
...
| 情報 | ||
|---|---|---|
| ||
pull -ljコマンド：レプリカとマスターにおけるカレントジャーナルの状態を表示するコマンドです |
６．mandatoryへ変更する【マスターサーバで作業します】
① マスタサーバとスタンバイサーバのジャーナルの整合性を確認します
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 servers -J |
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
master '2019/10/18 14:07:44' commit-server 1/8773 1/8773 wadL/1 1 |
...
| 情報 | ||
|---|---|---|
| ||
p4 servers -Jはジャーナルコピーの進行状況を確認するコマンドです。 |
...
２．serverID “standby” の設定を表示します。
実行コマンド
p4 ② serverID “standby” の設定を表示します。
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 -u super -p master-server:port server standby |
...
-serverID |
...
192.168.56.114:1666 server standby |
３．serverID ③ serverID “standby” のOptionsを変更します
赤文字が変更箇所です
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
⋮ |
...
mandatory ●nomandatoryからの書き換え |
４．mandatoryに変更されたことを確認します
実行コマンド
p4 servers -J
実行結果 ※末尾に「mandatory」と表示されます④ mandatoryに変更されたことを確認します
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 servers -J |
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
master '2019/10/18 14:09:47' commit-server 1/9179 1/9179 wadL/1 1 |
...
■ フェイルオーバー：テスト運用―マスタサーバが起動している場合【スタンバイサーバで作業します】
| 注意 | ||
|---|---|---|
| ||
マスターサーバが起動できており、ネットワークに接続できている状況を想定した運用のご案内です。 |
...
① フェイルオーバーの確認
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 failover |
...
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Checking if failover might be possible ... |
...
② フェイルオーバーの実行
自動的にPerforceサーバが再起動され、マスタサーバへと切り替わります。
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 failover -y |
...
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Starting failover process ... |
...
■ フェイルオーバー：テスト運用―マスタサーバが起動していない場合【スタンバイサーバで作業します】
| 注意 | ||
|---|---|---|
| ||
マスターサーバが起動できない・ネットワークに接続できない状況を想定した運用のご案内です。 |
...
① フェイルオーバーの確認
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
p4 failover -s master-server |
...
例：p4 failover -s master |
...
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Checking if failover might be possible ... |
...
| 情報 | ||
|---|---|---|
| ||
-s serverID………切り替えるサーバ（今回はマスタサーバ）のserverIDを指定します |
② フェイルオーバーの実行
自動的にPerforceサーバが再起動され、マスタサーバへと切り替わります。
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
p4 failover -s master-server -y |
...
例：p4 failover -s master -y |
...
| パネル | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
Starting failover process ... |
■ フェイルオーバー：テスト運用―参照サーバの変更
| 注意 |
|---|
...
|
...
| |
この項目では、フェイルオーバーを実行後、旧マスタサーバ(本マニュアルの場合はmaster)を参照していたサーバでの対応についてのご案内です。ここではエッジサーバを例にしています。 |
１．状況を確認する
【エッジサーバで作業します】①状況を確認する【エッジサーバで作業します】
実行コマンド
p4 pull -lj
※このメッセージが表示される場合は、DNSのエイリアス設定がされていません。
Replica access to P4TARGET server failed.
Remote server refused request. Please verify that service user is correctly logged in to remote server, then retry.
TCP connect to master-server:port failed.
connect: master-server:port: Connection refused
...