Chat now with support
Chat with Support

Identity Manager 8.0 - Configuration Guide

One Identity Manager Software Architecture Working with the Designer Customizing the One Identity Manager Default Configuration Checking Data Consistency Compiling a One Identity Manager Database Working with Change Labels Basic System Configuration Data
One Identity Manager Authentication Module Database Connection Data Configuration Parameters for System Configuration Setting up the Mail Notification System Enabling More Languages for Displaying and Maintaining Data Displaying Country Information Setting Up and Configuring Schedules Password Policies in One Identity Manager Reloading Changes Dynamically TimeTrace Databases Machine Roles and Server Functions Files for Software Update Operating Systems in Use System Configuration Reports Using Predefined Database Queries Managing Custom Database Objects within a Database
The One Identity Manager Data Model Granting One Identity Manager Schema Permissions Working with the User Interface
Object definitions for the User Interface User Interface Navigation Forms for the User Interface Statistics in the One Identity Manager Extending the Launchpad Task Definitions for the User Interface Applications for Configuring the User Interface Icons and Images for Configuring the User Interface Language Dependent Data Representation
Process Orchestration in One Identity Manager
Declaring the Job Server One Identity Manager Service Configuration Handling Processes in the One Identity Manager
Tracking Changes with Process Monitoring Conditional Compilation using Preprocessor Conditions One Identity Manager Scripts Maintaining Mail Templates Reports in the One Identity Manager Custom schema extensions Transporting One Identity Manager Schema Customizations Importing Data Web Service Integration SOAP Web Service One Identity Manager as SPML Provisioning Service Provider Searching for Errors in the One Identity Manager Processing DBQueue Tasks One Identity Manager Configuration Files

Displaying the Job Queue Sequence

To display the Job queue sequence

  • Select View | DBQueue from the menu.

This queries the number of entries in the Job queue. The current value is represented by a number and inserted, at the same time, into a bar graph. The process step progress state is shown in different colors. The display is updated every 5 seconds.

The tooltip shows the timestamp and the number of process steps in the Job queue at this point.

Table 353: Progress View - Meaning of the Colors
Color Meaning Progress state
Black Number of process steps that are not read for processing. False
Green Number of process steps ready for processing. True
Yellow Number of process steps loaded for processing. Loaded
Blue Number of process step that have completed processing Finished
Red Number of process steps with an unknown progress state Frozen/Overlimit/Missing

Stopping the System (Emergency Stop)

In certain circumstances, situations can occur in the system that require processing by One Identity Manager Service and processing of tasks by the DBQueue Processor to be stopped. Changes in One Identity Manager can, for example, sometimes cause the system to become overloaded by making mass entries in the job queue or the DBQueue. To analyze this situation and to take the necessary steps to solve the problem where necessary, the system can be stopped in Job Queue Info and started again once the problem has been fixed.

To temporarily halt process handling of a single Job server

  • Select the menu View | Server state from the menu and select the Job server.
  • Select Process handling from the context menu.
  • Use Start processing to continue processing the queue.

To stop processing entirely

  • Select Help | Emergency stop.
  • To stop DBQueue processing, click the DBQueue Processor button.

    From this point on no new calculations are carried out in the database.

    NOTE: After the problem has been fixed, the DBQueue Processor can be started again using the same button.

  • Click the One Identity Manager Service button to stop collection of process steps for all One Identity Manager Services.

    Process steps that have already been collected are still processed but no new process step are sent to the services.

    NOTE: After the problem has been fixed, the service can be started again using the same button.

The following icons are displayed in the status bar of all administration tools to inform the user that DBQueue Processor processing and services have been stopped.

Table 354: Special Icon in the Status Bar for System Stop
Icon Meaning
The DBQueue Processor has been stopped.
The server services have been stopped.

Error Messaging in the Error Message Window

Error messages are shown in a separate window in One Identity Manager tools. In addition, a more detailed description of the error is displayed.

Figure 61: Error Message Window

Configure the amount of information to be displayed using the options in the error message window.

To change options

  • Open the configuration with the button and enable or disable the options you want.

NOTE: The button Send as mail creates a new email message in the default mail program and copies over the error text.

Table 355: Options for Displaying Error Messages
Option Meaning

Show previous errors

Specifies whether all previous errors that lead to the current error, should also be shown.

Show One Identity error numbers

Specifies whether internal error numbers are shown.

Show error positions

Specifies whether error position are also shown in the program code.

Wrap long lines

Specifies whether long error messages are wrapped.

Show only user relevant

Specifies whether all error messages or only message classified as "user relevant" are shown.

Show asynchronous calls Specifies whether error messages in asynchronous method calls are shown.
Show crash report Specifies whether error messages from the crash recorder are shown.
Related Topics

Displaying Messages in the Error Log View

A program's error log, as in the Manager for example, collects all the messages, such as error messages and warnings, that have occurred since the program started. The error log is reinitialized when the program is restarted.

To display items from error log

  1. In the Manager, go to View | Error log.
  2. Enable the view in the error log toolbar.

TIP: Double-click a message to open more details in a separate dialog box.

Figure 62: Detailed information about a message

You can configure how the messages are displayed in the error log. To do this, switch the error log to advanced mode by clicking on the right of the column headers. Here you have the possibility to debug individual actions.

Figure 63: Simple Error Log (above) and Advanced Error Log (below)

Table 356: Meaning of Icons in the Error Log
Icon Meaning
Logs all critical error messages. (Severity level = Fatal)
Logs all information. (Severity level = Info)
Logs all warnings. (Severity level = Warning)
Logs all error messages. (Severity level = error)
Logs debugger output. This setting should only be used for testing. (Severity level = Debug)
Logs highly detailed information. This setting should only be used for analysis purposes. The log file quickly becomes large and cumbersome. (Severity level = Trace)
Adds a custom filter condition.
Deletes filter condition.

Searches for term.

Searches next term.
Marks all messages with a specific term.
Buffer size Sets the message buffer size. The buffer's level is displayed next to the text box.
Deletes the buffer contents.
Stops logging.
Starts logging.
Saves log to file.
Specifies which column are displayed in the error log.
Copies selected messages to the clipboard.
Opens the error log with a text editor.

The following information is displayed about a message. The range of information depends on the severity level of a message.

Table 357: Information about a message
Detail Description
Severity level Level of information supplied for the message.
Timestamp Time and date of the log entry.
Logger name One Identity Manager component from which the message was sent.
Message Logged message.
Error Message Detailed error message.
Data Additional data about the message.
Sequence ID Number of the line in the error log.
Stack trace Complete stack trace for the error message.
Session ID

Session identification number.

NOTE: If there is a filter set on the session ID, only the messages for this session are displayed, for example, loading collections and single objects. If no filter is set, action outside the connection, for example, loading table definitions or configuration parameters are displayed.

TIP: You can apply different filters to limit the information being displayed. Click the arrow in the column header and select a filter. The icon in the log toolbar shows whether a filter is active.

Related Topics
Related Documents