p4 server
Helixサーバを作成、変更、または削除します。
構文
p4 [g-opts] server serverIDp4 [g-opts] server -gp4 [g-opts] server -d serverIDp4 [g-opts] server -o [-l] serverIDp4 [g-opts] server -i [-c edge-server|commit-server]p4 [g-opts] server -c edge-server|commit-server serverID
説明
サーバ仕様は、Helixサーバの高レベルの構成および使用目的を表します。 Helixサーバが1つしかないインストールでは、サーバ仕様の設定は任意です。
p4 serverコマンドはサーバ仕様を一時ファイルに保存し、変数P4EDITORによって構成されたエディタを呼び出します。 ファイルを保存すると、変更がサーバ仕様に作成または保存されます。
オペレータタイプのユーザはこのコマンドを実行できません。 (3つのユーザタイプは「p4 user」で説明されています。)
フィルタリング
[ClientDataFilter:]、[RevisionDataFilter:]、および[ArchiveDataFilter:]フィールドは、複製環境で不要なデータを除外するために用意されています。 例えば、ビルドファームレプリカは、マスターサーバにある作業状態の全クライアントワークスペースのhaveリストを複製する必要はありません。 『Helix Coreサーバ管理者ガイド: マルチサイト展開』の「複製中にメタデータをフィルタリングする」を参照してください。
ArchiveDataFilter:をそのままにすることをお勧めします。 このフィルタを変更した場合は、サーバを最初から作成する必要があります。
バージョン2019.1以降: サーバ仕様には、そのサーバに適用される構成可能変数が表示されます。 詳しくは、DistributedConfig:フィールドの説明を参照してください。 管理者は、これらの構成可能変数の設定を変更することができます。
フォームフィールド
| フィールド名 | タイプ | 説明 |
|---|---|---|
|
|
読み取り専用 |
このサーバに関する一意の識別子。 |
|
|
書き込み可能 |
サーバの実行タイプ。 次のいずれか1つをとります。
各タイプが1つ以上のサービスを提供する場合があります。 |
|
|
書き込み可能 |
connectorタイプのサーバは、次のサービスを提供します。
|
| オプション: | 書き込み可能 |
|
| ReplicatingFrom: | 書き込み可能 | 複製処理またはジャーナルコピー処理の実行元となるサーバのサーバID。 サーバがstandbyまたはforwarding-standbyサーバで、どちらかにmandatoryオプションが設定されている場合、このフィールドは必須です。 |
|
|
書き込み可能 |
このサーバに関連付けられた 空白のままにするか、または |
|
|
書き込み可能 |
このサーバに使用される |
|
|
書き込み可能 |
|
|
|
書き込み可能 |
このサーバに関する任意入力の説明。 |
|
|
書き込み可能 |
サーバによって使用されるサービスユーザ名。 このフィールドの使用の詳細については、Helix Coreサーバ管理者ガイド: マルチサイト展開の「サービスユーザ」のセクションを参照してください。 |
|
|
書き込み可能 |
レプリカサーバの場合、この任意指定フィールドには、アクティブなクライアントワークスペースのメタデータを絞り込む方法を表す1つ以上のパターンを含めることができます。 アクティブなクライアントワークスペースのデータには、haveリスト、作業レコード、未実行の衝突解決が含まれます。 クライアントデータを含めるには、次の構文を使用します。
クライアントデータを除外するには、次の構文を使用します。
すべてのパターンはクライアントシンタックスで指定されます。 |
|
|
書き込み可能 |
レプリカサーバの場合、この任意指定フィールドには、サブミット済みリビジョンのメタデータを絞り込む方法を表す1つ以上のパターンを含めることができます。 サブミット済リビジョンのデータには、リビジョンレコード、反映レコード、ラベルの内容、およびサブミット済チェンジリストにリストされたファイルが含まれます。 ディポデータを含めるには、次の構文を使用します。
ディポデータを除外するには、次の構文を使用します。
すべてのパターンはディポシンタックスで指定されます。 |
|
|
書き込み可能 |
レプリカサーバの場合、この任意指定フィールドには、ファイルの内容の複製を自動的にスケジュールするためのポリシーを表す1つ以上のパターンを含めることができます。 このフィールドが存在する場合は、パターンで表されるファイルのみが自動的にレプリカに転送されます。その他のファイルは、ファイルの内容を求めるレプリカコマンドによって参照されるまで転送されません。
サブミット時にファイルを自動的に転送するには、次の構文を使用します。
自動転送からファイルを除外するには、次の構文を使用します。
すべてのパターンはディポシンタックスで指定されます。 警告
このフィルタは、そのままにすることをお勧めします。 このフィルタを変更した場合は、サーバを最初から作成する必要があります。 |
|
書き込み可能 |
すべてのサーバタイプで、サーバ仕様のDistributedConfigフィールドに、デフォルト値以外の値が設定されている各構成可能変数用の行が表示されます。 このフィールドで、値を編集したり、新しい行を追加して、別の構成可能変数をデフォルト値以外の値に設定したり、その行を削除して、構成可能変数の値をデフォルト値に戻したりすることができます。 すべてのサーバタイプについて、このオプションフィールドには、該当するサーバに関係する構成可能変数の設定が表示されます。 -cオプションを指定してp4 serverコマンドを実行すると、現在の設定値が構成値として取り込まれます。値が設定されていない場合は、デフォルトの推奨値が設定され、デフォルトの推奨値が設定されていない場合は、「unset」が値として設定されます。 -cフラグを指定してコマンドを呼び出したときにこのフィールドが存在する場合は、ServerIDオプションで指定されたサーバの範囲を使用して、このフィールド内の構成コマンドが現在のサーバ上で実行されます。 エッジサーバまたはコミットサーバでは、-cオプションを指定した場合にのみ、このオプションフィールドが表示されます。このフィールドには、現在の構成値、または値が設定されていないフィールドに対する推奨デフォルト値(推奨デフォルト値が設定されていないフィールドの場合は「
|
オプション
|
|
エッジサーバまたはコミットサーバで「DistributedConfig:」フィールドを使用して、分散環境の設定に使用される構成値の設定、変更、表示を行うことができます。 構成フィールドには、初期値として以下の値が設定されます。
フォームを終了すると、serverIDで指定された範囲内の現行サーバ上で、「DistributedConfig:」フィールドに含まれているすべての構成コマンドが実行されます。 これらの構成コマンドは、serverIDで指定されたサーバに対してのみ実行されるため、これらの構成コマンドで「server#」というプレフィックスを指定することはできません。 サポートされるサービスは、エッジサーバとコミットサーバのみです。 これらのサービスにより、サーバコマンドを最初に実行したときのフォームの初期値の設定に使用される構成値が定義されます。 |
|
|
指定されたサーバ仕様を削除します。 |
|
|
フォームの一部として、新しい「serverID」を生成します。 |
|
|
サーバ仕様を標準入力から読み込みます。 このオプションを |
|
|
DistributedConfig:フィールドの機能によって置き換えられたため、このオプションは非推奨になりました。 |
|
|
指定されたサーバ仕様を標準出力に書き出します。 |
|
|
詳細については、「グローバルオプション」を参照してください。 |
使用上の留意点
| ファイル引数にリビジョン指定子を使えるか？ | ファイル引数にリビジョン範囲を使えるか？ | 最低限必要なアクセスレベル |
|---|---|---|
|
適用外 |
適用外 |
以下を参照 |
更新モード(-i、-g、および-dオプションを使用)では、スーパーユーザのみがp4 serverを実行できます。 オペレータ以外のユーザは、更新モード以外のモードで(-oまたは-o-g オプションを使用して)p4 serverを実行できます。 オペレータは、p4 serverを実行することはできません。
関連コマンド
|
作成後にサーバIDを変更する |
|
|
既知のサーバをすべて一覧表示する |
