Chat now with support
Chat with Support

Identity Manager 8.1.2 - Data Archiving Administration Guide

Installing and configuring a server

The One Identity Manager History Service service ensures data transfer from the One Identity Manager database to the One Identity Manager History Database.

The system prerequisites for installing the One Identity Manager History Service on an server and the permissions required are described in the One Identity Manager Installation Guide.

Use the installation wizards to install the One Identity Manager History Service on the server for the first time. Installation and configuration of the One Identity Manager History Service is analog to One Identity Manager Service. The sequence is described in the One Identity Manager Installation Guide.

Installing One Identity Manager History Database components

To install components

  1. Launch autorun.exe from the root directory of the One Identity Manager installation medium.

  2. Go to the Other products tab, select One Identity Manager History Database, and click Install.

  3. This starts the installation wizard. Select the language and click Next.

  4. Confirm the conditions of the license.

  5. On the Installation settings page, enter the following information.

    • Installation source: Select the directory containing the installation files.

    • Installation directory: Select the directory in which you want to install the files for One Identity Manager History Database.

      NOTE: To make further configuration settings, click on the arrow button next to the input field. Here, you can specify whether you are installing on a 64-bit or a 32-bit operating system.

      For a standard installation, no further configuration settings are necessary.

  6. On the Assign machine roles page, define the machine roles.

    NOTE: All installation subpackages are selected when you select the machine role. You can deselect individual packages.

  7. On the Change service properties page, you can change the name, display name and the description for installing the One Identity Manager Service.

    NOTE: This page is only shown if you have selected the Server | Job Server machine role.

  8. You can start different programs for further installation on the last page of the install wizard.
    • To perform installation of the One Identity Manager History Database schema, start the Configuration Wizard and follow the instructions of the Configuration Wizard.

      NOTE: Only perform this step on the workstation that you use to start installing the One Identity Manager History Database schema.

  1. Click Finish to close the installation wizard.
  2. Close the autorun program.

The One Identity Manager is installed for all user accounts on the workstation or server. In the default installation the One Identity Manager is installed under:

  • %ProgramFiles(x86)%\One Identity (on 32-bit operating systems)

  • %ProgramFiles%\One Identity (on 64-bit operating systems)

Installing and updating a One Identity Manager History Database

The One Identity Manager database and One Identity Manager History Database must have the same version level.

Installation and update of a One Identity Manager History Database is similar to a One Identity Manager database. Use the Configuration Wizard to set up the One Identity Manager History Database. The Configuration Wizard executes the following steps.

  1. Installs the One Identity Manager History Database schema in a database.

    The Configuration Wizard can create a new database and install the schema. Alternatively, the schema can be installed in an existing database.

  2. Creates the required SQL Server logins and database users permissions for the administrative user, configuration user and end user.
  3. Creates administrative system users and permissions groups.
  4. Installs and configures the One Identity Manager Service with direct access to the One Identity Manager History Database for handling SQL processes.

For detailed information about system prerequisites for installing and updating a database, see the One Identity Manager Installation Guide.

The update process for releasing a new version

IMPORTANT: The One Identity Manager database and the One Identity Manager History Database must have the same version number.

NOTE: Read the release notes for possible differing or additional steps for updating One Identity Manager.

For detailed information about updating a database, see the One Identity Manager Installation Guide.

To update the One Identity Manager History Database to a new version

  1. In the Designer, carry out all consistency checks in the Database section.
    1. In the Designer, start the Consistency Editor by selecting the Database | Check data consistency menu item.
    2. In the Test options dialog click the icon .
    3. Activate all tests in the Database view and click OK.
    4. To start the check, select the Consistency check | Run menu item.

      All the database tests must be successful. Correct the errors. Some consistency checks offer repair methods for correcting errors.

  2. Update the administrative workstation on which the One Identity Manager History Database database schema update will start.
    1. Execute the autorun.exe program from the root directory on the One Identity Manager installation medium.
    2. Switch to the Other products tab and select the One Identity Manager History Database entry.

    3. Click Install.

      This starts the installation wizard.

    4. Follow the installation instructions.

      IMPORTANT: On the Installation Settings page, select the directory for your current installation as the installation directory. Otherwise the components are not updated and a new installation is created in the second directory instead.
  3. (From version 7.0.x or version 7.1.x) End the One Identity Manager Service on the server that processes direct database queries.

    (From version 8.0.x or version 8.1.x). End the One Identity Manager Service on the update server.

  4. Create a back up of the One Identity Manager History Database.
  5. Check whether the database's compatibility level is set the 130 and change it if necessary.
  6. Run a schema update of the One Identity Manager History Database.

    • Start the Configuration Wizard on the administrative workstation.

      Select a user who has at least administrative permissions for the One Identity Manager database to update the One Identity Manager schema with the Configuration Wizard.

      • Use the same user that you used to initially install the schema.

      • If you created an administrative user during schema installation, use that one.

      • If you selected a user with Windows authentication to install the schema, you must use the same one for updating.

      NOTE: If you want to switch to the granular permissions concept when you upgrade from version 7.0.x, 7.1.x or 8.0.x to 8.1.2, you will also require an installation user in accordance with Permissions for the One Identity Manager History Database on a SQL Server.

      After updating One Identity Manager, change the connection parameters. This affect the connection credentials for the database (DialogDatabase), for example, the One Identity Manager Service, the application server, administration, and configuration tools, web applications and web services, and the connection credentials in synchronization projects.

      If you want to switch to granular permissions when you update from 8.1.x, contact support. To access the Support Portal, go to https://support.oneidentity.com/identity-manager/.

  7. (From version 7.0.x or version 7.1.x) Update the One Identity Manager Service on the server that processes direct database queries.

    (From version 8.0.x or version 8.1.x). Update the One Identity Manager Service on the update server.

    1. Execute the program autorun.exe from the root directory on the One Identity Manager installation medium.

    2. Change to the Other products tab and select the One Identity Manager History Database entry.

    3. Click Install.

      This starts the installation wizard.

    4. Follow the installation instructions.

      IMPORTANT: On the Installation Settings page, select the directory for your current installation as the installation directory. Otherwise the components are not updated and a new installation is created in the second directory instead.
  8. Check the One Identity Manager Service‘s login information. Revert to the original settings if the One Identity Manager Service did not initially use the local system account for logging in. Specify the service account to use.

  9. Start the One Identity Manager Service on the update server.

Related Documents