Difference between revisions of "ViSUS Docker OnDemand Conversion"
From
(→How to run the Containter) |
(→How to run the Containter) |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 14: | Line 14: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | This container | + | This container provides three services: |
* the ViSUS Server | * the ViSUS Server | ||
* conversion service (i.e., currently limited to NetCDF datasets) | * conversion service (i.e., currently limited to NetCDF datasets) | ||
| Line 22: | Line 22: | ||
You need to specify few simple settings: | 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 conversion service (internal 80) |
| − | * the port you want to use for the webviewer and data server | + | * 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 | * 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 | * a folder to use for caching the multiresolution data for streaming, this will be mapped to "/data/idx" in the container | ||
| Line 35: | Line 35: | ||
# download a sample NetCDF dataset | # download a sample NetCDF dataset | ||
| − | wget https://www.dropbox.com/s/jnhptd5vswaurem/test2d.nc - | + | wget https://www.dropbox.com/s/jnhptd5vswaurem/test2d.nc -O ./nc/test2d.nc |
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 42: | Line 42: | ||
docker run -it -p 80:80 -p 42299:42299 -v $PWD/nc:/data/xml -v $PWD/idx:/data/idx visus/ondemand | docker run -it -p 80:80 -p 42299:42299 -v $PWD/nc:/data/xml -v $PWD/idx:/data/idx visus/ondemand | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| + | |||
| + | 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 == | == How to visualize your data on the server == | ||
Latest revision as of 20:52, 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 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.