The ViSUS Data Portal allows to easily configure your data on the server, convert data to a data-streaming friendly format and visualize them directly from your browser.
The ViSUS Data Portal is deployed as a Docker container. Here is how to get started.

== Quick start ==

Start your Docker and login into your account.
If you don't have installed follow these instructions: [https://docs.docker.com Docker Documentation]

Now pull the ViSUS image:
<syntaxhighlight lang="bash">
docker pull visus/dataportal
</syntaxhighlight>

This image contains:
* the ViSUS Server
* configuration files (see [[ViSUS configuration file]])
* a simple 2D/3D web viewer
* some tools to convert data (see [[ViSUS Convert]]).

The goal of the data portal is to allow to use all of the above tools from a web interface, so all you have to do is just run the container with
<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 visus/dataportal
</syntaxhighlight>

and point your browser to that same port (8080) on your host, as following:
URL: http://localhost:8080

[[File:Home.png|center|600px]]

From the main navigation bar you can reach three different areas that will be presented in the next sections.

'''Note''': the default credentials are: username=''admin'', password=''password''.

[[File:Login.png|center|400px]]

=== Configure Server ===
From here you can visualize and edit the list of the datasets that you are serving through this server. Those can be both remote datasets (i.e., with a web URL as in the case of the default dataset BlueMarble) or local (i.e., pointing to an actual file hosted on the server).

The name of the dataset is colored in red or green to show you if that dataset is ready for streaming or not.
To update the server you can click the "Update Server" button to trigger a reload of the datasets (metadata) on the server.

[[File:Configure.png|center|600px]]

=== Manage Data ===

Currently the data portal provides interface to convert single or stack of image (or raw) data.

[[File:Convert.png|center|600px]]

From the Browse button the user can open the file manager to select a file (or a folder) to convert. The user can also drop new file in the window, and those will be uploaded on the server.
'''Note''': if you are converting a stack of images put all (and only) the images you want to stack into a volume in the same folder.

[[File:File_manager.png|center|600px]]

The conversion process will try to estimate the size and datatype and automatically fill up the conversion parameters for you (i.e., size and datatype). The user can eventually customize those and run the conversion with the "Convert" button.

When a conversion process is launched a new entry in the conversion history will show up. This history allows the user to monitor the conversion processes taking place on the server and visualize the corresponding logs.
From this list is possible to add the converted (or still converting) dataset to the server using the "Add to server" button.

[[File:Chistory.png|center|600px]]

=== Explore Data ===

From here you can visualize the data using the [[ViSUS_WebViewer | Web Viewer]].

[[File:Hearth.png|center|500px]]

== Advanced ==
=== DataPortal internal settings ===

Some internal settings can be customized using a configuration file (i.e., ''local.php''), that can be mounted when you run your docker as following:

<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 -v my_local.php:/home/visus/dataportal/local.php visus/dataportal
</syntaxhighlight>

The ''local.php'' file looks like the following:
<syntaxhighlight lang="php">
<?php
// Admin credentials for this server
$admin_user="admin";
$admin_password="password";

// mod_visus_url
$mod_visus_url="http://localhost:8080/mod_visus?";

/**** DO NOT CHANGE THE REST ****/
// Default server config file location (on the server's filesystem)
$default_config_file="/home/visus/visus.config";

// Data directory
$data_dir="/data";

// visus executable
$visus_exe="/usr/local/lib/python3.5/dist-packages/OpenVisus/bin/visus";
?>
</syntaxhighlight>

=== Use persistant storage for your data ===

If you want to use your local data directly on the data portal and keep the converted multiresolution data available anytime you run your container you might want to mount this folder to the data portal data folder (''/data'') as following:

<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 -v /my/data/folder:/data visus/dataportal
</syntaxhighlight>

File:Hearth.png

2019-01-30T21:12:10Z

Admin: Admin uploaded a new version of File:Hearth.png

File:Convert.png

2019-01-30T21:10:07Z

Admin: Admin uploaded a new version of File:Convert.png

2019-01-23T18:00:41Z

Admin:

ViSUS Docker Deployment

2019-01-23T17:55:46Z

Admin: /* Content of the image */

== Quick start ==

Start your Docker and login into your account.
If you don't have installed follow these instructions: [https://docs.docker.com Docker Documentation]

