Versions Compared

Old Version 22

changes.mady.by.user Bill Branan

Saved on

compared with

New Version 23

changes.mady.by.user Danny Bernstein

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

As of version 2.2.0, DuraCloud requires Java 7. To determine the version of Java installed on your system, open a terminal (command prompt) and run the command "java -version". If the version number printed is less than 1.7, you will need to upgrade your Java version prior to running DuraCloud. As of version 3.3.0, DuraCloud is primarily tested using Java 8, and this is the recommended Java version for building and running DuraCloud. As of version 4.0.0, DuraCloud requires Java 8.

The steps below outline how to start up a DuraCloud instance from the binary distribution.

  1. Download the binary distribution from the downloads page
  2. Install Tomcat application server (the DuraCloud service uses Tomcat 7)
    1. Please follow Tomcat configuration detailed on the Building From Source page.
  3. Deploy the web applications
    1. Take the 3 .war files included in the binary distribution and copy them into the "webapps" directory under your tomcat installation.

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

    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 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.

  4. Log in to the application by going to http://localhost:8080/duradmin.
  5. Congratulations, you are now running DuraCloud!