p4 admin
概要
サーバに対する管理操作を実行します。
構文
p4 [g-opts
] admin checkpoint [-z | -Z] [prefix
]
p4 [g-opts
] admin journal [-z] [prefix
]
p4 [g-opts
] admin stop
p4 [g-opts
] admin restart
p4 [g-opts
] admin updatespecdepot [-a | -s type
]
p4 [g-opts
] admin resetpassword -a | -u user
p4 [g-opts
] admin setldapusers
解説
Perforceスーパーユーザは、現在作業中のマシンが共有Perforceサービスが稼動しているマシンとは異なる場合でも、p4 adminコマンドを使って管理タスクを実行することができます。
Perforceサービスを停止するには、p4 admin stopを使用します。このコマンドは、サーバの再起動時、データベースが一貫した状態にあるようにするためにデータベースをロックし、その上でPerforceのバックグラウンドプロセスを停止します。
サービスを再起動するには、p4 admin restartを使用します。データベースがロックされ、サービスが再起動した後、再起動を必要とするp4 configureの設定が適用されます。
チェックポイントを作成するには、p4 admin checkpoint
[prefix
]を使用します。サーバマシンにログインし、p4d
-jc [prefix
]でチェックポイントを作成するのと同じことです。チェックポイントが作成され、ジャーナルが連番を付けたファイルにコピーされます。prefix
を指定すれば、これらのファイルはそれぞれ
、prefix
.ckp.n
という名前で保存されます。ここで、prefix
.jnl.n-1
n
は連番です。チェックポイントのMD5チェックサムが別のファイルcheckpoint.
に書き込まれ、n
.md5lastCheckpointAction
カウンターが正常終了を反映して更新されます。
プレフィックスの一部に任意のディレクトリを指定することにより、そのディレクトリにチェックポイントおよびジャーナルを格納することができます。(循環ジャーナルは現在のジャーナルの格納ディレクトリに関わらず、P4ROOT
ディレクトリに格納されます。)prefix
の指定がなければ、デフォルトのファイル名checkpoint.
とn
journal.
が使用されます。
n-1
p4 admin journalコマンドは、p4d -jjと実行するのと同等です。詳細については、『Perforceサーバ管理者ガイド: 基本』を参照してください。これらのファイルは、Perforceサービス起動時の指定に従い、サーバルートに作成されます。
p4 admin updatespecdepotコマンドを実行すると、Perforceサービスが保管フォーム(具体的には、client
、depot
、branch
、label
、typemap
、group
、user
、およびjob
の各フォーム)をスペックディポにアーカイブします。-a
オプションを使用すると、すべての仕様タイプがアーカイブされます。-s
オプションを使用すると、特定のtype
を持つフォームのみがアーカイブされます。まだアーカイブされていないフォームのみが作成されます。
p4 admin resetpasswordコマンドは、既存のパスワードを持つ指定されたユーザが別のコマンドを実行する前にパスワードを変更することを強制します。パスワードを持つすべてのユーザ(コマンドを実行したスーパーユーザを含む)にパスワードのリセットを強制するには、p4 admin
resetpassword -aを使用します。単一のユーザにパスワードのリセットを強制するには、p4 admin resetpassword -u
user
を使用します。
p4 admin setldapusersコマンドにより、既存のすべての非スーパーユーザを、LDAP認証を使用するように変更できます。このコマンドは、各ユーザのユーザ仕様のAuthMethod
フィールドをperforce
からldap
に変更します。super
ユーザがLDAP認証を使用する場合、自分のAuthMethod
を手動で設定する必要があります。
オプション
|
p4 admin updatespecdepotに付けると、スペックディポを現在のすべてのフォームで更新します。 |
|
p4 admin updatespecdepotに付けると、特定タイプのフォームを持つスペックディポを更新します。タイプは、 |
|
p4 admin checkpointおよびp4
admin journalに付けると、チェックポイントとジャーナルファイルが拡張子 |
|
p4 admin checkpointおよびp4 admin
journalに付けると、チェックポイントは拡張子 |
|
“グローバルオプション”を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? |
ファイル引数にリビジョン範囲を使えるか? |
最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
|
-
p4 admin updatespecdepotコマンドおよびp4 admin resetpasswordコマンドの実行には
super
権限が必要です。その他のコマンドには、ユーザがオペレータであるか(p4 user参照)、super
権限を持っている必要があります。 -
パスワードを持つ新規作成されたすべてのユーザが最初にコマンドを実行する前にパスワードをリセットすることを必須にするには、構成可能変数
dm.user.resetpassword
を以下のとおり設定します。p4 configure set dm.user.resetpassword=1
p4 admin resetpassword -aの実行によってパスワードがリセットされるのは、その時点で存在する(かつ、パスワードが設定済みの)ユーザのみです。
-
p4 admin stopを実行するとPerforceサーバが停止するので、接続が予期せず切断されたというエラーメッセージが表示される場合がありますが、このメッセージは無視してかまいません。
-
p4 admin updatespecdepotを実行する前に、スペックディポが存在している必要があります。
-
p4 dbstat、p4 lockstat、およびp4 logstatは独立したコマンドとなり、p4 adminの古い構文は下位互換性を保つためにエイリアスとして残されています。
-
Perforceの管理について、詳しくは『Perforceサーバ管理者ガイド: 基本』および『Perforceサーバ管理者ガイド: マルチサイト展開』を参照してください。
例
p4 admin stop |
共有Perforceサービスを停止します。 |
p4 admin checkpoint |
|
p4 admin checkpoint name |
|