To log in from your terminal:
<syntaxhighlight lang="bash">
docker login
Username: your_username
Password: XXXX
</syntaxhighlight>

Now pull the ViSUS image:
<syntaxhighlight lang="bash">
docker pull visus/visus
</syntaxhighlight>

This image contains:
* the ViSUS Server
* configuration files (see [[ViSUS configuration file]])
* a simple 2D web viewer
* some tools to convert data (see [[ViSUS Convert]]).

Run the image:
<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 visus/visus
</syntaxhighlight>

Check if the server is running:
<syntaxhighlight lang="bash">
curl -v "http://localhost:8080/mod_visus?action=list"
</syntaxhighlight>

You will get a list of the current datasets on the server.

=== Content of the image ===

This image contains folders with configuration files and utilities.
The folders of interest are under /visus:
* '''config''', it contains the visus server.config (see [[ViSUS configuration file]])
* '''apache2''', it contains the apache2 config files that you can use for security settings (see [[ViSUS Server]])
* '''visus''', it contains visus tool (see [[ViSUS Convert]]) to convert data to IDX format

The user can map those folders locally and edit them adding a volume (with the Docker parameter ''-v''):

<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 -v /path/local_directory:/data/folder_in_container visus/visus
</syntaxhighlight>

when you run you docker image.

=== How to customize the list of datasets on your server ===
The list of dataset that the server exposes are contained in the [[ViSUS configuration file]].

If you have already a [[ViSUS configuration file]] that you want to use, you can run the container as following:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v $PWD/config:/visus/config visus/visus
</syntaxhighlight>

and edit the '''visus.config''' file (see [[ViSUS configuration file]]).

'''Note''': The server needs to be able to read and write the configuration file, so make sure that your ''server.config'' has the right privileges. For example:
<syntaxhighlight lang="bash">
chmod 766 /path/to/your/server.config
</syntaxhighlight>

Making the configuration file writable will allow to add datasets dynamically using the action ''add_dataset'' (see [[ViSUS Server]]).

If you also want to customize the apache security (e.g. change the users) you can run the command to mount also the apache2 directory as following:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v $PWD/config:/visus/config -v $PWD/apache2:/visus/apache2 visus/visus
</syntaxhighlight>

=== Convert your data to IDX using the Docker deployment tools ===

The ViSUS tools executables (see [[ViSUS Convert]]) are contained in the container under <code>/usr/local/visus/bin</code>.

For example, if you want to use the tools to convert a raw dataset using your docker deployment you can do it as follow.

Mount a folder that contains your ''raw'' data and your converted ''idx'' data as follow:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v /full/path/to/your/raw/:/home/visus/datasets/raw -v /full/path/to/your/idx/:/home/visus/datasets/idx visus/visus
</syntaxhighlight>

Check that your container is running correctly (using <code>docker ps</code>) and take note of the ''Container ID''.

Now run a bash session on this container using:
<syntaxhighlight lang="bash">
docker exec -it <id_from_docker_ps> /bin/bash
</syntaxhighlight>

From this bash session you can use your ViSUS converter to convert your data (just mounted in the container) as described in [[ViSUS Convert]].

=== Preview your data with the Web Viewer ===

You can preview and navigate you data on the server using the webviewer using your browser at the URL: http://localhost:8080

Here is a picture of the viewer:
[[File:2dwebviewer.png|300px]]

With the commands on the bottom bar you can:
* change server
* set a slice (if using a 3D dataset)
* set a timestep
* set palettes and min-max range
* choose a field of the selected dataset

== ViSUS Server for NetCDF data ==

An addition on-demand conversion service for NetCDF datasets is available in the "ondemand" Docker container.

To try it, pull the ViSUS on-demand image:
<syntaxhighlight lang="bash">
docker pull visus/ondemand
</syntaxhighlight>

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:
<syntaxhighlight lang="bash">
# 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
</syntaxhighlight>

Run the container:
<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>

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

=== Visualize/convert your data on the server ===

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

ViSUS Docker Deployment

2019-01-23T17:55:18Z

Admin: /* How to customize the list of datasets on your server */

== Quick start ==

Start your Docker and login into your account.
If you don't have installed follow these instructions: [https://docs.docker.com Docker Documentation]

