Difference between revisions of "ViSUS Docker OnDemand Conversion"

From
Jump to: navigation, search
(How to request on-demand conversion of a NetCDF dataset)
Line 18: Line 18:
 
* conversion service (i.e., currently limited to NetCDF datasets)
 
* conversion service (i.e., currently limited to NetCDF datasets)
 
* a simple Web viewer  
 
* 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
 +
 +
For example:
 +
<syntaxhighlight lang="bash">
 +
docker run -it -p 80:80 -p 42299:42299 -v $PWD/nc:/data/xml -v $PWD/idx:/data/idx visus/ondemand
 +
</syntaxhighlight>
  
 
== How to request conversion of a NetCDF dataset ==
 
== How to request conversion of a NetCDF dataset ==
 +
 +
Go to the On-demand Conversion test page: [http://localhost/ondemand.php 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.

Revision as of 17:26, 15 November 2018

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

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 request conversion of a NetCDF dataset

Go to the On-demand Conversion 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.