*************
Installation
*************
description
===========
This page describes how to install elasticHPC Client and make it ready for use.
requirements
============
ElasticHPC Client requires the following libraries to be installed:
* Python > 2.5
* **Sun Java** > 1.5
* `pyCrypto >= 2.3 `_
* simplejson
* `elementTree `_
* `PrettyTable `_
* `boto `_
Install
========
Download Package from `elasticHPC.org `_ page
Pull the recent dev build from SVN reprository
Configuration
=============
for ease of use, elasticHPC-Client supports saving AWS credentials in a config file so the user doesn't have to provide the credentials everytime using the program
Save a file (with name you want) in the following format in ``${EHPC_HOME}/conf/NAME_OF_FILE.conf``
.. note:: For Service Providers, they can set the AMI_ID across differnet regions in ``client.conf``, so that the users don't need to set AMI_ID everytime.
Format of Configuration File
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>>
[aws]
pkey: /path/to/pk.pem
cert: /path/to/cert.pem
accessKey: AKIAJ.....
secretKey: aK8........
keyPair:
keyPairPath: /path/to/pemfile
securityGroup: HPCloud
then when you to deal with the client just pass --conf=NAME_OF_FILE_CREATED and the credentials will be loaded from it
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
Creating a new security group
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>>> ./EHPC-Client --new-group -sg=GROUP_NAME -r=REGION
**Example 1**
``/EHPC-Client --new-group -sg=elasticHPC -r=EU1``
Configure Security Group
^^^^^^^^^^^^^^^^^^^^^^^^
>>> ./EHPC-Client --authorize -sg=GROUP_NAME
``./EHPC-Client --authorize -sg=elasticHPC -r=EU1``