ViSUS Docker OnDemand Conversion

From
Revision as of 17:47, 15 November 2018 by Admin (talk | contribs) (How to run the Containter)
Jump to: navigation, search

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 provide 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
  • the port you want to use for the webviewer and data server
  • 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

For example:

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

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.