PetaFs Installation Guide and User Manual

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

General Information

Petafs mounts available PetaShare resources to the users' machines. Petafs allows users to access to 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 Note:If your system has fuse libraries in different location from '/usr/lib' and 'usr/local/lib', you can specify it by using '--fuse-home' option.
$ ./setup --fuse-home <FuseHomeDirectory>

That's all!

If no error message is appeared, please open a new terminal to use petafs, or run the following to activate your updated environment... $ source ~/.petafs/.bashrc.petafs Note:If you are using C shell instead of bash, then run:
$ source ~/.petafs/.cshrc.petafs

If you are using TC shell
$ source ~/.petafs/.tcshrc.petafs

If you are using Korn shell
$ source ~/.petafs/.profile.petafs


Basic usage of petafs is:

$ petafs -m <siteName>

which mounts petashare site called siteName to 'petashare' directory under your home directory(/home/user/petashare).

More advance usage is:

$ petafs -m <siteName> /home/user/<somedirectory>

which mounts PetaShare site called siteName into the directory that is specified explicitly(/home/user/<somedirectory>).

Mounted PetaShare site can be accessible under this directory. At the time of being PetaShare is running on the following sites(i.e. siteName is one of them):

After mounting PataShare site(s) successfuly, you can access it as convenient as you access your local directory. You can copy your local files into PetaShare resource simply by running the following command:

$ cp -rf <localDirectory> </home/user/petashare/uno/tempZone/home/userX/>

where userX is your valid PetaShare account name...


petafs has the following options;

--mount <siteName>| -m <siteName>
--mount-all | -a
--unmount <siteName>| -u <siteName>
--unmount-all | -U
--force | -f
--change-user | -c
--get-sites | -g
--help | -h

--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 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 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. To activate account and get credentials you need to run this command first. When a private account has been obtained, this option must be used to activate new account in that machine, and(or) to switch between existing account(s) and 'testuser' account.

$ 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:



petafs is based on Fuse and iRODS. Please refer to the following webpages for further information.