jcmwave_daemon_add_workstation.mΒΆ

Usage: jcmwave_daemon_add_workstation(options)

Purpose: registers a workstation as a computing node

Input:
  options: key-value list (or matlab) structure to configure the output
    options.Hostname -> host name of the remote computer
                        To form a login chain concatenate the hostnames with
                        ';' separators, i.e 'gateway.com;maxwell'
    options.JCMROOT -> JCMsuite installation path on remote computer
                       default: same directory as local installation
    options.Login -> Login name to the remote computer
                     For a login chain concatenate the user names with
                        ';' separators, i.e 'user1;user2'
    options.SSHClient -> 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'
    options.SSHAgentForwarding -> Enables forwarding of the authentication agent connection.
                         ('yes'/'no', default 'no')
    options.SSHTimeOut ->  Timeout for establishing the ssh connection (default 6s)
    options.PEMFile -> File with private ssh-key for establishing a ssh
             connection, e.g. '~/.ssh/id_rsa' (optional).
    options.LicenseServerPort: 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.
    options.Multiplicity -> allow for multiply simultaneous use of the resource
                            default: 1 (single use)
    options.NThreads -> number of threads used by one job on the remote computer

    options.WorkingDir -> Directory used by JCMsuite to place files on the remote computer

    options.OOCDir -> swapping directory for out-of-core data

    options.MaxCoreSize -> restricts maximum core RAM usage (requires setting
                             of swapping directory OOCDIR)

    options.MemoryLimit -> maximum RAM usage in MB (aborts jobs if exceeded)


Output: resource identifier (integer vector form multiple used resources)

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