Setting up a Job Queue Server
The necessary steps to start a job queue server and allow access from client machines are explained below. You can either use the job queue server locally, or submit jobs to the server remotely from other client machines.
How to Set Up a Local Job Queue Server
- To open the dialog for managing the server on your machine, navigate to Cloud & Queue → Manage Job Queue Server in the GeoDict menu bar.
- In the Jobs tab of the dialog, click on Start Server. The server will start immediately, opening a terminal window in which it runs.
- Optional: Jobs are executed sequentially by default, but you can enable parallel execution by increasing the maximum number of parallel jobs via the Job Queue Settings.
- You can now submit jobs to your local server by using the Job Queue button. Since the machine running the job queue server is always automatically listed as its client, no exchange of certificates is required.
How to Set Up a Remote Job Queue Server
In order to set up a remote Job Queue Server, the client and server must be configured to recognize each other. This process involves exchanging certificates between the server and the client. All necessary steps are described here.
|
Important! In order for the Job Queue to function across multiple machines, the machines must be on the same network and able to communicate with each other. Setting this up may require coordination with your IT department. The client and server machines must use the same major (e.g., GeoDict 2026) and minor (e.g., Service Pack 1) versions of GeoDict for the job queue to work. If the versions differ, a corresponding log message is printed. |
On the machine running the server:
- To open the dialog for managing the server on this machine, navigate to Cloud & Queue → Manage Job Queue Server in the GeoDict menu bar.
- In this dialog, navigate to the Clients tab and click the Export my Certificate button. Then, select where you would like to save the server certificate.
- Copy the server certificate to all the client machines from which you want to access the job queue server.
- Collect certificates from all client machines.
- Go to the Cloud & Queue → Manage Job Queue Server → Clients tab and click on the Add Clients... button.
- In the file browser, select all client certificates and click Open.
- The Registered Clients list now shows all added clients.
- Go to the Jobs tab and click Start Server. The server will start immediately, opening a terminal window in which it runs.
- Optional: Jobs are executed sequentially by default, but you can enable parallel execution by increasing the maximum number of parallel jobs the Job Queue Settings.
- Registered client machines can now submit jobs to the job queue server.
On all client machines:
- In the menu bar, go to Cloud & Queue → Setup Job Queue to open the dialog that manages the registered servers for this client machine.
- Click on the Export my Certificate button, then select where to save the client certificate.
- Copy the client certificate to the machine running the job queue server.
- Obtain the server certificate.
- Go to Cloud & Queue → Setup Job Queue, then click on Add Servers....
- In the file browser, select the server certificate and click Open.
- The server is now shown the the Registered Servers list.
- After the server is running and the client certificate has been added, jobs can be submitted from this machine.
|
Warning! When the server grants access to a client, the client is granted permissions and may gain broad access to the server machine. For instance, Python scripts can be executed via GeoDict, which could potentially access sensitive resources. To maintain security, we strongly recommend setting up a dedicated "functional" user account on the server. 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. |
