This page last changed on Oct 30, 2011 by bbranan.

Introduction

The Upload Tool is a graphical utility which is used to transfer files from your local file system to DuraCloud. The Upload Tool can be run two ways:

  1. By selecting the option to upload many items into a space on the DuraCloud UI. This will open a new window and display the Upload Tool.
  2. By downloading the Upload Tool (see below) and running it on your own machine (or any other machine you copy it to.)

Regardless of which method you choose for running the Upload Tool, the functions will be the same. You will be able to select files and folders to be uploaded, then once the upload has started, you will see the progress of the upload.

Download

Download the upload tool from the Downloads page.

Operational notes

  • When starting the downloaded version of the Upload Tool, you will first be asked for some information necessary to connect to DuraCloud. The username and password required are those you would use to log into DuraCloud. The Space ID value is the space into which you would like the uploaded files to go. There is no need to enter any of this information when running the Upload Tool from the DuraCloud UI.
  • When the Upload Tool starts running, it checks to see if any of the files you have selected already exist in the space. It does this by checking for files with the same name. Any name matches trigger a checksum verification to determine if the files differ. If the files are different, the file being uploaded will overwrite the file in the space. If the files are found to be the same, no transfer occurs.

Prerequisites

  • You must have Java version 6 or above installed on your local system. If Java is not installed, you will need to download and install it. To determine if the correct version of Java is installed, open a terminal or command prompt and enter
    java -version
    The version displayed should be 1.6.0 or above. If running this command generates an error, Java is likely not installed.

Using the Sync Tool

  • To start the Upload Tool from the DuraCloud UI, simply navigate to the space you would like to upload files to, and select the "Add Many Items" button.
  • To start the downloaded Upload Tool, you can either simply double-click the downloaded file or execute the file from the command line.
    • To execute the Upload Tool via the command line, enter:
      java -jar uploadtool-{version}-driver.jar
    • If you choose to execute the Upload Tool via the command line, you have the option of providing connection parameters on the command line as well. If you enter these values on the command line, the first screen of the Upload Tool will be skipped. The connection parameters must be entered on the command line in this order (all values are required): host port username password spaceID. An example of running the upload tool using these parameters:
      java -jar uploadtool-{version}-driver.jar institution.duracloud.org 443 jsmith secretPassword myContent
Document generated by Confluence on Dec 14, 2011 18:53