Setting up a Job Queue Server
On this page all necessary steps to start a job queue server and allow access from client machines are explained. It is possible to only use the job queue server on the machine running the server (local) or to submit jobs from other client machines to the server (remote).
Setting up a local Job Queue Server
- Start GeoDict.
- Go to Cloud & Queue → Manage Job Queue Server in the menu bar to open the dialog for managing the server on your machine.
- Click on Start Server in the Jobs tab of the dialog. The server starts immediately and a terminal window opens in which the server runs.
- You can now submit jobs to your local server by using the Job Queue button. No exchange of certificates is required since the machine running a job queue server is always automatically listed as its client.
|
Setting up a remote Job Queue Server
To set up a remote Job Queue Server, the client and server must be configured to recognize each other. For this, we use certificates that need to be exchanged between the server and the client. All necessary steps are described here.
|
Important! In order for the job queue to function across multiple machines, they must be in the same network and able to communicate with each other. This may require coordination with your IT department for setting up.
|
On the machine running the server:
- Start GeoDict.
- Go to Cloud & Queue → Manage Job Queue Server in the menu bar to open the dialog to manage the server on this machine.
- Navigate to the Clients tab of this dialog and click on the Export my Certificate button. Then select a place where the server certificate should be saved.
- Copy the server certificate to all client machines that you want to be able to access this job queue server.
- Obtain all certificates from all client machines.
- Go to the Cloud & Queue → Manage Job Queue Server → Clients tab and click on the Add Clients button.
- Select all client certificates in the file browser and click Open.
- All added clients are now shown the the Registered Clients list.
- Go to the Jobs tab and click Start Server. The server starts immediately and a terminal window opens in which the server runs.
- Jobs can now be submitted to the job queue server from the registered client machines.
On all client machines:
- Start GeoDict.
- Go to Cloud & Queue → Setup Job Queue in the menu bar to open the dialog managing the registered servers for this client machine.
- Click on the Export my Certificate button and select a place where the client certificate should be saved.
- Copy the client certificate to the machine running the job queue server.
- Obtain the server certificate.
- Go to Cloud & Queue → Setup Job Queue and click on the Add Servers button.
- Select the server certificate in the file browser and click Open.
- The server is now shown the the Registered Servers list.
- Once the server is running and the client certificate was added to the server, jobs can be submitted from this client machine.
|
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.
|
|
