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.md5に書き込まれ、lastCheckpointActionカウンターが正常終了を反映して更新されます。

プレフィックスの一部に任意のディレクトリを指定することにより、そのディレクトリにチェックポイントおよびジャーナルを格納することができます。(循環ジャーナルは現在のジャーナルの格納ディレクトリに関わらず、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を手動で設定する必要があります。

オプション

-a

p4 admin updatespecdepotに付けると、スペックディポを現在のすべてのフォームで更新します。

-s type

p4 admin updatespecdepotに付けると、特定タイプのフォームを持つスペックディポを更新します。タイプは、client、depot、branch、label、typemap、group、user、またはjobのうち1つです。

-z

p4 admin checkpointおよびp4 admin journalに付けると、チェックポイントとジャーナルファイルが拡張子.gzを付けて圧縮(gzip)フォーマットで保存されます。

-Z

p4 admin checkpointおよびp4 admin journalに付けると、チェックポイントは拡張子.gzを付けて圧縮(gzip)フォーマットで保存されますが、ジャーナルファイルはレプリカサーバでの使用に備え、圧縮されません。

g-opts

“グローバルオプション”を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？

ファイル引数にリビジョン範囲を使えるか？

最低限必要なアクセスレベル

適用外

適用外

super

  • 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

checkpoint.nという名前のチェックポイントを作成し、かつjournalという名前の新しいジャーナルを開始します。以前のジャーナルの内容はjournal.n-1(nは連番)にコピーされます。

p4 admin checkpoint name

name.ckp.nという名前のチェックポイントを作成し、かつjournalという名前の新しいジャーナルを開始します。以前のジャーナルの内容はname.jnl.n-1(nは連番)にコピーされます。

関連コマンド

最後のチェックポイントのステータスを表示する。

p4 counter lastCheckpointAction