You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@brooklyn.apache.org by ri...@apache.org on 2014/12/10 16:40:30 UTC
[1/2] incubator-brooklyn-site git commit: Getting started updates
following user feedback
Repository: incubator-brooklyn-site
Updated Branches:
refs/heads/master cdad4846d -> dfcd9aedb
Getting started updates following user feedback
Project: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/commit/26cfa11e
Tree: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/tree/26cfa11e
Diff: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/diff/26cfa11e
Branch: refs/heads/master
Commit: 26cfa11e2fe179d9505c7041967f171bbcc9bd00
Parents: cdad484
Author: Richard Downer <ri...@apache.org>
Authored: Wed Dec 10 15:34:57 2014 +0000
Committer: Richard Downer <ri...@apache.org>
Committed: Wed Dec 10 15:38:22 2014 +0000
----------------------------------------------------------------------
quickstart/index.md | 64 +++++++++++++++++++++++++-------
quickstart/policies-and-catalogs.md | 5 +++
2 files changed, 55 insertions(+), 14 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/blob/26cfa11e/quickstart/index.md
----------------------------------------------------------------------
diff --git a/quickstart/index.md b/quickstart/index.md
index 18b565a..5bb38e4 100644
--- a/quickstart/index.md
+++ b/quickstart/index.md
@@ -15,6 +15,46 @@ We will be deploying an example 3-tier web application, described using this blu
(This is written in YAML, following the [camp specification](https://www.oasis-open.org/committees/camp/). )
+This tutorial assumes that you are using Linux or Mac OSX.
+
+
+## Verify SSH
+
+Brooklyn uses SSH extensively and therefore it is worth making sure that you have a known working SSH setup before
+starting.
+
+Please check the following items:
+
+- If you are using Mac OSX, open System Preferences, go to the Sharing item, and enable 'Remote Login'
+- You have a files named `~/.ssh/id_rsa` and `~/.ssh/id_rsa.pub`
+- `~/.ssh/id_rsa` is NOT readable by any other user
+ - You can verify this with `ls -l ~/.ssh/id_rsa` - the line should start with `-rw-------` or `-r--------`. If it
+ does not, execute `chmod 0600 ~/.ssh/id_rsa`.
+- The file `~/.ssh/authorized_keys` exists and contains a copy of your public key from `~/.ssh/id_rsa.pub`.
+ - Note that it is normal for it to contain other items as well.
+- The key in `~/.ssh/id_rsa` does *not* have a passphrase.
+ - You can test this by executing `ssh-keygen -y`. If does *not* ask for a passphrase, then your key is OK.
+ - If your key does have a passphrase, remove it. You can do this by running `ssh-keygen -p`. Enter the passphrase,
+ then when prompted for the new passphrase, hit Enter.
+
+Now verify your setup by running the command: `ssh localhost echo hello world`
+
+If you see a message similar to this:
+
+<pre>
+The authenticity of host 'localhost (::1)' can't be established.
+RSA key fingerprint is 7b:e3:8e:c6:5b:2a:05:a1:7c:8a:cf:d1:6a:83:c2:ad.
+Are you sure you want to continue connecting (yes/no)?
+</pre>
+
+then answer 'yes', and then repeat the command run again.
+
+If the response is `hello world`, with no other output or prompts, then your SSH setup is good and Brooklyn should be
+able to use it without a problem.
+
+If these steps are not working, [these instructions]({{ site.data.brooklyn.url.userguide }}/use/guide/locations/) may be
+useful.
+
## Install Brooklyn
@@ -87,8 +127,6 @@ $ wget {{site.url}}/quickstart/brooklyn.properties
Open brooklyn.properties in a text editor and add your cloud credentials.
-If you would rather test Brooklyn on localhost, follow [these instructions]({{ site.data.brooklyn.url.userguide }}/use/guide/locations/) to ensure that your Brooklyn can access your machine.
-
Restart Brooklyn:
{% highlight bash %}
@@ -108,14 +146,18 @@ Open the web console ([127.0.0.1:8081](http://127.0.0.1:8081)). As Brooklyn is n
### Chose your Cloud / Location
-Edit the 'location' parameter in the YAML template (repeated below) to use the location you configured.
+Let's look again at our YAML blueprint:
-For example, replace:
{% highlight yaml %}
-location: location
+{% readj _my-web-cluster.yaml %}
{% endhighlight %}
-with (one of):
+Copy this document into the large text box on the YAML tab, labelled `Enter CAMP Plan YAML code here`. But *before* you
+submit it, we need to make a modification.
+
+Find the line near the top of the blueprint that starts `location:`. Change the line to name a location. For example,
+one of these lines:
+
{% highlight yaml %}
location: aws-ec2:us-east-1
location: rackspace-cloudservers-us:ORD
@@ -125,14 +167,8 @@ location: localhost
**My Web Cluster Blueprint**
-{% highlight yaml %}
-{% readj _my-web-cluster.yaml %}
-{% endhighlight %}
-
-Paste the modified YAML into the dialog and click 'Finish'.
-The dialog will close and Brooklyn will begin deploying your application.
-
-Your application will be shown as 'Starting' on the web console's front page.
+With the modified YAML in the dialog, click 'Finish'. The dialog will close and Brooklyn will begin deploying your
+application. Your application will be shown as 'Starting' on the web console's front page.
![My Web Cluster is STARTING.](images/my-web-cluster-starting.png)
http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/blob/26cfa11e/quickstart/policies-and-catalogs.md
----------------------------------------------------------------------
diff --git a/quickstart/policies-and-catalogs.md b/quickstart/policies-and-catalogs.md
index 7e6723f..49489df 100644
--- a/quickstart/policies-and-catalogs.md
+++ b/quickstart/policies-and-catalogs.md
@@ -7,6 +7,11 @@ In the [previous step](index.html) we downloaded Brooklyn and used it to deploy
Here we will introduce Polices using a simple demo app, which we will load from a Service Catalog.
+We strongly advise that you complete [the first tutorial](index.html) before proceeding with this one, to make sure that
+your machine is correctly configured to be able to run Brooklyn applications. Like the previous tutorial, we are also
+assuming that you are running Linux or Mac OSX.
+
+
## Service Catalogs
Download the template [catalog.xml](catalog.xml) to your `~/.brooklyn/` folder, and relaunch Brooklyn.
[2/2] incubator-brooklyn-site git commit: Merge and close #16
Posted by ri...@apache.org.
Merge and close #16
Project: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/commit/dfcd9aed
Tree: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/tree/dfcd9aed
Diff: http://git-wip-us.apache.org/repos/asf/incubator-brooklyn-site/diff/dfcd9aed
Branch: refs/heads/master
Commit: dfcd9aedb389ef250a36e59747d452868e0cefa3
Parents: cdad484 26cfa11
Author: Richard Downer <ri...@apache.org>
Authored: Wed Dec 10 15:40:11 2014 +0000
Committer: Richard Downer <ri...@apache.org>
Committed: Wed Dec 10 15:40:11 2014 +0000
----------------------------------------------------------------------
quickstart/index.md | 64 +++++++++++++++++++++++++-------
quickstart/policies-and-catalogs.md | 5 +++
2 files changed, 55 insertions(+), 14 deletions(-)
----------------------------------------------------------------------