Chat now with support
Chat with Support

Identity Manager 8.1.4 - Operational Guide

About this guide Simulating data changes in the Manager Scheduling operations activation times Re-applying templates Exporting data with Manager Analyzing data and data changes Analyzing process monitoring in the Manager Schedules in One Identity Manager Mail templates in One Identity Manager Password policies in One Identity Manager Working with change labels Checking data consistency Compiling a One Identity Manager database Transporting custom changes Importing data with Data Import Importing and exporting individual files for the software update Command line programs

Compiling a database with the Database Compiler

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.

To ensure that HTML applications are successfully compiled, you must download packages from the NPM repository. Ensure that the workstation you are compiling on, can establish a connection to the registry.npmjs.org:443 website.

Alternatively, you can download packages from a proxy server and install them manually.

To compile a database

  1. In the Designer, select the Database | Compile database menu item.

  2. On the Database Compiler home page, click Next.
  3. On the Compilation settings page, you can specify which parts of the database are to be recompiled.

    Table 38: Compilation settings

    Setting

    Description

    Web services

    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.

    Type-safe database model

    Type-safe classes are created from table and column definition that you can use in scripts. As a result, a check whether the correct classes are used is performed when the scripts are written and compiled.

    TIP: After a schema extension, use this option to compile the database.

    Scripts in the Script Library

    To compile scripts from the script library, select the following items:

    Table 39: Selection for script compilation
    Selection Description

    Do not compile scripts

    The scrips in the script library are not compiled.

    Scripts without dependencies

    This variant results in script changes only becoming effective when the One Identity Manager tools are restarted.

    Scripts incl. all dependencies

    The scripts and all dependencies, such as templates, tasks, and processes, are recompiled. This guarantees that the script changes are loaded and become effective immediately. One Identity Manager tools do not need to be restarted.

    Templates, tasks, etc.

    Specifies whether code snippets, such as templates, formatting scripts or task definitions, are compiled. To limit which code snippets are to be compiled, use to show other selection options.

    Processes

    Specify whether processes are compiled. To limit which processes are to be compiled, use to show selection options.

    Table 40: Selection for compiling processes
    Selection Description

    All processes

    All processes are compiled.

    Changed processes

    All processes that have been modified since the last compilation are compiled.

    Selected processes

    Select single objects whose processes are to be compiled.

    To select single objects

    1. Click the [...] button.
    2. Choose between compiling modified processes, all processes or selected custom processes. You can limit the preselection more.
    3. Click OK.

    Compiling the web projects

    Specify whether web projects are compiled. To limit which web projects are to be compiled, use to show other selection options.

    Compiling the API projects

    Specifies whether API projects are compiled.

    Compile HTML applications

    Specifies whether HTML applications are compiled. To limit which HTML applications are compiled, use to show other selection options.

    Extract language-dependent texts

    Texts from scripts are extracted for translation into other languages. The templates are generated for the translation.

  4. To start compiling, click Next.

  5. The compiling progress is displayed on the Compiling page. Compiling may take some time. After you close compiling, click Next.
  6. To end the program, click Finish on the last page.

Output of errors and warnings during compilation

If compiler errors or warnings occur:

  1. Correct the error after compilation is finished.

  2. Recompile the database.

Errors are displayed in a separate log window during the compilation process in the Database Compiler.

  • Double-click an error message in the lower part of the log window to jump to the relevant line in the source code view in the upper part of the log window. You can only view the source code you cannot edit it.
  • Select Save to save the error messages to a file.
  • Select Close to close the error log. Then the compilation continues.

Figure 12: Error message log

All compiler errors and warnings are recorded during compilation. You can view compiler errors and warnings after compilation is complete.

To display and save messages

  • Select the Show button to display a message in the error message window. For detailed information about the error message window, see the One Identity Manager Process Monitoring and Troubleshooting Guide.
  • To save all messages to a file, select an entry and then select Save log to file from the context menu.
  • To add a message to the clipboard, select the entry and press Ctrl + C.

Transporting custom changes

Automatic version control is integrated into One Identity Manager, ensuring that One Identity Manager components are always consistent with each other and with the database. If program extensions that change the structure are implemented - for example, table extensions - the database needs to be updated.

You need to update the database if hotfixes and service packs are available for the version of One Identity Manager you are currently running or for complete version updates. In addition, customer-specific changes must be transferred from a development database into the test database and into the production system database.

Detailed information about this topic

Types of transport packages

You can customize the One Identity Manager schema by loading so-called transport packages. One Identity Manager recognizes the following types of transport packages that can be copied to the database depending on requirements.

Table 41: Transport package
Transport package type Description Tool used

Migration package

Migration packages are provided by for the initial database schema installation, for service pack and complete version updates. A migration package contains all the necessary tables, data types, database procedures, and the default One Identity Manager configuration.

Configuration Wizard

Hotfix package

Hotfix packages are provided to load individual corrections to the default configuration such as templates, scripts, processes, or files into the database.

NOTE: If a hotfix package only contains changed files, load these files into the database using the Software Loader file.

Database Transporter

Software Loader

Custom configuration package

A custom configuration package is used to exchange customer specific changes between the development, test, and productive system database. This transport package is created by the customer and loaded into the database.

Database Transporter

NOTE: If, in additional to a hotfix package, there are additional customized configuration settings to be installed in a One Identity Manager database, create a custom configuration package and use the Database Transporter to import it into the target database. There is no support for merging a hotfix package with a custom configuration package into one transport package.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating