daemon.add_workstation

jcmwave.daemon.add_workstation(Hostname='localhost', JCMROOT=None, Login='', SSHClient=None, SSHAgentForwarding=None, SSHTimeOut=None, PEMFile=None, Multiplicity=1, NThreads=1, GPUs=None, WorkingDir='', OOCDir=None, MaxCoreSize=None, MemoryLimit=None, LicenseServerPort=None)

Adds a new workstation. Example:

jcmwave.daemon.add_workstation(Hostname='maxwell', Multiplicity=4, NThreads=4)
Parameters:

  • Hostname (str) – host name of the remote computer To form a login chain concatenate the hostnames with ; separators, i.e gateway.com;maxwell

  • JCMROOT (str) – JCMsuite installation path on remote computer default: same directory as local installation

  • PEMFile (str) – File with private ssh-key for establishing a ssh connection, e.g. ~/.ssh/id_rsa (optional).

  • Login (str) – Login name to the remote computer For a login chain concatenate the user names with ; separators, i.e user1;user2

  • SSHClient (str) – ssh client used to establish a secure connection to the remote machine. As a default the system ssh client is used (if not available on Windows Putty’s plink is used) For a login chain concatenate ssh clients with ‘;’ separators, i.e ‘plink;ssh’

  • SSHAgentForwarding (str) – Enables forwarding of the authentication agent connection. (boolean, default False)

  • SSHTimeOut (str) – Timeout for establishing the ssh connection (default 6s)

  • Multiplicity (int) – allow for multiple simultaneous use of the resource default: 1 (single use)

  • NThreads (int) – number of threads used by one job on the remote computer

  • GPUs (list) – GPU usage (‘all’/’no’)

  • GPUs – Select specific gpu(s) by their device identifier (integer list)

  • WorkingDir (str) – Directory used by JCMsuite to place temporary files.

  • OOCDir (str) – swapping directory for out-of-core data

  • MaxCoreSize (int) – restricts maximum core RAM usage (requires setting of swapping directory OOCDir)

  • MemoryLimit (int) – maximum RAM usage in MB (aborts jobs if exceeded)

  • LicenseServerPort (int) – If the remote machine cannot reach the local license server (e.g. a cloud instance), it can be configured to look for the license server at localhost:XXXX. Then, LicenseServerPort must be equal to XXXX. default: No port forwarding.

Warning

Adding a machine recursively increases the number of simultaneously running jobs on this machine.