Instructions for the new AMBER CVS Tree v1.0

Last Modified: 2008/09/25

Given that the existing AMBER CVS at Scripps is being decomissioned
we have moved the CVS tree to a new server at The San Diego Supercomputer
Center. This server is being administered by Ross Walker (ross@rosswalker.co.uk)
and Mark Williamson (mjw@sdsc.edu).

The address of the new server is:
	cvs.ambermd.org

In order to facilitate cvs user management we have decided to adopt a SSH keypair
approach to authentication in place of passwords. This is significantly more
convenient when it comes to updating the cvs tree etc since you will not be
continually asked for a password. This however, necessitates us creating new
user accounts for everybody who needs access to the AMBER cvs trees.

The following provides instructions on how to request a user account, how to
generate your public ssh key and how to configure your machine locally to
access the cvs respositories.

Instructions for obtaining an account
=====================================

To create an account for you we require two pieces of information.

	1) A suitable username
	2) A file containing your public ssh key (or keys)

If you do not already have an ssh public key then you will need to 
create one, if you already have a public key then you can skip to
the account request step below.

SSH Key Generation
==================

This process involves creating a key pair which consists of two parts.
A public part (e.g. id_dsa.pub) and a private part (e.g. id_dsa). The private
part you should look after very carefully. Do not send this to anybody (including
us). The public part you can distribute to anybody whose machine you would like them
to grant you access to.

(Linux / Unix / Cygwin)
-----------------------

1) Login as your normal user.

2) Execute the following command:
	ssh-keygen -t dsa

3) ssh-keygen will ask you to set a passphrase to use the key. It is
   up to you whether you want to set a passphrase here or leave it
   blank. Remember, if someone obtains your private key, they can login to any
   machine where your public resides in a ~/.ssh/authorized_keys file.
   If you choose to set a passphrase (recommended) you will
   be prompted for it when you issue an ssh command, however you can
   make use of 'ssh-agent' to only need to enter this once per session.

4) Look in $HOME/.ssh/ for the following file:
	id_dsa.pub

   You will need to email this file along with your account request as
   explained below.

If you use an alternative ssh method with cvs please let us know and we will
try to update this document.

Account Request
===============

To request a cvs account please send an email to:

	mjw@sdsc.edu

With the subject line:

	AMBER CVS Account Request

In the message body please explain who you are and provide at
least two preferred usernames. Also make sure you attach your ssh
public key (e.g. id_dsa.pub as you created above).

By default you will only be able to checkout the CVS tree. If you require
commit access to the tree please also state this along with a brief description
of why.

You will receive an email back once the account is created.

Configuring Your CVS Client
===========================


Once you have received the confirmation email you can setup your local shell
to use the new cvs tree. Please note that if you have an existing AMBER cvs
tree checked out then you will need to checkout a brand new tree and migrate
any changes you have made across. Failure to do this will result in cvs update
failures.

You should set following environment variables

BASH SHELL
----------

	export CVSROOT='yourusername@cvs.ambermd.org:/cvsroot/'
	export CVS_RSH='ssh'

To have this set whenever you login add these lines to your ~/.bashrc file.

CSH SHELL
---------
	setenv CVSROOT 'yourusername@cvs.ambermd.org:/cvsroot/'
	setenv CVS_RSH 'ssh'

To have this set whenever you login add these lines to your ~/.cshrc file.


To checkout the new tree you can issue:

	cvs co amber11

Trees available currently are:

	amber11, amber10, amber9, amber8, amber7, amber6, dcqtp, nab5

We will be moving amber_web across shortly as well.