UNIX(またはMac OS X)では、p4バイナリおよびp4dバイナリを実行可能にする必要があります。ファイルを実行可能にするには、ソフトウェアのダウンロード後にchmodコマンドを以下のように使用します。

chmod +x p4
chmod +x p4d

Perforceサービスでは、ユーザによってサブミットされたファイルとシステムによって生成されたメタデータは、独自のルートディレクトリ下のファイルおよびサブディレクトリに保存されます。このルートディレクトリをサーバルートといいます。

サーバルートを指定するには、サーバルートを示す環境変数P4ROOTを設定するか、p4d起動時に-r server_rootフラグを使用します。PerforceアプリケーションはP4ROOTのディレクトリまたは環境変数を使用することはありません。p4dがP4ROOT変数を使用する唯一のプロセスです。

Perforceのファイルはすべてサーバルートに保存されるので、サーバルートのコンテンツは時を経るにつれて膨れ上がっていきます。ディスク容量の要件について、概要はインストールと管理に関する基本情報を、詳細はディスク容量の割り当てを参照してください。

Perforceサービスは特権的アクセスを必要としません。また、p4dを、rootまたはその他の特権を持つユーザとして実行する必要はありません。詳細については、UNIX: p4dを非特権ユーザとして実行するを参照してください。

サーバルートはどこに置いてもかまいませんが、p4dを実行するアカウントは、サーバルートおよびそのすべての下位ディレクトリに対してread、write、executeのパーミッションを持っている必要があります。セキュリティを確保するために、p4dを実行するアカウントのファイル作成モードマスクumask(1)は、他のユーザによるサーバルートディレクトリへのアクセスを許可しない値に設定してください。

p4dサービスとPerforceアプリケーションは、TCP/IPで通信します。p4dが起動すると、(デフォルトでは)ポート1666へのプレーンテキスト接続を待機します。p4などのPerforceアプリケーションは、(デフォルトでは)対応するp4dがperforceという名前のホスト上に置かれていて、ポート1666で接続を待っており、その接続がプレーンテキストで行われものと想定します。

p4dに別のポートで接続待ちさせるか、別のプロトコルを使用する場合は、その構成をp4d起動時に-p protocol:host:portフラグで(例えばp4d -p ssl:1818などと)指定するか、またはP4PORT環境変数の内容で指定します。プレーンテキスト接続はtcp:portで指定され、SSL暗号化はssl:portで指定されます。(SSLを使用するには、証明書およびキーペアを供給または生成し、サーバ上の安全な場所に格納する必要があります。詳細については、Perforceサーバへの接続を暗号化するを参照してください。)

P4ROOTとは異なり、環境変数P4PORTはPerforceサービスおよびPerforceアプリケーションの両方で使用されます。したがって、Perforceサービスをホストするマシンと各ユーザのワークステーションの両方で設定する必要があります。

p4dサービスがどのマシン上で接続を待機しているのか、またp4dがどのTCP/IPポートで接続を待機しているか、そして通信がプレーンテキストであるかSSLであるかをPerforceアプリケーションが知っている必要があります。

各PerforceユーザのP4PORT環境変数を、protocol:host:portに設定します。なお、protocolは通信プロトコル(SSLの場合はssl:から、プレーンテキストの場合はtcp:から始まります)、hostはp4dを実行中のマシンの名前、portはp4dが接続待機中のポート番号です。例:

SSL接続を有効にした場合、ユーザがサービスへの接続を最初に試みたときに、サーバのフィンガープリントが表示されます。フィンガープリントが正しければ、ユーザはp4 trustコマンド(p4 trust -yまたはp4 -p ssl:host:port trust -i fingerprintのいずれか)を使用して、フィンガープリントをP4TRUST環境変数で指定したファイルにインストールすることができます。このファイルには、既知または信頼済みのPerforceサーバおよびそれぞれのフィンガープリントのリストが保存されます。P4TRUSTが設定されていない場合は、このファイルはユーザのホームディレクトリにある.p4trustになります。

リリース2013.1以降、PerforceではIPv4ネットワークに加えて、IPv6ネットワークでの接続がサポートされるようになりました。

