Skip to content

Latest commit

 

History

History
145 lines (90 loc) · 3.23 KB

readme.md

File metadata and controls

145 lines (90 loc) · 3.23 KB
Raw

Creating an IDD Relay VM on Jetstream

Create an IDD Relay 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 idd-relay.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 IDD Relay With Docker and docker-compose

With the help of Docker and docker-compose, starting a VM containing an IDD relay is simple. There are a few directories you will need to map from outside to within the container. See here to install Docker and docker-compose.

~/etc Directory

This ~/etc directory will contain your LDM configuration files.

mkdir -p ~/etc
cp ~/science-gateway/vms/idd-relay/etc/* ~/etc/

You may have to tailor the ldmd.conf to your data feed requirements. Also edit the registry.xml file to update the hostname element so that Real-Time IDD Statistics can be properly reported. Finally, you may have to adjust the size of the queue currently at 10GBs.

~/queues Directory

This ~/queues directory will contain the LDM queue file.

mkdir -p ~/queues

/logs Directory

Create the LDM logs directory.

mkdir -p /logs/ldm

Port 388

Open LDM port 388 so that this VM may function as an IDD relay node.

docker-compose.yml

Based on the directory set we have defined, the docker-compose.yml file will look something like:

###
# LDM
###
version: '3'

services:
  ldm:
    image: unidata/ldm-docker:6.14.5
    container_name: ldm
    restart: always
    volumes:
      - ~/etc/:/home/ldm/etc/
      - ~/queues:/home/ldm/var/queues/
      - ~/logs/ldm/:/home/ldm/var/logs/
    ports:
      - "388:388"
    ulimits:
      nofile:
        soft: 1024
        hard: 1024
    env_file:
      - "compose.env"

LDM Environment Variable Parameterization

You can provide additional LDM parameterization via the compose.env file referenced in the docker-compose.yml file.

# https://github.com/Unidata/ldm-docker#configurable-ldm-uid-and-gid

LDM_USER_ID=1000

LDM_GROUP_ID=1000

Start the IDD Relay Node

To start the IDD relay node:

# wherever you cloned the repo above
cd ~/science-gateway/vms/idd-relay/
docker-compose up -d