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

p4 configure

サーバ構成変数を管理します。

構文

p4 [g-opts] configure set [P4NAME#|server_id#]variable=value
p4 [g-opts] configure unset [P4NAME#|server_id#]variable
p4 [g-opts] configure show [allservers | P4NAME | variable]

説明

構成変数を使用して、Perforceサービスの動作をカスタマイズします。

重要

構成変数については次を参照してください。

  • 構成可能変数 - アルファベット順リスト : サーバを停止する必要があるかどうかなどを含め、多くの情報を提供します
  • p4 help configurables: 名前、デフォルト値、使用方法を一覧表示します
  • p4 help environment : 名前、定義、詳細情報の入手場所を一覧表示します

構成可能変数の設定は、クライアント、サーバ、またはプロキシに影響する可能性があります。

p4 configureコマンドは、稼動中のサーバの構成を変更する1つの方法です。 クライアントまたはプロキシに影響する構成可能変数の設定についての説明は、「構成可能変数」を参照してください。

次の方法でサーバに構成可能変数を設定できます。 これらの方法は優先度の高い順に示されています。

優先度

メソッド

1

サーバ起動時にコマンドラインのオプションとして渡す。 以下に例を示します。

$ p4d -v net.keepalive.idle=2700
2

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

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

3

環境変数を使用します。

  • Windowsではp4 setコマンドを使用します
  • Unixではexportコマンドを使用します
注意

環境変数を使用して設定すると、特定のサーバ関連の構成可能変数が読み取り専用になります。
例えば、P4ROOTP4JOURNALp4 configureを使用して変更できません。

4

何もせずデフォルト値を使用する。

ヒント

KMを使用すると、大きい値を表すことができます。 例えば、10Mdm.shelve.maxfiles構成可能変数のデフォルト値です。

p4 configure showを使用して、現在のサーバ、指定のサーバ、およびすべてのサーバの構成状態を表示します。 各構成可能変数は、その値および設定に使用された方法とともに表示されます。 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の値と常に一致させる必要があります(どちらも設定されている場合)。 serverIDを設定することをお勧めしますが、下位互換性を維持するため、P4NAMEもサポートされています。

g-opts

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

使用上の留意点

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

適用外

適用外

super

p4 configure set “Replica1#startup.1=pull -i 1”

1秒間隔で1回ポーリングするようにstartup.n構成可能変数を設定します

関連コマンド

p4 configureコマンドは、以前p4 counterで設定された数多くの設定を置換します。

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

p4 counters