Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction:

This is a step-by-step guide to setup a displacement time series visualization server for a preconfigured HySDS/ARIA system. This tool enables the user to explore time-series products archived by the ARIA project by visualizing them using Leaflet Maps. It also enables the user to track explicit locations on the map by dropping markers, and graphing the data under that marker.

...

Setup:

Prerequisites:

  1. Install Terraform.

  2. If you are using AWS, make sure you have your credentials setup up.

    1. To set them up, install the AWS CLI and run aws configure.

  3. Complete setup of HySDS core with ARIA adaptation

    1. Include leaflet-ingester job

    2. Publish displacement-time-series datasets*

*If needed, follow S1-GUNW-MERGED Time Series to create datasets

Usage:

  1. Log into Mozart and clone repo

    Code Block
    mkdir ~/tss_server
    cd ~/tss_server
    git clone https://github.com/hysds/hysds-terraform.git -b leaflet_server
    cd hysds-terraform
  2. Copy the variables.tf.tmpl to variables.tf:

    Code Block
    cp variables.tf.tmpl variables.tf
    1. Initialize so plugins are installed:

    Code Block
    terraform init
  3. Update the values starting with two underscores, e.g. __region__, for your provider account and settings. Edit the variables.tf file with custom variables for this installation venue. Many of these values can be acquired from the aws console.

    Code Block
    vi variables.tf
  4. Determine the project, venue and counter for your HySDS cluster. They will be used to uniquely name and identify your cluster's resources.

    • project e.g. swot, smap, aria, grfn, eos

    • venue e.g. ops, dev, test, gerald

    • counter e.g. 1, 2, 3

  5. Validate your configuration:

    Code Block
    terraform validate --var project=aria --var venue=ops --var counter=1
  6. Build your HySDS clustser:

    Code Block
    terraform apply --var project=aria --var venue=ops --var counter=1
  7. Show status of your HySDS cluster:

    Code Block
    terraform show --var project=aria --var venue=ops --var counter=1
  8. Destroy your HySDS cluster once it's no longer needed:

    Code Block
    terraform destroy --var project=aria --var venue=ops --var counter=1

...

How to:

  1. Login into Tosca and select a displacement-time-series dataset.

  2. Click on On-Demand and select Displacement Time Series Ingest [dev] from Action list.

  3. Under hysds-io-ingest-ts:dev parameters set:

    1. thredds_data_dir to “/data/ts”

    2. leaflet_url to “https://<TS_PVT_IP>/ts/”.

      1. The TS_PVT_IP is in /home/ops/.sds/tss_config

  4. Click Process Now and wait till job is completed in Mozart

  5. Login back into Tosca and select the submitted displacement-time-series dataset. The Visualize button should now be available.

  6. Click on Visualize and enjoy the displacement-time-series visualization!

...

FAQ: