Specifying log retention times
Once the retention period has ended, the recorded data is either exported or deleted from the One Identity Manager database depending on which archiving method has been chosen. A longer retention period should be selected for sections whose records will be exported than for those that will be deleted.
NOTE: If you do not specify a retention period, the records in this section will be deleted daily from the One Identity Manager database within the daily DBQueue Processor maintenance tasks.
The recordings are not exported until the retention period for all sections has expired and no other active processes for the process group (GenProcID) exist in the DBQueue, process history, or as scheduled operation.
You use configuration parameters to define the data retention periods for the individual sections.
Table 125: Configuration parameter for handling change data
Common | ProcessState | PropertyLog | IsToExport |
Exports the data changes. If this configuration parameter is not set the information is deleted once the retention period has expired. |
Common | ProcessState | PropertyLog | LifeTime |
Maximum retention period in days of logged data changes in the database. The default value is 30. |
Table 126: Configuration parameter for handling process information
Common | ProcessState | ProgressView | IsToExport |
Exports the data in the process information. If this configuration parameter is not set the information is deleted once the retention period has expired. |
Common | ProcessState | ProgressView | LifeTime |
Maximum retention period in days of process information in the database. The default value is 30. |
Table 127: Configuration parameter for handling process history
Common | ProcessState | JobHistory | IsToExport |
Exports the information in the process history. If this configuration parameter is not set the information is deleted once the retention period has expired. |
Common | ProcessState | JobHistory | LifeTime |
Maximum retention period in days of logged process history in the database. The default value is 30. |
Optimizing performance by deleting log entries
If there is a large amount of data, you can specify the number of objects to delete per DBQueue Processor operation and run in order to improve performance. You use configuration parameters to make the choice for each section.
Table 128: Configuration parameters for deleting logged data changes
Common | ProcessState | PropertyLog | Delete |
Allows configuration of deletion behavior for logged data changes. |
Common | ProcessState | PropertyLog | Delete | BulkCount |
Number of entries to be deleted in any operation. The default value is 200. |
Common | ProcessState | PropertyLog | Delete | TotalCount |
Total number of entries to be deleted in any processing run. The default value is 10000. |
Table 129: Configuration parameters for deleting process information
Common | ProcessState | ProgressView | Delete |
Allows configuration of deletion behavior for process information. |
Common | ProcessState | ProgressView | Delete | BulkCount |
Number of entries to be deleted in any operation. The default value is 200. |
Common | ProcessState | ProgressView | Delete | TotalCount |
Total number of entries to be deleted in any processing run. The default value is 10000. |
Table 130: Configuration parameters for deleting process history
Common | ProcessState | JobHistory | Delete |
Allows configuration of deletion behavior for the process history. |
Common | ProcessState | JobHistory | Delete | BulkCount |
Number of entries to be deleted in any operation. The default value is 200. |
Common | ProcessState | JobHistory | Delete | TotalCount |
Total number of entries to be deleted in any processing run. The default value is 10000. |
Table 131: Configuration parameters for deleting process status entries
Common | ProcessState | Delete |
Allows configuration of deletion behavior for process status entries. |
Common | ProcessState | Delete | BulkCount |
Number of entries to be deleted in any operation. The default value is 500. |
Common | ProcessState | Delete | TotalCount |
Total number of entries to be deleted in any processing run. The default value is 10000. |
Conditional compilation using preprocessor conditions
Conditional compiling of program code is integrated into One Identity Manager. Conditional compilation allows parts of the program code to be parsed whereas other parts remain untouched.
Conditional compiling has the following advantages:
-
Assemblies are reduced in size
-
Structures the system configuration
-
Improves clarity for the model and permissions
-
Speeds up processing
-
Hides unnecessary data in all VB.Net expressions
-
Hides unnecessary model components
Conditional compiling in One Identity Manager is controlled using preprocessor conditions. Preprocessor conditions can be used in:
NOTE: Preprocessor conditions help stop the module being disabled. For example, SQL procedures and triggers are still run even if the objects are disabled by preprocessor conditions. To disabled a module, remove the module from the One Identity Manager database. For more information about removing modules, see the One Identity Manager Installation Guide.
Configuration parameters and their options define the possible preprocessor conditions. In order to become effective on a system-wide basis, every modification to preprocessor relevant configuration parameters as well as modifications to preprocessor conditions on objects and VB.Net expressions requires the One Identity Manager database to be recompiled.
Detailed information about this topic
Preprocessor-relevant configuration parameters
IMPORTANT: The One Identity Manager database needs to be recompiled every time a preprocessor-relevant configuration parameter and its options are changed.
The Preprocessor relevant parameter option is used to label a configuration parameter as preprocessor relevant. A preprocessor expression is entered in the associated configuration parameter option.
When a preprocessor relevant configuration parameter is set it is valid globally across the system. The preprocessor condition does not come into effect until the database has been compiled.
NOTE: Predefined preprocessor configuration parameters are overwritten during schema installation. Define company-specific, preprocessor-relevant configuration parameters and options in the Designer under the Custom configuration parameter.
To display preprocessor relevant configuration parameters
-
In the Designer, select the Base data > General > Configuration parameters category.
-
In the Configuration Parameter Editor, select the View > Preprocessor definitions menu item.
The Preprocessor definitions view shows all preprocessor conditions. Double-click an entry to display the configuration parameter.
NOTE: In the Designer, you can find an overview of existing preprocessor dependencies in the One Identity Manager Schema > Preprocessor dependencies category.
Related topics