This article describes the necessary steps for configuring and running the DuraCloud Management Console. The Management Console is a web application that enables users to manage DuraCloud account and user information as well as global configuration settings for a DuraCloud installation. More information about the capabilities of the DuraCloud Management Console is available here.
If you are not yet familiar with the DuraCloud Management Console please refer to the DuraCloud Architecture document, which describes how the Management Console fits into the DuraCloud ecosystem.
...
To start, clone and build the latest release of the millmanagement console
Code Block git clone https://github.com/duracloud/management-console.git cd management-console git checkout duracloud-mc-3.0.0 mvn clean install
- Create the empty management console database, add credentials and than create the schema using management-console/resources/schema.sql (found in the management-console code baseline.)
- Execute the management-console/resources/add-root-user.sql to add a root user account, changing the default username and/or password as you wish.
- Create a configuration file.
- Now that you've built the mill management console and created the database, we need to set up a configuration file that can be used by the various components of the system. A template of this configuration file can be found in the code at mill/resources/mill-config-sampleaccount-management-app/src/main/webapp/WEB-INF/config/mc-config.properties
- Copy and rename the file to mill-config.propertiesa permanent location
Configure the database connections to the mill database as well as the management console database and AWS (for notifications):
Code Block ################### # MC DATABASE ################### # Config for the management console database - used to retrieve accounts and storage provider credentials db.host=[fill in] db.port=[fill in] db.name=[fill in] # User must have read permission db.user=[fill in] db.pass=[fill in] mc.host=<hostname> mc.port=443 mc.context=<e.g. /ama> # leave blank if the mc is deployed in the root context. notification.user=<aws access key id> notification.pass=<aws secret key> notification.from-address=<email address> notification.admin-address=<admin email address>
- Now that you've built the mill management console and created the database, we need to set up a configuration file that can be used by the various components of the system. A template of this configuration file can be found in the code at mill/resources/mill-config-sampleaccount-management-app/src/main/webapp/WEB-INF/config/mc-config.properties
Create an SNS topic
Log into the AWS account associated with the Management Console application.
- In SNS add a topic.
- Ensure that the AWS credentials associated with the Management Console has permission to publish to that topic.
Goto into In a web browser, go to https://<yourhost>/<context>
- Click on "Create New User" under the login form.
- Create a new user (this will be your root user).
- Verify that you can log in with your new user. You will not have access to any accounts yet.
- Edit management-console/resources/sql/make-user-root.sql by replacing the text 'your-root-username-here' with the username you just created.
- Login with your new root credentials.the user you created
- Click on Root Console link in the upper right corner.
- Click on Global Properties
- Click Edit, enter the ARN of the topic you created above as well as the CloudFront settings and click save.
- NB: the CloudFront key path can refer to an s3 url: ie s3://<bucket>/path/to/item.
- Also be sure that the AWS credentials have access to the specified bucket.
- Click DuraCloud Mill tab and enter the appropriate settings.
- Create an account via the Accounts tab.
Related articles
Content by Label | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
hidden | true |
---|
...