openCRX Virtual Appliance

• Description / Purpose
• Downloading and Assembling
• Running openCRX Virtual Appliance
• Use PostgreSQL instead of MySQL

Description / Purpose

With the openCRX Virutal Appliance you get the opportunity to test openCRX in your own environment without spending any time on installing and configuring openCRX. This VMware image is built as an appliance that will start and run a openCRX with a single click. Many openCRX users have complained that the process of installing and configuring all of the components necessary to get openCRX running is difficult and time consuming. This appliance makes all of that complexity disappear.

The vmware image contains:

Guest Operating System	Kubuntu 7.0.4
DBMS	MySQL v5.0
Application Server	JBoss 4.0.3SP1
openCRX	v1.11.0

Please note that this vmware image is not intended for production use.

^top

Downloading and Assembling

You can download the openCRX virtual appliance (VMware image) from Sourceforge (look for the 5 files ending with ...vmx.zip.001 through ...vmx.zip.005). The total download is about 1.7GB. You can assemble/concatenate the split files to the file opencrx-1.11.0-jboss-4-mysql-5.vmx.zip as follows:

Windows:
Download and install 7zip from www.7zip.org (open source and free). Once 7zip is installed, you can simply right click on the first split file opencrx-1.11.0-jboss-4-mysql-5.vmx.zip.001 and then select "Extract files..." from the context menu.

Unix/Linux:
cp opencrx-1.11.0-jboss-4-mysql-5.vmx.zip.001+opencrx-1.11.0-jboss-4-mysql-5.vmx.zip.002+opencrx-1.11.0-jboss-4-mysql-5.vmx.zip.003+opencrx-1.11.0-jboss-4-mysql-5.vmx.zip.004+opencrx-1.11.0-jboss-4-mysql-5.vmx.zip.005 > opencrx-1.11.0-jboss-4-mysql-5.vmx.zip

You should now have a single file called opencrx-1.11.0-jboss-4-mysql-5.vmx.zip. Unzip this file to get the 2 files Ubuntu.vmdk and Ubuntu.vmx (requires about 4GB of empty disk space).

^top

Running openCRX Virtual Appliance

Follow these five easy steps to run the openCRX virtual appliance:

1. In order to run the openCRX virtual appliance you need the free vmware player. You can download the player appropriate for your platform (i.e. host operating system) from http://www.vmware.com/products/player/ (examples: if you want to run the openCRX virtual appliance on Windows, you need the vmware player for Windows - if you want to run the openCRX virtual appliance on Linux, you need the VMware player for Linux). This download is about 170MB.
2. Install the vmware player.
3. Download and assemble the openCRX virtual appliance (a VMware image) from Sourceforge (this download is about 1.7GB).
4. Start the VMware player and open the virtual machine Ubuntu.vmx to boot Kubuntu
5. Login with username opencrx and password opencrx
6. On the Kubuntu desktop, click the icon Start openCRX. This will start JBoss and deploy the openCRX EARs (the whole startup process takes between 2 and 3 minutes on a 2GHz CPU)
   
7. On the Kubuntu desktop, click the icon Firefox Web Browser and then click the button openCRX/Core on the Bookmarks Toolbar (Firefox will connect to http://localhost:8080/opencrx-core-CRX/Login).
8. The following openCRX Logins are active:
   

   Role	Username	Password
   Root Administrator	admin-Root	rootSecret
   Segment Administrator	admin-Standard	adminSecret
   User	guest	guest

9. You can stop the application server by clicking on the icon Shutdown openCRX on the Kubuntu desktop.

^top

Use PostgreSQL instead of MySQL

Our VMware image contains both MySQL and PostgreSQL. You can use PostgreSQL instead of MySQL by adapting JNDI-Names as follows:

1. make sure openCRX is not running (and stop it if it is running)
2. edit the file jdbc-opencrx-CRX-mysql-ds.xml and change the JNDI-Namen to jdbc_opencrx_CRX_MYSQL
3. edit the file jdbc-opencrx-CRX-pg-ds.xml and change the JNDI-Namen to jdbc_opencrx_CRX
4. start openCRX

Please note that data stored in MySQL is not automatically transferred to PostgreSQL, i.e. data entered/changed while using MySQL is not available after you switch to PostgreSQL.

^top