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つ以上のサービスを指定することができます。 |
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
これらのサービスの詳細については、『Helix Coreサーバ管理者ガイド』の「展開アーキテクチャ」を参照してください。 サービスをサーバに割り当てる場合、管理者は、p4 serverコマンドで表示されるServices:フィールドを使用する必要があります。
|
||||||||||||||||||||||||||||||||||||
| オプション: | 書き込み可能 |
|
||||||||||||||||||||||||||||||||||||
| ReplicatingFrom: | 書き込み可能 |
複製処理またはジャーナルコピー処理の実行元となるサーバのサーバID。サーバがstandbyまたはforwarding-standbyサーバで、どちらかにmandatoryオプションが設定されている場合、このフィールドは必須です。 注意
転送レプリカを使用して、エッジサーバでの読み取り専用コマンドの負荷を軽減する場合は、転送レプリカのサーバ仕様で、このフィールドの値をエッジサーバのサーバIDに設定します。 |
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
このサーバに関連付けられた 空白のままにすることも、 |
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
このサーバに使用される 以下の構文でp4 reloadコマンドを実行する場合は、コミットサーバとエッジサーバにこのフィールドが存在している必要があります。
|
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
|
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
バージョン2019.2以降、このオプションフィールドに、各リポジトリ名の前にスペースを付加した状態で、更新対象のリポジトリのリストを含めることができるようになりました。『Helix4Git管理者ガイド』の「Git Connectorのアップグレード」と「Git Connectorを構成してHelix4Gitからリポジトリをポーリングする」を参照してください。 |
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
このサーバに関する任意入力の説明。 |
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
サーバによって使用されるサービスユーザ名。このフィールドの使用方法については、 『Helix Coreサーバ管理者ガイド』の「サービスユーザ」を参照してください。 |
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 | このサーバで使用可能なアドレスのリスト。 セキュリティレベル6の場合、このフィールドを使用して、 指定したサービスユーザに中間サーバが関連付けられます。 一致するサーバ仕様が存在しない中間サーバ経由での接続はブロックされます。 | ||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
レプリカサーバの場合、この任意指定フィールドには、アクティブなクライアントワーク スペースのメタデータを絞り込む方法を表す1つ以上のパターンを含めることができます。 アクティブなクライアントワークスペースのメタデータには、haveリスト、作業レコード、 未実行の衝突解決が含まれます。 アクティブなクライアントメタデータを含めるには、以下の構文を使用します。
アクティブなクライアントメタデータを除外するには、以下の構文を使用します。
すべてのパターンはクライアントシンタックスで指定されます。 |
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
レプリカサーバの場合、この任意指定フィールドには、サブミット済みリビジョンの メタデータを絞り込む方法を表す1つ以上のパターンを含めることができます。 サブミット済みリビジョンのメタデータには、リビジョンレコード、反映レコード、 ラベルの内容、サブミット済みチェンジリストに登録されているファイルが含まれます。 サブミット済みリビジョンディポのメタデータを含めるには、以下の構文を使用します。
サブミット済みリビジョンディポのメタデータを除外するには、以下の構文を使用します。
すべてのパターンはディポシンタックスで指定されます。 |
||||||||||||||||||||||||||||||||||||
|
|
書き込み可能 |
レプリカサーバの場合、この任意指定フィールドには、ファイルの内容の複製を 自動的にスケジュールするためのポリシーを表す1つ以上のパターンを 含めることができます。このフィールドが存在する場合、パターンで記述される ファイルだけが自動的にレプリカサーバに転送されます。 その他のファイルは、ファイルの内容を求めるレプリカコマンドによって参照されるまで 転送されません。
サブミット時にファイルを自動的に転送するには、次の構文を使用します。
自動転送からファイルを除外するには、次の構文を使用します。
すべてのパターンはディポシンタックスで指定されます。 ほとんどのディポパスを含める場合は、以下のパターンを使用します。 >//... -//depot/projA/... -//depot/projB/... このパターンでは、最初にすべてのパスが処理対象として含められます。 いくつかのディポパスだけを含める場合は、以下のパターンを使用します。 >//depot/projA/... //depot/projB/... このパターンでは、明示的に含められていないすべてのパスが暗黙的に除外されます。 警告
レプリカサーバまたはエッジサーバを再起動しない限り、 |
||||||||||||||||||||||||||||||||||||
|
書き込み可能 |
すべてのサーバタイプについて、このフィールドには、デフォルト値以外の値が設定されている構成可能変数が表示されます(1行に1つの構成可能変数が表示されます)。管理者はこのフィールドを使用して、特定の値を編集したり、特定の構成可能変数をデフォルト値以外の値に設定するための新しい行を追加したり、行を削除して特定の構成可能変数をデフォルト値にリセットしたりすることができます。 以下の点に注意してください。
-cオプションを指定してp4 serverコマンドを実行すると、現在の設定値が構成値として取り込まれます。値が設定されていない場合は、デフォルトの推奨値が設定され、デフォルトの推奨値が設定されていない場合は、「unset」が値として設定されます。
エッジサーバまたはコミットサーバの場合、-cフラグを指定した場合にのみ、 このオプションフィールドが表示されます。 |
フィールドの下に行がある場合は、その行をインデントしてください。以下に例を示します。
Description:Created by maria
オプション
|
|
エッジサーバまたはコミットサーバで「DistributedConfig:」フィールドを使用して、マルチサーバ環境の設定に使用される構成値の設定、変更、表示を行うことができます。 構成フィールドには、初期値として以下の値が設定されます。
フォームを終了すると、serverIDで指定された範囲内の現行サーバ上で、「DistributedConfig:」フィールドに含まれているすべての構成コマンドが実行されます。 これらの構成コマンドは、serverIDで指定されたサーバに対してのみ実行されるため、これらの構成コマンドで「server#」というプレフィックスを指定することはできません。サポートされるサービスは、エッジサーバとコミットサーバだけです。これらのサービスにより、サーバコマンドを最初に実行したときのフォームの初期値の設定に使用される構成値が定義されます。 |
|
|
指定されたサーバ仕様を削除します。 |
|
|
フォームの一部として、新しい「serverID」を生成します。 |
|
|
サーバ仕様を標準入力から読み込みます。 このオプションを |
|
|
DistributedConfig:フィールドの機能によって置き換えられたため、このオプションは非推奨になりました。 |
|
|
指定されたサーバ仕様を標準出力に書き出します。 |
|
|
「グローバルオプション」を参照してください。 |
使用上の注意点
| ファイル引数でリビジョン指定子を使用できるか？ | ファイル引数でリビジョン範囲を使用できるか？ | 最低限必要なアクセスレベル |
|---|---|---|
|
適用外 |
適用外 |
以下を参照 |
-
更新モード(
-i、-g、および-dオプションを使用)では、 スーパーユーザのみがp4 serverを実行できます。 -
オペレータ以外のユーザは、更新モード以外のモードで(
-oオプションまたは-o-gオプションを使用して)p4 serverを実行できます。 -
オペレータは、
p4 serverを実行することはできません。
関連コマンド
|
作成後にサーバIDを変更する |
|
|
既知のサーバをすべて一覧表示する |
