p4 servers

すべてのサーバ仕様のリストを表示するか、複製のステータスを評価します。

オペレータ特権を持つユーザは、p4 serversおよびp4 servers -Jを実行できます。

構文

p4 [g-opts] servers [-J | --replication-status]

説明

構文バリアントについて、以下のセクションで説明します。

サーバ仕様の一覧表示

p4 servers は、マスターのHelixサーバに保存されている、すべてのサーバ仕様を一覧表示します。

edge-server_1 server edge-server_1 10.0.101.55:41261 edge-server 'edge-server '
edge-server_2 server edge-server_2 10.0.101.55:47050 edge-server 'edge-server '

出力には、サーバID、タイプ、提供されるサービス、サーバの作成時に指定されたコメントが一覧表示されます。

p4 serversの出力は、タグ付きフォームで取得すると解析が容易になります。

p4 -ztag servers

... ServerID commit-1
... Name
... Address
... Type server
... Services commit-server
... Options nomandatory
... Description commit-1
... ServerID edge-server-1
... Name
... Address
... Type server
... Services edge-server
... Options nomandatory
... Description edge-server-1

... ServerID edge-server-2
... Name
... Address
... Type server
... Services edge-server
... Options nomandatory
... Description edge-server-2

... ServerID remote-standby
... Name
... Address
... Type server
... Services standby
... Options nomandatory
... ReplicatingFrom commit-1

... Description Remote DR server
... ServerID standby-1
... Name
... Address
... Type server
... Services standby
... Options mandatory
... ReplicatingFrom commit-1
... Description Local HA server

複製ステータスの評価

-Jまたは--replication-statusオプションを使用すると、1つ以上のレプリカがマスターサーバのレコードを複製する際の効率性をチェックできます。 サーバAとレプリカBを使用する場合、このコマンドの出力によって2つの基本情報が提供されます。

• Aのジャーナルのサイズと更新時刻です。
• p4 pullまたはp4 journalcopy要求を送信したすべてのサーバBには、要求の送信時刻、およびBのジャーナルの保持状態と適用状態に関する情報が提供されます。 単純なマスターとレプリカの場合、保持されるレコード数と適用されるレコード数は常に同じになります。Bのジャーナルはp4 pullコマンドによって更新されるためです。

コマンドはマスターサーバに対して実行されることを前提としています。 スタンバイサーバは2つの操作を行ってマスターサーバのレコードを複製することができます。

• p4 journalcopyコマンドを使用して、マスターサーバのジャーナルをスタンバイサーバのジャーナルにコピー(保持)します。
• p4 pull -Lコマンドを使用して、コピーしたジャーナルレコードをスタンバイサーバのデータベースに適用し、そのステートファイルを更新します。

出力を確認することにより、分散システムのさまざまな場所の負荷を評価して、レプリカがマスターとどの程度同期しているか確認できます。 ラグタイムが長い場合は注意が必要です。

タグ付けを解除したp4 servers -Jの出力は次のようになります。

edge-server_1 '2014/09/18 13:14:58' edge-server 5/258 5/258 WaDl/10 1
edge-server_2'2014/09/18 13:14:57' edge-server 5/258 5/258 WaDl/10 1

この出力はタグ付きフォームを使用した方が解釈しやすくなります。

... ServerID edge-server_1
... Updated 2014/09/18 13:14:58
... ServerType edge-server
... PersistedJournal 5
... PersistedSequence 258
... AppliedJournal 5
... AppliedSequence 258
... JAFlags WaDl/10 1
... IsAlive 1

... ServerID edge-server_2
... Updated 2014/09/18 13:14:57
... ServerType edge-server
... PersistedJournal 5
... PersistedSequence 258
... AppliedJournal 5
... AppliedSequence 258
... JAFlags WaDl/10 1
... IsAlive 1

フィールドの意味について、以下のテーブルで説明します。

ServerID	サーバのサーバID。 重要 構成の問題を回避するには、serverIDの値をP4NAMEの値と常に一致させる必要があります(どちらも設定されている場合)。 serverIDを設定することをお勧めしますが、下位互換性を維持するため、P4NAMEもサポートされています。
Updated	要求元サーバがこのサーバ(通常はマスター)にジャーナルレコードを最後に要求した日付および時刻。
ServerType	サーバタイプ。 次のいずれか1つになります。standard、replica、forwarding-replica、build-server、edge-server、commit-server、depot-master、depot-standby、standby、forwarding-standby。
PersistedJournal	レコードが保持されているジャーナルのローテーション数。
PersistedSequence	保持されているジャーナルの場所。 マスターサーバ、レプリカ、ワークスペースサーバについては、ジャーナルが保持される場所および適用される場所は常に同じです。 スタンドバイサーバではタイプを問わず場所が異なります。
AppliedJournal	適用されたジャーナルのローテーション数。
AppliedSequence	適用されたジャーナルの場所。 マスターサーバ、レプリカ、ワークスペースサーバについては、ジャーナルが保持される場所および適用される場所は常に同じです。
JAFlags	設定されている場合は大文字で、設定されていない場合は小文字で出力されたフィールドのセット。 アルファベット順の表示に続いてフラグの数値が表示されます。 関連付けられているpullまたはjournalcopyコマンドによって表示される一般的なコマンドフィールドは、次のとおりです。 WAdl/12: p4 journalcopy -i 0 WaDl/10: p4 pull -i 0 wAdl/4: p4 journalcopy -i 1 waDl/2: p4 pull -i 1 wadL/1: マスターステータスの合成レコード。 各レプリカのジャーナルの場所をこのサーバのジャーナルの場所と比較して、いずれかのレプリカが遅れをとっていないか確認できます。 記号は次のように解釈します。 W/8: 待機、長いポーリング要求 w: 未待機 A/4: 確認中 a: 未確認 D/2: 永続的 d: 非永続的 L/1: ローカルジャーナルに関するデータ。p4 serversコマンドの対象となるサーバのジャーナルです。 l: レプリカからの要求(マスターのジャーナルのコピー中に進行状況を示します)。
IsAlive	サーバが稼働している場合は1、停止している場合は0。

Pullまたはjournal-copy要求がdb.jnlackテーブルに記録されるのは、サーバIDまたはP4NAMEのどちらかを持つレプリカから要求が行われた場合のみになります。 サーバIDまたはP4NAMEを持たないレプリカがこのような要求を行った場合は、テーブルに記録されません。

オプション

-J | --replication-status	サーバのジャーナルに関する情報、およびこのサーバから複製されたすべてのレプリカの複製ステータスに関する情報を提供します。
g-opts	詳細については、「グローバルオプション」を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？	ファイル引数にリビジョン範囲を使えるか？	最低限必要なアクセスレベル
適用外	適用外	list

関連コマンド

サーバの仕様を編集または表示する	p4 server
サーバの一意のIDを設定する	p4 serverid