Programmers' Canvas Toolkit Installation Guide

Create a CVS Repository on the CVS Server [Tiger]

1. The CVS erver can run on Linux or Windows
2. Create the initial CVS Tree

Install CVSNT on Developers' Machines and the Build Machine [ACME]

Install the CVSNT client.  The toolkit requires CVS.EXE to be in the system PATH.

1. See here and here
2. Put CVS.EXE's directory in the PATH environment variable for the SYSTEM user

See here for WinCVS, TortoiseCVS, etc. installation [optional]

Install the PCTK on Developers' Machines and the Build Machine [ACME]

Use one of the following:

1. Executables installation
   or,
2. Perl source installation

Then set environment variables, etc.

Install the Web Application on the Web Server

IIS can run on Tiger or ACME, or you can install it on a third machine.  It is recommended that you not use the build machine (Tiger).

See here

Configure the Build Machine [ACME]

1. Create a directory somewhere to contain build configuration files
2. Copy the file build/build.xml (from the CVS repository) to the directory created in the above step.  build.xml is a template file.  You will create many versions of this file based on the template for each "type" of build.
3. build.xml and its "clones" must reside on the local file system on the build machine.  You can check in these files if you wish, but the latest version must be stored in the filesystem.
4. The script dgbuild.exe / dgbuild.pl executes the build robot.  The build robot is described here

Configure the Build Process

• All build configuration files are stored in the CVS build module.  Read about the Build Robot Configuration Files.
• build_all.xml tells the build robot which projects to build.  build_all.xml is stored in the CVS repository in the build module.
• For VC++ projects, the example VC++ Workspace build/build_all.dsw contains all of the the VC++ projects that need to be built, and in what order.  Project dependencies can be set directly in this file.  This file is stored in the CVS repository in the build module.