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:
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.
If there are any queues in RSM that are not defined
in EKM under /Administration/Servers/Master, they will be created in EKM.
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.
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:
Go to the Administration section and then go to the Servers/Master folder.
Click the synchronize queues button
on the toolbar. This displays a dialog reporting
the progress of the synchronization.