From 2b99a5e3d587d1c24ec498a650e7323edde26fe2 Mon Sep 17 00:00:00 2001 From: Duncan Godwin Date: Thu, 31 Mar 2016 12:14:46 +0100 Subject: [PATCH 1/2] Getting started for deb distribution --- guide/start/running.md | 54 +++++++++++++++++++++++++++++++++--------- 1 file changed, 43 insertions(+), 11 deletions(-) diff --git a/guide/start/running.md b/guide/start/running.md index 0518743d..8a0f9ca8 100644 --- a/guide/start/running.md +++ b/guide/start/running.md @@ -22,8 +22,9 @@ To get you up-and-running quickly, the Vagrant option will provision four comput
@@ -55,7 +56,7 @@ $ cd apache-brooklyn-{{site.brooklyn-version}}-vagrant For Centos 7 and RHEL 7 users, the recommended way to install Apache Brooklyn on RPM-based Linux distributions is by using the RPM package. -RPM is the de facto standard for packaging software on these Linux distributions and provides a mechanism for installing, upgrading and removing packages such as Apache Brooklyn. The AMP package contains all the necessary files associated with the Apache Brooklyn application. +RPM is the de facto standard for packaging software on these Linux distributions and provides a mechanism for installing, upgrading and removing packages such as Apache Brooklyn. The RPM package contains all the necessary files associated with the Apache Brooklyn application. Download the Apache Brooklyn [RPM distribution](https://www.apache.org/dyn/closer.lua/brooklyn/apache-brooklyn-{{site.brooklyn-version}}-1.noarch.rpm){:target="_blank"}. @@ -68,7 +69,24 @@ $ yum install apache-brooklyn-{{site.brooklyn-version}}-1.rpm
- + + +For Ubuntu and Debian users, the recommended way to install Apache Brooklyn is to use the deb file. + +The deb file is the de facto standard for packaging software on these Linux distributions and provides a mechanism for installing, upgrading and removing packages such as Apache Brooklyn. The deb package contains all the necessary files associated with the Apache Brooklyn application. + +Download the Apache Brooklyn [deb distribution](https://www.apache.org/dyn/closer.lua/brooklyn/apache-brooklyn_{{site.brooklyn-version}}_noarch.deb){:target="_blank"}. + +Once downloaded, run the following shell command as root: + +{% highlight bash %} +$ sudo dpkg -i apache-brooklyn_{{site.brooklyn-version}}_noarch.deb +{% endhighlight %} + +
+
+ + For Linux or OSX please download the Apache Brooklyn `tar.gz` archive from the [download]({{site.path.website}}/download/){:target="_blank"} section. @@ -91,9 +109,9 @@ $ cd apache-brooklyn-{{ site.brooklyn.version }} {% endif %}
-
+
- + For all versions of Microsoft Windows, please download the Apache Brooklyn zip file from [here]({{site.path.website}}/download/){:target="_blank"}. @@ -116,8 +134,9 @@ you may wish to set up other configuration options first:
@@ -154,7 +173,20 @@ The application should then output its logs to `/var/log/brooklyn/apache-brookly
- + + +Apache Brooklyn should now have been installed and be running as a system service. It can stopped and started with the standard service commands: + +{% highlight bash %} +$ sudo service brooklyn start|stop|restart|status +{% endhighlight %} + +The application should then output its logs to `/var/log/brooklyn/apache-brooklyn.debug.log` and `/var/log/brooklyn/apache-brooklyn.info.log`. + +
+
+ + Now start Apache Brooklyn with the following command: @@ -165,9 +197,9 @@ $ bin/brooklyn launch The application should then output its log into the console and also `apache-brooklyn.debug.log` and `apache-brooklyn.info.log`
-
+
- + You can now start Apache Brooklyn by running `c:\Program Files\brooklyn\bin\brooklyn.bat` From e1bf2651c3b22aea7a8c218ea1db0e0cdbb1cb65 Mon Sep 17 00:00:00 2001 From: Duncan Godwin Date: Thu, 31 Mar 2016 12:47:03 +0100 Subject: [PATCH 2/2] Minor corrections --- guide/ops/catalog/index.md | 2 +- guide/start/running.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/ops/catalog/index.md b/guide/ops/catalog/index.md index 230eedc8..a547dede 100644 --- a/guide/ops/catalog/index.md +++ b/guide/ops/catalog/index.md @@ -55,7 +55,7 @@ brooklyn.catalog: #### Catalog Metadata -Catalog metadata fields supply the additional information required In order to register an item in the catalog. +Catalog metadata fields supply the additional information required in order to register an item in the catalog. These fields can be supplied as `key: value` entries where either the `` or `` placeholders are, with the latter overriding the former unless otherwise specfied below. diff --git a/guide/start/running.md b/guide/start/running.md index 8a0f9ca8..60c81c56 100644 --- a/guide/start/running.md +++ b/guide/start/running.md @@ -77,7 +77,7 @@ The deb file is the de facto standard for packaging software on these Linux dist Download the Apache Brooklyn [deb distribution](https://www.apache.org/dyn/closer.lua/brooklyn/apache-brooklyn_{{site.brooklyn-version}}_noarch.deb){:target="_blank"}. -Once downloaded, run the following shell command as root: +Once downloaded, run the following shell command: {% highlight bash %} $ sudo dpkg -i apache-brooklyn_{{site.brooklyn-version}}_noarch.deb