Chat now with support
Chat with Support

Identity Manager 8.0 - Installation Guide

About this Guide One Identity Manager Overview Installation Prerequisites Installing the One Identity Manager Installing and Configuring the One Identity Manager Service Updating the One Identity Manager Installing and Updating a One Identity Manager Application Server Installing, Configuring and Maintaining the Web Portal Installing the Operations Support Web Portal Installing and Updating the Manager Web Application Logging into One Identity Manager Tools Troubleshooting Appendix: One Identity Manager Authentication Modules Appendix: Creating a One Identity Manager Database for a Test or Development Environment from a Database Backup Appendix: Manager Web Application Extended Configuration Appendix: Machine Roles and Installation Packages Appendix: Settings for a New SQL Server Database

Editing the Database during Update

Installation and configuration of the database is automatically carried out by the Configuration Wizard. This procedure may take some time depending on the amount of data and system performance.

The Configuration Wizard performs the following steps:

  • Schema installation

    Before the schema installation can take place the Configuration Wizard tests the database. Error messages are displayed in a separate window. The errors must be corrected manually. The schema installation cannot be started until these are resolved.

    All the tables, data types, database procedures that are required are loaded into the database through migration. When a migration package is imported into a One Identity Manager database, the following operations are executed:

    Table 36: Operations When Importing a Migration Package
    Operation Description
    Insert A new object with key values is added in the target database if no object is found through an alternative key.
    Update If an object is found in the target database through an alternative key, this object is updated.
    Delete Objects no longer required in the target database are deleted.

    During migration, calculation tasks are queued in the database. These are processed by the DBQueue Processor.

    When a schema is installed with the Configuration Wizard, migration date and migration revision are recorded in the database's transport history.

  • System compilation

    Scripts, templates and processes are declared in the database. The authentication module "system user" with the given system user is used for compiling.

  • Automatic update

    In order to distribute One Identity Manager files using the automatic software updating mechanism, the files are loaded into the One Identity Manager database.

Related Topics

Installing a Hotfix in the One Identity Manager Database

Installing a Hotfix in the One Identity Manager Database

IMPORTANT: Test changes in a test system before you install a hotfix in a productive system.

Hotfix packages contain:

  • Transport packages which contain changes to the default configuration, such as templates, scripts, processes in the One Identity Manager database
  • Modified files, such as *.exe, *.dll or *.vif

When you receive a transport package with a hotfix, use the program "Database Transporter" to update the One Identity Manager database.

When you import a transport package with the Database Transporter, the import date and description, the database version and the transport package name are recorded in the transport history of the target database.

If a hotfix contains a modified file, copy the file to the install directory of the test computer for testing. To distribute files using automatic software update to all workstations and server, import the files into the One Identity Manager database with the program "Software Loader".

NOTE: If more custom configuration adjustments are made to a One Identity Manager database, then create a custom configuration package and import this transport package in the target database with the Database Transporter. There is no support for merging a hotfix package with a custom configuration package into one transport package.

Detailed information about this topic

Displaying Contents of a Transport Package with the Database Transporter

Displaying Contents of a Transport Package with the Database Transporter

You can display the contents of a transport package with the Database Transporter before you import.

NOTE: Always start the Database Transporter on an administrative workstation!

To display the contents of a transport package

  1. Start the Launchpad and select Transport custom modifications. This starts the program "Database Transporter".
  2. Select Show transport file on the start page.
  3. Select the transport package file browser and click Open.
  4. Click Next on the Select transport file page.
  5. The contents of the transport file are displayed on the Show transport file.
    • To display the order for importing objects
      1. Us + to open an entry in the transport file and select Sort in import order from the context menu.
      2. Click OK and enter the database connection data. This step is only required when you established the first in the order.

        The order in which the entry's objects are imported into the database is found.

      3. Repeat this step for all other entries for which you want to determine the import order.
  6. Click Finish on the last page to end the program.

Related Topics

Importing a Transport Package with the Database Transporter

Importing a Transport Package with the Database Transporter

NOTE: To import transport packages with the Database Transporter, the current user must be authorized to use the program function "Allows transport packages to be imported into the database (Transport_Import)".

NOTE: Always start the Database Transporter on an administrative workstation!

To import a transport package

  1. Start the Launchpad and select Transport custom modifications. This starts the program "Database Transporter".
  2. Select Import transport file on the start page.
  3. Enter the connection credentials for the One Identity Manager database, into which you want to import the transport package, on the Select the database connection page.
  4. Select the transport package file browser and click Open.

  5. Specify your import options on the Select transport file.
    1. To create an import log file, set the option Create import log file.

      The log file is saved in the output directory of the transport file.

    2. To import individual objects, set the option Import objects singly and ignore errors.

      Errors, which might occur during importing are ignored and displayed when importing is complete. If this option is not set, the import is stopped when an error occurs.

  6. Import steps and import progress are displayed on the Importing transport data page. The import procedure can take some time. Calculation tasks are queued for the DBQueue Processor on termination.
  7. If changes have been made to the system configuration, for example, processes or scripts imported, you have to compile the database after the tasks have been processed. Compilation is started automatically once importing is complete.
  8. Click Finish on the last page to end the program.

    NOTE: Use the button to save errors that occur whilst importing.

When you import a transport package with the Database Transporter, the import date and description, the database version and the transport package name are recorded in the transport history of the target database.

Related Topics
Related Documents