Finished getting started changes Added windows and RPM variants
Project: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/commit/33bc8f07 Tree: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/tree/33bc8f07 Diff: http://git-wip-us.apache.org/repos/asf/brooklyn-docs/diff/33bc8f07 Branch: refs/heads/master Commit: 33bc8f07e1bbe6791cb7c301081948260fb5cf69 Parents: 93ed528 Author: drigodwin <[email protected]> Authored: Mon Mar 28 11:07:39 2016 +0100 Committer: drigodwin <[email protected]> Committed: Mon Mar 28 11:07:39 2016 +0100 ---------------------------------------------------------------------- guide/start/running.md | 44 ++++++++++++++++++++++++++++++++++++-------- 1 file changed, 36 insertions(+), 8 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/brooklyn-docs/blob/33bc8f07/guide/start/running.md ---------------------------------------------------------------------- diff --git a/guide/start/running.md b/guide/start/running.md index 078189e..0518743 100644 --- a/guide/start/running.md +++ b/guide/start/running.md @@ -53,16 +53,16 @@ $ cd apache-brooklyn-{{site.brooklyn-version}}-vagrant <strong class="hidden started-pdf-include">b) Centos / RHEL 7</strong> -For Centos and RHEL (v7) users, the recommended way to install Apache Brooklyn on RPM-based Linux distributions is by using the RPM package. +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 most 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 AMP 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"} (CentOS 7, RHEL 7.x only): +Download the Apache Brooklyn [RPM distribution](https://www.apache.org/dyn/closer.lua/brooklyn/apache-brooklyn-{{site.brooklyn-version}}-1.noarch.rpm){:target="_blank"}. -Once downloaded, run the following shell command: +Once downloaded, run the following shell command as root: {% highlight bash %} -$ sudo yum install apache-brooklyn-{{site.brooklyn-version}}-1.rpm +$ yum install apache-brooklyn-{{site.brooklyn-version}}-1.rpm {% endhighlight %} </div> @@ -70,7 +70,8 @@ $ sudo yum install apache-brooklyn-{{site.brooklyn-version}}-1.rpm <strong class="hidden started-pdf-include">c) OSX / Linux</strong> -Other binary distributions are also available to [download]({{site.path.website}}/download/){:target="_blank"}. +For Linux or OSX please download the Apache Brooklyn `tar.gz` archive from the [download]({{site.path.website}}/download/){:target="_blank"} section. + {% if brooklyn_version contains 'SNAPSHOT' %} Extract the `tar.gz` archive (note: as this is a -SNAPSHOT version, your filename will be slightly different): {% else %} @@ -94,6 +95,10 @@ $ cd apache-brooklyn-{{ site.brooklyn.version }} <strong class="hidden started-pdf-include">d) Windows</strong> +For all versions of Microsoft Windows, please download the Apache Brooklyn zip file from [here]({{site.path.website}}/download/){:target="_blank"}. + +Extract this zip file to a directory on your computer such as `c:\Program Files\brooklyn` where `c` is the letter of your operating system drive. + </div> </div> @@ -132,10 +137,24 @@ You can see if Apache Brooklyn launched OK by viewing the log files with the com $ vagrant ssh brooklyn --command 'sudo journalctl -n15 -f -u brooklyn' {% endhighlight %} + </div> <div id="impl-2" class="tab-pane fade"> -<strong class="hidden started-pdf-include">b) Install</strong> +<strong class="hidden started-pdf-include">b) Centos / RHEL 7</strong> + +Apache Brooklyn should now have been installed and be running as a system service. It can stopped and started with the standard systemctl commands: + +{% highlight bash %} +$ systemctl start|stop|restart|status brooklyn +{% endhighlight %} + +The application should then output its logs to `/var/log/brooklyn/apache-brooklyn.debug.log` and `/var/log/brooklyn/apache-brooklyn.info.log`. + +</div> +<div id="impl-3" class="tab-pane fade"> + +<strong class="hidden started-pdf-include">c) OSX / Linux</strong> Now start Apache Brooklyn with the following command: @@ -143,7 +162,16 @@ Now start Apache Brooklyn with the following command: $ bin/brooklyn launch {% endhighlight %} -The application should then output its log into the console +The application should then output its log into the console and also `apache-brooklyn.debug.log` and `apache-brooklyn.info.log` + +</div> +<div id="impl-4" class="tab-pane fade"> + +<strong class="hidden started-pdf-include">d) Windows</strong> + +You can now start Apache Brooklyn by running `c:\Program Files\brooklyn\bin\brooklyn.bat` + +The application should then output its log into the console and also `c:\Program Files\brooklyn\apache-brooklyn.debug.log` and `c:\Program Files\brooklyn\apache-brooklyn.info.log` </div> </div>
