GSE

h1. Perforce

Last updated by {{lastupdated_by}}.

{{lastupdated_at}} 

The installation executables are listed below. Click on the link to download the appropriate version, and then execute it.

For Windows 10, use the 64 bit version, "p4vinst64.exe":/attachments/28/p4vinst64.exe

For Windows 7, use the 32 bit version, "p4vinst.exe":/attachments/56/p4vinst.exe

h2. Step 1 - Run the install file, select "Next"

!picture425-1.png! 

 

h2. Step 2 - Keep default selections, select "Next"

!picture624-1.png!

 

h2. Step 3 - Set Server to values below, set your User Name, select "Next"

!picture799-1.png! 

 

h2. Step 4 - Select "Install"

!picture895-1.png!

 

h2. Step 5 - Select "Close"

!picture655-1.png!

 

h2. Step 6 - To start Perforce select "P4V"

!{width:500px}picture843-1.png!

 

h2. Step 7 - Default startup dialog should appear, should have the proper Server and User set from Perforce installation Step 3 above. Select "OK"

!picture639-1.png! 

 

h2. Step 8 - Check the "Trust this fingerprint" button and select "Connect"

!picture850-1.png!

 

h2. Step 9 - Enter in your password and select "OK"

!picture710-1.png!

 

h2. Step 10 - Select "No"

!{width:600px}picture132-1.png!

 

h2. Step 11 - Select "No"

!{width:600px}picture371-1.png!

 

h2. Step 12 - We need to create a workspace. Go to View Tab, pull down to "Workspaces"

!{width:600px}picture26-1.png! 

 

h2. Step 13 - Notice a "Workspaces" pane has now appeared on the left side

!picture343-1.png!

 

h2. Step 14 - Right click in "Workspaces" pane and select "New Workspace ..."

!picture241-1.png! 

 

h2. Step 15 - Default Workspace name is fine, but change Workspace root: to C:\ and select "OK"

!picture264-1.png!

 

h2. Step 16 - You might get the following warning, select "No"

!picture631-1.png! 

 

h2. Step 17 - Now you should see your workspace in the right pane

!picture623-1.png!

 

h2. Step 18 - But we want to make a change to the workspace. Right click and select "Edit Workspace ...'

!picture465-1.png!

 

h2. Step 19 - Select the "Text List Box" display style to see the text of Workspace Mappings:

!picture841-1.png!

 

h2. Step 20 - Edit the text box to as show below, "//depot/..   //<your_workspace_name>/perforce/...

!picture99-1.png! 

 

h2. Step 21 - Select "Do Not Update" (we will do it manually at first)

!picture227-1.png!

 

h2. Step 22 - In the right pane, select depot, right click, and select "Get Latest Revision"

!picture307-1.png!

 

h2. Step 23 - In a file explorer window, verify you now have a C:\perforce directory and a number of notional subdirectories and placeholder files to kickstart discussions

!picture78-1.png!

 

h2. Adding Files to Perforce

It's not very obvious how to add files to Perforce. If you have set up things up the "simple" way, the Perforce Depot is a simple mapping to your local drive at c:\perforce, i.e. \depot\... = C:\perforce\... (you can create custom mappings, if you want/need to, just ask Greg)

h2. Step 1

Let's say I want to add a new GSE Perl script, newTest.pl, to the Perforce depot. The location in the Depot where I would want to add the file is: \depot\EMIRS\software\GSE\perl\. So I place the file in the my local drive at C:\perforce\EMIRS\software\GSE\perl\.

Then bring up Perforce and select the workspace tab view in the left Perforce pane:

!workspaceView.png!

h2. Step 2

newTest.pl should be visible in the workspace view. (You may need to hit the refresh icon in the upper left of the Perforce window, if you just added the file) You'll notice the file has just a blank white icon to the left of the file name, and of course, no revision information to the right of the file name.

h2. Step 3

Highlight the file name, right click, and select "Mark for Add". Now on the Perforce right pane, with the "Pending" tab selected, you should see newTest.pl in the "default" change list, as shown below:

!pending.png!

h2. Step 4

Highlight the default change list, right click, and select "Submit". Now provide something meaningful in the change list description, and hit the "Submit" button.

!submit.png!

h2. Step 5

You should be done adding the file (or multiple files, or directory, or multiple directories) and they should now show up in the depot view (left Perforce pane, select Depot view tab).

h2. Creating Labels in Perforce

When we create software releases, we use Perforce labels to tag the individual version of the files in the label. We can then print out this file info is a software release version description document (VDD).

h2. Step 1

In the depot view, highlight the files and/or directories which will comprise the software release. Right click, and select "Labels ..."

!picture121-1.png!

h2. Step 2 

Create the Label name and then hit the Label button in lower right corner. When it asks to create it, select Yes.

!picture177-1.png!

h2. Step 3

Verify the new label exists by bringing up the "Labels" tab in the right pane. (View->Labels)

!picture2-1.png!

h2. Step 4

Listing the file details in a Label seems impossible in the Perforce GUI. (It used to be able to do it). Instead we have to use the command line Perforce interface. Go to a command.exe window and type "p4 files@esimDATP100040"

!picture294-1.png!

You can now cut and paste from the command.exe window into a version description document.