ViSUS Docker OnDemand Conversion

Start your Docker and login into your account. If you don't have installed follow these instructions: Docker Documentation

To log in from your terminal:

docker login
Username: your_username
Password: XXXX

Now pull the ViSUS on-demand image:

docker pull visus/ondemand

This container provides three services:

the ViSUS Server
conversion service (i.e., currently limited to NetCDF datasets)
a simple Web viewer

How to run the Containter

You need to specify few simple settings:

the port you want to use for the conversion service (internal 80)
the port you want to use for the webviewer and data server (internal 42299)
the folder containing the files to serve/convert (i.e., NetCDF files), this will be mapped to "/data/xml" in the container
a folder to use for caching the multiresolution data for streaming, this will be mapped to "/data/idx" in the container

Quick start with some demo data:

# create directory for your input data
mkdir -p $PWD/nc
# create directory for your cache
mkdir -p $PWD/idx

# download a sample NetCDF dataset
wget https://www.dropbox.com/s/jnhptd5vswaurem/test2d.nc -O ./nc/test2d.nc

Run the container:

docker run -it -p 80:80 -p 42299:42299 -v $PWD/nc:/data/xml -v $PWD/idx:/data/idx visus/ondemand

In this run command we mapped:

port 80, used in the container for the data streaming and webviewer services
port 42299, used in the container for the NetCDF data conversion service

How to visualize your data on the server

Go to the On-demand test page: http://localhost/ondemand.php. Note: replace "localhost" with your server name and port if you are running with custom settings.

In this page you will find the list of *.nc contained in the folder you provided. You can click on the corresponding "View" button to visualize your data. Note: if the dataset has not been already converted the request could take a few second since it will be converting on-demand.