{% include fields.md %}
To install Apache Brooklyn on a production server:
This guide covers the basics. You may also wish to configure:
Check that the server meets the requirements. Then configure the server as follows:
~/.brooklyn
directory on the host with $ mkdir ~/.brooklyn
iptables
or other firewall service, making sure that incoming connections on port 8443 is not blockednss
for SSL.Download Brooklyn and obtain a binary build as described on the download page.
{% if brooklyn_version contains ‘SNAPSHOT’ %} Expand the tar.gz
archive (note: as this is a -SNAPSHOT version, your filename will be slightly different): {% else %} Expand the tar.gz
archive: {% endif %}
{% if brooklyn_version contains ‘SNAPSHOT’ %} {% highlight bash %} % tar -zxf apache-brooklyn-dist-{{ site.brooklyn-stable-version }}-timestamp-dist.tar.gz {% endhighlight %} {% else %} {% highlight bash %} % tar -zxf apache-brooklyn-{{ site.brooklyn-stable-version }}-dist.tar.gz {% endhighlight %} {% endif %}
This will create a apache-brooklyn-{{ site.brooklyn-stable-version }}
folder.
Let's setup some paths for easy commands.
{% highlight bash %} % cd apache-brooklyn-{{ site.brooklyn-stable-version }} % BROOKLYN_DIR=“$(pwd)” % export PATH=$PATH:$BROOKLYN_DIR/bin/ {% endhighlight %}
Set up brooklyn.cfg
as described here:
Out of the box, Apache Brooklyn includes the default Karaf security configuration. This configuration is used to manage connections to the ssh port of Karaf (which is available to localhost connections only). It is recommended that you update the credentials as detailed in the Karaf Security page.
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.
Launch Brooklyn in a disconnected session so it will remain running after you have logged out:
{% highlight bash %} % nohup bin/brooklyn launch > /dev/null 2&>1 & {% endhighlight %}
Apache Brooklyn should now be running on port 8081 (or other port if so specified).
To install on a different port edit config in etc/org.ops4j.pax.web.cfg
.