ネットワークサービスの動作とパフォーマンスは、サービスをホストするマシンのネットワーク性能や、エンドユーザが使用するオペレーティングシステムばかりでなく、ユーザ固有のLANまたはWANのインフラストラクチャ(加えて、エンドユーザとPerforceバージョン化サービスの間にあるすべてのルータにおけるIPv6サポート状況)によって異なります。

想定される事例を1つだけ挙げます。ユーザが自宅から作業する場合、そのユーザがIPv6ベースのホームネットワークを配備しているとしても、ISPまたはVPNのプロバイダがIPv6を完全にサポートしているとは限りません。したがって弊社では、P4PORTの設定としていくつかの選択肢を用意することにより、IPv4からIPv6へ移行中の管理者とユーザが可能な限り柔軟に作業できるようにし、旧バージョンとの互換性を持たせています。

混合環境では構成可能変数net.rfc3484に1を設定することが推奨されます。

p4 configure set net.rfc3484=1

この設定により、RFC3484準拠の動作が、プロトコルの値を明示的に指定していないユーザに対しても保証されます。すなわち、クライアント側の構成可能変数net.rfc3484に1が設定され、P4PORTがexample.com:1666またはtcp:example.com:1666、またはssl:example.com:1666に指定されている場合、ユーザのオペレーティングシステムはそれぞれの接続にIPv4とIPv6のどちらを使用するかを自動的に決定します。

マルチサーバ環境では、サーバ側でnet.rfc3484を設定すると、サーバからサーバへの(またはサーバからプロキシやブローカへの)通信を開始する際のホスト解決の動作も制御されます。

p4dの環境変数P4PORTおよびP4ROOTを設定したら、以下のコマンドを使用してバックグラウンドでp4dを実行することにより、サービスを起動します。

p4d &

p4dを実行するだけであればこのコマンドで十分ですが、他にもエラーログ、チェックポイント、ジャーナル作成などを制御する他のフラグを指定することができます。

p4d -r /usr/local/p4root -J /var/log/journal -L /var/log/p4err -p tcp64:[::]:1818 &

Perforceサービスを停止するには、以下のコマンドを使用します。

p4 admin stop

p4 admin stopコマンドを使用できるのは、Perforceスーパーユーザのみに限られます。

実行中のPerforceサービスを再起動するには(例えば、新しいライセンスファイルを読み込むには)、以下のコマンドを使用します。

p4 admin restart

p4 admin restartコマンドを使用できるのは、Perforceスーパーユーザのみに限られます。UNIXプラットフォームでは、kill -HUPコマンドでサービスを再起動できます。

このマニュアルでは、Perforceサービスおよびp4dという用語は、WindowsサーバプロセスとWindowsサービスプロセスを明確に区別する場合を除き、いずれも同義で使用されており、ともに「Perforceアプリケーションにバージョン化サービスを提供するプロセス」を意味します。

UNIXシステムでは、バージョン化サービスの提供を担うのは、Perforceサービス(p4d)のみです。ただしWindowsでは、ブート時に実行されるWindowsサービス(p4s.exe)プロセスか、コマンドプロンプトから手動で起動するWindowsサーバ(p4d.exe)プロセスのいずれかとして起動するように構成できます。

Perforceサービス(p4s.exe)とPerforceサーバ(p4d.exe)の2つの実行ファイルはお互いのコピーです。ファイル名が違うだけで、この2つは全く同じものです。実行すると、それぞれの実行ファイルは、起動時に呼び出された名前の最初の3文字(p4sまたはp4dのいずれか)を使用して、それぞれの動作を決定します。(例えば、起動したp4d.exeの名前が、p4smyservice.exeであればサービスとして、あるいはp4dmyserver.exeであればサーバとして起動します。)

デフォルトでは、PerforceインストーラはPerforceをWindowsサービスとして構成します。サービスとサーバの区別の詳細については、WindowsサービスとWindowsサーバを参照してください。

PerforceをWindows環境下にサービスとしてインストールすると、マシン起動時に必ずPerforceサービスが起動します。Perforceサービスの動作を制御するには、[コントロール パネル]の[サービス]アプレットを使用します。

