Perforce 2008.1 P4 User's Guide
<< Previous Chapter
About This Manual
 Table of Contents
Index
Perforce on the Web
 Next Chapter >>
Configuring P4

Chapter 1
Installing P4

This chapter tells you how to install the Perforce Command-Line Client (p4) on a client machine. For details about installing the Perforce Server, refer to the Perforce System Administrator's Guide.

Installing P4 on UNIX and OS X

To install the Perforce Command-Line Client (p4) on a UNIX or Macintosh OS X machine, perform the following steps:

  1. Download the p4 executable file from the Perforce web site:

    http://www.perforce.com/perforce/loadprog.html

    The Perforce client programs are typically downloaded to /usr/local/bin.

  2. Make the p4 file executable (chmod +x p4)

  3. Configure the server port setting, client workspace name, and user name. You can specify these settings by configuring the P4PORT, P4CLIENT, and P4USER environment variables. (For details, see Chapter 2, Configuring P4.)

Installing P4 on Windows

To install the Perforce Command-Line Client (p4.exe) on Windows, download and run the Perforce Windows installer (perforce.exe) from the Downloads page of the Perforce web site:

The Perforce installer enables you to install and uninstall the Perforce Command-Line Client and other Perforce Windows components.

Verifying the installation

To verify that you have successfully installed the Perforce Command-line Client, type p4 info at the command line and press ENTER. If you have a server running on the specified host and port, the following message is displayed:

User name: ona
Client name: ona-agave
Client host: agave
Client root: /home/ona/p4-ona
Current directory: /home/ona/p4-ona
Client address: 10.0.0.196:2345
Server address: ida:1818
Server root: /usr/depot/p4d
Server date: 2008/06/28 12:11:47 -0700 PDT
Server uptime: 752:41:33
Server version: P4D/FREEBSD/2008.1/156375 (2008/05/25)
Server license: P4Admin <p4adm> 20 users (expires 2009/01/01)

If your configuration settings are incorrect, the following message is displayed::

Perforce client error:
        Connect to server failed; check $P4PORT.
        TCP connect to <hostname> failed.
        <hostname>: host unknown.

Perforce 2008.1 P4 User's Guide
<< Previous Chapter
About This Manual
 Table of Contents
Index
Perforce on the Web
 Next Chapter >>
Configuring P4
Please send comments and questions about this manual to [email protected].
Copyright 2005-2008 Perforce Software. All rights reserved.
Last updated: 07/08/08