GamesCrafters CVS setup instructions for inst machines running Solaris

Gaining access to the GamesCrafters repository

These instructions should work from any inst machine running Solaris.

  1. Create a SourceForge account and request to be added as a GamesCrafters developer before continuing. For details on how to do this, refer to the General GamesCrafters CVS Information.

  2. If you did not generate an SSH key pair in a previous semester, generate one now. Otherwise, skip this step and the next step.
    You can generate an SSH key pair by running ssh-keygen2. You will be prompted for a passphrase. This may be any passphrase you'd like and does not have to be the same as the password to your inst account.

    Example:
    % ssh-keygen2
    Generating 2048-bit dsa key pair
    Key generated.
    2048-bit dsa, user@CS.Berkeley.EDU, Wed Sep 26 2003 15:50:32 -0800
    Passphrase : [myPassword or blank]
    Again : [myPassword or blank]
    Private key saved to /home/aa/users/username/.ssh2/id_dsa_2048_a
    Public key saved to /home/aa/users/username/.ssh2/id_dsa_2048_a.pub

    The name of your key in the above case would be id_dsa_2048_a, which (in most cases) is the default name. However, be aware that your key may be given a different name. In such a case, you may need to replace id_dsa_2048_a with your key's name in all future steps.

    Remember your password! If you forget your password, you'll need to repeat this entire process.

  3. Create a .ssh2/identification file (if it doesn't already exist) and add the following line to it:

    IdKey id_dsa_2048_a

    (If the key you created in part 1 has a different name than id_dsa_2048_a, use that name instead.)

    One way to do this (assuming you don't already have an identification file) is:

    1. cd ~/.ssh2
    2. echo IdKey id_dsa_2048_a > identification

    Warning: The above instructions will not work if there is an existing .ssh2/identificiation file. In such a case, you should add the line using a text editor (like vi or emacs):

  4. Convert your SSH public key file to the OpenSSH format

    The key you created using ssh-keygen2 uses the IETF SECSH format, but SourceForge only accepts public keys in an OpenSSH-compatible format. First, you will need to download OpenSSH or a key converter. For your convenience, I've already compiled OpenSSH's ssh-keygen for Solaris (SPARC) and Solaris (x86). (nova, star, solar, h30, h50, c199, quasar, pulsar, and cory are SPARC-based systems. rhombus, pentagon, po, torus, and the machines in 277 Soda are x86-based systems.) You may need to run chmod u+x ssh-keygen-solaris-system to allow the program to be executed. If you're feeling bored, you can instead compile OpenSSH from the source.

    Executing the following commands should convert your keys:

    cd ~/.ssh2
    ../ssh-keygen-solaris-system -i -f id_dsa_2048_a.pub > inst.pub

    Replace system with sparc or x86 depending on the system you are using.
    The above assumes you downloaded ssh-keygen-solaris-system to your home directory. You may need to modify the path if you downloaded it to another location.

  5. Add your OpenSSH-compatible public key to your SourceForge account

    Go to the SourceForge website and log in to your account. Access your account options (my sf.net -> Account Options) and select [Edit SSH Keys for Shell/CVS]. Enter the public key in the text box. (Your public key is the text of the file .ssh2/inst.pub). Your entire key should be on one line!

Automating your login to CVS

Use CVS for the first time

Confused by these instructions? Email your team lead!
This page was last updated on .