Grid Appliance on FutureGrid - Nimbus
From Grid-Appliance Wiki
Contents |
Pre-requisites
Creating Account And Using Educational Appliances on FutureGrid
Introduction
This is an introductory tutorial for using grid-appliance images tailored for use on FutureGrid resources with the Nimbus toolkit.
(Note: In the current early stages of FutureGrid, the virtual machines created using the nimbus toolkit run on Linux Kernel 2.6.18. Since the latest releases of Ubuntu require later kernel versions, this image is built on Ubuntu Jaunty (9.04). Note that grid-appliance is not actively supported on Ubuntu Jaunty. For cloud environments which can support Ubuntu Karmic 9.10 (for example the Science Cloud @ University of Chicago), Grid Appliance images built on Ubuntu Karmic are available. Link for the images and tutorial are available here).
Getting Started
Setup your Nimbus client
Follow the FutureGrid Nimbus tutorial NM1 to get started setting up your Nimbus client and credentials. If you would like to run the Nimbus client on an appliance in your own desktop, you may also follow the FutureGrid client appliance tutorial ga6
Using the Cloud Client
At this point, it is expected that you have read the cloud client quick start tutorial. For help and additional help messages, use the below commands:
$ ./bin/cloud-client.sh --help $ ./bin/cloud-client.sh --extrahelp
To start a workspace of the 64-bit grid-appliance, use the below command:
$ ./bin/cloud-client.sh --list $ ./bin/cloud-client.sh --run --name grid-appliance-jaunty-amd64.gz --hours 1
Once the workspace reaches "running" state, it's the hostname/IP address would be dispalyed. To log into the Grid Appliance, ssh using the root user.
$ ssh root@<grid_appliance.cloudurl.edu>
The appliance does not connect automatically to any pool at start-up when it is instantiated using the cloud-client. To connect to the default public pool, you need to simply install the grid-appliance-public-pool package in your grid-appliance.
# apt-get install grid-appliance-public-pool
To connect to any other GroupVPN pool, you need to place a floppy disk containing the GroupVPN configuration files inside the appliance in the /opt/grid_appliance/etc directory and then restart the grid_appliance service. This floppy can be generated using the grid-appliance.org web front-end. The steps are as outlined below: 1. Stop the grid_appliance service in the grid-appliance
# /etc/init.d/grid_appliance.sh stop # exit
2. Download the GroupVPN floppy to your local system from the grid-appliance website. Transfer it to the Grid Appliance workspace using scp or sftp.
$ scp ./floopy.img root@<grid_appliance.cloudurl.edu>:/opt/grid_appliance/etc/
3. SSH back into grid appliance and start the grid appliance service
$ ssh root@<grid_appliance.cloudurl.edu> # /etc/init.d/grid_appliance.sh start
Images
The below images are listed in the Foxtrot cloud. To download the images, use the command:
./bin/cloud-client.sh --download --name <image_name> --localfile /tmp/<image_name>
1. Grid Appliance Base Image (Condor)
grid-appliance-jaunty-amd64.gz This appliance is ready to run condor jobs. Note that only the grid-appliance-base package in installed in this image. To tailor the image further, please follow the steps mentioned in TestingGridAppliance.
2. Hadoop Appliance
grid-appliance-jaunty-hadoop-amd64.gz The grid-appliance-hadoop package is installed in this image. For more details on using this image, check Hadoop_Virtual_Cluster_Appliance.
3. MPI Appliance
grid-appliance-jaunty-mpi-amd64.gz This image has the grid-appliance-mpi package installed which is based on mpich2 package in ubuntu's repository. For further details on configuring a virtual cluster, check the wiki page at MPI_Virtual_Cluster_Appliance.
