Package: paraview-connect
ParaViewConnectPython3 library and command line tool to help starting and connecting to remote Linux ParaView servers. It sets up the required ssh tunnels to establish a forward or reverse connection to a remote host and launches the paraview pvserver process.
The client supports Windows, MacOS and Linux but is designed to connect to Linux based remote servers.
For the current release of ParaviewConnect, Windows users are recommneded to use [WSL].RequirementsYour local machine has python with the latest version of pip installedYour local machine and remote server have matching versions of paraview and paraview server installed, and you know the location of the Paraview Server binary (pvserver) on the remote host. See below for application specific configuration tips.Currently zCFD is using paraview 5.10You havepasswordless sshset up to the remote server, allowing you to connect to the remote host without entering a passwordInstallationFrom PyPiYou can install the package from PyPi using pip withpip install paraview-connectFrom GithubYou can install directly from Github using pip withpip install git+https://github.com/zenotech/ParaViewConnect.gitMacOSIf installation fails with errors installing/building the cyptography package, please ensure you are using the latest release of pip.ConfigurationConfigure paraview-connect by runningparaview-connect configure. This will then prompt you to enter details of your first connection and save it with a profile name. All confiuration is stored in ~/.paraview-connect/config by default. You will be presented with the following prompts, values in brackets are shown as the default entries. This example will set up a connection tojoe.blogs@login1.server.comParaview Connect
----------------
Configuring Paraview Connect
Hostname or IP to connect to: login1.server.com
Username on remote system: joe.blogs
Certificate to connect with [~/.ssh/id_rsa]:
Is cerfiticate passphrase protected? [y/N]:
Local port to use for connection [11111]:
Number of MPI processes to use [1]:
Paraview server command [pvserver]:
Pre script to run before paraview server [None]:
Name of profile to store config as: myFirstConfigurationIf you want to add another connection or update the existing one simply runparaview-connect configureagain. You can store multiple profiles in the configuration file.Using .ssh/config filesBy default Paraview-connect does not read any of the settings in an ssh config file. If you want to enable this then set the value ofload_ssh_configsto True in~/.paraview-connect/config.Configuration for zCFDWhen configuring for zCFD you can use the paraview-connect to run the zCFD activate script to prepare your remote environment. To do this add it as a pre-script. For example if zCFD was installed in /apps/zcfd/zCFD-icc-sse-impi-2020.12.116-Linux-64bit/ then your pre-sript would be. /apps/zcfd/zCFD-icc-sse-impi-2020.12.116-Linux-64bit/bin/activate. Your pvserver command would then just bepvserver.Configuration for OpenFoamWhen configuring for OpenFoam you can use the paraview-connect to source the OpenFoam environment script to prepare your remote environment. To do this add it as a pre-script. For example if OpenFoam was installed in /apps/OpenFoam/OpenFoam-v1806/ then your pre-sript would be. /apps/OpenFoam/OpenFoam-v1806/etc/bashrc.UsageTo launch paraview connect to use a profile created withparaview-connect configuresimply runparaview-connect run <profile-name>. This will launch the client with the configuration specified for that profile. From within Paraview you can then File->Connect and add/load a server configration connection. The server configration should always connect to your localmachine (localhost) but the port and connection type will depend on your paraview-connection configuration.The following fields are what are typically required for a paraview-connect connection from within the local paraview client.FieldValueNamemyFirstConfigurationServer TypeClient/ ServerHostlocalhostPort11111You can also launch sessions directly without using a config file if you runparaview-connect connect. Check the command help for the list of switches.SettingsThe following settings are defined in the ~/.paraview-connect/config file created by configure. Any settings in the DEFAULT section can be overridden in each profile section if required.SettingDescriptionDefaultcertLocation of your SSH private key./.ssh/id_rsaremote_hostHostname or IP or remote machine to connect tousernameUsername to connect withpvserver_commandName of pvserver binary to launchpvserverpre_scriptCustom script to setup env before launching pvsererNonedirectionType of Paraview Server connection, reverse or forwardforwardclusterLaunch pvserver onto a batch clusterFalselocal_portPort on localmachine to create connections on11111remote_port_rangeParaview-connect will search for an unused port on the remote machine to use, this is the range it checks12000:13000nprocsHow many MPI processes to launch paraview with. For values > 1 mpiexec must be available on the remote host.1load_ssh_configsMake use of any local ssh configuration files. If false then the only private key that will be tried is defined as certFalse