Setting Things Up to Participate in Calenco Development With the NetBeans IDE

Note: These instructions are for an Ubuntu Linux system, adapt as needed for your Linux distribution or your Microsoft^® Windows^™ system.

Note: All commands/operations have to be performed as your regular user, you will be told explicitly when you have to run commands with system administrator (root) privileges. Prepend sudo to the commands in question to run them with root privileges.

Installing Java Development Kit

All major Linux distributions provide packages for Sun's JDK. It's important to install Sun JDK instead of other JDKs (like GCJ). If your distribution doesn't provide packages for Sun's JDK, you can download and install it from the Sun Java web site:

• Open your favourite web browser on  http://java.sun.com/javase/downloads
• Download the latest JDK available (at the time of this writing it was JDK 6 Update 12) for your platform
• Open a terminal window, change to the folder where your download resides, make the download executable (chmod 700 jdk*.bin) and execute it
• Move (as root) the resulting folder (named something like jdk1.6.0_12/) to the /opt/ folder and make sure its bin/ folder is on your PATH

Installing NetBeans IDE

You can download the NetBeans IDE at  http://netbeans.org/. The 'Java' package is recommended for Calenco development. Follow the installation instructions provided in the download page with the link "Installation Instructions".

Create the NetBeans Project(s)

• Start The NetBeans IDE
• Open the Checkout window (Team->Subversion -> Checkout)
• Enter the repository URL :
  •  svn+ssh://svn.calenco.com/var/lib/svn/repositories/calenco/trunk for the development project.
  •  svn+ssh://svn.calenco.com/var/lib/svn/repositories/calenco/branches/stable for the production usable project.
• Specify the tunnel command providing your private key (ssh -i /home/user/.ssh/id_rsa for example)
• Click Next
• Choose the local folder where to store the project
• Check Scan for NetBeans Projects after Checkout
• Click Finish
• Once the checkout is done, a pop-up should appear asking if you want to open the project, click OK

Configuring the Logging System

To account for differences between the different developers' preferences, the log4j.properties.example file have to be copied with a different name and edited according to your preferences.

• Copy src/log4j.properties.example to src/log4j.properties (add it to SVN's ignore list, if needed), make modifications if you want a different logging level and/or format. Note that the copied file can be left with the same content as in the .example file.

Build and Deploy Calenco

• Right click on the desired project in NetBeans and choose Clean and Build

or

• From the Console : change to the folder where Calenco was checked out (~/NetBeansProjects/stable/ for example), and run ant clean jar to rebuild Calenco

then

• Change to the directory dist and run Calenco using the provided script ./CalencoV2.sh
• You can point your browser to " http://localhost:8182/" and experience Calenco

To Stop Calenco

Calenco must be stopped gracefully using the proper HTTP request, for example :
curl -uadmin@calenco.com:secret -XPOST http://localhost:8182/system/control/shutdown

Informations

Useful information can be found in the following files (in the project root folder) :

• README
• CHANGELOG
• INSTALL
• KNOWN_ISSUES