Setting up Perforce (DTG)

There are two steps in setting up FogBugz-Perforce integration:

1. Installing either trigger scripts or the Perforce Defect Tracking Gateway so that Perforce transmits changes to FogBugz
2. Getting FogBugz to provide links to P4Web, the Perforce web client

Getting Perforce to transmit changes to FogBugz

These instructions are for setting up the Defect Tracking Gateway, so that cases from FogBugz will show up in Perforce. (See instructions for setting up a trigger script in VBScript, or a trigger script in Perl)

The Perforce DTG is currently only available for Windows XP, and requires the 2006.2 Perforce server.  Note, however, that you do not need to install the Perforce DTG on the same server as your Perforce install: you can install it on a Windows XP computer that connects to your Perforce server on any other platform.

Before downloading the FogBugz plugin, you'll need to download the Perforce Defect Tracking Gateway (DTG).

Once you've installed the Perforce DTG, you'll need to download and configure the the FogBugz plugin. 

1. Log on to FogBugz as an administrator, and go to Settings | Site. In the Main tab, you will see a link to download scripts.
2. Click the link for the Perforce DTG Setup program
3. Follow the instructions and download and run the Perforce DTG Setup program
4. When prompted, enter the location of of the Perforce Defect Tracking gateway that you installed previously (typically C:\Program Files\Perforce\p4dtg)
5. After installation is done, you'll need to update your Perforce jobspec and configure the plugin.
6. If you're already logged in as a Perforce administrator, the setup program will launch the jobspec editor automatically.  If not, you'll need to log in as a Perforce administrator and enter p4 jobspec on the command line (cmd window), or type p4 jobspec -u [admin user name] -P [admin password].
7. Copy the lines given by the setup page in FogBugz into your jobspec
8. Save and close the window
9. Setup should not open the configuration editor.  You can also find this program in C:\your\Perforce\install\p4dtg\p4dtg-config.exe.
10. Click "Start Replication" to start the replication engine

Getting FogBugz to provide links to P4Web, the Perforce web client

In order to browse a Perforce repository, you need something that allows you to view file diffs and history logs from a web browser. With Perforce, you use P4Web, the Perforce Web Client.

Once that is installed and working with your Perforce repository, log onto FogBugz as an administrator and go to the Settings | Site screen, in the Main tab.

• Under Source Control URL for logs, enter

http://path to P4Web:8080/@md=d&cd=//&c=6fI@/^R2?ac=10

• Under Source Control URL for diffs, enter 

http://path to P4Web:8080/@md=d&cd=//&c=6fI@/^R2?ac=10