*CVSTrac on Windows*

_CVSTrac_ compiles and runs now natively on Windows. Latest binary build can be downloaded here at attachments section (_7-zip_ format).

_CVSTrac_ Windows version supports:
*: password synchronization with Windows domain accounts
*: Microsoft IIS support
*: compatibility with other CGI generic servers

*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 recent versions of _MinGW_ (gcc 3.4 or later) and _crypt_ (1.1 or later) need to be installed first. _MinGW_ and _crypt_ can be downloaded from:{linebreak}
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:{linebreak}
http://www.sqlite.org/download.html
ftp://ftp.gnu.org/pub/gnu/regex/regex-0.12.tar.gz

Download the sources (CVS or minimum 2.0.2) as described in:{linebreak}
http://www.cvstrac.org/cvstrac/wiki?p=DownloadCvstrac

Before you run =make= make sure you fix the libraries paths in =win32-mingw.mak= files (=INCDIRSQLITE=, =LIBDIRSQLITE=, =LIBREGEX=).

When you have made appropriate changes in =win32-mingw.mak=, build the binary using:

  make -f win32-mingw.mak

After the build is finished you should find =cvstrac.exe= in the _CVSTrac_ sources files folder. (You may rename it to =svntrac.exe= for Subversion mode)

----

*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 _CVSTrac_, _CVSNT_ or _Subversion_ binaries need to be installed first before running _CVSTrac_. They can be obtained at:{linebreak}
http://www.cvsnt.org/
http://subversion.tigris.org/project_packages.html

*Note*: _CVS_ or _Subversion_ binary folders need to be added to system =PATH=.

----

*Installing CVSTrac on Apache HTTP Server*

Follow general _Apache_ documentation to install _CVSTrac_ as CGI module:{linebreak}
http://httpd.apache.org/docs/2.0/howto/cgi.html

----

*Installing CVSTrac on Microsoft IIS*

It is possible to install _cvstrac_ so it will be visible at nice URL like http://yourwebsite/tracker/YourProject/ on IIS with few easy tricks.

This sample shows how to do that on _IIS 6_ for _Windows 2003/XP_ or later.

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=.

*: We need to modify =adsutil.vbs= to be able somehow pass quote (") character as parameter (Note: Quotes are markets for win32 console therefore you cannot pass it easily as parameters without escaping it somehow).

  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

*: Now we can create mapping in our website (use relevant number instead sample =w3svc/1= shown, default _IIS_ site is =w3svc/1=):

  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"

*: Now you should be able to check if everything is fine with:

  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 we should be able to use _cvstrac_ on IIS.

----

*CVSTracNT*

(There is also _CVSTracNT_ project that is not actively developed anymore)

It is transitioned to Windows version with extra tools and an installer.

_CVSTracNT_ is registered at SourceForge:{linebreak}
http://sourceforge.net/projects/cvstracnt/

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

_See also:_ CvstracNtIntroduction {linebreak}
by Jingyu Zhou(zjy@cnpack.org) from China.