Page History

...

The DuraCloud software, by its very nature, is designed to be integrated with underlying cloud storage providers. As may be expected, these integrations are necessary for the system to be properly exercised. In order for DuraCloud to connect to these underlying providers, appropriate credentials must be provided as part of the application initialization step. It is recommended that you acquire the necessary storage provider credentials prior to attempting to set up DuraCloud. Only one storage provider is required to run DuraCloud.

The storage providers which are currently supported are :

• Amazon S3
• Rackspace CloudFiles
• SDSC Cloud
• Windows Azure (beta)

listed here.

This guide lays out the steps necessary to begin using DuraCloud:

...

1. Check out latest stable release from Subversion repository

   Code Block
   svn co https://svn.duraspace.org/duracloud/tags/duracloud-2.3.0

2. Set environment variables

   Code Block
   export JAVA_OPTS="-XX:MaxPermSize=256m" export MAVEN_OPTS="-Xmx1024m -XX:MaxPermSize=1024m"

3. Configure Tomcat
   

   1. Add to $CATALINA_HOME/conf/tomcat-users.xml

      No Format
      <tomcat-users> <role rolename="manager"/> <role rolename="admin"/> <user username="[ANY-USERNAME]" password="[ANY-PASSWORD]" roles="admin,manager"/> </tomcat-users>

4. Start Tomcat

   Code Block
   $CATALINA_HOME/bin/startup.sh

5. Configure Maven2

6. Add tomcat user to $M2_HOME/conf/settings.xml

   No Format
   <servers> <server> <id>tomcat-server</id> <username>[ANY-USERNAME]</username> <password>[ANY-PASSWORD]</password> </server> </servers>

7. Modify the default ActiveMQ configuration file (there a many configuration options but this is quick approach)

   Code Block
   cd [ACTIVEMQHOME]/conf cp activemq.xml activemq.xml.orig [yourfaveditor] activemq.xml

   DuraCloud expects the broker to run on localhost:61617. We will make it the default for simplicity by finding the "transport" stanza and modifying it.

   No Format

   <transportConnectors> <!-- DOS protection, limit concurrent connections to 1000 and frame size to 100MB --> <transportConnector name="openwire" uri="tcp://0.0.0.0:61617?maximumConnections=1000&amp;wireformat.maxFrameSize=104857600"/> <!-- <transportConnector name="openwire" uri="tcp://0.0.0.0:61616?maximumConnections=1000&amp;wireformat.maxFrameSize=104857600"/> --> <transportConnector name="amqp" uri="amqp://0.0.0.0:5672?maximumConnections=1000&amp;wireformat.maxFrameSize=104857600"/> </transportConnectors>

8. Start ActiveMQ

   Code Block
   cd [ACTIVEMQHOME]/bin ./activemq start

9. Build
   

   1. From top of source tree

      Code Block
      mvn clean install

...