Please enable JavaScript to view this site.

GeoDict User Guide 2025

Manage Job Queue Server

The Manage Job Queue Server dialog allows you to control the job queue server on this machine, see and control all jobs submitted by clients, and add new clients to this server.

Jobs Tab

Under the Jobs tab you can find all functionalities regarding the job queue server on this machine and an administrator overview over all jobs submitted to this job queue server.

At the top of the dialog, you can see the current Server Status:

  • Ready: The server is running but no jobs are running or in queue.
  • Busy: The server is running and a job is currently running.
  • Paused: The server is paused due to clicking the Pause Processing button.
  • Not available: The server is not running or not reachable, e.g., due to blocking by a firewall.

To the right of the Server Status, the buttons to control the server a located. When the server is not running, the Start Server button can be clicked to start the server. A job queue server can be started by any user who has purchased a GeoDict server license. Administrator privileges are not required.

When the server is started, a terminal window opens in which the server runs. This terminal window shows a log output of all functions which have been invoked and by whom (e.g., GeoDict Job Queue Server running, CreateJob called by User, Running GeoDict, ...). This log is also saved to the job system directory (\GeoDict2025\JobSystem\serverlogs).

Note-Info

Note! It is also possible to start the job queue server by starting GeoDict from the command line with the option: --job-server=<project folder>. In this case, the location of the project folder for the job queue server needs to be provided.

Click Pause Processing when the server is running to interrupt the current simulation. This allows you to temporarily free computational resources without completely stopping the job queue server. Click the button again to resume the simulations in the queue.

Click Stop Server when the server is running to shut down the server. This will also close the terminal window. Manually closing the terminal window also stops the server.

When the job queue server is running and you close GeoDict, an exit message indicating that the job queue server is still running is shown. Here you have two options. You can Leave the server running and exit GeoDict. The terminal window remains open in this case and, as long as this window is not closed, the job queue server runs and jobs can be submitted. Alternatively, you can Stop the server and exit GeoDict, which will also close the terminal window.

Below the Server Status, you can find information on the current number of Jobs in queue and Jobs finished. You can also Filter the jobs that are shown in the list below by entering text. This allows you to quickly find specific jobs in the list by entering Job, Project, or Host names, a certain Status, or dates / times.

In the Jobs tab the server administrator has the same list of jobs as the clients in the Job Queue Projects dialog. However, the administrator can see all jobs on the server submitted by all clients, whereas the clients can only see their own jobs. The server administrator can also perform the same actions as the clients such as downloading results, terminating simulations, deleting jobs, and changing the queue order.

The information shown in the list of all jobs on the server contains:

  • Status: This column gives you information on the current status of you job. The possible values are:
    • Queued: This job is currently in queue. The queue position is given in the brackets following the Queued status.
    • Simulation Running: This job is currently running on a job queue server.
    • Completed: This job has run successfully and the results can be downloaded.
    • Downloaded: This job has run successfully and the results have been downloaded. You can download the results again if necessary.
    • Error: There are multiple possible causes for this status. The computation has failed and the error message can be seen in the log file. You have terminated this job. The job has reached the defined timeout limit. If the job ran before failing, terminating or timeout, partial results might still be available for download.
  • Host: This column shows you the name of the job queue server that the job was submitted to.
  • Project: This column shows you the project name that you have defined.
  • Job: This column shows you the job name that you have defined. The job name is followed by a number if the job name is duplicated.
  • Created: This column shows you when the job was created and submitted to the queue.
  • Started: This column shows you when the computation of the job was started on the server. For jobs in the queue this entry is empty.
  • Running: This column shows you the time that the job ran or is still running for. For jobs in the queue this entry is empty.

At the bottom left of the dialog, you can raise the main GeoDict window without closing this dialog. Clicking Close at the bottom right of the dialog closes the dialog.

When you select one (or more) job(s) in the list, you can perform multiple actions using the buttons at the bottom of the dialog:

Note-KnowHow

Know how! Multiple jobs can be selected either by holding the Ctrl button and left-clicking on multiple jobs, or by left-clicking on a job and then holding the Shift button and left-clicking on another job to select these jobs and any in between.

OpenDownload Results

OpenShow Log

OpenTerminate Simulation(s)

OpenDelete Job(s)

OpenUp & Down Buttons

Clients Tab

Under the Clients tab, the server administrator can manage which client machines are allowed to access the job queue server. View the list of Registered Clients to see which clients currently have access to this server. Export the server certificate so it can be added to the client machines to enable access from the client side.

In the list you can see all Registered Clients for which you have added the certificates via Add Clients.

Clicking Export my Certificate opens a file browser dialog. Save the server certificate file username@hostname_cert.pem somewhere on the machine. Then, transfer this file to all client machines and use Add Servers there. You can also access the certificate file directly under the JobSystem/id/ folder as described here.

Click Add Clients and select the certificates of all clients that you have transferred to the server machine in the opening file browser. After clicking Open, the clients appear in the list of Registered Clients. To manually add a server, copy the client certificates to the JobSystem/clients/ folder on the server machine and then click the Refresh List button to see it in the list.

Note-Important

Warning! When the server allows access to client, these clients are granted permissions and may gain broad access to the server machine. For example, it is possible to execute Python scripts via GeoDict, which can potentially access sensitive resources. To maintain security, we strongly recommend setting up a dedicated "functional" user account on the server machine. This allows for better control and monitoring of client access. Never grant server access to unauthorized or unverified users. Doing so may pose a security risk.

Select one or multiple clients in the list and click Remove Selected Clients to delete the corresponding client certificates from the server machine. These clients can then no longer access the server. The server machine itself is always a registered client and you cannot remove this certificate from the list. A warning message appears, if you try to remove your own certificate.

Note-Info

Note! If you update your GeoDict version (e.g. from 2024 to 2025), GeoDict will check automatically for certificates in the clients and servers folders of the old version and ask if you want to import these certificates to the clients and servers folders of the new version.

©2025 created by Math2Market GmbH / Imprint / Privacy Policy