p4 configure
このコマンドは、サーバ構成変数の設定、表示、管理を行う場合に使用します。
構文
p4 [g-opts] configure set [server_id#]variable=value
p4 [g-opts] configure unset [server_id#]variable
p4 [g-opts] configure show [allservers | variable]
p4 [g-opts] configure history [allservers | variable]
説明
上記の構文を使用することをお勧めしますが(P4NAMEではなくp4 serveridを使用)、以下の構文を使用してもかまいません。
p4 [g-opts] configure set [P4NAME#]variable=value
p4 [g-opts] configure unset [P4NAME#]variable
p4 [g-opts] configure show [allservers | P4NAME | variable]
p4 [g-opts] configure history [allservers | P4NAME | variable]
構成変数を使用して、Helix Coreサービスの動作をカスタマイズします。 構成可能変数の設定内容は、クライアント、サーバ、プロキシに影響する可能性があります。
別の方法として、p4 serverコマンドを使用することもできます。このコマンドを使用すると、サーバ仕様内の設定を簡単に編集することができます。 詳細については、p4 serverコマンドのDistributedConfig:フィールドの説明を参照してください。
構成変数に関する説明は、本ガイドのみでなく、以下のコマンドを実行して参照することもできます。
本ガイド | コマンドライン |
---|---|
詳細については、「構成可能変数 - アルファベット順リスト」を参照してください。 (サーバを停止する必要がある構成変数を確認することができます) |
p4 help configurables |
詳細については、「環境変数およびレジストリ変数」を参照してください | p4 help environment |
スーパーユーザはp4 [g-opts] configure history [allservers | P4NAME | variable]を使用して、構成可能変数の変更履歴を表示することができます。この履歴は、バージョン2019.2以降のサーバで記録されます。 詳細については、『オプション』を参照してください。
優先度
以下の表に、構成可能変数で値を設定する場合の優先度を示します。「優先度」欄の「1」の設定方法は「2」よりも優先され、「2」の設定方法は「3」よりも優先され、「3」の設定方法は「4」よりも優先されます。
優先度 |
値の設定方法 |
---|---|
1 |
コマンドラインで「-v」オプションを指定する(-vオプションは、サーバの起動時にサーバに渡されます)。 以下に例を示します。 $ p4d -v net.keepalive.idle=2700
|
2 |
継続して この方法では、指定のサーバまたはあらゆるサーバに特定の構成可能変数を設定することができます。 |
3 |
環境変数を使用します。
|
4 |
デフォルト値を使用する(特に操作を行う必要はありません)。 |
K
とM
を使用すると、大きい値を表すことができます。 例えば、10M
はdm.shelve.maxfiles構成可能変数のデフォルト値です。
すべてのサーバの構成可能変数の値を表示する
すべてのサーバの構成可能変数を表示するには、以下の構文を使用します。
p4 configure show allservers
次のような出力が表示されます。
any: lbr.autocompress = 1
any: submit.allowbgtransfer = 1
paris-edge: P4LOG = /home/perforce/servers/edge1/log
headquarters-commit: P4LOG = /home/perforce/servers/commit-hq/log
「any」は、接続されているすべてのサーバで使用されている、コミットサーバ上で定義されている構成可能変数を表示するという意味です(特定のサーバの設定で上書きされている構成可能変数を除く)。
特定のサーバの構成可能変数の値を表示する
現在のサーバ、特定のサーバ、任意の構成可能変数(環境変数Helix Coreを含む)の設定状態を表示するには、以下の構文を使用します。
p4 configure show
上記のコマンドを実行すると、各構成可能変数がその値とともに表示されます。( )内の項目は、その値の設定元のコマンドを示しています。
出力行 | 値の設定元コマンド |
---|---|
P4PORT=20192 (-p) | p4d -p |
monitor=2 (-v) | p4d -v |
net.parallel.max: 10 (configure) | p4 configure |
serverid=commit (serverid) | p4 serverid |
monitorの値が「2」に設定されていることに注意してください。 特定の構成可能変数の値が複数のコマンドを使用して設定されているかどうかを確認するには、その構成可能変数を以下のように指定します。
p4 configure show monitor
この場合、以下のような出力が表示されることがあります。
monitor=2 (-v) monitor=10 (configure)
この出力は、p4d -vコマンドを使用してmonitorの値が「2」に設定され、p4 configureコマンドを使用してmonitorの値が「10」に設定されたことを示しています。 p4dコマンドはp4 configureコマンドよりも優先度が高いため、p4 configure showコマンドを実行すると、値が「2」に設定されたmonitorが表示されることになります。
値の設定を解除する
構成可能変数のカスタム設定を削除するには、p4 configure unset
コマンドを使用します。
Helixサーバをインストールした後、次の操作を実行することをお勧めします。
monitor
を1または2に設定し、プロセスの監視を有効にしますsecurity
を3または4に設定し、チケットベースの認証を必須にしますdm.user.noautocreate
を1または2に設定し、新しいユーザの自動作成を防止しますdm.user.resetpassword
を1に設定し、作成した新規ユーザに対してパスワードのリセットを強制します
一部の構成可能変数の実行時にサーバを停止する
ほとんどの構成可能変数は変更が加えられるとすぐに有効になります。 例えば、
|
|
特定の構成可能変数の場合(ssl.tls.version.minなど): この構成可能変数の値を変更した後、サーバを明示的に「停止」する必要があります。 注意
p4 admin restartを実行できません。 UNIXを使用している場合は、「Perforceサービスを停止する」および「Perforceサービスを開始する」を参照してください。 Windowsを使用している場合は、「Helixサーバを開始および停止する」を参照してください。 |
マルチサーバ環境で構成可能変数を設定する
サーバは名前による識別が可能です。 複製環境とマルチサーバ環境では、サーバ名を構成可能変数の一部として指定することにより、複数のレプリカサーバの設定をマスターサーバで管理することができます。 例えば、次のコマンドにより、エッジサーバ(tokyo_edge
)のserviceUser
構成可能変数の値の設定が可能になります。 このコマンドは、コミットサーバで実行されます。
$ p4 configure set tokyo_edge#serviceUser=svc_tokyo_edge
詳しくは、『Helix Coreサーバ管理者ガイド』の「展開アーキテクチャ」を参照してください。
サーバのダウン時に構成可能変数にアクセスする
Helixサーバサーバが作動しない、またはサーバにアクセスできない場合、
コマンドを使用して、サーバの構成可能変数をリスト、設定、設定解除できます。p4d
-
すべてのサーバ構成変数をリストするには、
-cshow
オプションを使用します。 例:$ p4d -r $P4ROOT -cshow
-
値を設定または設定解除するには、
-cset
または-cunset
を使用します。 以下に例を示します。$ p4d -r $P4ROOT "-cset myServer#auth.ldap.timeout=30" $ p4d -r $P4ROOT "-cunset myServer#db.replication"
詳細については、サポートナレッジベースの記事「Accessing Server Configuration Variables」を参照してください。
オプション
|
指定された変数に、与えられた値を設定します。 |
|
指定された変数の設定を解除します。 |
|
注意
|
|
システムが認識しているすべてのサーバの構成変数を表示します。 |
|
指定された構成変数の設定内容を表示します。 |
|
|
|
db.confighテーブル内の各構成可能変数の値に対する変更内容が記録されます。このテーブルには、構成可能変数の名前、対象となるserverId、変更前の値、変更後の値、変更を行ったuser、変更が行われたdatetime、configureVersionの番号、変更が行われたサーバのserverIdが保存されます。 |
|
システム上で認識されているすべてのサーバの構成変数の変更履歴を表示します。 |
|
指定された構成変数の変更履歴を表示します。 |
|
|
|
詳細については、「グローバルオプション」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? | ファイル引数にリビジョン範囲を使えるか? | 最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
|
例
p4 configure set "Replica1#startup.1=pull -i 1" |
「Replica1」で指定したサーバで、1秒間隔で1回ポーリングするようにstartup.n構成可能変数を設定します。 |
p4 configure set rpl.labels.global=1
|
サーバから以下の出力が返されます。 For server 'any', configuration variable 'rpl.labels.global' set to '1' 「any」は、同じ設定に対するローカルのオーバーライドが存在しない限り、この設定がすべてのサーバに適用されるということを意味しています。 |
関連コマンド
p4 configure
コマンドは、以前p4 counter
で設定された数多くの設定を置換します。
すべてのカウンタとその値を一覧表示する |
|
Helix Coreサーバのシステム変数を設定する | p4 set |