p4 storage
物理的なアーカイブストレージの表示、検証、更新を行う場合は、このコマンドを使用します。
構文
p4 [g-opts] storage [-v [-q]] [-c change] [-T tags -F filters] [-m max] archive... p4 [g-opts] storage -u [-c change] [-T tags -F filters] [-m max] archive... p4 storage -d [-c change] [-y] [-D secs] [ -t target ] [-q] archive... p4 storage -w p4 storage -l start|pause|restart|wait|status|cancel //depotdirectory/...
説明
adminアクセス権を持つユーザは、以下のコマンドを使用して、サーバ上のアーカイブファイルに関する情報とその使用状況を表示することができます。
p4 storage [-v [-q]] [-c change] [-T tags -F filters] [-m max] archive...
-lオプションを使用して、孤立したアーカイブファイルを検索するためのコマンドグループを指定し、それらのファイルをstorage -dコマンドで削除するためのマークを付けます。
詳細については、『Helix Coreサーバ管理者ガイド』の「ディスク容量を管理する」で、「孤立したアーカイブファイルを削除してディスクスペースを解放する」を参照してください。
表示情報が格納されるフィールドを以下に示します。
| lbrFile | アーカイブファイルのパス |
| lbrRev | アーカイブファイルのリビジョン |
| lbrType |
アーカイブファイルのファイルタイプ(text+Cなど) 詳細については、「ファイルタイプ」を参照してください。 |
| lbrRefCount | ライブラリアンファイルを参照するリビジョンの数 |
| headTime | レコードが書き込まれたときのタイムスタンプ |
| filesize | ライブラリアンファイルのサイズ |
| digest | ライブラリアンファイルのMD5ダイジェスト |
| serverSize | リビジョンのサブミット時または保留時にサーバ上に存在していたライブラリアンファイルのサイズ |
| compCksum | サーバ上のリビジョンが含まれているライブラリアンファイルのMD5 (そのライブラリアンファイルが圧縮されていて、submit.storagefieldsの値が「1」である場合) |
-vフラグを指定すると、以下のフィールドが追加で使用されます。
| actualSize | ライブラリアンファイルの実際のサイズ |
| actualDigest | ライブラリアンファイルの実際のMD5ダイジェスト |
| status | 検証結果(OK、BAD、MISSINGのいずれか) |
オプション
|
|
指定したアーカイブファイルが変更されていないかどうかが確認されます。 各アーカイブファイルのダイジェストが計算されて表示されます。
p4 storage -vコマンドとp4 verifyコマンドは似ていますが、以下の点が異なっています。
|
||||||||||||||||||||||||||
|
|
保存されたダイジェストが存在しないリビジョンについてのみ、ダイジェストの計算と保存が実行されます。 |
||||||||||||||||||||||||||
|
|
storage -vコマンドで、最低限の出力が表示されます(ダイジェストの不一致エラー、またはリビジョンの再生成エラーのみが表示されます)。 |
||||||||||||||||||||||||||
| -d |
参照されていないアーカイブが削除されます。 指定したアーカイブの参照カウントが「0」の場合、そのアーカイブが記述されているデータベース行と、ベースアーカイブのリビジョンが削除されます。 -yオプションを指定せずにコマンドを実行した場合、削除対象のファイルとリビジョンが一覧表示されるのみで、実際に削除されることはありません。 -yオプションを指定してコマンドを実行した場合、ファイルとリビジョンのみでなく、まったく参照されていないストレージレコードも削除されます。 有効期限は、 lbr.storage.delay構成可能変数を使用して設定します。 有効期限を設定することにより、サブミット処理や保留処理の進行中にストレージレコードやアーカイブファイルが誤って削除されるのを防ぐことができます。 この構成可能変数の値を上書きする場合は、コマンドラインで-D secsパラメータを指定します。 参照カウントが「0」になっているアーカイブはほとんどありませんが、以下の場合にこうしたアーカイブファイルが作成される可能性があります。
-qオプションを指定すると、削除候補のリビジョンの一覧が表示されなくなります。 -t targetオプションを指定すると、参照されていないアーカイブがサーバのP4ROOTから削除される前に、指定したディレクトリにそのアーカイブがコピーされます。 |
||||||||||||||||||||||||||
| -c | このオプションは、指定したチェンジリストに適用されます。 | ||||||||||||||||||||||||||
| -T |
このオプションは、指定したタグに適用されます(複数のタグを指定する場合は、コンマまたはスペースを区切り文字として使用します)。 例: -T "lbrFile, lbrRev" |
||||||||||||||||||||||||||
| -F |
このオプションは、指定したフィルタに適用されます。 フィルタ式に一致するレコードのみが一覧表示されます。 このフィルタ式の構文は、jobs -e jobviewで使用される構文に似ています。この構文を使用して、上記の各フィールドの内容が評価されます。 フィルタリングでは、大文字と小文字が区別されます。 例: -v -F "lbrRefCount = 1 & status=OK" |
||||||||||||||||||||||||||
| -m | 出力が、指定した件数のレコードのみに制限されます。 | ||||||||||||||||||||||||||
|
|
アップグレードプロセスの完了時に「The storage upgrade process is complete」というメッセージが表示されます。 バージョン2019.1以降にアップグレードする方法については、『Helix Coreサーバ管理者ガイド』を参照してください。 |
||||||||||||||||||||||||||
|
-l
|
管理者は、孤立したファイルを検索してマーキングするためのバックグラウンドプロセスについて、作成、一時停止、再開、キャンセルを行うことができます。 このプロセスは、指定された//depotdirectory内と、サーバのアーカイブファイル形式の命名規則に一致するサブディレクトリ内で、ファイルを検索します。 検索されたファイルとそのリビジョンは、db.storageテーブル内の一致するエントリに対して確認されます。 一致するエントリがない場合は、ファイルとリビジョンの組み合わせを記述する新しいレコードが作成され、参照カウントとして「0」が設定されます。 その後p4 storage -dを呼び出すと、まったく参照されていないレコードとそれに関連するアーカイブリビジョンが削除されます。 p4 storage -lコマンドには、以下に示すサブコマンドがあります。
警告
|
||||||||||||||||||||||||||
|
|
詳細については、「グローバルオプション」を参照してください。 |
ワークフローの例
孤立ファイルの検索
スキャンを開始するには、以下のように指定します。
p4 storage -l start //depot/path/...
スキャンのステータスを確認するには、以下のように指定します。
p4 storage -l status //depot/path/...
スキャンを一時停止するには、以下のように指定します。
p4 storage -l pause //depot/path/...
一時停止を解除してスキャンを再開するには、以下のように指定します。
p4 storage -l restart //depot/path/...
スキャンをキャンセルするには、以下のように指定します。
p4 storage -l cancel //depot/path/...
スキャンプロセスは、キャンセルされるまでシステム上に残ったままになります。 スキャンをもう一度実行する場合は、最初にpauseサブコマンドでスキャンを一時停止してから(スキャンがアクティブな状態になっている場合)、cancelサブコマンドでスキャンをキャンセルします(スキャンが正常に完了したかエラーで終了したかにかかわらず、スキャンをキャンセルしてください)。
サーバ上のディスクスペースを解放する
孤立ファイルをターゲットディレクトリに保存し、一度も参照されていないレコードとそれに関連するアーカイブファイルをサーバのP4ROOTから削除するには、以下のように指定します。
p4 storage -d -y -t /myTargetDirectory //depot/path/...
/myTargetDirectoryは、オペレーティングシステム上のターゲットディレクトリです。例えばWindowsの場合、D:\myCopyOfOrphanedFilesなどがターゲットディレクトリになります。
使用上の留意点
| ファイル引数にリビジョン指定子を使えるか？ | ファイル引数にリビジョン範囲を使えるか？ | 最低限必要なアクセスレベル |
|---|---|---|
|
使用不可 |
使用不可 |
|
