Success and error messages from process handling are written to the One Identity Manager Service log file. In order to test you processes, you can enable logging mode for process steps in the Job Queue Info. In this case, the processing messages of the processing step are written along with the Debug level of information into a separate log. You can display the log in the Job Queue Info as well as in the log file of the One Identity Manager Service itself.
NOTE: The log mode is only available if the logged in user has permissions for the Option to selectively set the logging mode of process steps in the Job queue in Job Queue Info program function (JobQueue_LogMode).
To enable process step logging mode
-
To log the messages on success and on failure, select the process step in the Job queue view in Job Queue Info and select the Processing log > Create always context menu.
-
To log the messages on failure only, in the Job Queue Info, select the process step in the Job queue view and select the Processing log > On Error context menu item.
NOTE: You can set the log mode by default for separate process steps. To do this, edit the process step in the Designer in Process Editor. For detailed information about editing processes and process steps, see the One Identity Manager Configuration Guide.
To display the log in Job Queue Info
-
In the Job queues view in Job Queue Info, select the process step and select the Processing log > Display context menu.
This displays the log in a separate window. If a process step was run more than once, for example, if it is re-enabled more than once, several log are displayed.
To display the log in the One Identity Manager Service log file
-
In the Job Queue Info, select the Server status view on the Job server tab and select the Show in browser context menu item.
-
The log is marked with a link entry Log written to Job_<UID_Job>_<yyyymmdd>_<Timestamp>.log. Click the link to display the log.
The files are stored in the One Identity Manager Service log directory.
Repository structure:
<Log directory>\JobLogs\<First 4 digits of the UID_Job>\Job_<UID_Job>_<yyyymmdd>_<Timestamp>.log
To end log mode
Related topics
To get a quick overview of the availability of the Job server and the web server, you can request the Job Queue Info's status.
NOTE: Set the HTTP port to be queried and the maximum response time for status queries in the program settings.
TIP: Use Refresh server list or F6 to reload the list of servers.
One Identity Manager Service configurations of each Job server stored in the database are used to get more detailed results of Job server status queries. This is especially required if the HTTP server port has been set individually or a Job server processes several queues. In the Designer, configure and enable the Get configuration file from the Job server and write in the Job server configuration schedule to import the One Identity Manager Service configuration of the Job server into the database. For more information, see the One Identity Manager Configuration Guide.
To request the status of all the existing Job servers in the database
-
In the Job Queue Info program, select the View > Server state menu item.
-
Select the Job server tab and press F5.
To request the status of a single Job server
-
In the Job Queue Info program, select the View > Server state menu item.
-
On the Job server tab, select the Job server and then the Get status context menu item.
NOTE: Use the Enter credentials context menu item to enter a user and password to request the server status. You can select more than one Job server. The user information is kept until the next time the Job Queue Info starts.
If the server responds, the system time, the One Identity Manager Service version, and the One Identity Manager Service account name are determined and displayed. The software update status as well as the current version of the software are also displayed.
If an error occurs during the status request, the symbol is displayed for the Job server. You use the Show request error context menu item to show a detailed error message.
To display a Job server's services
-
In the Job Queue Info program, select the View > Server state menu item.
-
On the Job server tab, select the Job server and select the Show in browser context menu item.
The One Identity Manager Service HTTP server for the Job server is queried and the varying One Identity Manager Service services are displayed.
To show the status of a web server
-
In the Job Queue Info program, select the View > Server state menu item.
-
On the Web server tab, select the web server and select the Show in browser context menu item.
Related topics
On the Job server, the Last fetch time property logs when a process step was retrieved by the One Identity Manager Service. If no completion message for this process step has been returned within the time specified in the Common | Jobservice | LoadedJobsTimeOut configuration parameter, the One Identity Manager Service runs a check. The time of the last check for loaded process steps (Last timeout check property) is set to the current time.
To configure the process collection check, adjust the following settings in the Designer.
-
Common | Jobservice | LoadedJobsTimeOut configuration parameter
The configuration parameter contains the time in minutes within which a process should be reported back before a check is run. Default value is 15 minutes.
NOTE: If there are Job server that have exceeded the time limit, the Last timeout check column is displayed in red.
-
Common | MailNotification | NotifyAboutRequestStall configuration parameter
Use the configuration parameter to specify whether an email notification should be sent when the One Identity Manager Service stops running requests. The configuration parameter is not set by default.
-
Send notification when Job server is not requesting processes schedule
The schedule checks whether the One Identity Manager Service regularly asks for processes from a queue. If a One Identity Manager Service stops making process requests, notification is sent by email.
Enable the schedule. The interval should be set as in the Common | Jobservice | LoadedJobsTimeOut configuration parameter.
A queue is initialized when the One Identity Manager Service starts. The One Identity Manager Service queries the Job queue to see which processes are waiting for its own queue. During the initialization phase, no processes are handled and it may take a long time, particularly if the Job queue is very full.
In Job Queue Info, in the Progress view, a warning shows you the queue being initialized. Click the message to get more detail.
Related topics