GW+HEN white paper
The paper will be witten with LaTeX. We will use the revision control software SVN to
work collectively on the same files and keep track of the changes. See instructions
below to get started.
The SVN repository has a (real only) web access: https://cvs.in2p3.fr/gwhen2009
Instructions for SVN
Setting up SSH connections
We need to set up the connections to the computer which hosts the document files. These connections to the SVN will be secured by SSH. You will have to generate a pair of SSH key and register your public key.Linux and Mac OS X platforms
1. execute the following command in a terminal
ssh-keygen -t rsa -b 2048 -f ~/.ssh/key_for_gwhen2009
Your private identification is saved in ~/.ssh/key_for_gwhen2009
Your public key is saved in ~/.ssh/key_for_gwhen2009.pub
2. append following text to ~.ssh/config
Host cvs.in2p3.fr
User [USER]
PasswordAuthentication no
IdentityFile ~/.ssh/key_for_gwhen2009
IdentitiesOnly yes
RSAAuthentication yes
PubkeyAuthentication yes
Protocol 2
ForwardX11 no
ForwardAgent no
where [USER] is your user name (i.e., the result of the command whoami).
3. You can now proceed to the registration page to register your public key
Windows platforms
You can generate an SSH key on Windows using the PuTTY SSH client.
You can download PuTTY for free from this URL.
To generate a key with PuTTY, you should:
1. Download and start the puttygen.exe generator.
2. In the "Parameters" section choose SSH2 RSA and press Generate.
3. Generate entropy: move your mouse randomly in the small screen in order to generate the key pairs.
4. Enter a key comment, which will identify the key (useful when you use several SSH keys).
5. (optional) Type in the passphrase and confirm it. The passphrase is used to protect your key.
You will be asked for it when you connect via SSH.
6. Click "Save private key" to save your private key as key_for_gwhen2009
Choose an obvious location such as desktop.
7. Click "Save public key" to save your public key as key_for_gwhen2009.pub
Choose an obvious location such as desktop.
8. You can now proceed to the registration page to register your public key.
Checking out the SVN repository
You have registered your public key as described above. It takes typically a ew days to proceed your registration.You will receive a notice when it is done. Once you receive this notice, here are the steps to finalize the access
to SVN.
You have to install a SVN client (http://subversion.tigris.org).
Linux and Mac OS X platforms
1. init ssh key agent
eval `ssh-agent`
ssh-add ~/.ssh/key_for_gwhen2009
2. check out repository
with the standard command line client, this is done with
svn checkout svn+ssh://[USER]@svn.in2p3.fr/gwhen2009
where [USER] is your user name
Windows platform
1. download ssh key agent pageant.exe, http://the.earth.li/~sgtatham/putty/latest/x86/pageant.exe
Press the ‘Add Key’ button in the Pageant main window.
Pageant will bring up a file dialog, labelled ‘Select Private Key File’.
Select key_for_gwhen2009
2. download subversion (SVN in short) from
http://subversion.tigris.org/files/documents/15/46485/Setup-Subversion-1.6.4.msi
Users that are not familiar with SVN may want to install TortoiseSVN (http://tortoisesvn.tigris.org) as well.
TortoiseSVN provides a graphical interface.
Configure using the following URL: svn+ssh://[USER]@svn.in2p3.fr/gwhen2009
Edit and commit changes
You now have the possibility to open, read and edit the TeX files.
Once you inserted your contributions, you should:
1. make sure that the coordinator of your section knows you are editing the document
2. update the document (this won't cancel the changes you made)
3. commit your changes
