OppStore version 0.1
====================

OppStore is a middleware that allows the efficient and reliable usage of the free storage space of
machines connected to an opportunistic grid.

Installation:
-------------

1) Enter in directory 'oilpack' and type './install.sh'. This procedure will install the OiL ORB and
the Lua programming language libraries.

2) Enter the directory 'adr' and type 'make'. This will compile the ADR and generate the executable
'AdrLauncher'.

3) Enter the directory 'broker' and type 'make'. This will compile the access broker library.

4) Return to the main OppStore directory and type 'ant' to compile the CDRM.

Deployment:
-----------

1) It is necessary to launch a CORBA name service server and a CDRM server on a machine for each
grid cluster. Those servers can be launched using the scripts 'launchNs.sh' and 'launchCdrm.sh'
respectively and stopped using the scripts 'killNs.sh' and 'killCdrm.sh'.

2) Machines that will share their resources with the grid must execute the ADR module. It can be
launched by calling the 'AdrLauncher' executable in the 'adr' directory. The file 'adr.conf' should
be edited to configure the ADR.

3) The access broker library can be accessed by linking the application to 'broker/lib/libbroker.so'
and calling the methods from its API, provided in the header 'OppStoreBroker.h'. A sample
application, 'TestBrokerReal.cpp' is provided.

Limitations:
------------

- The current version is under actively development and is not intended for general usage.

- OppStore requires all machines running OppStore modules to be visible to each others. This means
that every machine must have a valid IP address or every machine should be inside a single
subnetwork.

- Several other limitations not listed here.
