Contributing to Chrysalis
To contribute to Chrysalis, please contact one of the project administrators on the Project Team. We are using the following development tools to work on Chrysalis. Familiarity with the tools is a prerequisite for working on the project:
To make it easier to get started, we have put together a Java Software Bundle containing all the necessary software.
We are also using Putty for secure communications on Windows (SSH, FTPS, etc.) and CVS as our source code control system.
You can build Chrysalis in your working environment as follows:
You must be connected to the Internet for this process to work. Once you have built Chrysalis, you can work on it locally, though you are encouraged to synchronize with the CVS repository on a regular basis.
1. Setup Your Source Forge Account
Go to sourceforge.net and select the "New User" link in the upper left-hand corner. Follow the instructions.
2. Install Putty
If you are a developer, you will only need Putty to enable security for your Source Forge account. After that, Eclipse can handle the rest.
You can get Putty at: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
Install it, then use Putty.exe to connect to the Chrysalis CVS server:
Click Open when you are finished.
If this is the first time you have used Putty to connect to SourceForge, Putty will inform you that it does not recognize Source Forge's digital certificate. Click "Yes" to accept it.
Putty will open a SSH window, which will immediately close. This is normal. The Putty connection is only used to establish your user directory on the CVS server.
3. Install the Java Software Bundle
This step is optional. If you do not install the bundle, you will need to install all the separate software packages (the JDK, Ant, Tomcat, etc.) yourself. To install the Java Software Bundle:
We apologize, but for the moment, the software-bundle is set up for Windows only. When we get the time, we will upgrade it to cover Unix-based OS.
4. Create CVS Location in Eclipse
To point Eclipse to the Source Forge CVS repository:
Once you have finished, you should be able to browse the Chrysalis repository in the "CVS Repositories" view.
5. Check Out the Project in Eclipse
To open the project in Eclipse:
Warning: Be careful not to select Check Out As Project . If you do, Eclipse will open a "Simple Project" instead of a "Java Project". If you accidentally create a simple project, delete the project (and all of its contents) and start over.
6. Build the Project With Ant
When you first check out the project in Eclipse, it will not build successfully, because you are still missing dependencies like JUnit and the servlet API. You can retrieve the necessary jars by building the project using Ant.