Downloads

Contents

The Distro

First time user? The getting started guide will walk you through downloading Brooklyn, setup of your brooklyn.properties and catalog.xml files, and then trying the examples.

The Distribution archives contain Brooklyn as a standalone executable package, and are available in the following formats and locations:

The All Jar

You can grab a single JAR containing all of Brooklyn and its dependencies here:

Just download your preferred flavour and add it to your classpath.

Getting Started and Release Notes

First time using Brooklyn? Read Getting Started to set up your brooklyn.properties and catalog.xml files.

Release notes can be found here, and specifically for 0.5.0-rc.1.

Examples

You can checkout the examples from the brooklyn-examples git repository. Maven (v3) is required to build them, as described here. The examples for this version (0.5.0-rc.1) are in the branch 0.5.0-rc.1, so if you have git and mvn already, you can simply:

% git clone https://github.com/brooklyncentral/brooklyn-examples.git
% cd brooklyn-examples
% git checkout 0.5.0-rc.1
% mvn clean install

If you don't use git, you can download the projects as a tarball instead from this link. These commands should do the trick:

% curl -L -o brooklyn-examples-0.5.0-rc.1.tgz \
     https://github.com/brooklyncentral/brooklyn-examples/tarball/0.5.0-rc.1
% tar xvfz brooklyn-examples-0.5.0-rc.1.tgz
% mv brooklyncentral-brooklyn-examples-* brooklyn-examples-0.5.0-rc.1 \
     # change the strange name which github assigns in the tarball
% mvn clean install

A good example to start with is the Elastic Web Cluster.

Maven

If you use maven, you can add Brooklyn with the following in your pom:

    <dependencies>
        <dependency>
            <groupId>io.brooklyn</groupId>
            <artifactId>brooklyn-all</artifactId>
            <version>0.5.0-rc.1</version>
        </dependency>
    </dependencies>

brooklyn-all (used above) brings in all dependencies, including jclouds and Apache Whirr. If you prefer a smaller repo you might want just brooklyn-core, brooklyn-policies, and some of brooklyn-software-webapp, brooklyn-software-database, brooklyn-software-messaging, or others (browse the full list here).

If you wish to use the Sonatype and/or Cloudsoft repositories (particularly for snapshots), you can add some of the following sections:

    <repositories>
        <repository>
            <id>cloudsoft-cloudfront-releases-repo</id>
            <url>http://developers.cloudsoftcorp.com/maven/releases/</url>
        </repository>
        <!-- optional for snapshot versions -->
        <repository>
            <id>sonatype-nexus-snapshots</id>
            <name>Sonatype Nexus Snapshots</name>
            <url>https://oss.sonatype.org/content/repositories/snapshots</url>
            <releases> <enabled>false</enabled> </releases>
            <snapshots> <enabled>true</enabled> </snapshots>
        </repository>
        <repository>
            <id>cloudsoft-cloudfront-snapshots-repo</id>
            <url>http://developers.cloudsoftcorp.com/maven/snapshots/</url>
            <snapshots>
                <enabled>true</enabled>
                <updatePolicy>never</updatePolicy>
                <checksumPolicy>fail</checksumPolicy>
           </snapshots>
         </repository>
    </repositories>

Source Code

Full source is at github.com/brooklyncentral/brooklyn. Information on working with the source is here.

Alternatively you can download archives of the source directly: