Skip to content

Latest commit

 

History

History
137 lines (83 loc) · 3.46 KB

readme.md

File metadata and controls

137 lines (83 loc) · 3.46 KB
Raw

Creating an ADDE VM on Jetstream

Create an ADDE VM on Jetstream

Create an m1.medium VM with the Jetstream OpenStack API. Work with Unidata system administrator staff to have this VM's IP address resolve to adde.scigw.unidata.ucar.edu.

Clone the science-gateway Repository

We will be making heavy use of the Unidata/science-gateway git repository.

git clone https://github.com/Unidata/science-gateway

Start ADDE With Docker and docker-compose

With the help of Docker and docker-compose, starting a VM with an ADDE server should be fairly easy. There are a few directories you will need to map from outside to within the container. See here to install Docker and docker-compose.

ADDE Configuration

A minor amount of configuration is required to get ADDE going.

mkdir -p ~/etc ~/mcidas/upcworkdata/ ~/mcidas/decoders/ ~/mcidas/util/
cp pqact.conf_mcidasA ~/etc
cp RESOLV.SRV ~/mcidas/upcworkdata/

LDM Data Directory from idd-archiver Via NFS

ADDE will need access to the /data/ldm/ directory from idd-archiver in order to serve data. Mount it via NFS on the 10.0. network. For example, if idd-archiver is at 10.0.0.4:

# create the NFS mount point
mkdir -p /data
mount 10.0.0.4:/data /data

Ensure /data Availability Upon Machine Restart

You will want to ensure the NFS /data volume is available with the help of fstab.

echo 10.0.0.4:/data    /data   nfs rsize=32768,wsize=32768,timeo=14,intr | tee --append /etc/fstab > /dev/null

Port 112

ADDE operates via port 112. Open port 112 on the ADDE VM via OpenStack.

docker-compose.yml

Based on the directory set we have defined, the docker-compose.yml file that looks like:

###
# McIDAS
###

version: '3'

services:
  mcidas:
    image: unidata/mcidas
    container_name: mcidas
    # restart: always
    volumes:
      # Directories outside of the container that need to be accessible
      - ~/mcidas/upcworkdata/:/home/mcidas/upcworkdata/
      - ~/mcidas/util/:/home/mcidas/util/
      - ~/mcidas/decoders/:/home/mcidas/decoders/
      - /data/ldm/pub:/data/ldm/pub/
    ports:
      - "112:112"

Note the unidata/mcidas container is closed source so is unavailable at DockerHub. Contact Unidata for more information.

Start ADDE

Once you have done the work of setting up ADDE related directories in the way you like,

docker-compose up -d

to start ADDE.

Access ADDE from the IDV

To verify all is in order, access this ADDE server from the Unidata IDV by pointing to the adde.scigw.unidata.ucar.edu server in the Image Data Chooser.