PerforceをWindows環境下でサーバとしてインストールした場合、p4d.exeの起動にはコマンドプロンプトを使用します。Windows環境下のp4dで使用できるフラグは、UNIXで使用できるフラグと同じです。

Perforceサービス(またはサーバ)を停止するには、以下のコマンドを使用します。

p4 admin stop

p4 admin stopコマンドを使用できるのは、Perforceスーパーユーザのみに限られます。

これ以前のバージョンのPerforceでは、サービスを手動で停止するのに[コントロール パネル]の[サービス]アプレットを使用します。実行中のサーバをコマンドプロンプトウィンドウでシャットダウンするには、ウィンドウ内にCTRL+Cと入力するか、コマンドプロンプトウィンドウの[閉じる]アイコンをクリックします。この方法により手動でサーバをシャットダウンすることは必ずしもスマートな方法ではありません。ベストプラクティスは、p4 admin stopコマンドを使用することです。

古いバージョンのPerforceアプリケーションを新しいバージョンのPerforceと併用しても基本的には問題なく動作しますが、新しいサーバリリースにおける機能のなかにはPerforceアプリケーションのアップグレードを必要とするものもあります。ユーザが古いアプリケーションを使用している場合、概して、使用中のアプリケーションのリリース時点におけるPerforceバージョニングサービスの各種機能を使用できますが、それ以降のサービスのアップグレードによって提供される新機能を使用することはできません。

Perforceを新しいバージョンにアップグレードするには、Perforceライセンスファイルが有効である必要があります。有効期間を過ぎたライセンスファイルは、アップグレード後のバージョンのPerforceでは使用できません。

アップグレード前のバージョンおよびアップグレード後のバージョンが、両方とも2013.3以降であるか、または両方とも2013.2以前である場合は、この節で説明する手順を実行してください。

アップグレード手順の詳細については、リリースノートをお読みください。

Perforceのアップグレードでは、一般的に以下の操作が必要です。

アップグレード中に不明な点や障害が発生した場合、Perforceテクニカルサポートへご連絡ください。

アップグレード前のバージョンが2013.2以前であり、かつアップグレード後のバージョンが2013.3以降である場合、このセクションで説明する手順を実行してください。

Perforce 2013.3では、Perforceデータベースの実装に関する大きな変更点が複数あります。これらの変更により、同時並行処理能力とスケーラビリティが向上し、db.*データベースのファイル容量制限が16TBにまで増加しています。

db.*データベースのファイル形式は変更されましたが、チェックポイントおよびジャーナルファイルの形式は以前のバージョンと変わりありません。2013.2(またはそれ以前)のリリースから2013.3(またはそれ以降)のリリースへアップグレードするには、必ずチェックポイントからデータベースを復元してください。これを行うには、

Perforceバージョン化サービスは、サポートするユーザの数に応じてライセンスされます。

ライセンス情報は、サーバルートディレクトリのlicenseというファイルに含まれています。licenseファイルは、Perforceソフトウェアによって供給されるプレーンテキストファイルです。licenseファイルがない場合、Perforceサービスは20人のユーザと20のクライアントワークスペース(ファイル数は無制限)、または無制限のユーザとワークスペース(ファイル数の上限は1000)のいずれかにアクセスを制限します。p4 licenseコマンドを使用すると、Perforceを停止せずに既存のファイルを更新できます。詳細については、新規ライセンス許可ユーザを追加するを参照してください。

サービスの実行中は、どのユーザでもp4 infoを使用すれば基本的なライセンス情報を確認できます。管理者はp4 license -uを使用して、使用中のユーザ数とファイル数に関してより詳しい情報を取得できます。

サービスの停止中でも、licenseファイルが置かれているサーバルートディレクトリからp4d -Vを実行するか、コマンドライン(p4d -V -r server_root)または環境変数P4ROOTのいずれかでサーバルートディレクトリを指定することにより、ライセンス情報を取得できます。

サーバのバージョンは、p4d -Vまたはp4 -Vを実行することによっても表示されます。

Perforceを定期的にバックアップしておくことはきわめて重要です。要点は以下の通りです。

バックアップとリストアの手順の詳細については、“Perforceのサポート: バックアップとリカバリ”を参照してください。

インストール先のシステムがUNIXとWindowsのいずれであっても、P4ROOTディレクトリ(すなわちデータベースおよびバージョンファイルを格納しているディレクトリ)は、ジャーナルファイルとは別の物理ドライブに置くことを推奨します。

ジャーナルを別のドライブに保存しておけば、たとえP4ROOTを含むドライブがディスク故障により破損したとしても、その影響が使用中のジャーナルファイルにおよぶことはありません。その場合、ジャーナルファイルを使用して、消失または損傷したメタデータをすべて復元することができます。

詳細については、“Perforceのサポート: バックアップとリカバリ”を参照してください。

管理者がPerforceスーパーユーザを定義しない限り、すべてのPerforceユーザは、Perforceスーパーユーザと同等の権限を持ちながら、あらゆるファイルに対してあらゆるPerforceコマンドを実行できます。新しいPerforceサービスのインストール後、管理者はできるだけすみやかに

p4 protect

を使用して、Perforceスーパーユーザを定義してください。p4 protectの動作の詳細は、“Perforceの管理: 保護”を参照してください。

パスワードを定義していない場合、すべてのユーザは、-uフラグを使用するか、P4USERに既存のPerforceユーザ名を指定することにより、他のPerforceユーザとして操作する(なりすます)ことができます。このようななりすましを防ぐには、Perforceパスワードを使用してください。詳細については、『P4ユーザ－ズガイド』を参照してください。

ユーザのパスワードを設定(またはリセット)するには、(Perforceスーパーユーザとして)p4 passwd usernameを使用して該当ユーザの新しいパスワードを入力するか、(やはりPerforceスーパーユーザとして)p4 user -f usernameを実行してユーザ仕様フォームに新しいパスワードを入力します。

セキュリティ意識の高いPerforceスーパーユーザであれば、p4 protectを使用して、listよりも高いレベルのアクセスを非特権ユーザに対して許可しないように設定し、またp4 configureを使用して、すべてのユーザに強力なパスワードの使用を要求するようにsecurityレベルを変更し、さらにp4 groupを使用して、すべてのユーザをグループに振り分ける(と同時に、必要に応じて、任意のグループを指定してその所属ユーザにパスワードの定期的な変更を要求したり、サイト内のすべてのユーザにパスワードの最小文字数を設定したり、事前に定義した回数だけログイン試行に失敗したユーザアカウントをロックしたりする)べきです。

バージョン化ファイルの合計サイズは時を経るにつれて膨れ上がっていくため、使用中のP4ROOTディレクトリ内に十分な空き容量を割り当てることを推奨します。その容量としては、まずバージョンファイルの現在の合計サイズの3倍をベースとし、さらにディポファイル、ファイルの状態、ファイルリビジョン履歴のリストの格納用データベースファイルを保存するのに1ファイル当たり0.5KBにユーザ数をかけた合計の容量を加えるとよいでしょう。

ディスクサイズの推定方法の詳細については、ディスク容量の割り当てを参照してください。

Perforceのバージョン化ファイルはすべて、データベースファイルや(デフォルトでは)チェックポイントおよびジャーナルと同様に、サーバルート以下のサブディレクトリにあります。ディスク容量が少なくなっている場合、ディスク容量の使用を制限するために以下のアプローチを検討してください。

最初期のバージョンのPerforce(概して98.2以前)では、一部の古いオペレーティングシステムと同様に、Perforceデータベースファイル(使用中のサイトのメタデータを記録しているP4ROOTディレクトリ中のdb.*ファイル)のサイズが最大2 GBまでに制限されています。db.haveファイルには、現在クライアントワークスペースと同期しているファイルのリストが記録されているため、そのファイルサイズは最も急速に増大する傾向があります。

Perforceデータベースファイルのいずれかのサイズが増大して2 GBを超えることが予想されたら、大容量ファイルをサポートするプラットフォームにPerforceサーバをインストールしてください。

デフォルトでは、Perforceサービスは、WindowsのローカルSystemアカウントのもとで動作します。Windowsでネットワークドライブ上のファイルにアクセスするにはリアルアカウント名とパスワードが必要であるため、WindowsにPerforceをインストールしてP4ROOTにネットワークドライブを指定すると、インストーラはアカウント名とパスワードを要求します。入力すると、Perforceサービスは提供されたデータに基づいて構成され、Systemではなく指定したユーザとして動作します。(サービスを実行するアカウントは、そのマシン上でAdministratorの権限を持っていなければなりません。)

