Bureaucrats, cc_docs_admin, cc_staff
2,306
edits
No edit summary |
(Marked this version for translation) |
||
Line 1: | Line 1: | ||
<languages /> | <languages /> | ||
<translate> | <translate> | ||
= Client-server visualization = | = Client-server visualization = <!--T:1--> | ||
<!--T:2--> | |||
Please use the tabs below to select the remote system. | Please use the tabs below to select the remote system. | ||
<!--T:3--> | |||
'''NOTE''' VisIt requires the same major version between the local client and the remote host, so please try to stick to that to avoid incompatibilities that typically show as a failed handshake when establishing the client-server connection. | '''NOTE''' VisIt requires the same major version between the local client and the remote host, so please try to stick to that to avoid incompatibilities that typically show as a failed handshake when establishing the client-server connection. | ||
<!--T:4--> | |||
<tabs> | <tabs> | ||
<tab name="Select"> | <tab name="Select"> | ||
<!--T:5--> | |||
Please click on one of the tabs to select the remote system on which you want to run VisIt. | Please click on one of the tabs to select the remote system on which you want to run VisIt. | ||
<!--T:6--> | |||
</tab> | </tab> | ||
<tab name="Cedar and Graham"> | <tab name="Cedar and Graham"> | ||
== Client-server visualization on Cedar and Graham == | == Client-server visualization on Cedar and Graham == <!--T:7--> | ||
<!--T:8--> | |||
On Cedar and Graham we have two versions of VisIt installed: visit/2.12.3 and visit/2.13.0. To use remote VisIt in client-server mode, on your laptop you need the matching major version, either 2.12.x or 2.13.x, respectively. Before starting VisIt, download the Host Profile XML file [https://owncloud.westgrid.ca/index.php/s/HGxHPO2fPspdb0O/download host_cedar.xml]. On Linux/Mac copy it to ~/.visit/hosts/, and on Windows to "My Documents\VisIt 2.13.0\hosts\". Start VisIt on your laptop, and in its main menu in Options - Host Profiles you should see a host profile called ''cedar''. If you want to do remote rendering on Graham instead of Cedar, set | On Cedar and Graham we have two versions of VisIt installed: visit/2.12.3 and visit/2.13.0. To use remote VisIt in client-server mode, on your laptop you need the matching major version, either 2.12.x or 2.13.x, respectively. Before starting VisIt, download the Host Profile XML file [https://owncloud.westgrid.ca/index.php/s/HGxHPO2fPspdb0O/download host_cedar.xml]. On Linux/Mac copy it to ~/.visit/hosts/, and on Windows to "My Documents\VisIt 2.13.0\hosts\". Start VisIt on your laptop, and in its main menu in Options - Host Profiles you should see a host profile called ''cedar''. If you want to do remote rendering on Graham instead of Cedar, set | ||
Host nickname = graham | <!--T:9--> | ||
Host nickname = graham | |||
Remote host name = graham.computecanada.ca | Remote host name = graham.computecanada.ca | ||
<!--T:10--> | |||
For both Cedar and Graham, set your CCDB username | For both Cedar and Graham, set your CCDB username | ||
Username = yourOwwUserName | <!--T:11--> | ||
Username = yourOwwUserName | |||
<!--T:12--> | |||
With the exception of your username, your settings should be similar to the ones shown below: | With the exception of your username, your settings should be similar to the ones shown below: | ||
<!--T:13--> | |||
[[File:HostSetting.png|880px]] | [[File:HostSetting.png|880px]] | ||
<!--T:14--> | |||
In the same setup window select the Launch Profiles tab. You should see two profiles (''login'' and ''slurm''): | In the same setup window select the Launch Profiles tab. You should see two profiles (''login'' and ''slurm''): | ||
<!--T:15--> | |||
[[File:LaunchProfiles.png]] | [[File:LaunchProfiles.png]] | ||
<!--T:16--> | |||
''Login'' profile is for running VisIt's engine on a cluster's login node, which we do not recommend for heavy visualizations. ''Slurm'' profile is for running VisIt's engine inside an interactive job on a compute node. If you are planning to do the latter, select the ''slurm'' profile and then click on Parallel tab and below it on the Advanced tab and change Launcher arguments from ''--account=def-someuser'' to your default allocation, as shown below: | ''Login'' profile is for running VisIt's engine on a cluster's login node, which we do not recommend for heavy visualizations. ''Slurm'' profile is for running VisIt's engine inside an interactive job on a compute node. If you are planning to do the latter, select the ''slurm'' profile and then click on Parallel tab and below it on the Advanced tab and change Launcher arguments from ''--account=def-someuser'' to your default allocation, as shown below: | ||
<!--T:17--> | |||
[[File:LauncherArguments.png]] | [[File:LauncherArguments.png]] | ||
<!--T:18--> | |||
Save settings with Options - Save Settings and then restart VisIt on your laptop for settings to take effect. Start the file-open dialogue and switch the Host from localhost to ''cedar'' (or ''graham''). Hopefully, the connection is established, the remote VisIt Component Launcher gets started on the cluster's login node, and you should be able to see the cluster's filesystem, navigate to your file and select it. You will be prompted to select between ''login'' (rendering on the login node) and ''slurm'' (rendering inside an interactive Slurm job on a compute node) profiles, and additionally for ''slurm'' profile you will need to specify the number of nodes and processors and the maximum time limit: | Save settings with Options - Save Settings and then restart VisIt on your laptop for settings to take effect. Start the file-open dialogue and switch the Host from localhost to ''cedar'' (or ''graham''). Hopefully, the connection is established, the remote VisIt Component Launcher gets started on the cluster's login node, and you should be able to see the cluster's filesystem, navigate to your file and select it. You will be prompted to select between ''login'' (rendering on the login node) and ''slurm'' (rendering inside an interactive Slurm job on a compute node) profiles, and additionally for ''slurm'' profile you will need to specify the number of nodes and processors and the maximum time limit: | ||
<!--T:19--> | |||
[[File:SelectProfile.png]] | [[File:SelectProfile.png]] | ||
<!--T:20--> | |||
Click Ok and wait for VisIt's engine to start. If you selected rendering on a compute node, it may take some time for your job to get started. Once your dataset appears in the Active source in the main VisIt window, the VisIt's engine is running, and you can proceed with creating and drawing your plot. | Click Ok and wait for VisIt's engine to start. If you selected rendering on a compute node, it may take some time for your job to get started. Once your dataset appears in the Active source in the main VisIt window, the VisIt's engine is running, and you can proceed with creating and drawing your plot. | ||
<!--T:21--> | |||
</tab> | </tab> | ||
<tab name="Niagara"> | <tab name="Niagara"> | ||
== Client-server visualization on Niagara == | == Client-server visualization on Niagara == <!--T:22--> | ||
=== VisIt Configuration === | === VisIt Configuration === <!--T:23--> | ||
<!--T:24--> | |||
For allowing VisIt connect to the Niagara cluster you need to set up a "Host Configuration". Choose ''one'' of the methods bellow: | For allowing VisIt connect to the Niagara cluster you need to set up a "Host Configuration". Choose ''one'' of the methods bellow: | ||
=== Niagara Host Configuration File === | === Niagara Host Configuration File === <!--T:25--> | ||
<!--T:26--> | |||
You can just download the Niagara host file, right click on the following link [https://support.scinet.utoronto.ca/~mponce/viz/host_niagara.xml host_niagara.xml] and select save as... | You can just download the Niagara host file, right click on the following link [https://support.scinet.utoronto.ca/~mponce/viz/host_niagara.xml host_niagara.xml] and select save as... | ||
Depending on the OS you are using on your local machine: | Depending on the OS you are using on your local machine: | ||
Line 62: | Line 83: | ||
</ul> | </ul> | ||
<!--T:27--> | |||
Restart VisIt and check that the niagara profile should be available in your hosts. | Restart VisIt and check that the niagara profile should be available in your hosts. | ||
=== Manual Niagara Host Configuration === | === Manual Niagara Host Configuration === <!--T:28--> | ||
<!--T:29--> | |||
If you prefer to set up the verser yourself, instead of the configuration file from the previous section, just follow along these steps. | If you prefer to set up the verser yourself, instead of the configuration file from the previous section, just follow along these steps. | ||
Open VisIt in your computer, go to the 'Options' menu, and click on "Host profiles..." | Open VisIt in your computer, go to the 'Options' menu, and click on "Host profiles..." | ||
Then click on 'New Host' and select: | Then click on 'New Host' and select: | ||
Host nickname = niagara | <!--T:30--> | ||
Host nickname = niagara | |||
Remote host name = niagara.scinet.utoronto.ca | Remote host name = niagara.scinet.utoronto.ca | ||
Username = Enter_Your_OWN_username_HERE | Username = Enter_Your_OWN_username_HERE | ||
Path to VisIt installation = /scinet/niagara/software/2018a/opt/base/visit/2.13.1 | Path to VisIt installation = /scinet/niagara/software/2018a/opt/base/visit/2.13.1 | ||
<!--T:31--> | |||
Click on the "<code>Tunnel data connections through SSH</code>", and then hit Apply! | Click on the "<code>Tunnel data connections through SSH</code>", and then hit Apply! | ||
<!--T:32--> | |||
{| align="center" | {| align="center" | ||
| [[File:Visit_niagara-01.png|880px|]] | | [[File:Visit_niagara-01.png|880px|]] | ||
|} | |} | ||
<!--T:33--> | |||
Now on the top of the window click on 'Launch Profiles' tab. | Now on the top of the window click on 'Launch Profiles' tab. | ||
You will have to create two profiles: | You will have to create two profiles: | ||
Line 88: | Line 115: | ||
</ol> | </ol> | ||
<!--T:34--> | |||
For doing so, click on 'New Profile', set the corresponding profile name, ie. login/slurm. Then click on the Parallel tab and set the "Launch parallel engine". For the slurm profile, you will need to set the parameters as seen below: | For doing so, click on 'New Profile', set the corresponding profile name, ie. login/slurm. Then click on the Parallel tab and set the "Launch parallel engine". For the slurm profile, you will need to set the parameters as seen below: | ||
<!--T:35--> | |||
<br style="clear:both" /> | <br style="clear:both" /> | ||
{| align="center" | {| align="center" | ||
Line 97: | Line 126: | ||
<br style="clear:both" /> | <br style="clear:both" /> | ||
<!--T:36--> | |||
Finally, after you are done with these changes, go to the "Options" menu and select "Save settings", so that your changes are saved and available next time you relaunch VisIt. | Finally, after you are done with these changes, go to the "Options" menu and select "Save settings", so that your changes are saved and available next time you relaunch VisIt. | ||
<!--T:37--> | |||
</tab> | </tab> | ||
<tab name="Cloud VM"> | <tab name="Cloud VM"> | ||
== Client-server visualization on a VM == | == Client-server visualization on a VM == <!--T:38--> | ||
=== Prerequisites === | === Prerequisites === <!--T:39--> | ||
<!--T:40--> | |||
You can launch a new cloud virtual machine (VM) as described in the [[Cloud Quick Start|Cloud Quick Start Guide]]. Once you log into the VM, you will need to install some additional packages to be able to compile ParaView or VisIt. For example, on a CentOS VM you can type: | You can launch a new cloud virtual machine (VM) as described in the [[Cloud Quick Start|Cloud Quick Start Guide]]. Once you log into the VM, you will need to install some additional packages to be able to compile ParaView or VisIt. For example, on a CentOS VM you can type: | ||
sudo yum install xauth wget gcc gcc-c++ ncurses-devel python-devel libxcb-devel | <!--T:41--> | ||
sudo yum install xauth wget gcc gcc-c++ ncurses-devel python-devel libxcb-devel | |||
sudo yum install patch imake libxml2-python mesa-libGL mesa-libGL-devel | sudo yum install patch imake libxml2-python mesa-libGL mesa-libGL-devel | ||
sudo yum install mesa-libGLU mesa-libGLU-devel bzip2 bzip2-libs libXt-devel zlib-devel flex byacc | sudo yum install mesa-libGLU mesa-libGLU-devel bzip2 bzip2-libs libXt-devel zlib-devel flex byacc | ||
sudo ln -s /usr/include/GL/glx.h /usr/local/include/GL/glx.h | sudo ln -s /usr/include/GL/glx.h /usr/local/include/GL/glx.h | ||
<!--T:42--> | |||
If you have your own private-public SSH key pair (as opposed to the cloud key), you may want to copy the public key to the VM to simplify logins, by issuing the following command on your laptop: | If you have your own private-public SSH key pair (as opposed to the cloud key), you may want to copy the public key to the VM to simplify logins, by issuing the following command on your laptop: | ||
cat ~/.ssh/id_rsa.pub | ssh -i ~/.ssh/cloudwestkey.pem centos@vm.ip.address 'cat >>.ssh/authorized_keys' | <!--T:43--> | ||
cat ~/.ssh/id_rsa.pub | ssh -i ~/.ssh/cloudwestkey.pem centos@vm.ip.address 'cat >>.ssh/authorized_keys' | |||
=== Compiling VisIt with OSMesa === | === Compiling VisIt with OSMesa === <!--T:44--> | ||
<!--T:45--> | |||
VisIt with offscreen rendering support can be built with a single script: | VisIt with offscreen rendering support can be built with a single script: | ||
wget http://portal.nersc.gov/project/visit/releases/2.12.1/build_visit2_12_1 | <!--T:46--> | ||
wget http://portal.nersc.gov/project/visit/releases/2.12.1/build_visit2_12_1 | |||
chmod u+x build_visit2_12_1 | chmod u+x build_visit2_12_1 | ||
./build_visit2_12_1 --prefix /home/centos/visit --mesa --system-python \ | ./build_visit2_12_1 --prefix /home/centos/visit --mesa --system-python \ | ||
--hdf4 --hdf5 --netcdf --silo --szip --xdmf --zlib | --hdf4 --hdf5 --netcdf --silo --szip --xdmf --zlib | ||
<!--T:47--> | |||
This may take a couple of hours. Once finished, you can test the installation with: | This may take a couple of hours. Once finished, you can test the installation with: | ||
~/visit/bin/visit -cli -nowin | <!--T:48--> | ||
~/visit/bin/visit -cli -nowin | |||
<!--T:49--> | |||
This should start a VisIt Python shell. | This should start a VisIt Python shell. | ||
=== Running VisIt in client-server mode === | === Running VisIt in client-server mode === <!--T:50--> | ||
<!--T:51--> | |||
Start VisIt on your laptop and in Options -> Host profiles... edit the connection nickname (let's call it Cloud West), the VM host name, path to VisIt installation (/home/centos/visit) and your username on the VM, and enable tunneling through ssh. Don't forget to save settings with Options -> Save Settings. Then opening a file (File -> Open file... -> Host = Cloud West) you should see the VM's filesystem. Load a file and try to visualize it. Data processing and rendering should be done on the VM, while the result and the GUI controls will be displayed on your laptop. | Start VisIt on your laptop and in Options -> Host profiles... edit the connection nickname (let's call it Cloud West), the VM host name, path to VisIt installation (/home/centos/visit) and your username on the VM, and enable tunneling through ssh. Don't forget to save settings with Options -> Save Settings. Then opening a file (File -> Open file... -> Host = Cloud West) you should see the VM's filesystem. Load a file and try to visualize it. Data processing and rendering should be done on the VM, while the result and the GUI controls will be displayed on your laptop. | ||
<!--T:52--> | |||
</tab> | </tab> | ||
</tabs> | </tabs> | ||
</translate> | </translate> |