To log in from your terminal:
<syntaxhighlight lang="bash">
docker login
Username: your_username
Password: XXXX
</syntaxhighlight>

Now pull the ViSUS image:
<syntaxhighlight lang="bash">
docker pull visus/visus
</syntaxhighlight>

This image contains:
* the ViSUS Server
* configuration files (see [[ViSUS configuration file]])
* a simple 2D web viewer
* some tools to convert data (see [[ViSUS Convert]]).

Run the image:
<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 visus/visus
</syntaxhighlight>

Check if the server is running:
<syntaxhighlight lang="bash">
curl -v "http://localhost:8080/mod_visus?action=list"
</syntaxhighlight>

You will get a list of the current datasets on the server.

=== Content of the image ===

This image contains folders with configuration files and utilities.
The folders of interest are under /visus:
* '''config''', it contains the visus server.config (see [[ViSUS configuration file]])
* '''apache2''', it contains the apache2 config files that you can use for security settings (see [[ViSUS Server]])
* '''visus''', it contains visus tool (see [[ViSUS Convert]]) to convert data to IDX format

The user can map those folders locally and edit them adding a volume (with the Docker parameter ''-v''):

<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 -v /path/local_directory:/data visus/dataportal
</syntaxhighlight>

when you run you docker image.

=== How to customize the list of datasets on your server ===
The list of dataset that the server exposes are contained in the [[ViSUS configuration file]].

If you have already a [[ViSUS configuration file]] that you want to use, you can run the container as following:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v $PWD/config:/visus/config visus/visus
</syntaxhighlight>

and edit the '''visus.config''' file (see [[ViSUS configuration file]]).

'''Note''': The server needs to be able to read and write the configuration file, so make sure that your ''server.config'' has the right privileges. For example:
<syntaxhighlight lang="bash">
chmod 766 /path/to/your/server.config
</syntaxhighlight>

Making the configuration file writable will allow to add datasets dynamically using the action ''add_dataset'' (see [[ViSUS Server]]).

If you also want to customize the apache security (e.g. change the users) you can run the command to mount also the apache2 directory as following:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v $PWD/config:/visus/config -v $PWD/apache2:/visus/apache2 visus/visus
</syntaxhighlight>

=== Convert your data to IDX using the Docker deployment tools ===

The ViSUS tools executables (see [[ViSUS Convert]]) are contained in the container under <code>/usr/local/visus/bin</code>.

For example, if you want to use the tools to convert a raw dataset using your docker deployment you can do it as follow.

Mount a folder that contains your ''raw'' data and your converted ''idx'' data as follow:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v /full/path/to/your/raw/:/home/visus/datasets/raw -v /full/path/to/your/idx/:/home/visus/datasets/idx visus/visus
</syntaxhighlight>

Check that your container is running correctly (using <code>docker ps</code>) and take note of the ''Container ID''.

Now run a bash session on this container using:
<syntaxhighlight lang="bash">
docker exec -it <id_from_docker_ps> /bin/bash
</syntaxhighlight>

From this bash session you can use your ViSUS converter to convert your data (just mounted in the container) as described in [[ViSUS Convert]].

=== Preview your data with the Web Viewer ===

You can preview and navigate you data on the server using the webviewer using your browser at the URL: http://localhost:8080

Here is a picture of the viewer:
[[File:2dwebviewer.png|300px]]

With the commands on the bottom bar you can:
* change server
* set a slice (if using a 3D dataset)
* set a timestep
* set palettes and min-max range
* choose a field of the selected dataset

== ViSUS Server for NetCDF data ==

An addition on-demand conversion service for NetCDF datasets is available in the "ondemand" Docker container.

To try it, pull the ViSUS on-demand image:
<syntaxhighlight lang="bash">
docker pull visus/ondemand
</syntaxhighlight>

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:
<syntaxhighlight lang="bash">
# 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
</syntaxhighlight>

Run the container:
<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>

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

=== Visualize/convert your data on the server ===

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

ViSUS Docker Deployment

2019-01-23T17:55:05Z

Admin: /* How to customize the list of datasets on your server */

== Quick start ==

Start your Docker and login into your account.
If you don't have installed follow these instructions: [https://docs.docker.com Docker Documentation]

