Note: this is only for developers. If you want just to use this program
download a release from files section.
Disclaimer: The information below is based on my own (limited)
experience with ssh/cvs, and I'm aware that some suggestions presented here may
not apply to everyone, so please consult the links at the end for more
information. If you have suggestions/corrections to improve this material
please contact me.
1. Basic CVS Usage
This usage should be identical under Win32 and Unix/Linux. (those
instructions are for command line usage). I assume that you have ssh and cvs
installed and working, if this is not the case please go first and read the Unix/Linux
or Windows sections.
1.1 checkout the whole project to a local directory
- go to the directory that will contain the project subdirectory
- cvs -d:ext:email@example.com:/cvsroot/umlsculptor
You now should have a local subdirectory named umlsculptor in the
1.2 update your local files from CVS server
1.3 commit your changes to the CVS server
- go to the project subdirectory
- cvs update -d -P
- go to the project subdirectory
- cvs commit
- you can use cvs -z9 instead of cvs to compress data transfer to/from CVS
- you can alias cvs='cvs -z9' to use compression without specifying
-z9 every time. Add the following line to your .bashrc (don't forget to
alias cvs='cvs -z9'
3.1 Create a home directory
- create a new directory as your home directory (unix-style commands will
store here their configuration files), for example: c:\home
- add set HOME=c:\home to your autoexec.bat (don't forget to
4. WinCVS frontend
WinCVS is a popular free GUI frontend for CVS. You can download it from www.cvsgui.org
(it include a working version of CVS).
4.1 WinCVS configuration
- General/CVSROOT= :ext:firstname.lastname@example.org:/cvsroot/umlsculptor
- General/Authentification: SSH server
- optional: if you created ssh identity keys
set RSA identity to your %home%/.ssh/identity file
- optional: Globals/TCPIP compression to 9 (recommended)
- Ports/Alternate rsh name: ssh
- WinCVS/Home: your home directory
- ! important: if you don't use ssh identity
you will need to type your password in the black console window that appear when
you activate a CVS command
5. SSH identity keys
Creating those keys allow you to access SourceForge server without typing
your password every time.
Warning: the information presented here is for ssh1, and it may not be
correct for ssh2. (if you can help me with the instructions for ssh2 please contact
5.1 Creating SSH identity keys
- ssh-keygen -C email@example.com (from
your local computer, you should now have to files .identity and identity.pub
in your .ssh directory)
- copy public identity file to SF server: scp .ssh/identity.pub firstname.lastname@example.org:identity.pub
(from your local computer)
- rename identity file: mv identity.pub .ssh/authorized_keys (from
SF shell, after you login with ssh)
Now you can try to login with ssh -l username
umlsculptor.sourceforge.net and you shouldn't be asked for a password.
For more information regarding SourceForge access and ssh identity keys read SSH Keys and CVS/Shell Accounts.
5.2 Using the same identity keys under Linux and Windows
Just copy identity and identity.pub in .ssh
subdirectory of your home directory on your local machine (from Linux partition
to Windows or from Windows partition to Linux).
! Important: if you have copied identity keys from Windows partition
to Linux don't forget to set access mode to 600,
otherwise they will not work. (chmod 600 .ssh/identity*)
6. More CVS/SSH information
6.1 SourceForge documents
6.2 General CVS information