Managing a Local Job Server

If the feature flag for the new Job Server infrastructure is enabled, jobs submitted to the “localhost” entry will use a Job Server which will run on a local computer.

Before you can submit jobs to “localhost” on the command line via -HOST localhost, start the local Job Server:

$SCHRODINGER/jsc local-server-start

When you start Maestro after enabling the feature flag, the local Job Server starts automatically.

You can check the status of the local Job Server by entering:

$SCHRODINGER/jsc local-server-status

on the command line. The command prints:

Status of jobserverd: RUNNING
Job server available at localhost:<port>

The local Job Server will use the Schrödinger “scratch” directory. Check the documentation for more information on the location of the scratch directory.

You can explicitly specify the location of the “tmpdir:” in the schrodinger.hosts file, e.g.

name:   localhost
tmpdir: /scr

In this case, the local Job Server will be started in /scr/<username>/jobserverd-<hostname>/.

If the IGNORE_SCHRODINGER_HOSTS feature flag is turned on, you can specify the location of the "tmpdir:" by setting the Temporary project location in Maestro → Preferences or using the mmpref command in the command line.

If “tmpdir:” is not set explicitly, a default location for the “scratch” directory will be created.

On Linux and MacOS, the "scratch" directory will be in $HOME/.schrodinger/tmp.

On Windows, the "scratch" directory will be a folder in %LOCALAPPDATA%\Schrodinger\tmp.

The local Job Server is not stopped automatically when Maestro is closed. To stop the Job Server manually, enter:

$SCHRODINGER/jsc local-server-stop

If you stopped the local Job Server and have Maestro running, you will not be able to submit jobs to localhost. Close the current Maestro session and open a new one to start a new local Job Server. Alternatively, start the local Job Server again manually:

$SCHRODINGER/jsc local-server-start