---

title: Locations layout: page toc: ../guide_toc.json categories: [use, guide]

---

Locations are the environments to which Brooklyn deploys applications. These can be clouds (public or private), fixed infrastructure environments, or your laptop.

Brooklyn looks for Location configuration in ~/.brooklyn/brooklyn.properties.

Setting up an SSH key

While some locations can be accessed using user:password credentials it is more common to use authentication keys.

To use keyfile based authentication, Brooklyn requires that the management machine has an SSH key. By default Brooklyn looks for a key at ~/.ssh/id_rsa and ~/.ssh/id_dsa.

If you do not already have an SSH key installed, create a new id_rsa key:

{% highlight bash %} $ ssh-keygen -t rsa -N "" -f ~/.ssh/id_rsa {% endhighlight %}

If you wish to use an existing key SSH, or an SSH key that has a passphrase, or a location other than ~/.ssh, you can specify this in brooklyn.properties using brooklyn.location.localhost.privateKeyFile and brooklyn.location.localhost.privateKeyPassphrase.

Localhost

Brooklyn can access localhost if there is an SSH key on the machine and if the SSH key has been added to the list of authorized_keys on that machine.

{% highlight bash %}

Appends id_rsa.pub to authorized_keys. Other keys are unaffected.

$ cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys {% endhighlight %}

MacOS user? In addition to the above, enable ‘Remote Login’ in System Preferences > Sharing.

Cloud Endpoints (via jclouds)

Apache jclouds is a multi-cloud library that Brooklyn uses to access many clouds. The full list of supported providers is available on jclouds.apache.org.

Add your cloud provider's (API) credentials to brooklyn.properties and create an SSH key on the management machine.

Some clouds provide both API keys and SSH keys. In this case add only the API credentials to brooklyn.properties. (jclouds will transparently use the API credentials to setup access using the management machine's SSH key.)

Example: AWS Virginia Large Centos

{% highlight bash %}

Snippet from ~/.brooklyn/brooklyn.properties.

Provide jclouds with AWS API credentials.

brooklyn.location.jclouds.aws-ec2.identity = AKA_YOUR_ACCESS_KEY_ID brooklyn.location.jclouds.aws-ec2.credential = YourSecretKeyWhichIsABase64EncodedString

Name this location ‘AWS Virginia Large Centos’ and wire to AWS US-East-1

brooklyn.location.named.AWS\ Virginia\ Large\ Centos = jclouds:aws-ec2:us-east-1

(Using the same name) specify image, user and minimum ram size (ie instance size)

brooklyn.location.named.AWS\ Virginia\ Large\ Centos.imageId=us-east-1/ami-7d7bfc14 brooklyn.location.named.AWS\ Virginia\ Large\ Centos.user=root brooklyn.location.named.AWS\ Virginia\ Large\ Centos.minRam=4096

{% endhighlight %}

This will appear as ‘AWS Virginia Large Centos’ in the web console, but will need to be escaped on the command line as: AWS\ Virginia\ Large\ Centos.

See the Getting Started template brooklyn.properties for more examples of using cloud endpoints.

Fixed Infrastructure

Bringing your own nodes (BYON) to Brooklyn is straightforward.

You will need the IP addresses of the nodes and the access credentials. Both SSH and password based login are supported.

Example: On-Prem Iron

{% highlight bash %}

Snippet from ~/.brooklyn/brooklyn.properties.

Use the byon prefix, and provide the IP addresss (or IP ranges)

brooklyn.location.named.On-Prem\ Iron\ Example=byon:(hosts=“10.9.1.1,10.9.1.2,produser2@10.9.2.{10,11,20-29}”) brooklyn.location.named.On-Prem\ Iron\ Example.user=produser1 brooklyn.location.named.On-Prem\ Iron\ Example.privateKeyFile=~/.ssh/produser_id_rsa brooklyn.location.named.On-Prem\ Iron\ Example.privateKeyPassphrase=s3cr3tpassphrase

{% endhighlight %}

Advanced Options

Unusual provider? ‘Featureful’ API? Brooklyn can cope.

This spreadsheet provides explanation, guidance, and examples for the majority of location options.