Computer Science Department - University of Piemonte Orientale  
 
     
 
 
Command line interface

Introduction

The purpose of this guide is to make it easy for you, as a ShareGrid user, to get the most out of the resources and advantages offered by grid computing, by submitting your jobs via a command line interface.

MyGrid is the tool that you as a user need to be familiar with in order to run your applications on ShareGrid. Once you have MyGrid installed and properly configured (which takes about 5-10 minutes), you will be ready to roll.

MyGrid must be installed only in the machine where you plan to submit job.

Requirements

  • user account - you must have an account on the machine on which you want to install MyGrid
  • disk space - you will need 15MBs for the installation
  • operating system - Linux
  • Java - version 1.5 or later
  • MyGrid machine must be able to connect to the Peer machine and to receive incoming connections from this machine on a TCP port
  • tools - decompression tools (i.e. tar/gzip/gunzip)

 

Before to start

  • Check the Java version installed on MyGrid machine doing:

    java -version

  • If MyGrid machine is behind a firewall be sure that it is possible to estabilsh and to accept connections to/from Peer machine ramses.di.unipmn.it (193.206.55.107). Please be aware that your machine might be running a personal firewall (e.g. iptables).

  • If the hostname of the MyGrid machine is not resolved by public DNS, you have to send us the hostname and ip address of your machine.

  • The computational machine are able to execute java and C/C++ applications. If you need specific application to run your task, you have to send us all the details concerning the application.

 

Installing

  1. Download ShareGridClient.tgz 1.78 Mb 5.45 Mb
  2. Execute:
    1. tar zxvf shareGridClient.tar.gz
    2. cd shareGrid/clientSG
    3. ./startUp.sh
  3. Answer the questions in the configuration wizard checking that the values it found in the system are correct.
    1. You can keep the default values. The most important values are the first two: hostname and port. The hostname must be resolved by public DNS and port must be open for connections from the peer.

 

Test your installation

Now that installation and setup is complete, you should verify that it basicly works as expected. Any time, you can check its status doing:

  1. cd shareGrid/clientSG
  2. ./status.sh

Before to submit your own task, we suggest to submit a simple job doing:

  1. cd shareGrid/clientSG
  2. ./testSubmitJob.sh

If everything worked fine, it will be created two files named output-1 and output-2 containing the hostnames of the remote machines where the tasks have been executed.

IMPORTANT: when you have finished, you must shutdown your MyGrid process doing:

  1. cd shareGrid/clientSG
  2. ./shutDown.sh

 

Describing your jobs

The easiest way to submit your own applications consist to modify the file testJob.jdf located in shareGrid directory.

This job has a label and two tasks. The label is useful for monitoring and controlling the job during execution. Each task will execute an application and retrieve the result of the execution. The first task executes the hostname command and redirects the output to the output-1 file. The second does the same thing, but redirects the output to the output-2 file. After the remote processing, the results are collected back to the MyGrid machine.

Steps for job submission:

  1. cp testJob.jdf myJob.jdf
  2. customize myJob.jdf in order to execute your application (more details concerning how you can specify your job can be found here)


Submit your job

Now you are ready to submit your job doing:

  1. ./submitJob.sh myJob.jdf

and to check the execution status of your job doing:

  1. ./status.sh


That's all folks!

Enjoy the ShareGrid experience! If you have any problem.. just drop us a messagel!

 

Login Form






Lost Password?
 
  Design by augs-burg.de & go-vista.de