PetaFs 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

Petafs allows users to access to the data stored in PetaShare sites by using standard UNIX commands (ls, cp, etc) and system calls (open, read, write, etc). Petafs is basically based on FUSE.

Supported System

Right now, only Linux systems are supported. Support for Mac OS is on proccess and will be provided in the near future.


Installation of petafs is straightforward:

1) Unpack the petafs package:

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

2) Go into the top directory of the package

$ cd petafs-(version)

3) Run 'setup' script

$ ./setup

If your system does not have the required libraries to install petafs, you will be asked to install them. If you get the following message:

Your system does not have fuse libraries installed in '/usr/lib' and 'usr/local/lib' directoy!
Please run 'install-fuse' script as a ROOT to install fuse libraries.
After running 'instal-fuse', you should rerun 'setup' script again as a NON-ROOT user !!!

then, do the following:

4) switch to ROOT user

$ su

5) run 'install-fuse' script

$ ./install-fuse

7) switch to NON-ROOT user

$ exit

6) re-run 'setup' script to finish installation

$ ./setup

Note:If your system has fuse libraries in different location from '/usr/lib' and 'usr/local/lib', you can specify it by using '--fuseHomeDir' option.
$ ./setup --fuseHomeDir /usr/fuseDirLocation

That's all!

If no error message is gotten, please open a new terminal to use petafs...


Basic usage of petafs is:

$ petafs

which mounts all online petashare sites to 'petashare' directory under your home directory(/home/user/petashare).

More advance usage is:

$ petafs home/user/<somedirectory>

which mounts all online petashare sites into the directory that is specified explicitly(home/user/<somedirectory>).

All PetaShare sites can be accessible under this directory. At the time of being PetaShare is running on the following sites:


petafs has the following options;

--test | -t
--mount | -m
--unmount | -u
--unmount-all | -U
--force | -f
--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 that 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 petafs on testbed type the following:

$ petafs -t

to mount testbed sites unto <your-home-directory>/petashare


$ petafs <mount-here> -t

to mount testbed sites into a specific directory(<mount-here>).

--mount(or -m) option:
It is used for mounting a particular PetaShare site into your system. Type the following: $ petafs -m lsu

This command mounts lsu site into the '~/petashare/' directory. It is also possible to specify the directory where site should be mounted.

$ petafs -m lsu /home/user/mount-here

It mounts the lsu site into '/home/user/mount-here' directory.

--unmount(or -u) option:
It unmounts a mounted PetaShare site from your system. Type the following:

$ petafs -u /home/user/petashare/uno

to unmount uno site from your system.

--unmount-all(or -U) option:
Instead of unmounting a particular site, one may wants to unmount all Petashare sites. You should use this option to unmount all PetaShare sites. Type the following:

$ petafs -U

it unmounts all Petashare sites from your system.

--force(or -f) option:
It is used to force unmount operation(s) of petafs. If '-u' or '-U' option doesn't work as it is desired it can be used along with '-u' or '-U' command to force to unmount site(s). Its usage is similar to '-u' and '-U' option.

$ petafs -fu ~/petashare/lsu

This will force to unmount lsu site from your system.

Or, you can force to unmount all PetaShare sites on your system by typing the following:

$ petafs -fU

--change-user(or -c) option:
petafs package comes with a default 'testuser' account. This account has many restrictions and can be used by all petafs 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.

$ petafs -c

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 are becomig online. This command retrieves the required information to connect to the available PetaShare sites. Type the following:

$ petafs -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 shows what the options are, and their respective usage.

$ petafs -h

Online Sites

Following sites are online right now:

Testbed Sites

The original PetaShare site names are being used for testbed, too. These are:



petafs is based on Fuse and iRODS i-commands. The original Notes and Credits are located in respective directories(i.e. fuse, iRODS). Please also refer to their webpages for further information.