We will be using the vendor branch feature of CVS to get you setup.
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 setup, 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 setup
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/03wi/cse501.
For example, the first group, cse501a will get the /projects/instr/03wi/cse501/cse501a
directory.
Once you have a group name, one of the group members should log onto
a solaris8 machine, and run the following command:
% /projects/instr/03wi/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. For
reference here are the main commands in cvs-import:
set GROUP_HOME=/projects/instr/03wi/cse501/$1
setenv CVSROOT $GROUP_HOME/.CVS
cvs init
mkdir $GROUP_HOME/tmp
mkdir $GROUP_HOME/tmp/vortex
cd $GROUP_HOME/tmp/vortex
cp /projects/cecil19/lerns/vortex-501-1.tar.gz .
tar zxvf vortex-501-1.tar.gz
rm vortex-501-1.tar.gz
cvs import -m "Importing 501 vortex v. 1" vortex UW_DIST VORTEX501_1
cd $GROUP_HOME
rm -r -f $GROUP_HOME/tmp
Individual setup
Each group member will need to checkout a copy of the CVS repository.
You can do this either on a solaris8 machine, or on a windows machine running
CygWin. Here are the instructions to
follow based on which operating system you want to use (keep in mind that
if you use windows, you will have your own machine, whereas if you use
solaris8, you will have to share the machines with others).
Solaris8
You can set up your own vortex tree for solaris8 machines by running
:
% /projects/instr/03wi/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 setup if the directory /projects/instr/03wi/cse501/<group_name>/<user_name>/vortex
contains the files SETUP-Cecil.solaris8.done and SETUP-Vortex.solaris8.done.
For reference here are the main commands in cvs-checkout-and-setup:
set GROUP_HOME=/projects/instr/03wi/cse501/$1
setenv CVSROOT $GROUP_HOME/.CVS
mkdir $GROUP_HOME/$2
cd $GROUP_HOME/$2
cvs co vortex
cd vortex
setenv VORTEX_HOME $GROUP_HOME/$2/vortex
mkdir $VORTEX_HOME/bin/solaris8
ln -s /projects/cecil/bin/solaris8/vortex-3-1 $VORTEX_HOME/bin/solaris8/vortex
$VORTEX_HOME/bin/shell/SETUP Vortex Cecil
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):
if (`uname` == "SunOS") then
setenv CVSROOT /projects/instr/03wi/cse501/<group_name>/.CVS
setenv VORTEX_HOME /projects/instr/03wi/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
endif
Winnt
First, install CygWin (with at
least perl, gcc, tcsh, make, 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>@rousseau.cs.washington.edu:/projects/instr/03wi/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-3-1.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 setup 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:
setenv CVSROOT <user_name>@rousseau.cs.washington.edu:/projects/instr/03wi/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