To log in from your terminal:
<syntaxhighlight lang="bash">
docker login
Username: your_username
Password: XXXX
</syntaxhighlight>

Now pull the ViSUS image:
<syntaxhighlight lang="bash">
docker pull visus/visus
</syntaxhighlight>

This image contains:
* the ViSUS Server
* configuration files (see [[ViSUS configuration file]])
* a simple 2D web viewer
* some tools to convert data (see [[ViSUS Convert]]).

Run the image:
<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 visus/visus
</syntaxhighlight>

Check if the server is running:
<syntaxhighlight lang="bash">
curl -v "http://localhost:8080/mod_visus?action=list"
</syntaxhighlight>

You will get a list of the current datasets on the server.

=== Content of the image ===

This image contains folders with configuration files and utilities.
The folders of interest are under /visus:
* '''config''', it contains the visus server.config (see [[ViSUS configuration file]])
* '''apache2''', it contains the apache2 config files that you can use for security settings (see [[ViSUS Server]])
* '''visus''', it contains visus tool (see [[ViSUS Convert]]) to convert data to IDX format

The user can map those folders locally and edit them adding a volume (with the Docker parameter ''-v''):

<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 -v /path/local_directory:/data visus/dataportal
</syntaxhighlight>

when you run you docker image.

=== How to customize the list of datasets on your server ===
The list of dataset that the server exposes are contained in the [[ViSUS configuration file]].

If you have already a [[ViSUS configuration file]] that you want to use, you can run the container as following:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v $PWD/config:/visus/config visus/dataportal
</syntaxhighlight>

and edit the '''visus.config''' file (see [[ViSUS configuration file]]).

'''Note''': The server needs to be able to read and write the configuration file, so make sure that your ''server.config'' has the right privileges. For example:
<syntaxhighlight lang="bash">
chmod 766 /path/to/your/server.config
</syntaxhighlight>

Making the configuration file writable will allow to add datasets dynamically using the action ''add_dataset'' (see [[ViSUS Server]]).

If you also want to customize the apache security (e.g. change the users) you can run the command to mount also the apache2 directory as following:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v $PWD/config:/visus/config -v $PWD/apache2:/visus/apache2 visus/visus
</syntaxhighlight>

=== Convert your data to IDX using the Docker deployment tools ===

The ViSUS tools executables (see [[ViSUS Convert]]) are contained in the container under <code>/usr/local/visus/bin</code>.

For example, if you want to use the tools to convert a raw dataset using your docker deployment you can do it as follow.

Mount a folder that contains your ''raw'' data and your converted ''idx'' data as follow:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v /full/path/to/your/raw/:/home/visus/datasets/raw -v /full/path/to/your/idx/:/home/visus/datasets/idx visus/visus
</syntaxhighlight>

Check that your container is running correctly (using <code>docker ps</code>) and take note of the ''Container ID''.

Now run a bash session on this container using:
<syntaxhighlight lang="bash">
docker exec -it <id_from_docker_ps> /bin/bash
</syntaxhighlight>

From this bash session you can use your ViSUS converter to convert your data (just mounted in the container) as described in [[ViSUS Convert]].

=== Preview your data with the Web Viewer ===

You can preview and navigate you data on the server using the webviewer using your browser at the URL: http://localhost:8080

Here is a picture of the viewer:
[[File:2dwebviewer.png|300px]]

With the commands on the bottom bar you can:
* change server
* set a slice (if using a 3D dataset)
* set a timestep
* set palettes and min-max range
* choose a field of the selected dataset

== ViSUS Server for NetCDF data ==

An addition on-demand conversion service for NetCDF datasets is available in the "ondemand" Docker container.

To try it, pull the ViSUS on-demand image:
<syntaxhighlight lang="bash">
docker pull visus/ondemand
</syntaxhighlight>

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:
<syntaxhighlight lang="bash">
# 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
</syntaxhighlight>

Run the container:
<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>

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

=== Visualize/convert your data on the server ===

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

ViSUS Docker Deployment

2019-01-23T17:54:53Z

Admin: /* Content of the image */

== Quick start ==

Start your Docker and login into your account.
If you don't have installed follow these instructions: [https://docs.docker.com Docker Documentation]

To log in from your terminal:
<syntaxhighlight lang="bash">
docker login
Username: your_username
Password: XXXX
</syntaxhighlight>

