Production Installation

To install Apache Brooklyn on a production server:

  1. Set up the prerequisites
  2. Download Apache Brooklyn
  3. Configuring brooklyn.properties
  4. Configuring default.catalog.bom
  5. Test the installation

This guide covers the basics. You may also wish to configure:

Set up the Prerequisites

Check that the server meets the requirements. Then configure the server as follows:

  • install Java JRE or JDK (version 7 or later)
  • install an SSH key, if not available
  • enable passwordless ssh login
  • create a ~/.brooklyn directory on the host with $ mkdir ~/.brooklyn
  • check your iptables or other firewall service, making sure that incoming connections on port 8443 is not blocked
  • check that the linux kernel entropy is sufficient

Download Apache Brooklyn

Download Brooklyn and obtain a binary build as described on the download page.

Expand the tar.gz archive:

% tar -zxf apache-brooklyn-0.9.0-dist.tar.gz

This will create a apache-brooklyn-0.9.0 folder.

Let’s setup some paths for easy commands.

% cd apache-brooklyn-0.9.0
% BROOKLYN_DIR="$(pwd)"
% export PATH=$PATH:$BROOKLYN_DIR/bin/

Configuring brooklyn.properties

Set up brooklyn.properties as described here:

  • Configure the users who should have access
  • Turn on HTTPS
  • Supply credentials for any pre-defined clouds

It may be useful to use the following script to install an initial brooklyn.properties:

% mkdir -p ~/.brooklyn
% wget -O ~/.brooklyn/brooklyn.properties https://brooklyn.apache.org/v/0.9.0/start/brooklyn.properties
% chmod 600 ~/.brooklyn/brooklyn.properties

Configuring the Catalog

By default Brooklyn loads the catalog of available application components and services from default.catalog.bom on the classpath. The initial catalog is in conf/brooklyn/ in the dist. If you have a preferred catalog, simply replace that file.

More information on the catalog is available here.

Confirm Installation

Launch Brooklyn in a disconnected session so it will remain running after you have logged out:

% nohup bin/brooklyn launch > /dev/null 2&>1 &

Apache Brooklyn should now be running on port 8081 (or other port if so specified).