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.