Skip to content

Commit

Permalink
Simplify phoenix paraview workflow
Browse files Browse the repository at this point in the history
  • Loading branch information
max-Hawkins committed Mar 29, 2024
1 parent 943fd2c commit 6c377df
Showing 1 changed file with 9 additions and 32 deletions.
41 changes: 9 additions & 32 deletions Tutorials/interactive-visualization-on-Phoenix.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,51 +39,28 @@ If you updated line 51 of `pace-paraview-server` to reflect a default account, t

- `--mem` specifies the memory per node to request (default is to request all memory)

- `--gres` specifies the GPU resources to request.
- `--gres` specifies the GPU resources to request.
These instructions have only been verified to work with `--gres gpu:V100:2`.

- `--time` specifies the time limit for your job.
This option is optional and defaults to whatever is set on line 52 of `pace-paraview-server`.

Once you run `./pace-paraview-server <options>`, you will see
Once you run `./pace-paraview-server <options>`, it'll take a bit to start up. In the meantime, you'll see the below message:

```
Submitted batch job <job #>
Waiting for ParaView server to start. This may take several minutes ...
```

in your terminal.
Once the job starts, a dialogue containing the following instructions will appear detailing how to connect to the remote server from your local machine.
When it's done initializing, you should see a dialogue with some recommended next steps numbered 1-4. Below is a slightly altered version of that dialogue:

```
1) Press SHIFT + ~ then SHIFT + C to open an SSH console (The prompt 'ssh>' should appear on the next line)
***Note: '~' MUST be the first character on the line to be recognized as the escape character, in which case it will not appear on your terminal.***
***If you see the '~' character when you start typing, delete it, hit 'ENTER' and type 'SHIFT' + '~' + 'C' again.***
2) Type -L 8722:<nodeIdentifier>:53723 and then ENTER
3) In the ParaView 5.11 desktop client, create the server configuration.
( screenshots are at https://docs.pace.gatech.edu/slurm-software/paraview/#starting-the-paraview-client-on-your-computer )
Set the 'Server Type' to:
Client / Server
Set the 'Host' to:
localhost
Set the 'Port' to:
8722
If you have previously configured the server cs://localhost:8722 in ParaView,
you can re-use it and do not need to create a new configuration.
4) When your work is finished, check the Slurm queue (squeue --name=paraview)
and end your ParaView job if it is still active (scancel --name=paraview)
```

Depending on your local version of openSSH, you may need to add the following to you `/.ssh/config` file for `SHIFT + ~ + C` to work as expected.

```
Host *
EnableEscapeCommandline yes
```
1) Create the appropriate port forwarding for your local ParaView session to connect with.
* On your local machine, run the following from a terminal where `nodeIdentifier` is the remote node running the ParaView server process (given in the output of the batch script) and `paceSystemIdentifier` is the name of the PACE system (however this is configured with your `.ssh/config`). This terminal session must not be killed for the duration of your ParaView session as it's maintaining the port forwarding.
* `ssh -L 8722:<nodeIdentifier>:53723 <paceSystemIdentifier>`

## Step 4 - Connecting from your Local Machine
Once you have `Paraview5.11.0` open on your machine, select `file -> Connect..` to open the remote connection dialogue box.
If you've already set up the pace connection, simply double-click the existing configuration.
If you have not yet set up the pace connection, click `Add Server`.
2) Once you have `Paraview5.11.0` open on your machine, select `file -> Connect..` to open the remote connection dialogue box.
* If you've already set up the pace connection, simply double-click the existing configuration.
* If you have not yet set up the pace connection, click `Add Server`.
This will bring up a new dialogue box where you can specify a configuration name and set the `Port` to 8722.
Once this is done, click `configure` and then `save` on the next dialogue box.

0 comments on commit 6c377df

Please sign in to comment.