VisIt: Difference between revisions

302 bytes removed ,  5 years ago
no edit summary
No edit summary
No edit summary
Line 4: Line 4:


<!--T:2-->
<!--T:2-->
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.
VisIt requires the same major version on the local client and the remote host; this prevents incompatibilities that typically show as a failed handshake when establishing the client-server connection.


<!--T:3-->
<!--T:3-->
Line 14: Line 14:
<!--T:53-->
<!--T:53-->
<tab name="Cedar and Graham">
<tab name="Cedar and Graham">


<!--T:8-->
<!--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
Two versions of VisIt are 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. Before starting VisIt, download the host profile XML file [https://owncloud.westgrid.ca/index.php/s/HGxHPO2fPspdb0O/download host_cedar.xml].
<br>
* On Linux/Mac, copy the file to ''~/.visit/hosts/''.
* On Windows, copy the file to ''My Documents\VisIt 2.13.0\hosts\''. Start VisIt on your laptop; in the main menu, under ''Options -> Host Profiles'', you should see the ''cedar'' host profile. If you want to do remote rendering on Graham instead, set


  <!--T:9-->
  <!--T:9-->
Line 25: Line 26:


<!--T:10-->
<!--T:10-->
For both Cedar and Graham, set your CCDB username
For both Cedar and Graham, set your CCDB username.


  <!--T:11-->
  <!--T:11-->
Line 37: Line 38:


<!--T:14-->
<!--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, click on the ''Launch Profiles'' tab. You should see two profiles (''login'' and ''slurm''):


<!--T:15-->
<!--T:15-->
Line 43: Line 44:


<!--T:16-->
<!--T:16-->
* The ''login'' profile is for running VisIt's engine on a cluster's login node, which we do not recommend for heavy visualizations.
* The ''login'' profile is for running the engine on a login node, which we do not recommend for heavy visualizations.
* The ''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:
* The ''slurm'' profile is for running the engine inside an interactive job on a compute node. If you are planning to do the this, select the ''slurm'' profile and then click on the ''Parallel'' tab and below it on the ''Advanced'' tab. In the ''Launcher arguments'' field, replace ''--account=def-someuser'' by your default allocation, as shown below:


<!--T:17-->
<!--T:17-->
Line 50: Line 51:


<!--T:18-->
<!--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 the settings with ''Options -> Save Settings'' and then restart VisIt on your laptop for settings to take effect. Start the file-open dialogue and change the 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 either the ''login'' (rendering on the login node) or ''slurm'' (rendering inside an interactive Slurm job on a compute node) profile. If you select the ''slurm'' profile, you will need to specify the number of nodes and processors and the maximum time limit:


<!--T:19-->
<!--T:19-->
Line 56: Line 57:


<!--T:20-->
<!--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 on ''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'', the VisIt's engine is running and you can proceed with creating and drawing your plot.


<!--T:21-->
<!--T:21-->
Line 62: Line 63:
<tab name="Niagara">
<tab name="Niagara">


 
=== VisIt configuration === <!--T:23-->
 
=== VisIt Configuration === <!--T:23-->


<!--T:24-->
<!--T:24-->
For VisIt to connect to the Niagara cluster, you need to set up a "Host Configuration". Choose ''one'' of the methods below:
For VisIt to connect to the Niagara cluster, you need to configure your host through one of the following methods:


=== Niagara Host Configuration File === <!--T:25-->
=== Host configuration file === <!--T:25-->


<!--T:26-->
<!--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...  
Download the Niagara host file, right-click on [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:
<ul>
<br>
<li> on a Linux/Mac OS place this file in <code>~/.visit/hosts/</code>
* On Linux/Mac, place the file in <code>~/.visit/hosts/</code>.
<li> on a Windows machine, place the file in <code>My Documents\VisIt 2.13.0\hosts\</code>
* On Windows, place the file in <code>My Documents\VisIt 2.13.0\hosts\</code>.
</ul>


<!--T:27-->
<!--T:27-->
Restart VisIt and check that the niagara profile should be available in your hosts.
Restart VisIt and check that the Niagara profile is available under ''Options -> Host Profiles''.


=== Manual Niagara Host Configuration === <!--T:28-->
=== Manual host configuration === <!--T:28-->


<!--T:29-->
<!--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.
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:


  <!--T:30-->
  <!--T:30-->
Line 96: Line 93:


<!--T:31-->
<!--T:31-->
Click on the "<code>Tunnel data connections through SSH</code>", and then hit Apply!
Check ''Tunnel data connections through SSH'' and click on ''Apply''.


<!--T:32-->
<!--T:32-->
Line 104: Line 101:


<!--T:33-->
<!--T:33-->
Now on the top of the window click on 'Launch Profiles' tab.
At the top of the window, click on the ''Launch Profiles'' tab to create a profile:
You will have to create two profiles:
<br>
<ol>
* <code>login</code> to connect through a login node and access data;
<li> <code>login</code>: for connecting through the login nodes and accessing data </li>
* <code>slurm</code> to using compute nodes as rendering engines.
<li> <code>slurm</code>: for using compute nodes as rendering engines </li>
 
</ol>


<!--T:34-->
<!--T:34-->
Line 123: Line 119:


<!--T:36-->
<!--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 launch VisIt.


<!--T:37-->
<!--T:37-->
</tab>
</tab>
<tab name="Cloud VM">
<tab name="Cloud VM">


=== Prerequisites === <!--T:39-->
=== Prerequisites === <!--T:39-->
Line 171: Line 165:


<!--T:51-->
<!--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. In ''Options -> Host profiles'', edit the connection nickname (let's call it Cloud West), the VM host name, the path to the VisIt installation (/home/centos/visit) and your username on the VM; also enable tunneling through SSH. Don't forget to save your settings with ''Options -> Save Settings''. TWhen you open a gile (''File -> Open file -> Host = Arbutus'') 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-->
<!--T:52-->
rsnt_translations
56,430

edits