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
p4 [g-opts] admin end-journal

説明

Helixサーバスーパーユーザは、現在作業中のマシンが共有Perforceサービスが稼動しているマシンとは異なる場合でも、p4 adminコマンドを使用して管理タスクを実行することができます。

サービスを停止するには、p4 admin stopを使用します。 このコマンドは、サーバの再起動時、データベースが一貫した状態にあるようにするためにデータベースをロックし、その上でバックグラウンドプロセスを停止します。

サービスを再起動するには、p4 admin restartを使用します。 データベースがロックされ、サービスが再起動した後、再起動を必要とするp4 configureの一部の設定が適用されます。

チェックポイントを作成するには、p4 admin checkpoint [prefix]を使用します。 サーバマシンにログインし、p4d -jc [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と実行するのと同等です。 詳細については、『Helix Coreサーバ管理者ガイド: 基本』を参照してください。 これらのファイルは、Perforceサービス起動時の指定に従い、サーバルートに作成されます。

p4 admin updatespecdepotコマンドを実行すると、サービスが保管フォームをスペックディポにアーカイブします。

p4 admin resetpasswordコマンドは、既存のパスワードを持つ指定されたユーザが別のコマンドを実行する前にパスワードを変更することを強制します。 このコマンドは、authMethodがperforceに設定されているユーザのみ機能します。 ただし、混合環境すなわちHelixサーバベースとLDAPベースの認証が有効な環境で使用することができます。

• パスワードを持つすべてのユーザ(コマンドを実行したスーパーユーザを含む)にパスワードのリセットを強制するには、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、repo、branch、label、typemap、group、user、job、stream、triggers、protect、server、license、jobspecのいずれかになります。
-z	p4 admin checkpointまたはp4 admin journalでこのオプションを指定すると、拡張子.gzで、チェックポイントとジャーナルファイルが圧縮(gzip)フォーマットで保存されます。
-Z	p4 admin checkpointでは、チェックポイントは拡張子.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の古い構文は下位互換性を保つためにエイリアスとして残されています。
• 詳細については、「Helix Coreサーバ管理者ガイド: 基本」および「Helix Coreサーバ管理者ガイド: マルチサイト展開」を参照してください。

例

p4 admin stop	共有サービスを停止します。
p4 admin checkpoint	checkpoint.nという名前のチェックポイントを作成し、かつjournalという名前の新しいジャーナルを開始します。以前のジャーナルの内容はjournal.n-1(nはシーケンス番号)にコピーされます。
p4 admin checkpoint name	name.ckp.nという名前のチェックポイントを作成し、かつjournalという名前の新しいジャーナルを開始します。以前のジャーナルの内容はname.jnl.n-1(nはシーケンス番号)にコピーされます。
p4 admin end-journal	フェイルオーバーの場合、このコマンドは次のように動作します。 ジャーナルが正常に複製および整合されている直近時点で複製を終了します 整合されている時点のジャーナル番号とオフセットを返します スタンバイサーバのjournalcopyスレッドで停止します

関連コマンド

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

p4 counter lastCheckpointAction