Installation Instructions

Since ROMIO is included in MPICH, LAM, HP MPI, SGI MPI, and NEC MPI, you don't need to install it separately if you are using any of these MPI implementations. If you are using some other MPI, you can configure and build ROMIO as follows:

Untar the tar file as

    gunzip -c romio.tar.gz | tar xvf -
    zcat romio.tar.Z | tar xvf -


    cd romio

Some example programs and a Makefile are provided in the romio/test directory. Run the examples as you would run any MPI program. Each program takes the filename as a command-line argument ``-fname filename''.

The configure script by default configures ROMIO for the file systems most likely to be used on the given machine. If you wish, you can explicitly specify the file systems by using the ``-file_system'' option to configure. Multiple file systems can be specified by using `+' as a separator, e.g.,
./configure -file_system=xfs+nfs
For the entire list of options to configure, do
./configure -h | more
After building a specific version, you can install it in a particular directory with
make install PREFIX=/usr/local/romio (or whatever directory you like)
or just
make install (if you used -prefix at configure time)

If you intend to leave ROMIO where you built it, you should not install it; make install is used only to move the necessary parts of a built ROMIO to another location. The installed copy will have the include files, libraries, man pages, and a few other odds and ends, but not the whole source tree. It will have a test directory for testing the installation and a location-independent Makefile built during installation, which users can copy and modify to compile and link against the installed copy.

To rebuild ROMIO with a different set of configure options, do
make distclean
to clean everything, including the Makefiles created by configure. Then run configure again with the new options, followed by make.

Rob Latham 2016-08-01