9.4.1. Synchronizing Job Submission Queues

The first time that the EKM server is started, it will attempt to find queues defined in RSM and automatically create batch job submission queues of the same name in EKM under /Administration/Servers/Master. EKM will also detect interactive queues defined in the ekm.xml file and add them to the same folder. This automatic synchronization will occur every time that the EKM server is subsequently started to keep EKM up-to-date with the settings defined in RSM and the ekm.xml file.

For batch job submission queues, the synchronization process works as follows:

  1. EKM contacts RSM so that it can compare the queues defined in RSM with the Batch Job Submission Queues defined in EKM on the /Administration/Servers/Master page.

  2. If there are any queues in RSM that are not defined in EKM under /Administration/Servers/Master, they will be created in EKM.

  3. If a queue is defined in EKM but is not defined in RSM, a notConfigured status flag is set for the queue in EKM. In /Administration/Servers/Master, you will see a warning icon   next to the queue and the corresponding tool tip will indicate" Queue not configured in RSM."


Important:  Any queues that are marked as notConfigured will be unavailable for job submission. Users will not be able to send jobs to these queues as they do not exist in RSM. If this queue is later defined in RSM and you synchronize from EKM again, the notConfigured status flag will be cleared and the queue will be available for job submission.



Note:
  • During synchronization, the EKM Server Data Extraction Queue is ignored (see Types of Queues). Only Job Submission Queues are synchronized.

  • During startup, the EKM server will synchronize the queues for all workspaces. Each workspace stores its own queue definitions, so they all will be synchronized.

  • RSM's default localhost cluster configuration contains a queue named Local, so you can always expect to see a queue named Local in EKM.


In addition to the synchronization performed at startup, an EKM administrator may synchronize queues at any time from the EKM interface. This may be necessary, for example, if a queue has been accidentally deleted in the current session. Unlike the automatic synchronization performed at startup, on-demand synchronization only synchronizes the queues in the current workspace.

To synchronize queues for the workspace to which you are currently signed in, do the following:

  1. Go to the Administration section and then go to the Servers/Master folder.

  2. Click the synchronize queues button   on the toolbar. This displays a dialog reporting the progress of the synchronization.


Release 18.2 - © ANSYS, Inc. All rights reserved.