Preflight Builds Demo

tanay on Tue Oct 06, 2009 10:53 pm

Use these instructions to set up the sandbox Commander setup used in the "Introduction to Preflight Builds" presentation. These instructions are specific to Windows. While you are free to use existing Perforce, Commander, or Eclipse setups, we assume that you are starting with a clean environment.

Step 1: Download artifacts

Download (attached to this post) and unzip it to C:\

Step 2: Install the Perforce server

Download and run the installer for the Perforce Server (P4D) from
  • Select Features: Leave default values
  • Server Configuration: Leave default values
  • Client Configuration: Set the server name (localhost:1666) and the user name (joedoe)
  • Complete the installation

Step 3: Install the Perforce visual client

Download and run the installer for the Perforce Visual Client (P4V) from
  • Select Features: Leave default values
  • Client Configuration: Should already be set to what you chose for the same screen in the server installation
  • Complete the installation
  • Restart the machine

Step 4: Perforce setup

Run P4V (Start Menu -> Programs -> Perforce)
  • Click Yes to run the connection setup wizard
  • The server connection settings should be set to localhost and 1666
  • Log In: Create a new user account. Choose a login name (joedoe), full name (Joe Doe), and email ( Leave the password blank.
  • Create a New Workspace: Select a workspace name (joe-demo-1) and a location (C:\demo\sources).
  • Add Files to Server: Select a location (C:\demo\sources\original\scripts)
  • Complete the wizard
  • Your p4 client will be launched
    • joe-demo-1 should be selected as the current workspace. In it, you'll have a directory called scripts containing and

Step 5: Install the ElectricCommander server

Download and run the ElectricCommander installer
  • Install Directories: Leave default values
  • Installation Type: Commander Server
  • Host Name for Web Server: localhost
  • Account for the Commander Server: Leave blank and uncheck the "Use a separate account for agent service" checkbox
  • Workspace Configuration: Set the UNC path (C:\demo\workspace) and drive path (C:\demo\workspace)
  • Complete the installation

Step 6: Install Eclipse

Download the Eclipse IDE for Java Developers from
  • You may use another flavor of the IDE if you wish
  • Extract the .zip file to C:\
  • If you don't have Java installed, download and install the latest JRE from

Step 7: Eclipse setup

Run C:\eclipse\eclipse.exe
Set the workspace (C:\demo\sources)
Create a new project
  • File -> New -> Project
  • General -> Project
  • Set the project name (joe-demo-1)
  • Finish
Install the Eclipse Perforce integration using the instructions at
Download the ElectricCommander Eclipse integration
  • Unzip its contents to C:\Program Files\Electric Cloud\ElectricCommander\apache\htdocs
  • Follow the installation instructions from the technical note (ec_EclipseTechNote1_0.pdf)
Add the project to source control
  • Right click on the project name in the package explorer
    • Team -> Share project
    • Perforce
    • Server address: localhost:1666, user: joedoe, client workspace: joe-demo-1

Step 8: Import the basic build procedure

Login via ectool and then call ectool import c:/demo/exports/beforePreflights.xml.
This will create a new project called ElectricDemo-1.0 on the Commander server.

Step 9: Run the demo

Step through the PowerPoint presentation BasicPreflightDemo.ppt (attached to this post) to see the basics of adding preflight support to an existing build

Have more questions?


Please sign in to leave a comment.