GridPP Cloud-GettingStarted

From GridPP Wiki
Jump to: navigation, search

GridPP Cloud pilot Getting Started Guide=====Introduction=

This guide will describe how to connect to the cloud pilot and how to use it.

Prerequisites

As described on the main page, you need to have requested an account on the cloud. Once the account has been created, a zip file containing your credentials will be sent. The 'openrc' file contains credentials you can use for both Nova and EC2 API access. Nova is the OpenStack native API, while EC2 (Elastic Compute Cloud) is compatible with the service provided by Amazon Web Services. The commands you'll use to interact with OpenStack operate via one of these two web services-based APIs.

Create a new directory for the credentials then copy the file there:

mkdir ~/.gridppcloud
cp geoffrey-smith.zip ~/.gridppcloud
cd ~/.gridppcloud
unzip geoffrey-smith.zip
cd ~
chmod 0700 ~/.gridppcloud
chmod 0600 ~/.gridppcloud/*
. ~/.gridppcloud/openrc-gsmith

The last command . ~/.gridppcloud/openrc-gsmith should be added to ~/.bashrc or your preferred shell initialization script, to ensure that the credentials are available at each login.

Command-line access

Now that you have the credentials in your shell, you need to install some tools to use them. For Nova, you need python-novaclient, which is in Fedora and in EPEL for RHEL and its derivatives, and Debian/Ubuntu.

Assuming that you've followed the credentials setup steps above, you can run a Nova command to check that it's working:

nova image-list

which should provide a listing of the VM images available for you to use.

For EC2, you need euca2ools, which is available under that name in Fedora/EPEL and Debian/Ubuntu.

The equivalent test command for EC2 is:

euca-describe-images

Remote Access

A temporary login node has been created to provide for remote access during the testing of images. Please contact GridPP Clouod admins for details.

Back to GridPP Cloud sites page