Source

mrt-storeCloud / README-SETUP.txt

Full commit

* Requirements
JDK 1.6(+)
Java servlet container that accepts .war (e.g. tomcat, resin, jetta, ...)
ant
maven 2
________________________________
* Setup local maven dependencies
storeCloud is has 2 dependencies:
mrt-core
mrt-s3

- clone each of the 3 bitbucket projects locally
https://dloy@bitbucket.org/merritt/mrt-core
https://dloy@bitbucket.org/merritt/mrt-s3
https://dloy@bitbucket.org/merritt/mrt-storecloud

- run mvn on each project
cd mrt-core
mvn clean install
cd ../mrt-s3
mvn clean install
cd ../mrt-storecloud
mvn clean install
________________________________

* Create basic d-flat repository using base/storage/mrt.local.properties
Edit  - these ant properties that define the
new Storage Microservice 

Properties:
-storage.node=[absolute file path to storage node that will be constructed by script]
Example: storage.node=/home/me/store
Required

-can.node=[absolute file path to CAN node that will be constructed by script]
The actual storage of the pairtree/dflat architecture will occur under ths directory.
Example: can.node=/home/me/node
Required

-can.info.identifier=[any number - used in restful interface]
The Storage Service restful calls use this number which must be unique to the
Storage service.
Example: can.info.identifier=10
Required

-store.info.baseURI=[Absolute URL that will be used for the Storage Service]
This is the URL for your Storage Service calls.
Example: http:storge.myhost.org:8080/storage
Required

-exists.storage.node=delete
if present then delete storage service every time clean/build is done in maven
Default: do not delete

-exists.can.node=delete
if present then delete CAN every time clean/build is done in maven
Default: do not delete

NOTE: If you are using Windows for your Storage Service, then the file paths that you
set in the properties need to be specified in a unix style format with forward slashes:
C:/Documents and Settings/dloy/...

* run maven
cd to downloaded version of mrt-storeCloud
mvn install -Pdemo

This should build a working storage service

________________________________

* Building a working servlet
After running the previous step a storage.war file will now exist that can be used
on the Storage Service defined by the previous step.

The .war is base/store-war/war/storage.war

Place this .war in a java container (tomcat/webapps, resin/webapps, jetta, ...) and start the container.

The restful interface should now be available at[store.info.baseURI]

Test:
- [store.info.baseURI]/state 
Example: http:storge.myhost.org:8080/storage/state - Storage Service state

- [store.info.baseURI]/state/[[store.info.baseURI]
Example: http:storge.myhost.org:8080/storage/state/10 - CAN state


============================================
Note:
- Storage service URLs are sensitive to slashes (/) so URL encoding is required for any
URL element containing a slash:
http://storge.myhost.org:8080/storage/state/15/ark%3A%2F13030%2Fabcd