Now pull the ViSUS image:
<syntaxhighlight lang="bash">
docker pull visus/visus
</syntaxhighlight>

This image contains:
* the ViSUS Server
* configuration files (see [[ViSUS configuration file]])
* a simple 2D web viewer
* some tools to convert data (see [[ViSUS Convert]]).

Run the image:
<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 visus/visus
</syntaxhighlight>

Check if the server is running:
<syntaxhighlight lang="bash">
curl -v "http://localhost:8080/mod_visus?action=list"
</syntaxhighlight>

You will get a list of the current datasets on the server.

=== Content of the image ===

This image contains folders with configuration files and utilities.
The folders of interest are under /visus:
* '''config''', it contains the visus server.config (see [[ViSUS configuration file]])
* '''apache2''', it contains the apache2 config files that you can use for security settings (see [[ViSUS Server]])
* '''visus''', it contains visus tool (see [[ViSUS Convert]]) to convert data to IDX format

The user can map those folders locally and edit them adding a volume (with the Docker parameter ''-v''):

<syntaxhighlight lang="bash">
docker run -it --rm -p 8080:80 -v /path/local_directory:/data visus/dataportal
</syntaxhighlight>

when you run you docker image.

=== How to customize the list of datasets on your server ===
The list of dataset that the server exposes are contained in the [[ViSUS configuration file]].

If you have already a [[ViSUS configuration file]] that you want to use, you can run the container as following:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v $PWD/config:/visus/config visus/visus
</syntaxhighlight>

and edit the '''visus.config''' file (see [[ViSUS configuration file]]).

'''Note''': The server needs to be able to read and write the configuration file, so make sure that your ''server.config'' has the right privileges. For example:
<syntaxhighlight lang="bash">
chmod 766 /path/to/your/server.config
</syntaxhighlight>

Making the configuration file writable will allow to add datasets dynamically using the action ''add_dataset'' (see [[ViSUS Server]]).

If you also want to customize the apache security (e.g. change the users) you can run the command to mount also the apache2 directory as following:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v $PWD/config:/visus/config -v $PWD/apache2:/visus/apache2 visus/visus
</syntaxhighlight>

=== Convert your data to IDX using the Docker deployment tools ===

The ViSUS tools executables (see [[ViSUS Convert]]) are contained in the container under <code>/usr/local/visus/bin</code>.

For example, if you want to use the tools to convert a raw dataset using your docker deployment you can do it as follow.

Mount a folder that contains your ''raw'' data and your converted ''idx'' data as follow:
<syntaxhighlight lang="bash">
docker run -d -p 8080:80 -v /full/path/to/your/raw/:/home/visus/datasets/raw -v /full/path/to/your/idx/:/home/visus/datasets/idx visus/visus
</syntaxhighlight>

Check that your container is running correctly (using <code>docker ps</code>) and take note of the ''Container ID''.

Now run a bash session on this container using:
<syntaxhighlight lang="bash">
docker exec -it <id_from_docker_ps> /bin/bash
</syntaxhighlight>

From this bash session you can use your ViSUS converter to convert your data (just mounted in the container) as described in [[ViSUS Convert]].

=== Preview your data with the Web Viewer ===

You can preview and navigate you data on the server using the webviewer using your browser at the URL: http://localhost:8080

Here is a picture of the viewer:
[[File:2dwebviewer.png|300px]]

With the commands on the bottom bar you can:
* change server
* set a slice (if using a 3D dataset)
* set a timestep
* set palettes and min-max range
* choose a field of the selected dataset

== ViSUS Server for NetCDF data ==

An addition on-demand conversion service for NetCDF datasets is available in the "ondemand" Docker container.

To try it, pull the ViSUS on-demand image:
<syntaxhighlight lang="bash">
docker pull visus/ondemand
</syntaxhighlight>

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:
<syntaxhighlight lang="bash">
# 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
</syntaxhighlight>

Run the container:
<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>

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

=== Visualize/convert your data on the server ===

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

ViSUS Data Portal

2019-01-18T23:53:32Z

Admin: /* Explore Data */

ViSUS Data Portal

2019-01-18T23:53:21Z

Admin:

File:Hearth.png

2019-01-18T23:52:52Z

Admin: