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
注意

タグ付き出力に表示される[Options]フィールドと[ReplicationFrom]フィールドは、フェイルオーバー機能と関連しています。「p4 failover」を参照してください。

複製ステータスの評価

-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