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

Compiling a Database with the Database Compiler

Compiling a Database with the Database Compiler

To compile a database, use the Database Compiler You start the Database Compiler in the Designer.

NOTE: Before you begin the compilation, all the DBQueue Processor tasks have to be processed. If there are still outstanding tasks on the database, you are notified by the Database Compiler. In this case the compilation cannot go ahead.

To compile a database

  1. Select Database | Compile database... in the Designer.
  2. Enter which parts of the database should be recompiled.

    TIP: Hide the other options using the arrow next to the option.

    1. To compile web services, select the Web Services option.

      The One Identity Manager offers the option of linking in data that comes from different web service interfaces. The web service proxy code is stored in the database. The Database Compiler compiles the proxy code for all web services of a DLL and saves it in the database. When changes are made to proxy code the database needs to be compiled.

    2. To create type-safe classes for the data model, select the option Typed wrappers.

      Type-safe classes are created from table and column definition that you can use in scripts. This checks whether the classes used in writing and compiling scripts are correct.

      TIP: Use this option to compile the database after extending the schema.

    3. To compile scripts from the script library, select the following items:
      Table 34: Options for Compiling Scripts
      Option Description
      Do not compile scripts Scripts from the script library are not compiled.
      Script without dependencies Changes to scripts do not become active until the One Identity Manager tool is restarted.
      Scripts including all dependencies Recompiles the scripts and all dependencies (templates, methods, processes). This guarantees that the script changes are loaded and become effective immediately. One Identity Manager tools do not need to be restarted.
    4. To compile additional script expressions, select the options Templates, methods, etc. and specify which script expressions to compile in the options underneath. You can select from templates and formatting scripts, scripts for selecting tables, view and objects, task definitions, insert values and parameter scripts.

    5. To compile processes, select the option Processes and specify which processes to compile in the options underneath.
      Table 35: Options for Compiling Scripts
      Option Description
      All processes All processes are compiled.
      Changed processes All processes hat have changed since the previous compilation are compiled.
      Selected processes...

      Only processes for the selected objects are compiled.

      To select objects separately

      1. Click [...].
      2. Select changed processes, all processes or only selected processes (user defined). You can limit the preselection more.
      3. Click OK.
    6. Set the option Extract language dependent strings if you want text from scripts to be translated.

      This creates templates for translation. Use the Language Editor to translate.

  3. To start compiling, click Next. Compiling may take some time.
  4. Click Next.
  5. Click Finish to quit the program.

Logging Compiler Errors and Warnings

NOTE: Any compiler errors and warnings are recorded during compilation. You can view compiler errors and warnings after compilation is complete.

  • Use Save log to file... in the context menu to save the compilation log.
  • Correct the error after compilation is finished.

  • Compile the database again after correcting the errors. To do this, start compilation in Designer using Database | Compile database....

To display messaging during compilation and saving

  • Select Display to display a message. This opens an error message window.

    In addition, a more detailed description of the error is displayed. Configure the amount of information to be displayed using the options in the error message window. Open the configuration with the button and enable or disable the options you want.

    Table 36: 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.

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

  • To save all the messages in a file, select the entry and select Save log to file... from the context menu.
  • To add a message to the clipboard, select the entry and user CTRL + C.

If errors occur, these are shown immediately in a separate log window during compilation.

  • If you double click on the error message with the mouse you jump to the corresponding line in the source code view (upper part of the window). You can only view the source code you cannot edit it.
  • Use the Save button to save the error messages to file.
  • Use the Close button to close the error log. Then the compilation continues.

Figure 12: Error Message Log

Working with Change Labels

Define change labels under which changes are grouped together in order to swap data between development and test databases as well as the productive database.

You can create and edit change labels in different One Identity Manager tools. The method is similar in all tools. Change labels are allocated using different methods depending on the One Identity Manager tool. Changes are normally allocated before or on saving the changes in the database.

Change labels are available in the program "Database Transporter" as export criteria for creating custom configuration packages.

Change labels can contain:

  • Changes to single object properties at a specific point in time

    When you create a custom configuration package, single object properties are added to the transport package. The properties contain the values given at the time they were added.

    IMPORTANT: This is the default process when applying changes in the Designer. If you apply this method, be consistent in booking all changes to the change label when the object is saved. It is not possible to add changes of individual properties to the change label at a later date.

  • Snapshots of an object at a specific point in time, optionally with dependent objects

    When you create a custom configuration package, the object is added to the transport package with all its properties. The properties contain the values given at the time they were added.

  • Reference to an object, optionally with dependent objects

    When you create a custom configuration package, the object is added to the transport package with all its properties. The properties are determined at the time of export.

    IMPORTANT: Object references cannot be grouped together with changes to single properties and snapshots of objects in the same change label. Book object references to their own change labels.

Detailed information about this topic

Creating Change Labels

You can create and edit change labels in different One Identity Manager tools. The method is similar in all tools and is explained in the following example from the Designer.

To create or edit change labels

  1. in the Designer menu, click Database | Change management....
  2. In the dialog box "Edit change labels...", select the icon next to the list Change labels.

    A dialog box for editing change labels is opened.

  3. Create a new change label with the button.

    - OR -

    Select a change label and open the edit view with the button.

  4. Enter the change label data.
    Table 37: Properties of change labels
    Property Meaning
    Change label Change label name. This name is used to select the change label for allocating the changes or creating a customer transport package.
    Description Detailed description of the change label.
    Parent change label Option to enter a specific parent change label.
    Status Status of object changes, for example: development, test, production.
    Status comments Additional status comments
    Comment Additional information about changes made to a change label.
    Label type Label type for further classification. Label type "Change" is used by default.
    Locked

    Indicates if the change label is locked. If a change label is locked, you can no longer make changes to it.

  5. Click the button.
  6. Click OK.

    This closes the dialog box. The change label is preselected in the Change label.

To delete a change label

  1. In the Manager menu, select Database | Edit change labels...
  2. Click the button next to the Change labels list.

    A dialog box for creating and editing change labels opens.

  3. Select the change label you want to delete and click the button.
  4. Confirm the security prompt with Yes.
  5. To close the dialog box, click Cancel.
  6. To close the dialog box, "Edit change labels..." click OK.
Related Topics
Related Documents