Getting the software

Once you've got the code, as described on this page, you'll need to set it up.

The development code is in http://icamodel.sourceforge.net

At the moment there is no stable snapshot available

For end users

There is no pre-built software at the moment, so you need to build your own using NetBeans. We are currently on 5.5, not 6.x.

The sections below assume that you have installed the Netbeans & JDK cobundle.

Anonymous Checkout

This allows you to get the project files without needing developer privileges.

In Netbeans, select CVS ; Checkout ; Edit and enter the following settings:

• Access Method: pserver
• User: (leave blank)
• Host: icamodel.cvs.sourceforge.net
• Port: 2401
• Repository Path: /cvsroot/icamodel

Click OK and it should go ahead and fetch a copy of the files from Sourceforge.

For developers

You need a developer account on Sourceforge for this. The project's administrator will set this up for you.

In the steps below, suppose your username is harrypotter.

Generating a secure key (Linux)

Most Linux installations will have OpenSSH already installed, but if not then you will have to install it first.

• Open a shell
  • ssh-keygen -t dsa -C "harrypotter@shell.sourceforge.net" (the C just adds a comment)
• It puts the keys in /home/yourusername/.ssh. There are 2 keys, one of which ends in .pub. This is the public key and is the one to be uploaded. Edit the file and copy the contents to the clipboard.
• Login to your Sourceforge account, go to the preferences page and paste the new key into the text box. If you have more than one key (eg if you want to develop on more than one platform or PC) then you need to put a carriage return between the keys.
• Allow a while for the key to be lodged with the Sourceforge server – usually takes about 10 mins but could be longer.
• Test the key and tell the CVS server to recognise it. To do this:
  • Open a shell
  • ssh –I harrypotter@icamodel.cvs.sourceforge.net (or something like that - look up the ssh options to make sure)
  • It should connect now
  • When it asks to remember you, say Y.
  • Type exit to get out

• Go into Netbeans CVS Checkout and enter the following settings:
  • CVS Root: (include leading colon!) :ext:harrypotter@icamodel.cvs.sourceforge.net:/cvsroot/icamodel
  • Select Use external shell
  • SSH Command: ssh

Generating a secure key (Windows)

• Get the PuTTY toolset from http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html (use the Windows Installer)
• Create c:\\ssh (or other directory of your choice but best to avoid spaces)
• Run PuTTYgen utility
  • Leave passphrase blank - this avoids having to set up Pageant
  • Click Generate

• Login to “My Account” on sourceforge
  • Click “Edit SSH Keys for Shell/CVS”
  • Paste the key from PuTTYgen into the text box and click Update
• Allow a while for the key to be lodged with the Sourceforge server – usually takes about 10 mins but could be longer.

• In PuTTYgen:
  • save the public key in c:\\sshsourceforge-shell.pub (just so you have a record of it.
  • save the private key in c:\\sshsourceforge-shell.ppk (necessary)

• Test the key and log the username:
  • Open a shell
  • Cd program filesputty
  • Plink –ssh –I c:\\sshsourceforge-shell.ppk harrypotter@icamodel.cvs.sourceforge.net
  • It should connect now
  • When it asks to remember you, say Y.
  • Type exit to get out

• Go into Netbeans CVS Checkout and enter the following settings:
  • CVS Root: (include leading colon!) :ext:harrypotter@icamodel.cvs.sourceforge.net:/cvsroot/icamodel
  • Select Use external shell
  • SSH Command: c:\\program filesputtyplink -ssh -i c:\\sshsourceforge-shell.ppk