Table of Contents |
---|
Prerequisites
To set up this application we will assume that you have the following tools installed on the target instance:
- git
- Maven 3+
- Tomcat7 (with the manager turned on)
- Mysql 5.5+
Download and build the source code
You can download the source from https://github.com/duracloud/snapshot.
Code Block |
---|
git clone https://github.com/duracloud/snapshot.git |
Setup Bridge Root Directory
The application needs a directory of sufficient size (depending on your expected load) for storing application state files as well as receiving space data both from the DPN node as well as from DuraCloud. The tomcat user must have read/write access to the directory.
Create log directory
The bridge application will attempt to write logs to /var/log/duracloud. To make this possible, create that directory, and set permissions to allow the bridge application to write to it.
Code Block |
---|
sudo mkdir /var/log/duracloud sudo chown tomcat7 /var/log/duracloud |
Setup Tomcat
- Set up tomcat server credentials for automatic deployment on build
in your settings.xml file (~/.m2/settings.xml) add the following to the servers element:
Code Block <server> <id>tomcat-server</id> <username>tomcat</username> <password>password</password> </server>
Set up environment variables
These variables are picked up by the application:
...
Code Block |
---|
JAVA_OPTS="$JAVA_OPTS -Dduracloud.bridge.root.username=<your username> -Dduracloud.bridge.root.password=<your password> -Dduracloud.bridge.root.email=<your email> -Dduracloud.bridge.root.dir=<your root dir>" |
Build and deploy the source
Run a build of the Bridge software, which will perform a deployment. Alternatively, perform the build and copy the generated WAR file to your Tomcat webapps directory.
Code Block |
---|
cd snapshot mvn clean install |
Create the database
Using a mysql client create a database:
...
Code Block |
---|
mysql --user [username] --password [password] snapshot --execute set @saved_cs_client='utf8'; source snapshot_create-mysql.sql; |
Create a DuraCloud User
You will need to create a duracloud user with ROLE_ADMIN permissions in order for the bridge to read data from and write data to DuraCloud. This can be done by your DuraCloud account administrator through https://manage.duracloud.org/
Initialize the application
First you'll need to create an init.json file using the values you setup in previous steps. See the Bridge App REST API for a copy of the init JSON file.
...
NB: Ensure that the "clean" parameter is set to false.
Reinitializing
If you wish to change any of your initialization parameters, you must first remove the persistent initialization params on the server by deleting the following file:
...