Question

How do you integrate FogBugz with IBM/Rational ClearCase?

Answer 1

This guide is a starting point for ClearCase integration. ClearCase integration is not currently fully supported. We do have at least one user who used these instructions and is using FogBugz integration with ClearCase.

The following instructions show how to set up a trigger script in ClearCase which will notify FogBugz whenever a checkin occurs that is related to a particular bug.

Download the trigger script: http://www.fogcreek.com/FogBugz/Downloads/logBugDataCC.pl

Make the following changes at the top of the file to suit your environment:

• Set the value of BUGZ_SERVER to the DNS name of the web server running FogBugz, for example "www.example.com".
• Set the value of BUGZ_URL to the virtual path to your FogBugz installation. For many sites this is "/FogBugz/". Just take the full URL of your FogBugz installation - "http://www.example.com/bugz/" and remove the "http://www.example.com" part. (If FogBugz is running at the root, use "/").
• If you are using the PHP version of FogBugz, change CVSSUBMIT from "cvsSubmit.asp" to "cvsSubmit.php".
• If your ClearCase repository is on Unix, make sure to set execute permissions on the logBugDataCC.pl file.

Here's the ClearCase command you should run in each vob you want this feature:

/usr/atria/bin/cleartool mktrtype \
    -postop checkin               \
    -element -all                 \
    -c "fogbugz integration"      \
    -execwin "ccperl \\\\your\\path\\here\\logBugDataCC.pl"         \
    -execunix "/usr/atria/bin/Perl /your/path/here/logBugDataCC.pl" \
    post_checkin_trigger

Where it says "your path here", replace that with your path to the file logBugDataCC.pl. Also, note the space after "bin/Perl".

In the FogBugz database, the source control table, named CVS, needs to have sPrev and sNew set to varchar(255).