Perforce 2007.2 System Administrator's Guide

More documents

Recommendations

Info

Chapter 1: Welcome to Perforce: Installing and UpgradingStarting the Perforce serverAfter you set p4d’s P4PORT and P4ROOT environment variables, start the server by runningp4d in the background with the command:p4d &Although the example shown is sufficient to run p4d, you can specify other flags thatcontrol such things as error logging, checkpointing, and journaling.Example:Starting a Perforce serverYou can override P4PORT by starting p4d with the -p flag, and P4ROOT by starting p4d withthe -r flag. Similarly, you can specify a journal file with the -J flag, and an error log file withthe -L flag. A startup command that overrides the environment variables might look like this:p4d -r /usr/local/p4root -J /var/log/journal -L /var/log/p4err -p 1818 &The -r, -J, and -L flags (and others) are discussed in “Supporting Perforce: Backup andRecovery” on page 25. A complete list of server flags is provided in the “Perforce Server (p4d)Reference” on page 151.Stopping the Perforce serverTo shut down a Perforce server, use the command:p4 admin stopOnly a Perforce superuser can use p4 admin stop.If you are running a release of Perforce from earlier than 99.2, you must find the processID of the p4d server and kill the process manually from the UNIX shell. Use kill -15(SIGTERM) instead of kill -9 (SIGKILL), because p4d might leave the database in aninconsistent state if it is in the middle of updating a file when a SIGKILL signal is received.Windows installationTo install Perforce on Windows, use the Perforce installer (perforce.exe) from theDownloads page of the Perforce web site.:http://www.perforce.com/perforce/loadprog.htmlUse the Perforce installer to:• Install the Perforce Command-Line Client software (“User install”)The user install option installs only the Perforce Command-Line Client (p4.exe).Other Perforce clients on Windows, such as the Perforce Visual Client (P4V), thePerforce Windows Client (P4Win), as well as third-party plug-ins, may be downloadedand installed separately.14 Perforce 2007.2 System Administrator’s Guide
Chapter 1: Welcome to Perforce: Installing and Upgrading• Install Perforce as either a Windows server or Windows service as appropriate(“Administrator typical” and “Administrator custom” install)These options enable you to install Perforce client programs and the Perforce Windowsserver (p4d.exe) and service (p4s.exe) executables, or to automatically upgrade anexisting Perforce server or service running under Windows.Under Windows 2000 or higher, you must have Administrator privileges to installPerforce as a service or as a server.• Uninstall PerforceThis option removes the Perforce server, service, and client executables, registry keys,and service entries. The Perforce database and the depot files stored under your serverroot are preserved.For more about installing on Windows, see “Using the Perforce installer” on page 133.Windows services and serversIn this manual, the terms Perforce server and p4d are used interchangeably to refer to “theprocess which handles requests from Perforce client programs” unless the distinctionbetween a Windows server process a Windows service process is relevant.On UNIX systems, there is only one Perforce “server” program (p4d) responsible for thisback-end task. On Windows, however, this back-end program can be configured to run asa Windows service (p4s.exe) process that starts at boot time, or as a server (p4d.exe)process that you invoke manually from a command prompt.The Perforce service (p4s.exe) and the Perforce server (p4d.exe) executables are copiesof each other; they are identical apart from their filenames. When run, the executables usethe first three characters of the name with which they were invoked (either p4s or p4d) todetermine their behavior. (For example, invoking copies of p4d.exe namedp4smyservice.exe or p4dmyserver.exe invoke a service and a server, respectively.)In most cases, it is preferable to install Perforce as a service, not a server. For a moredetailed discussion of the distinction between services and servers, see “Windowsservices vs. Windows servers” on page 136.Starting and stopping PerforceIf you install Perforce as a service under Windows, the service starts whenever themachine boots. Use the Services applet in the Control Panel to control the Perforceservice’s behavior.If you install Perforce as a server under Windows, invoke p4d.exe from a commandprompt. The flags for p4d under Windows are the same as those used under UNIX.Perforce 2007.2 System Administrator’s Guide 15
Page 2 and 3: This manual copyright 1997-2007 Per
Page 4 and 5: Table of ContentsLogging errors....
Page 6 and 7: Table of ContentsDeleting groups ..
Page 8 and 9: Table of ContentsChapter 9Perforce
Page 10 and 11: Preface: About This Manual10 Perfor
Page 12 and 13: Chapter 1: Welcome to Perforce: Ins
Page 26 and 27: Chapter 2: Supporting Perforce: Bac
Page 40 and 41: Chapter 3: Administering Perforce:
Page 64 and 65:
Chapter 3: Administering Perforce:
Page 66 and 67:
Page 68 and 69:
Page 70 and 71:
Page 72 and 73:
Page 74 and 75:
Page 76 and 77:
Page 78 and 79:
Page 80 and 81:
Page 82 and 83:
Page 84 and 85:
Page 86 and 87:
Chapter 5: Customizing Perforce: Jo
Page 88 and 89:
Page 90 and 91:
Page 92 and 93:
Page 94 and 95:
Page 96 and 97:
Chapter 6: Scripting Perforce: Trig
Page 98 and 99:
Page 100 and 101:
Page 102 and 103:
Page 104 and 105:
Page 106 and 107:
Page 108 and 109:
Page 110 and 111:
Page 112 and 113:
Page 114 and 115:
Page 116 and 117:
Page 118 and 119:
Page 120 and 121:
Chapter 7: Tuning Perforce for Perf
Page 122 and 123:
Page 124 and 125:
Page 126 and 127:
Page 128 and 129:
Page 130 and 131:
Page 132 and 133:
Page 134 and 135:
Chapter 8: Perforce and WindowsUser
Page 136 and 137:
Chapter 8: Perforce and WindowsWind
Page 138 and 139:
Chapter 8: Perforce and WindowsBefo
Page 140 and 141:
Chapter 8: Perforce and WindowsReso
Page 142 and 143:
Chapter 8: Perforce and Windows142
Page 144 and 145:
Chapter 9: Perforce ProxySystem req
Page 146 and 147:
Chapter 9: Perforce ProxyAdminister
Page 148 and 149:
Chapter 9: Perforce ProxyMaximizing
Page 150 and 151:
Chapter 9: Perforce Proxy150 Perfor
Page 152 and 153:
Appendix A: Perforce Server (p4d) R
Page 154 and 155:
Appendix A: Perforce Server (p4d) R
Page 156 and 157:
Indexcreating checkpoints 26creatin
Page 158 and 159:
Index.ini files 49installationWindo
Page 160 and 161:
IndexP4ROOT 12, 152and depot files
Page 162 and 163:
Indexforce flag 51Perforce, definin
show all

Perforce 2007.2 System Administrator's Guide

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?