Page History

...

1. Download the binary distribution from the downloads page
2. Install Tomcat application server (versions 5.5.x and 6.0.x are known to work)the DuraCloud service uses Tomcat 8)
   
   1. Please follow Tomcat configuration detailed on the Building From Source page.
3. Deploy the web applications
   
   1. Take the 4 3 .war files included in the binary distribution and copy them into the "webapps" directory under your tomcat installation.
      1. You may need to remove the "ROOT" directory under webapps in order for the ROOT.war to deploy properly

   2. Start tomcat, as part of the startup process, tomcat will unpack the wars and deploy them

4. Start up the OSGi container
   1. Unpack the osgi-container zip file from the distribution package
   2. Create an empty directory which will serve as the execution directory for the services
   3. Create a BUNDLE_HOME environment variable pointing at the full path to the new execution directory
   4. From a command prompt, step down into the runner directory under the unpacked osgi-container directory

   5. Make the run.sh script executable

      No Format
      chmod +x run.sh

   6. execute run.sh
      • Note: Errors of the type "ClassNotFoundException: org.apache.jasper.servlet.JspServlet" can be safely ignored
   7. Wait a few moments for startup to complete. Then hit enter to get a prompt and type "ss". You should see a list of 50 bundles which are in either the ACTIVE or RESOLVED states.
5. Initialize the DuraCloud applications
   1. Open the init.properties file found in the distribution package
   2. Edit the values that are contained in brackets "[...]" to be appropriate for your environment. This is the step where most problems tend to show up, so feel free to ask questions regarding what values need to be included in this file.
   3. A few notes on editing this file:
      • The value of [host] will almost certainly be: localhost
      • You will need to have your own Amazon S3 account in order to connect. The "username" and "password" in the init.properties file, in the case of Amazon, refer to the Access Key ID and the Private Access Key that are used to make API connections to Amazon Web Services.
      • You probably want to comment out (using '#') the section starting with 'durastore.storage-acct.1', unless you also want to create a Rackspace CloudFiles account.

      • The version number below is currently, 2.2.0

        No Format
        duraservice.primary-instance.services-admin-context=org.duracloud.services.admin_[VERSION]

      • Even though they are not in brackets, you will probably want to update the values of duraservice.service-storage.space-id and duraservice.service-storage.service-xml-id. I'd recommend these values:

        Code Block
        duraservice.service-storage.space-id=duracloud-2-2-0-service-repo duraservice.service-storage.service-xml-id=duracloud-2-2-0-service-repo.xml

      • The security user settings at the bottom allow you to indicate the username and password users accounts that can access your local DuraCloud, you'll use these credentials to log in to DuraCloud after initialization

   4. Execute the app-config jar, passing in the init.properties file as a parameter

      Code Block
      java -jar app-config.jar init.properties

   5. The very last line of output from the execution of the app-config process should be "success". If that's not the case, look at the output more closely to determine what error may have occurred.
6. Add servicesAt this point, the applications are deployed and initialized. Point your browser to Log in to the application by going to http://localhost:8080/duradmin and log in to DurAdmin.
7. On the spaces tab, create a space called: duracloud-2-2-0-service-repo (assuming you took the naming suggestions above)
8. Use the Add Items button to add all of the files included under the services directory in the distribution package to this new space.

...

1. Congratulations, you are now running DuraCloud!