Introduction
The Stitcher Tool is a utility which provides a simple way to retrieve "chunked" files from DuraCloud. When files are moved to DuraCloud using either the Chunker Tool or the Sync Tool and they exceed a defined size limit, they are split (chunked) into multiple files for transfer. The Stitcher tool provides the means by which those files can be retrieved and combined to result in the original file. It should be noted that the Stitcher Tool is also embedded into the Retrieval Tool. If you are using Retrieval Tool, stitching will be automatically performed.
Download
Download the Stitcher Tool from the Downloads page.
Operational notes
If you want to jump directly into using the tool, download it from the link above and run the following command
java -jar stitch-{version}-driver.jar
The resulting usage statement (detailed below) should be enough to help you get started.
- When using the Stitcher Tool, you need to know the ID of the manifest which was generated to list all of the chunks of the original file. If the chunking was done by either the Chunker or Sync tool, then the name of the manifest is the name of the original file (prefixed with any enclosing directory names) followed by ".dura-manifest".
Prerequisites
As of DuraCloud version 2.2.0, the Stitcher Tool requires Java 7 to run. The latest version of Java can be downloaded from here.
You must have Java version 7 or above installed on your local system. If Java is not installed, or if a previous version is installed, you will need to download and install Java 7. 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.7.0 or above. If running this command generates an error, Java is likely not installed.
- You must have downloaded the Stitcher Tool. It is available as a link near the top of this page.
Using the Stitcher Tool
- To run the Stitcher Tool, open a terminal or command prompt and navigate to the directory where the Stitcher Tool is located and run the above command.
The following options are available when running the Stitcher Tool
Short Option
Long Option
Argument Expected
Required
Description
Default Value (if optional)
-m
--manifest-id
Yes
Yes
The ID of the manifest file used to contain the listing of content chunks
-d
--to-dir
Yes
Yes
Retrieved and stitched content is stored in this local directory
-s
--space-id
Yes
Yes
The space ID in which content and manifest files reside
-i
--store-id
Yes
No
The store ID for the DuraCloud storage provider
The default store is used
-h
--host
Yes
Yes
The host address of the DuraCloud instance
-r
--port
Yes
No
The port of the DuraCloud instance
443
-u
--username
Yes
Yes
The username necessary to perform writes to DuraCloud
-p
--password
Yes
Yes
The password necessary to perform writes to DuraCloud