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 |
継続して この方法では、指定のサーバまたはあらゆるサーバに特定の構成可能変数を設定することができます。 |
3 |
環境変数を使用します。
|
4 |
何もせずデフォルト値を使用する。 |
K
とM
を使用すると、大きい値を表すことができます。 例えば、10M
はdm.shelve.maxfiles構成可能変数のデフォルト値です。
p4 configure show
を使用して、現在のサーバ、指定のサーバ、およびすべてのサーバの構成状態を表示します。 各構成可能変数は、その値および設定に使用された方法とともに表示されます。 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」を参照してください。
オプション
|
指定された変数に、与えられた値を設定します。 |
|
指定された変数の設定を解除します。 |
|
注意
|
|
システムが認識しているすべてのサーバの構成変数を表示します。 |
|
特定の構成変数の設定を表示します。 |
|
|
|
詳細については、「グローバルオプション」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? | ファイル引数にリビジョン範囲を使えるか? | 最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
|
例
p4 configure set “Replica1#startup.1=pull -i 1” |
1秒間隔で1回ポーリングするようにstartup.n構成可能変数を設定します |
関連コマンド
p4 configure
コマンドは、以前p4 counter
で設定された数多くの設定を置換します。
すべてのカウンタとその値を一覧表示する |