Skip to content

Latest commit

 

History

History
82 lines (72 loc) · 3.91 KB

management-console-setup.md

File metadata and controls

82 lines (72 loc) · 3.91 KB
Raw

Management Console Setup

Prerequisites

Please make sure that you have followed all of the steps laid out in the AWS Setup document before proceeding.

Deploy to Beanstalk

Create Beanstalk Environment

  1. Go to Beanstalk Service
  2. Create application
  3. Give it a name and description (e.g. Management Console)
  4. Click create web server
  5. Select "tomcat" platform and "load balancing" environment
  6. Click through defaults until you reach the configuration details and select m3.large instance, your keypair, basic health reporting, and root volume device of 30 GiB with General Purpose SSD.
  7. Select the IAM instance role you set up previously (ie management-console).
  8. Launch the environment.

Configure Environment Variables

  1. Navigate to environment -> configuration -> software configuration
  • jvm command line params: -Dduracloud.home=/tmp/duracloud-home -Dmc.config.file=s3://<your-s3-config-bucket>/path-to-duracloud-properties-file
  • environment params:
    • key: S3_CONFIG_BUCKET
    • value: <your-s3-config-bucket>

Configure Autoscaling

  1. Set min/max instance counts to 2 and 3 respectively.
  2. Under scaling trigger section:
  • Trigger measurement: CPU Utilization
  • Trigger statistic: average
  • Unit of measurement: percent
  • Measurement period: 1
  • Breach duration: 1
  • Upper threshold: 80
  • Upper breach scale: 1
  • Lower threshold: 20
  • Lower breach scale: -1

Configure Load Balancer

  1. Secure listener port: 443
  2. Navigate to "Load Balancing"
  3. Select SSL Certificate
  4. Select session stickiness
  5. Click Apply
  6. Navigate to EC2 -> load balancers
  7. Under port configuration enable "load balancer generated cookie stickiness" for ports 80 and 443.

You are now ready to deploy the DuraCloud beanstalk zip. You can do so by following the instruction in "Deploy to Production" detailed in this document.

  1. Build the latest tagged release of the management-console 
    git clone https://github.com/duracloud/management-console.git
cd management-console
mvn clean install -DskipTests -DskipIntTests -DskipDeploy
  2. Upload the account-management-app/target/ama-.war to Beanstalk (Application Versions).

Configure Management Console

Create a root user

  1. Create a user by clicking on the new user link on the management console login page.
  2. Make the newly created user a root user by logging directly into the duracloud_accounts database and runing the following command: update duracloud_user set root = true;

Configure Mill properties

  1. Login into the management console.
  2. Click on Root Console in the upper right hand corner of window.
  3. Click on DuraCloud Mill tab.
  4. Enter the requested mill database fields.
  5. Enter "auditlogs" for the Audit Log Space Id
  6. In a separate window, log into the aws console and navigate to SQS. Note the name of the queue ending in "_audit" and enter that into the DuraCloud Mill form you were just working on.
  7. Click Ok

Configure Global Properties

  1. Click on the Global Properties tab.
  2. In a separate tab go into the AWS SNS console, copy the topic ARN for the duracloud-account-topic for the topic your created in the SNS step in the AWS Setup document, and paste into the Instance Notification Topic ARN field.
  3. Retrieve your CloudFront account id, the access key id and s3 path to your CloudFront key. These values you set aside in the CloudFront Key generation step in the AWS setup document and plug them into their respecitive fields in the form.
  4. Now you are ready to start creating accounts. The first account you create should be the account that will be used to store and access your auditlogs and duplication-policy-repo, as noted in the instructions for the (duplication-policy-editor](mill-setup.md#deploy-the-duplication-policy-editor)