Set-up Instructions

We will be using the vendor branch feature of CVS to get you set up. We will provide you with a tar file and each group will create a CVS repository with the contents of this tar file. Then each group will use their CVS repository to manage the development of their local code. If there are bug fixes that we wish to provide you with, we will give you a new tar file, and each group will import this tar file into their CVS repository.

The following instructions tell you how to get set-up, and how to update your CVS repository if we provide any bug fixes. If you want more information about CVS, there are many resources available on the web (Google for CVS, I personally use this), or by running the "info" command. For more information on the vendor branch features of CVS, see the following link.

Group set-up

First, you need to form your groups, and one person from the group needs to email Craig and Sorin with the names of the group members. Once we get your email, we will create a project directory for you, and assign you a group name. The project directories will all be in /projects/instr/04wi/cse501. For example, the first group, cse501a will get the /projects/instr/04wi/cse501/cse501a directory.

Once you have a group name, one of the group members should log onto a research Linux or Solaris machine, and run the following command:

% /projects/instr/04wi/cse501/bin/cvs-initial-import <group_name>

This will create a CVS repository in the directory .CVS under your group directory, untar the vortex-501-1.tar.gz file to a temporary directory, and import the contents into the CVS repository.

Individual set-up

Each group member will need to checkout a copy of the CVS repository. You can do this either on a Linux machine, a Solaris machine, or on a Windows machine running Cygwin. Here are the instructions to follow based on which operating system you want to use.

Linux or Solaris

You can set up your own Vortex tree for Linux or Solaris machines by running the following:

% /projects/instr/04wi/cse501/bin/cvs-checkout-and-setup <group_name> <user_name>

This will create a directory <user_name> under your group directory. Then it will checkout a copy of the repository into this directory, and finally call the Vortex SETUP script to set things up (which takes a long time to run). You are successfully set-up if the directory /projects/instr/04wi/cse501/<group_name>/<user_name>/vortex contains the files SETUP-Cecil.<arch>.done and SETUP-Vortex.<arch>.done, where arch is either solaris8 or linux, depending on the system you're running on.

Now, change your .cshrc (or other appropriate shell initialization file) by adding the following (where you need to change <group_name> and <user_name> as appropriate):

setenv CVSROOT /projects/instr/04wi/cse501/<group_name>/.CVS
setenv VORTEX_HOME /projects/instr/04wi/cse501/<group_name>/<user_name>/vortex
if (-f ${VORTEX_HOME}/bin/shell/vortex.cshrc) then
source ${VORTEX_HOME}/bin/shell/vortex.cshrc else
setenv VORTEX_ARCH unknown
endif

Windows

First, install Cygwin (with at least perl, gcc/g++, tcsh, make, and ssh). Now, you need to choose a directory (in Cygwin) on your Windows machine to install Vortex. Let's call this directory <VORTEX_DIR>. Now you can set up your own Vortex tree on windows by running the following commands in Cygwin:

% setenv CVSROOT <user_name>@lagoon.cs.washington.edu:/projects/instr/04wi/cse501/<group_name>/.CVS
% setenv CVS_RSH ssh
% cd <VORTEX_DIR>
% cvs co vortex
% cd vortex
% setenv VORTEX_HOME <VORTEX_DIR>/vortex
% mkdir $VORTEX_HOME/bin/winnt
% <ftp the file /projects/cecil/bin/winnt/vortex.exe to the file $VORTEX_HOME/bin/winnt/vortex.exe>
% $VORTEX_HOME/bin/shell/SETUP Vortex Cecil Java

Then it will checkout a copy of the repository into <VORTEX_DIR>, and call the vortex SETUP script to set things up (which takes a long time to run). You are successfully set-up if the directory <VORTEX_DIR>/vortex contains the files SETUP-Cecil.winnt.done and SETUP-Vortex.winnt.done.

Now, change your .cshrc (or other appropriate shell initialization file) by adding the following (where you need to change <group_name> and <user_name> as appropriate):

setenv CVSROOT <user_name>@lagoon.cs.washington.edu:/projects/instr/04wi/cse501/<group_name>/.CVS
setenv CVS_RSH ssh
setenv VORTEX_HOME <VORTEX_DIR>/vortex
if (-f ${VORTEX_HOME}/bin/shell/vortex.cshrc) then
source ${VORTEX_HOME}/bin/shell/vortex.cshrc
else
setenv VORTEX_ARCH unknown
endif