How to set up an OpenGeo Suite cluster on AWS¶

Packages¶

1. Mac OS X only: Install pip:

   sudo easy_install pip
   

2. Ansible must be installed via pip. If you have Ansible installed through your standard package manager, run apt-get remove --purge ansible first before running pip install ansible.

3. Install the python-dev package through your package manager. For example, on Ubuntu:

   apt-get install python-dev
   

4. Install boto with pip:

   pip install boto
   

Java¶

1. Set the $JAVA_HOME variable to the location of Java. For example:

   export JAVA_HOME=/usr/lib/jvm/java-7-openjdk-i386/jre
   

   Note

   The command which java may not give the true path. For more information on how to find the real location of Java, see the Amazon EC2 documentation.

2. To verify, type the following command:

   $JAVA_HOME/bin/java -version
   

EC2 tools¶

1. Download and install the EC2 API tools.

2. Extract the EC2 API tools into /usr/local/ec2/ec2-api-tools-a.b.c.d, where a.b.c.d is the specific version of the EC2 API tools.

3. Add the path where you extracted the EC2 API tools to the $EC2_HOME environment variable. For example:

   export EC2_HOME=/usr/local/ec2/ec2-api-tools-1.6.14.1
   

4. Add the $EC2_HOME/bin path to the $PATH:

   export PATH=$PATH:$EC2_HOME/bin
   

5. Verify that the EC2 tools are on your path by entering the following command:

   ec2-describe-regions
   

   If you see a list of regions, your EC2 interface is correct:

   REGION  eu-west-1 ec2.eu-west-1.amazonaws.com
   REGION  sa-east-1 ec2.sa-east-1.amazonaws.com
   REGION  us-east-1 ec2.us-east-1.amazonaws.com
   REGION  ap-northeast-1  ec2.ap-northeast-1.amazonaws.com
   REGION  us-west-2 ec2.us-west-2.amazonaws.com
   REGION  us-west-1 ec2.us-west-1.amazonaws.com
   REGION  ap-southeast-1  ec2.ap-southeast-1.amazonaws.com
   REGION  ap-southeast-2  ec2.ap-southeast-2.amazonaws.com
   

For more information about setting up the EC2 tools, please see the Amazon documentation.

EC2 remote access¶

In order to be able to use the EC2 tools, you will need to have AWS access keys. These consist of a pair of credentials, called an Access Key and a Secret Access Key.

1. Retrieve these keys (or make a new pair) by logging into your AWS account.

2. Set these keys as local environment variables:

   export AWS_ACCESS_KEY=your_access_key
   export AWS_SECRET_KEY=your_secret_access_key
   

You will also need to have a key pair set up on your EC2 account.

1. To create a key pair, navigate to the EC2 key pairs page.
2. Click Create key pair.
3. You will then be asked to download a file (with the extension .pem). Save this file in a safe place.

Misc¶

The following are other setup tasks that don’t fall under any specific category.

1. Add another environment variable:

   export ANSIBLE_HOST_KEY_CHECKING=False
   

2. Open $HOME/ssh_config in a text editor.

3. Add the following line to the bottom of the file:

   StrictHostKeyChecking no
   

4. Save and close the file.

Clustering script¶

1. Download and extract the clustering script archive to a directory.

   Note

   If you are an Enterprise client and do not have the script, please let us know.

2. Open the file roles/aws/vars/main.yml in a text editor.

3. Change the line that starts with aws_keypair to contain the name of your key file (omitting the .pem extension):

   aws_keypair: key
   

4. Save and close the file.