...

On this page:

...

Getting the

...

1.0.0 Beta 2 (Released July 26th, 2011)

• Download fcrepo-cloudsync-service-1.0.0-beta-2.war (15MB, md5 sha1 asc)
• Related Issues:
  • Addressed in this release
  • Outstanding (to be addressed for final 1.0.0 release)

1.0.0 Beta 1 (Released June 4th, 2011)

• Download fcrepo-cloudsync-service-1.0.0-beta-1.war (15MB, md5 sha1 asc)

Upgrade Instructions

Upgrading from 1.0.0 Beta 1 to 1.0.0. Beta 2

This upgrade just requires a straight WAR file replacement. No changes to the content of CLOUDSYNC_HOME are needed.

Upgrading will depend on the servlet container you're using. For example, if using Tomcat:

1. Stop Tomcat
2. Delete the old WAR file and the directory it expanded into, in the webapps directory.
3. Put the new WAR file in the old WAR file's place
4. Start Tomcat

...

latest version

See Downloads for the latest WAR file.

Installing CloudSync 1.0.0

Define CloudSync Home

This is the directory where CloudSync will keep all data files and logs. You have four options for defining it:

1. Don't define it. If undefined, CloudSync will create and use the .cloudsync directory in the home directory of the user the servlet container runs as. For this to work, the home directory of the servlet container user must exist.
2. Set the value of the CLOUDSYNC_HOME environment variable. If set, the directory will be created and used when CloudSync starts.
3. Set the value of the cloudsync.home system property. If set, the directory will be created and used when CloudSync starts.
4. Modify the war file (unzip it, then zip it again when finished) and modify the cloudsync.properties file in the WEB-INF/classes directory.

Configure Sufficient Memory

It is recommended that you allocate at least 128 MB of heap and 128 MB of PermGen memory for use by CloudSync when running in a dedicated servlet container. In a shared container, you should find out what these values are set to currently, and increase them by at least 128 MB each.

This can be done in a variety of ways, depending on the servlet container. In Tomcat, one way to control it is to set the CATALINA_OPTS environment variable before starting up the container.

For example, in Unix:

export CATALINA_OPTS="-Xms128m -Xmx128m -XX:MaxPermSize=128m"

In Windows:

set CATALINA_OPTS=-Xms128m -Xmx128m -XX:MaxPermSize=128m

Deploy the WAR File

CloudSync is designed to be installed in the servlet container of your choice. It has been tested with Tomcat 6.

...

CloudSync's main logfile can be found in $CLOUDSYNC_HOME/systemlogs/cloudsync.log. If you're having trouble starting or using the service, this file often contains details that will help you resolve the problem.

Upgrading from 1.0.0-beta-1 or 1.0.0-beta-2

Upgrading from one of the beta releases will require a re-installation due to significant database changes.