Perforceは、ルートディレクトリがネットワークドライブ上にあっても信頼できる動作をしますが、パフォーマンスが相当低下してしまいます。これは、データベースへの書き込みがすべてネットワークを経由して実行されるためです。最適なパフォーマンスを獲得するには、ネットワークドライブではなくローカルドライブを使用してWindowsサービスをインストールします。

詳細についてはネットワークドライブにPerforceサービスをインストールするを参照してください。

Perforceではアクセスの際に特権を要求しません。セキュリティを確保するには、p4dをrootとして動作させないようにするか、またはp4dプロセスの所有者にrootレベルの特権を与えます。

p4dを管理するUNIXの非特権ユーザ(例えばperforce)を作成し、(必要に応じて)そのユーザのためにUNIXグループ(例えばp4admin)を作成します。umask(1)コマンドを使用して、サーバルート(P4ROOT)およびそれ以下に作成されているすべてのファイルとディレクトリの書き込みをUNIXユーザperforceのみに許可し、さらに(必要に応じて)その読み込みをUNIXグループp4adminのメンバーに許可します。

この設定では、Perforceサービス(p4d)は実行中にUNIXユーザperforceとしてサーバルートのファイルに書き込むことができる一方で、どんなユーザもそれらのファイルを読み込みまたは上書きできません。p4dによって作成されたファイル(つまりディポファイル、チェックポイント、ジャーナルなど)へのアクセス権を、信頼されるユーザに与えるには、それらのユーザをUNIXグループp4adminに追加します。

Perforceのエラー出力ファイルを指定するには、p4dに-Lフラグを付けて使用するか、環境変数P4LOGを使用します。エラー出力ファイルが定義されていない場合、エラーはp4dプロセスの標準エラーとしてダンプされます。p4dはすべてのエラーメッセージをユーザへ確実に届けることを試みますが、エラー発生後、そのエラーが受信される前にユーザアプリケーションの接続が解除された場合、p4dはこうしたエラーをエラー出力ファイルに記録します。

Perforceでは、デバッグ用のトレースフラグもサポートされています。詳細については、Perforceサーバトレースおよび追跡用オプションを参照してください。

サイトでユーザからファイルへのアクセスを追跡する必要がある場合は、p4dを-Aフラグ付きで使用するか、環境変数P4AUDITを使用することにより、監査を有効にしてPerforceの監査ログファイルを指定します。監査が有効になっている場合、ユーザがファイルにアクセスするたびに、その記録が監査ログファイルに保存されます。このオプションは、アクティブなシステム上で相当のディスク容量を消費する可能性があります。

詳細については、ユーザのファイルアクセスの監査を参照してください。

Perforceバージョン化サービスをホストする環境がWindowsとUNIXのいずれであるにせよ、サイトでクロスプラットフォーム開発が行われている場合(つまりPerforceアプリケーションをWindowsとUNIXの両方の環境で使用している場合)、ユーザは大文字と小文字の区別に関する問題の詳細についてもある程度知っておく必要があります。

詳細については、大文字と小文字の区別とマルチプラットフォーム開発を参照してください。

Perforceは、バージョン化サービスをホストするマシン上で稼働中のプロセスに関する情報を追跡します。プロセスの監視に必要なシステムリソースは最小限で済みますが、p4 monitorを使用してプロセスを監視するにはその機能を有効にする必要があります。

プロセスの監視を有効にするには、monitor構成可能変数を以下のように設定します。

p4 configure set monitor=1

詳細については、サーバの動作を監視するを参照してください。

Perforceは、ネットワークの帯域幅やCPUの処理能力を効率よく消費します。パフォーマンスを左右する最も重要な要素は、ホストマシンのディスクI/Oサブシステムの効率性と、ユーザ由来の任意のPerforce操作で参照されるファイルの数です。

パフォーマンス調整の詳細については、“Perforceのパフォーマンス調整”を参照してください。