*************
Installation
*************
description
===========
This page describes how to install EHPC-EMR Client and make it ready for use.

.. note:: This scrclient requires `AWS's EMR Ruby client <http://aws.amazon.com/developertools/2264>`_ to be installed and configured to be able to interact with AWS's EMR Service.

requirements
============
elasticHPC Client requires the following libraries to be installed:
	* Python > 2.5
	* Ruby 1.8 
	* `pyCrypto >= 2.3 <https://www.dlitz.net/software/pycrypto/>`_
	* simplejson
	* `elementTree <http://effbot.org/media/downloads/elementtree-1.2.7-20070827-preview.zip>`_
	
Install
========

Download Package from `elasticHPC.org <http://www.elastichpc.org/downloads/EHPC-EMR-0.50.tar.gz>`_ page 

Pull the recent dev build from SVN reprository

Configuration
=============

The EMR client requires `AWS's EMR Ruby client <http://aws.amazon.com/developertools/2264>`_ to be installed and configured to be able to interact with AWS's EMR Service. 

AWS EMR Client has the ability to save credentials in a file so that the user doesn't need to provide them everytime. `This is mentioned in the README file` on the tool

.. note:: Path of AWS Ruby client has to be set the config.cfg file.

Security Group Configuration
=============================

The Client allows you to configure an old security group with the Library requirements or to create a new one security group on AWS

Configure Security Group
^^^^^^^^^^^^^^^^^^^^^^^^
EHPC-EMR client communicate with the EMR cluster through a server listening on port TCP 5000.

You have to add this port to the security group 'ElasticMapReduce-master' by hand (like image below)

.. image:: Server.png