Running the Plom server

The server handles all communication between the database (which stores all the information about your test) and the various programmes, including plom-client, plom-manager, plom-create, plom-scan, and plom-finish.

Launching the server

After we have initialized our server, we can run it with plom-server launch. You can either change into your server directory (midterm if following the walkthrough) or you can specify the directory on the command line:

$ plom-server launch midterm

INFO:server	Plom Server (communicates with api 53)
INFO:server	Working from directory "midterm"
INFO:server	Database is not yet present: creating...
INFO:server	No manager password: autogenerating and writing to stdout...
Initial manager password: correcthorsebatterystaple
INFO:server	Loading ssl context
WARNING:server	SSL: Loaded default self-signed cert and key
INFO:server	Start the server!
======== Running on ========
(Press CTRL+C to quit)

The server has found everything it needs and is up and running on the indicated IP and port.

If you’re running on a remote server, you probably want to use nohup or screen.

Make note of the manager password

If you did not previously configure user accounts, then the server will create a manager account for you when it starts up.

The password for this account will be printed to the stdout (not the log file). Make note of it; you’ll never see it again.

We are now ready to create a specification for our test.

Stopping the server

One can stop the server with Ctrl-C or by simply killing the underlying python process. You can also restart it again later as needed.