This book describes how to install the openCRX SDK (Software Development Kit) with the BitRock installer on Windows or Linux platforms. Please note that this is a guide to set up a development environment.

openCRX is the leading enterprise-class open source CRM suite. openCRX is based on openMDX, an open source MDA framework based on the OMG's model driven architecture (MDA) standards. This guarantees total openness, standards compliance, a state-of-the-art component-based architecture, and virtually unlimited scalability.

1.1 Who this book is for

The intended audience are openCRX developers and administrators.

1.2 What do you need to understand this book

This book describes how to install openCRX with the BitRock installer, which takes care of all the tricky configuration issues for you. The prerequisites are minimal (JDK and Ant) and once they are met you should have the openCRX SDK installed in less than 5 minutes.

1.3 Tips, Warnings, etc.

We make use the following pictograms:

Information provided as a “Tip” might be helpful for various reasons: time savings, risk reduction, etc. - it goes without saying that we advise to follow our guides meticulously

meticulous \muh-TIK-yuh-luhs\, adjective:
Extremely or excessively careful about details.

You should carefully read information marked with “Important”. Ignoring such information is typically not a good idea.

Warnings should not be ignored (risk of data loss, etc.)

2 Prerequisites

2.1 JDK 5.0

Install the Sun Java JDK 5.0 available from the following site:

Sun JDK 5.0:
http://java.sun.com/javase/downloads/index_jdk5.jsp

It is not sufficient to have a Java Runtime Environment (JRE) only. The full-blown JDK is required to run openCRX.

Don't forget to set the environment variable JAVA_HOME

2.2 Ant 1.7.0

Install Ant 1.7.0 for your platform. Downloads are available from http://ant.apache.org/

It is a good idea to avoid paths containing blanks like the default installation directory ...\Program Files\... on Windows

Ant v1.7.1 should work as well. However, if the installation of the openCRX SDK fails with Ant v1.7.1, please try Ant v1.7.0 (there are some combinations of JDK versions and Ant that “don't like each other”...

2.3 openCRX SDK Installer

Download the openCRX SDK Installer appropriate for your platform from Sourceforge: http://www.opencrx.org/downloads.htm

Installer for Windows:
opencrxSdk-2.4.0-windows-installer.exe

Installer for Linux:
opencrxSdk-2.4.0-linux-installer.bin

3 Installing openCRX SDK on Windows

Launch the Installer opencrxSdk-2.4.0-windows-installer.exe
Click [Next] on the following screen:
Accept the BSD License Agreement and click [Next]:
Choose an installation directory (it will be created automatically if it does not exist yet).

It is a good idea to avoid paths containing blanks like the default installation directory ...\Program Files\... on Windows.

Then click [Next] to continue:
Please note the information on the following screen. It is assumed that you have installed JDK 1.5 (also called JDK 5.0) and Ant 1.7.0 appropriate for your platform (see Prerequisites). Click [Next] to continue:
Select the home directory of your JDK 1.5 installation - for example D:\Java\jdk1.5.0 - and then click [Next] to continue:
Select the home directory of your Ant installation – for example D:\apache-ant-1.7.0 - and then click [Next] to continue:

Click [Next] to start the installation:

Please note that once the installation is complete, the installer will automatically launch a post installation script. This script builds an openCRX distribution from scratch (and depending on your CPU this can easily take a few minutes, so please be patient).

Once the post installation script has completed, verify that at the end of the output you see “BUILD SUCCESSFUL” as shown below:

Don't forget to read the Readme file as it contains important information regarding your openCRX SDK installation. Finally, click [Finish]:

4 Installing openCRX SDK on Linux

Launch the Installer opencrxSdk-2.4.0-linux-installer.bin
Click [Forward] on the following screen:
Accept the BSD License Agreement and click [Forward]:
Choose an installation directory (it will be created automatically if it does not exist yet). Then click [Forward] to continue:
Please note the information on the following screen. It is assumed that you have installed JDK 1.5 (also called JDK 5.0) and Ant 1.7.0 appropriate for your platform (see Prerequisites). Click [Forward] to continue:
Select the home directory of your JDK 1.5 installation - for example /opt/jdk1.5.0_17 - and then click [Forward] to continue:
Select the home directory of your Ant installation – for example /opt/apache-ant-1.7.0 - and then click [Forward] to continue:

Click [Forward] to start the installation:

Once the post installation script has completed, verify that at the end of the output you see “BUILD SUCCESSFUL” as shown below:

Don't forget to read the Readme file as it contains important information regarding your openCRX SDK installation. Click [Finish] to complete the installation:

5 Configuration Files, Scripts, etc.

The SDK Installer copied/unpacked all the files required to build openCRX from the sources to the installation directory. In addition to the plain source files, however, you will also find lots of configuration files, scripts, etc. The following list of interesting locations will get you started even though there is a lot more to discover.

5.1 DB Scripts

The directory <SDK_Install_Dir>\opencrx-2.4.0\core\src\sql contains all the scripts required to setup an openCRX database on any of the supported database management systems (HSQLDB, MySQL, PostgreSQL, DB2, Oracle, MSSQL). Please refer to the appropriate DB installation guide for additional information.

5.2 Code Tables – UI Customizing

Code tables of the default distribution are contained in the directory <SDK_Install_Dir>\opencrx-2.4.0\core\src\data\org.opencrx\code

UI customizing files of the default distribution are contained in the directory <SDK_Install_Dir>\opencrx-2.4.0\core\src\data\org.opencrx\ui

Please refer to the openCRX customizing guide for additional information.

5.3 UML Models and Java Source of openCRX/core

The directory <SDK_Install_Dir>\opencrx-2.4.0\core\src\model contains all UML models, the Java sources are contained in the directory <SDK_Install_Dir>\opencrx-2.4.0\core\src\java

5.4 openCRX servlets

The directory <SDK_Install_Dir>\opencrx-2.4.0\core\src\data contains the servlets ical, imap, news, rest, and vcard.

5.5 openCRX/store

The directory <SDK_Install_Dir>\opencrx-2.4.0\apps contains all the files related to openCRX/store.

6 Next Steps

Now that you have successfully installed openCRX you might want to have a look at some of the additional documentation published at http://www.opencrx.org/documents.htm.