Helix Core P4コマンドリファレンス (2020.1)

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

継続してp4 configure setコマンドを使用する。

この方法では、指定のサーバまたはあらゆるサーバに特定の構成可能変数を設定することができます。

3

環境変数を使用します。

  • Windowsの場合、以下のように「p4 set -S Perforce」コマンドを指定します。
    p4 set -S Perforce P4DEBUG="net.keepalive.idle=2700" - この場合、永続的な値になります。
  • Unixの場合、exportコマンドを使用します。この場合、一時的な値になります。
注意

サーバに関する構成可能変数の中には、読み取り専用の変数があります。 例えば、p4 configureコマンドとp4 configure setコマンドの場合、環境変数のP4ROOTP4JOURNALの値を変更することはできません。

4

デフォルト値を使用する(特に操作を行う必要はありません)。

ヒント

KMを使用すると、大きい値を表すことができます。 例えば、10Mdm.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サーバをインストールした後、次の操作を実行することをお勧めします。

  • monitor1または2に設定し、プロセスの監視を有効にします
  • security3または4に設定し、チケットベースの認証を必須にします
  • dm.user.noautocreate1または2に設定し、新しいユーザの自動作成を防止します
  • dm.user.resetpassword1に設定し、作成した新規ユーザに対してパスワードのリセットを強制します

一部の構成可能変数の実行時にサーバを停止する

ほとんどの構成可能変数は変更が加えられるとすぐに有効になります。 例えば、

P4AUTHP4PORT、複製環境で使用されるstartup.N構成可能変数、net.tcpsize、およびnet.backlogを変更する場合は、再起動が必要になります。 サーバを再起動するには、p4 admin restartを使用してください。

特定の構成可能変数の場合(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」を参照してください。

オプション

set variable=value

指定された変数に、与えられた値を設定します。

unset variable

指定された変数の設定を解除します。

show

P4PORTに現在指定されているサーバの現在の構成内容を表示します。

注意

db.monitorテーブルの最大サイズについてはdb.monitor.shared構成可能変数を参照してください。p4 configure showは実際の最大を示しますが、p4 configure show allserversは充分なメモリを使用可能な場合のみ実施されるマニュアルプリファレンスを示すことに注意してください。

show allservers

システムが認識しているすべてのサーバの構成変数を表示します。

show variable

指定された構成変数の設定内容を表示します。

show P4NAME

-InP4NAMEまたはP4NAME環境変数をサーバ名に設定してHelixサーバが起動された場合、指定されたサーバの設定を表示します。

重要

構成の問題を回避するには、serverIDの値をP4NAMEの値と常に一致させる必要があります(どちらも設定されている場合)。 P4NAMEではなくserverIDを設定することをお勧めします。

history

db.confighテーブル内の各構成可能変数の値に対する変更内容が記録されます。このテーブルには、構成可能変数の名前、対象となるserverId、変更前の値、変更後の値、変更を行ったuser、変更が行われたdatetimeconfigureVersionの番号、変更が行われたサーバのserverIdが保存されます。

history allservers

システム上で認識されているすべてのサーバの構成変数の変更履歴を表示します。

history variable

指定された構成変数の変更履歴を表示します。

history P4NAME

-In P4NAMEまたはP4NAME環境変数でサーバ名を指定してHelixサーバを呼び出した場合、指定したサーバの設定の変更履歴が表示されます。

重要

構成の問題を回避するには、serverIDの値をP4NAMEの値と常に一致させる必要があります(どちらも設定されている場合)。 P4NAMEではなくserverIDを設定することをお勧めします。

g-opts

詳細については、「グローバルオプション」を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか? ファイル引数にリビジョン範囲を使えるか? 最低限必要なアクセスレベル

適用外

適用外

super

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で設定された数多くの設定を置換します。

すべてのカウンタとその値を一覧表示する

p4 counters

Helix Coreサーバのシステム変数を設定する p4 set