Petashell Installation Guide and User Manual

  1. General Information
  2. Supported System
  3. Installation
  4. Usage
  5. Options
  6. Online Sites
  7. Testbed
  8. Contact
  9. Acknowledgment

General Information

Petashell allows users to attach their existing programs in local machines to the data on remote PetaShare sites, so it makes PetaShare resources appear as a file system to the application.

Supported System

Right now, petashell is running on Linux.


The installation is straightforward:

1) Unpack the petashell package:

$ tar xvfz petashell-(version).tar.gz

2) Go into the top directory of the package

$ cd petashell-(version)

3) Run 'setup' script

$ ./setup

Hopefully, there should be no error, and that's it!

Please open a new terminal to use petashell...

if you received an error regarding globus, please run the setup script with the --disable-globus option!

$ ./setup --disable-globus


To run petashell type the following;

$ petashell

then, it falls into its own shell. After this point local applications can be used on PetaShare sites. PetaShare sites can be accessed by using similar command;

$ ls /petashare/lsu

which lists the directories under 'lsu' site.

It is convenient to access PetaShare resources as like as UNIX directories by using the '/petashare/<site-name>' virtual path:

$ cd /petashell/lsu/tempZone/home/testuser

it drops into home directory of testuser in PetaShare, so programs can be associated with data which is over there. For example, a file can be edited by using of favourite text editor(like vi) by using:

$ vi file1

where file1 resides in '/petashell/lsu/tempZone/home/testuser' and vi is running in local machine.


petashell has the following options;

--test | -t
--change-user | -c
--get-sites | -g
--help | -h

--test(or -t) option:
A testbed is being provided for the new comers to PetaShare environment to let them get an experience on PetaShare. This testbed has five sites that can be used for experimental purposes. However, it is encouraged to be carefull and do not put any essential data in testbed since everbody can access them and perform tests that may cause lose of data. To use petashell on testbed type the following:

$ petashell -t


$ petashell --test

--change-user(or -c) option:
petashell package comes with a default 'testuser' account. This account has many restrictions and can be used by all petashell users. One can use this account until obtains a private account. When a private account has been obtained, this option must be used to activate the account in that machine, and(or) to switch between existing account(s) and 'testuser' account. Before using this option, be sure that valid username and password had been obtained from PetaShare authorities.

$ petashell -c


$ petashell --change-user

it will prompt a username and a password.

To switch 'testuser' account, type 'testuser' for username. There is no need to enter a password for 'testuser'.

--get-sites(or -g) option:
It is necessary to obtain the information of new petashare sites. It should be run when the new petashare sites become online. This command retrieves the required information to connect to the available PetaShare sites. Type the following:

$ petashell -g it will download the latest list of PetaShare sites and their respective parameters.

--help(or -h) option:
It pop ups the help screen. It basically shows what are the options, and their respective usage.

$ petashell -h

Online Sites

Following sites are online right now:

Testbed Sites

The original PetaShare site names are being used for testbed, too. These are: Note that these are different sites from the real PetaShare sites.



petashell is based on parrot(cctools) and iRODS i-commands. The original Notes and Credits are located in respective directories(i.e. cctools, iRODS). You can also visit their webpages for further information.