How to Access Perforce
From MIT Project ORCA
Contents |
Install the Perforce Client
- Go to www.perforce.com and download the client for your platform. If you have the choice you want both the visual client and the command line. For some platforms they come as a bundle.
- Run the installer
- Install the client only installation.
- You may want to include all of the client components except maybe for SCC plugin. This is a plugin for some windows based IDEs like Visual Studio. You can only have one SSC plugin per system so don't install this if you are already using visual source safe or some other plugin.
- In the Perforce Client Setup dialog enter the following information:
Server Port : orca4.mit.edu:1666 Editior: <your favorite text editor> Username : <pick-a-username> P4Web Port: 8080
- Tell the administrator your user name so they can put you in the orca group. You will have to do this before you can access any of the files.
Setup Your Perforce Client
- Launch p4win (p4v on other platforms)
- Create a new Client spec. This is a mapping from the depot onto your local disk. To do this click on the "new" menu item under the clientspec menu.
- Enter a name for your client. I like to use <username>-<machinename> as the name of the client spec. For the root directory specifiy the directory where you want all of the code to go. For example apgar-zeus.
- On the next dialog the fields you want to change are Root and View. Root is the top level directory on your machine for the depot files. The view is the mapping from the depot to your local disk. The default for root is "c:\" which is probably not what you want (this will put all of the orca code in the c:\ drive. On a unix machine you might want:
<home dir>/orca/
or something like that. On windows something like
dir>c:\Documents and Settings\<username>\orca.
But it is really up to you.
- Change the default view. The default value for view is to map the entire depot to the client. I would change it to only map the ORCA2005 and ORCA2006 source so you dont spend all your time sincing down 4 year old code. The value for these two changes are below:
Root: c:\Documents and Settings\apgar\orca
View:
//depot/ORCA2005/... //<ClientName>/ORCA2005/...
//depot/ORCA2006/... //<ClientName>/ORCA2006/...
Building The Source
There is a build.bat file (windows) and a build script (unix bash) in the ORCA2005 directory that is a wrapper around the ant build file. The build relies on a couple of environment variables. If you don't already have java installed on your system they will be setup automatically. If you do have java already you may need to clear the JAVA_HOME environment variable.
c:\orca\ORCA2005> set ORCA_HOME=. c:\orca\ORCA2005> set JAVA_HOME=
To build run the build script
C:\orca\ORCA2005>build
Warning using Non-ORCA-Standard JVM .\external\java\windows\jdk1.4.2_08
Buildfile: build.xml
compile:
[mkdir] Created dir: C:\orca\ORCA2005\class
[mkdir] Created dir: C:\orca\ORCA2005\test-class
[copy] Copying 9 files to C:\orca\ORCA2005\class
[javac] Compiling 276 source files to C:\orca\ORCA2005\class
[rmic] RMI Compiling 1 class to C:\orca\ORCA2005\class
[rmic] RMI Compiling 1 class to C:\orca\ORCA2005\class
[javac] Compiling 14 source files to C:\orca\ORCA2005\test-class
[jar] Building jar: C:\orca\ORCA2005\lib\ORCA.jar
[jar] Building jar: C:\orca\ORCA2005\lib\ORCA-TEST.jar
test:
[junit] Running edu.mit.orca.test.FullTestSuite
[junit] Foo!
[junit] 0 [main] INFO edu.mit.orca.management.SingletonFactory - Configuring resources
[junit] 0 [main] INFO edu.mit.orca.management.SingletonFactory - Configuring publisher
[junit] 31 [main] INFO edu.mit.orca.management.SingletonFactory - Configuring filter
[junit] 31 [main] INFO edu.mit.orca.management.SingletonFactory - Configuring publisher
[junit] 219 [main] INFO edu.mit.orca.management.SingletonFactory - Configuring configserver
[junit] 219 [main] INFO edu.mit.orca.management.SingletonFactory - Configuring missiondata
[junit] 219 [main] INFO edu.mit.orca.management.SingletonFactory - Setting ... missiondata.gateToPingerHeading=4.9
[junit] 234 [main] INFO edu.mit.orca.management.SingletonFactory - Setting ... missiondata.pipelineToDockingHeading=1.85
[junit] 234 [main] INFO edu.mit.orca.management.SingletonFactory - Setting ... missiondata.pipelineToDockingHeadingR=1.95
[junit] 234 [main] INFO edu.mit.orca.management.SingletonFactory - Setting ... missiondata.pingerToPipelineHeading=0.98
[junit] 234 [main] INFO edu.mit.orca.management.SingletonFactory - Setting ... missiondata.pingerToPipelineHeadingL=0.88
[junit] 234 [main] INFO edu.mit.orca.management.SingletonFactory - Setting ... missiondata.pingerFrequency=24
[junit] 234 [main] INFO edu.mit.orca.management.SingletonFactory - Setting ... missiondata.pipelineToDockingHeadingL=1.75
[junit] 234 [main] INFO edu.mit.orca.management.SingletonFactory - Setting ... missiondata.defaultMission=missionCAB
[junit] 234 [main] INFO edu.mit.orca.management.SingletonFactory - Configuring filter
[junit] Tests run: 23, Failures: 0, Errors: 0, Time elapsed: 0.453 sec
BUILD SUCCESSFUL
Total time: 20 seconds
Extra
- The user's guide on the perforce website is very good if you need help figuring out how to do things:User Guide ]
- P4 has been intergrated into emacs as well as other IDEs like eclipse. You can download these extra packages at: support packages
If you if you have any problem with these directions please email the orca list
