CVSTrac on Windows

CVSTrac compiles and runs now natively on Windows. Latest binary build can be downloaded here at attachments section below (7-zip format due attachments site limitation).

CVSTrac Windows version supports:

Note: This Windows version doesn't yet run as standalone HTTP server. See CVSTracNT project below if you need this functionality.

Compiling CVSTrac Windows version

In order to compile CVSTrac Windows you need to install recent versions of MinGW (gcc 3.4 or later) and crypt library (1.1 or later), which comes with MinGW distribution. MinGW and crypt can be downloaded from:
http://www.mingw.org/download.shtml http://sourceforge.net/project/showfiles.php?group_id=2435

CVSTrac also depends on SQLite and regex libraries that can be downloaded from:
http://www.sqlite.org/download.html ftp://ftp.gnu.org/pub/old-gnu/regex/regex-0.12.tar.gz

Once you have all prerequisites, download the CVSTrac sources (CVS or at least 2.0.2 stable) as described in:
http://www.cvstrac.org/cvstrac/wiki?p=DownloadCvstrac

Copy win32-mingw.mk to Makefile and set the paths in Makefile (INCDIRSQLITE, LIBDIRSQLITE, LIBREGEX) according to your configuration.

Build the binary using make command.

When the build succeeds you should get cvstrac.exe in the CVSTrac folder. (You may rename it to svntrac.exe or build with make APPNAME=svntrac for Subversion mode version)

Installing CVSTrac on Windows

Currently CVSTrac can be installed only as CGI module for Microsoft IIS or Apache HTTP Server. Native Windows builds doesn't (yet) run as standalone HTTP daemon.

Relatively to the versioning system used together with CVSTrac, CVSNT or Subversion distributions need to be installed first before running CVSTrac. They can be obtained at:
http://www.cvsnt.org/ http://subversion.tigris.org/project_packages.html

Note #1: CVS/Subversion binaries folder needs to be added to system PATH.

Note #2: RCS binaries are not needed with Windows build as it is using CVSNT RCS wrappers.

Installing CVSTrac on Apache HTTP Server

Follow general Apache documentation to install CVSTrac as CGI module:
http://httpd.apache.org/docs/2.0/howto/cgi.html

Installing CVSTrac on Microsoft IIS

It is possible to install CVSTrac so it is visible at "friendly URLs" like http://yourwebsite/tracker/YourProject/ on IIS using few easy tricks.

This recipe requires IIS 5.1 for Windows 2003/XP or later.

Note #1: IIS 5.1 for Windows XP requires creating C:\InetPub\www\tracker\YourProject folder in order to avoid "The directory name is invalid." error. IIS 6 or later is not affected by this problem.

Note #2: On IIS 6 cvstrac.exe must be added as allowed Web Service Extension.

We will use adsutil.vbs from C:\InetPub\AdminScripts.

We assume that CVSTrac is compiled into cvstrac.exe put in C:\pathtocvstrac\bin, also that we have some projects databases initialized in C:\pathtocvstrac\db using cvstrac init. 

  Line 426, find:


    Case "STRING"
	    IIsObject.Put ObjectParameter, (ValueList)


  Replace with:


    Case "STRING"
	    ValueList = Replace(Args(2), "''", """") ' Replace quotes
	    IIsObject.Put ObjectParameter, (ValueList)


  Line 449, find:


    Case "LIST"
        ReDim ValueList(ArgCount - 3)
        For ValueIndex = 2 To ArgCount - 1
                ValueList(ValueIndex - 2) = Args(ValueIndex)
        Next


  Replace with:


    Case "LIST"
        ReDim ValueList(ArgCount - 3)
        For ValueIndex = 2 To ArgCount - 1
                ValueList(ValueIndex - 2) = Replace(Args(ValueIndex), "''", """") ' Replace quotes
        Next


  adsutil.vbs create w3svc/1/Root/tracker IIsWebFile
  adsutil.vbs set w3svc/1/Root/tracker/ScriptMaps "*,''C:\pathtocvstrac\bin\cvstrac.exe'' cgi C:\pathtocvstrac\db,1,GET,HEAD,POST"


  C:\InetPub\AdminScripts>adsutil enum w3svc/1/Root/tracker
  KeyType                         : (STRING) "IIsWebFile"
  ScriptMaps                      : (LIST) (19 Items)
    "*,"C:\pathtocvstrac\bin\cvstrac.exe" cgi C:\pathtocvstrac\db,1,GET,HEAD,POST"

... and from now on we should be able to use CVSTrac on IIS.

E-mail notification on Windows

For instant e-mail notification you can use great tool sendEmail available at:
http://caspian.dotconf.net/menu/Software/SendEmail/.

Sample configuration can be in this (win32) case: (feed it into single line) 

  sendEmail -f "%p Tracker <tracker@your-server.com>" -t %A -u "[tracker] %p (%s)
  %t" -m "*%u* has changed the ticket assigned to you. Click here to view this
  ticket:\n	https://www.your-server.com/tracker/%p/tktview?tn=%n\n\n%d"

Cygwin Windows versions

CVSTracNT

There is also CVSTracNT project, the newest version is v2.0.1 Build 20080601.

It is CygWin Windows version with extra tools and an installer.

CVSTracNT is registered at SourceForge:
http://sourceforge.net/projects/cvstracnt/

You can always download the latest version from here:
http://download.cnpack.org/CVSTracNT.exe

See also: CvstracNtIntroduction by Jingyu Zhou(zjy@cnpack.org) from China.

Attachments: