Install the Binary Distribution

The easiest way to get Cloud42 up and running is to use the binary distribution from the download page. This description assumes you have already installed Java and Apache Tomcat or another Servlet-Container. Furthermore, the binary distribution is intented to be used with Amazon EC2 only.
Important: If you want to use Cloud42 to administrate an Eucalyptus instance, you need to install it from source (see below).

Unzip the files to any folder on your hard drive.
Start the database. To run Cloud42, you have to start a HSQLDB database in server mode. The database system is shipped with Cloud42 and can be found in a subdirectory of the distribution.
Open a console window, go to the subdirectory tools/hsqldb/database and type
```
java -classpath ../lib/hsqldb.jar org.hsqldb.Server
```
.
Now you can deploy the WAR-files of Cloud42 in Tomcat or the container of your choice.

Note that you can install the GUI and the Web service interface of Cloud42 fully independent from each other. Just deploy the WAR-file(s) you need. The file cloud42.war contains the Web application for the graphical part of the management framework, whereas the file cloud42WS.war contains the Web service interface of Cloud42.

That's it!

To test your installation, browse to http://localhost:8080/Cloud42 to access the GUI part of Cloud42.

The WSDLs for the Web service interface can be found at http://localhost:8080/Cloud42WS/Cloud42BaseService?wsdl, http://localhost:8080/Cloud42WS/Cloud42FileService?wsdl, http://localhost:8080/Cloud42WS/Cloud42RemotingService?wsdl and http://localhost:8080/Cloud42WS/Cloud42NotificationService?wsdl .

Install from Source Code

This section describes the steps required if you want to build Cloud42 yourself. You must follow these instructions if you want to use Cloud42 together with Eucalyptus.

The project uses the Maven build system along with Jetty, a lightweight container. This makes installing and deploying Cloud42 very easy. Here are the instructions for you when working with the source code.

Download & configure Maven 2.0.9 if you don't have it yet.
Cloud42 requires Java. It was developed using version 1.6, but it should be able to run on 1.5.x as well. In any case, check your Java installation and make sure your JAVA_HOME environment variable is set.
Extract the files from the source code distribution available on the download page anywhere on your hard disc.
This step is only required if you want to use Cloud42 with Eucalyptus:

You have to configure Cloud42 to connect to a server different from "ec2.amazonaws.com". For this purpose, we provided a configuration file located at core/service/src/main/resources/config.properties. Please read the comments in this file carefully and adjust all(!) the settings to your needs.
Cloud42 needs to know your AWS credentials to pass its unit tests. You have to enter them in the file core/module-configuration/src/main/resources/test-config.properties

Note: This file also contains an option allowing you to enable all tests, including the ones that require starting and stopping instances (and therefore cause costs). Adjust it to your needs.

Note 2: Don't worry, the configuration file containing your AWS credentials will not be included in the resulting WAR file when building Cloud42, since it is only referenced in scope "test".

Note 3: If you do not know your credentials or even do not have an AWS account yet, building Cloud42 is possible though by skipping the tests. Simply add the parameter -Dmaven.test.skip to the mvn clean install command mentioned below.
Now open a console window and execute a
```
 mvn clean install
```
from the directory where you unpacked the files.
Start the database. To run Cloud42, you have to start the HSQLDB database in server mode. The database system is shipped with Cloud42 and can be found in a subdirectory of the distribution.
Go to the subdirectory tools/hsqldb/database and type
```
java -classpath ../lib/hsqldb.jar org.hsqldb.Server
```
Run webapp:
Now you can start the Web application containing the GUI of Cloud42 using Jetty, a lightweight container. From the webapp folder, run
```
mvn jetty:run
```
Browse to http://localhost:8080/Cloud42 and enjoy.
Run webservice:
The Web service interface part of Cloud42 is a Web application that includes the Axis2 Servlet. This means, you can deploy it without any installations or configurations.
From the webservice folder, type
```
mvn jetty:run
```
The WSDLs for the Web service interface can be found at http://localhost:8080/Cloud42WS/Cloud42BaseService?wsdl, http://localhost:8080/Cloud42WS/Cloud42FileService?wsdl, http://localhost:8080/Cloud42WS/Cloud42RemotingService?wsdl and http://localhost:8080/Cloud42WS/Cloud42NotificationService?wsdl .

Note: if the GUI Web application from previous step is still running, you may want to use another port for the Web service. To do this, add the option -Djetty.port=8081 to your command.
If you want to use the GUI Web application or the Web service with any application server of your choice, just deploy the .war files from the target folders in the subdirectories webapp/ or webservice/.

Working with the Code

Some useful hints when working with the code:

In order to build Eclipse project files simply execute
```
mvn eclipse:clean eclipse:eclipse
```
from the root folder and import the resulting project files into your Eclipse workspace.
Don't forget to set a classpath variable in the Eclipse IDE for M2_REPO pointing to your local Maven repository.
If you want to generate a project documentation including JavaDoc, execute the following steps:
```
mvn site
```
from the root folder to create the Maven project site. Then:
```
mvn site:stage -DstagingDirectory="(your_folder)"
```
to deploy it to a folder of your choice.
Warning: both of these steps are very time-consuming!
The folder utils/NotificationEndpoint contains a tool that is very useful for testing the Cloud42 notification mechanism. See the corresponding readme file.
The folder BPEL/Cloud42BPELSample contains a sample BPEL process created with Oracle JDeveloper.
You can use this example if you are interested in invoking Cloud42 from within BPEL processes.
For more information, see the corresponding readme-file in the mentioned directory.

Content of this page