Helix Coreサーバ管理者ガイド (2020.1)

グローバル設定

ブローカに対して指定するすべての操作に、次の設定が適用されます。

設定 意味

target

コンフィギュレーションファイルの他の設定でオーバーライドされない限り、コマンドの送信先となるデフォルトのHelix Coreサーバ (P4D)。

target = [protocol:]host:port;

listen

HelixブローカHelixサーバクライアントアプリケーションからのコマンドを待機するアドレス。

listen = [protocol:][host:]port;

directory

Helixブローカのホームディレクトリ。 ブローカコンフィギュレーションファイルで指定される他のパスは、この位置に相対的である必要があります。

directory = path;

logfile

Helixブローカのログファイルへのパス。

logfile = path;

debug-level

ログに記録するデバッグ出力レベル。 -vオプションおよびP4DEBUGにより指定される値をオーバーライドします。 1つ以上のフラグで値を指定することができます。

debug-level = server=1, time=1, rpl=3;

admin-name

Helixサーバ管理者の名前。 特定のエラーメッセージ内に表示されます。

admin-name = "P4 Admin";

admin-email

Helixサーバ管理者の問い合わせ先電子メールアドレス。 ブローカの構成に問題が発生した場合にユーザに表示されます。

admin-email = admin@example.com;

admin-phone

Helixサーバ管理者の電話番号。

admin-phone = nnnnnnn;

redirection

使用するリダイレクトモード: selectiveまたはpedantic

selectiveモードでは、デフォルト(ターゲット)サーバに対して1つのコマンドが実行されるまで、1つのセッション内でリダイレクトが許可されます。 コマンドが実行されると、そのセッション内のすべてのコマンドがデフォルトサーバに対して実行され、リダイレクトされません。

pedanticモードでは、リダイレクトのリクエストはすべて尊重されます。

デフォルトのモードはselectiveです。

redirection = selective;

service-user

ブローカがターゲットサーバと通信する際に、自身を認証するために用いるオプションのユーザアカウント。

セキュリティ上の問題があるとされているため、ブローカ設定にはパスワードを指定する設定が含まれていません。 p4 login -u service-user -pコマンドを使用してチケットを生成してください。 ファイルに表示されたチケット値を書き留め、ticket-file設定にそのファイルのパスを設定します。

ブローカを継続的に動作させるには、service-userユーザを、Timeout設定がunlimitedのグループに含めてください。 デフォルトのチケットタイムアウトは12時間です。

service-user = svcbroker;

ticket-file

P4TICKETSファイルのオプションの代替場所。

ticket-file = /home/p4broker/.p4tickets;

compress

ブローカとサーバ間の通信を圧縮します。 WANなどの低速のリンクでは、圧縮によりパフォーマンスを向上させることができます。 ブローカおよびサーバが互いに近接している場合(特に同じ物理マシンに配置されている場合)、帯域幅は問題となりません。CPUサイクルを節約するために、圧縮は無効にしてください。

compress = false;

altserver

ターゲットサーバのロードを削減するオプションの代替サーバ。
代替サーバに割り当てられているnameコマンドハンドラの仕様で使用されています。
詳細については、代替サーバの定義を参照してください。

構文は、以下です。

altserver: name { target=[protocol:]host:port; }

各代替サーバに1つのブローカコンフィギュレーションファイルに、複数のaltserver設定が表示される場合があります。 以下に例を示します。

altserver: rep_18310 { target=10.5.10.118:18310; }
altserver: rep_18320 { target=10.5.10.118:18320; }
altserver: rep_18330 { target=10.5.10.118:18330; }

 

次の手順

コマンドハンドラの仕様