...
The purpose of the Bridge Report Capture Tool is to retrieve a status report from the DuraCloud Bridge application (in JSON format) and store that report in an S3 bucket. To accomplish this, the tool can be run in one of two modes. The first mode (Properties Mode) requires that all parameters be provided, and these parameters are written to a properties file (with encrypted values where necessary.) The second mode (Capture Mode) takes only the -f parameter to specify the properties file. It is the second mode in which calls are made to the bridge app to retrieve a report and store that report in S3. Properties Mode is run to create the properties file used to execute Capture Mode.
Command Line Options
Short Option | Long Option | Argument Expected | Properties Mode | Capture Mode | Description |
---|---|---|---|---|---|
-f | --props-file | Yes | Yes | Yes | The full path to a properties file. In capture mode, this file must exist. In Properties Mode, if the file exists, it will be overwritten. |
-r | --bridge-url | Yes | Yes | No | The URL at which the bridge application report can be retrieved. This must be the full URL, a GET call is made to the exact value provided to this parameter. |
-u | --bridge-username | Yes | Yes | No | The username necessary to read from the bridge application |
-p | --bridge-password | Yes | Yes | No | The password necessary to read from the bridge application |
-a | --s3-access-key | Yes | Yes | No | The AWS access key ID needed to write to the S3 bucket |
-s | --s3-secret-key | Yes | Yes | No | The AWS secret access key needed to write to the S3 bucket |
-b | --s3-bucket-name | Yes | Yes | No | The S3 bucket in which the bridge reports are to be written |
Example Usage
Properties Mode
Code Block |
---|
java -jar bridge-report-capture-tool-1.0.0-driver.jar -f bridge-report-capture.properties -r "https://bridge.server.com/bridge/snapshot" -u bridgeUser -p bridgePa55word -a ANS3ACCESSKEY -s "the-s3-secret-key-value" -b bridge-report-bucket |
Capture Mode
Code Block |
---|
java -jar bridge-report-capture-tool-1.0.0-driver.jar -f bridge-report-capture.properties |
Prefix Update Tool
...
Short Option | Long Option | Argument Expected | Required | Description | Default Value (if optional) |
---|---|---|---|---|---|
-h | --host | Yes | Yes | The host address of the DuraCloud DuraStore application |
|
-s | --space-id | Yes | Yes | The ID of the DuraCloud space where content will be stored |
|
-u | --username | Yes | Yes | The username necessary to connect to DuraCloud | |
-p | --password | Yes | Yes | The password necessary to perform writes to DuraStore |
|
-r | --port | Yes | No | The port of the DuraCloud DuraStore application | 443 |
-i | --store-id | Yes | No | The Store ID for the DuraCloud storage provider | The primary storage provider is used |
-o | --old-prefix | Yes | Yes | The prefix value that is to be replaced. Use "" to match all content items (if adding a prefix to all content items in a space is desired.) | |
-n
| --new-prefix | Yes | Yes | The prefix value that will be applied to all content items matching the old prefix. Use "" to simply remove the old prefix. |
|
-d | --dry-run | No | No | Indicates that no changes should be made to DuraCloud, but that the changes which would be made should be printed to the console. This allows you to see what the tool would do without changing anything. |
Example Usage
Code Block |
---|
java -jar prefixupdatetool-1.0.0-driver.jar -h institution.duracloud.org -s my-favorite-space -o C:/bobsfiles/Fall 2002 notes/ -n robert/notes/2002-fall/ -u [username] -p [password] |
...