1. Installation¶

This section describes how to leverage CloudsStorm. There are three ways of usage:

Standalone
- Prerequisites
- Download
Package
- Prerequisites
- Usage
Source

Note

This framework is implemented in Java. It is therefore portable with various operating systems, as long as JRE is installed. However, we have not fully test CloudsStorm with Windows currently. The preferred operating system is MacOS or Linux. You are also welcome to report bugs with Windows.

1.1. Standalone ¶

This is to leverage CloudsStorm as a command line tool. It provides several commands to execute the infrastructure code, delete resources, etc. Currently, we support three Clouds: EC2, ExoGENI and EGI. In this way, you can only manage your infrastructures from these three Clouds. Detailed usage method can be found in the section Standalone (Get started).

1.1.1. Prerequisites ¶

There should be a JRE-7+ installed in advance to execute Java program.

1.1.2. Download ¶

Go to the release page: https://github.com/CloudsStorm/Standalone/releases

Downloading with the command:

$ wget https://github.com/CloudsStorm/Standalone/releases/download/1.0/CloudsStorm.jar

1.2. Package ¶

This is to leverage CloudsStorm as a library for advanced usage. In this way, developers can extend and override the basic V-Engine to manage resources from a new Cloud provider or even for their own private cluster. Detailed usage method can be found in section Package (Advanced usage).

1.2.1. Prerequisites ¶

This is a Java program. Therefore, JDK 7+ is necessary to set up your project and import our jar package. It is preferred to use Maven 3.0.0+ to set up the project.

1.2.2. Usage ¶

Download and import to your project manually:

$ wget https://github.com/CloudsStorm/mvn-repo/blob/master/releases/nl/uva/sne/zh/CloudsStorm/1.0/CloudsStorm-1.0.jar

Through Maven (recommended), add following XML texts to your pom.xml.

<dependencies>
  <dependency>
      <groupId>nl.uva.sne.zh</groupId>
      <artifactId>CloudsStorm</artifactId>
      <version>1.0</version>
  </dependency>
</dependencies>
<repositories>
  <repository>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
    <id>zh-releases</id>
    <url>https://raw.githubusercontent.com/CloudsStorm/mvn-repo/master/releases</url>
  </repository>
</repositories>

Note

Tag <dependencies></dependencies> and <repositories></repositories> should be excluded, if there already exists one.

1.3. Source ¶

This is for developers who want to be collaborators on this project. Detailed development guide can be found in the section Source (For developers).

1.3.1. Prerequisites ¶

In order to make further development on this project, it is preferred to use Maven and Git to manage the project.

JDK 7+
Maven 3.0.0+
Git 2.0+

1.3.2. Download ¶

Download the latest source code with the command:

$ git clone https://github.com/zh9314/CloudsStorm.git

1.3.3. Build ¶

To build a Jar package as a library, use the command:

$ cd CloudsStorm
$ mvn clean install

To build a standalone program for direct usage, adopt the command:

$ cd CloudsStorm
$ mvn clean compile assembly:single

Then, the corresponding compiled Jar files can be found in the directory CloudsStorm/target/