Chat now with support
Chat with Support

Identity Manager 8.0.2 - Release Notes

Product licensing

This product does not require licensing.

Upgrade and installation instructions

NOTE: To install One Identity Manager 8.0.2 for the first time, follow the installation instructions in the One Identity Manager Installation Guide. For more detailed instructions about updating, see the One Identity Manager Installation Guide.

IMPORTANT:

  • Ensure that the administrative system user, who is going to compile the database, has a password before you update the One Identity Manager database to version 8.0.2. Otherwise the schema update cannot be completed successfully.
  • Note the following for automatic software updating:
    • Automatic software updating of version 7.0 to version 8.0.2 only works smoothly if the service pack 7.0.3 is installed. In addition, the files VI.Update.dll and JobService.dll must be installed.

      Request the files VI.Update.dll and JobService.dll from the support portal.

      To distribute the file, use the Software Loader.

      Future version 7.0 service packs will already contain the changes to these files, and therefore, must not distributed separately.

    • Automatic software updating of version 7.1 to version 8.0.2 only works smoothly if the service pack 7.1.3 is installed.

To update an existing One Identity Manager installation to version 8.0.2

  1. Run the all consistency checks in the Designer in Database section.
    1. Start the Consistency Editor in the Designer using the Database | Check data consistency menu item.
    2. In the Test options dialog, click .
    3. Under the Database node, enable all the tests and click OK.
    4. Start the check by selecting the Consistency check | Run menu item.

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

  2. Update the administrative workstation, on which the One Identity Manager database schema update is started.
    1. Execute the file Autorun.exe from the root directory of the One Identity Manager installation medium.
    2. Change to the Installation tab. Select the edition you have installed and click Install.

      This starts the installation wizard.

    3. Follow the installation instructions.

      IMPORTANT: Select the directory you used for your previous installation as the installation directory on the Installation settings page. Otherwise the components are not updated and a new installation is created in the second directory instead.
  3. Stop the One Identity Manager Service on the update server.
  4. Create a backup of the One Identity Manager database.
  5. If you are using an SQL Server database, set the compatibility level to 130.
  6. Run the One Identity Manager database schema update.
    • Start the Configuration Wizard on the administrative workstation and follow the instructions.

  7. 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 Installation tab. Select the edition you have installed and click Install.

      This starts the installation wizard.

    3. Follow the installation instructions.

      IMPORTANT: Select the directory you used for your previous installation as the installation directory on the Installation settings page. Otherwise the components are not updated and a new installation is created in the second directory instead.
    4. Check the One Identity Manager Service's login data. Revert to the original settings if the One Identity Manager Service did not initially use the local system account for logging in. Enter the service account to use.
  8. Start the One Identity Manager Service on the update server.
  9. Update other installations on workstations and servers.

    You can use the automatic software update method for updating existing installations.

  10. Any required changes to system connectors or the synchronization engine are made available when you update One Identity Manager. These changes must be applied to existing synchronization projects to prevent target system synchronizations that are already set up, from failing. Patches are made available for this.

    NOTE: Some patches are applied automatically. A process that migrates all existing synchronization project is queued in the Job queue to do this. To execute the process, the One Identity Manager Service must be started on the database server and on all the synchronization servers.

    • Check whether the process DPR_Migrate_Shell has been started successfully.

      If the patch cannot be applied because the target system could not be reached, for example, you can manually apply it.

    For more information, see Applying patches to synchronization projects.

To update an application server to version 8.0.2

  • After updating the One Identity Manager database's schema, the application server starts the automatic update.
  • To start the update manually, open the application's status page in the browser and select Update immediately from the current user's menu.

To update the Web Portal to version 8.0.2

NOTE: As from version 7.1. and later, the Web Portal requires an application server with a search service installed on it. For more information, see the document Web Designer and Web Portal Changes and the One Identity Manager Installation Guide.

NOTE: Ensure that the application server is updated before you install the Web Portal.
  • To update the Web Portal automatically, connect to the monitoring site http://<server>/<application>/monitor in a browser and start the web application update.
  • To manually update the Web Portal, uninstall the existing Web Portal and install the Web Portal again. For more information, see the One Identity Manager Installation Guide.

To update the Operations Support Web Portal to version 8.0.2

  1. Copy the contents of the folder Modules\QER\dvd\AddOn\Operations Support Web Portal to the installation directory for the Operations Support Web Portal, for instance OperationSupport.
  2. Copy the following file in the folder bin into the Web Portal application install directory.
    • Modules\QER\install\bin\QER.WebRuntime.WebApi.dll

    • Modules\QBM\install\bin\QBM.CompositionApi.Web.dll

To update the Manager web application to version 8.0.2

  1. Uninstall the Manager web application
  2. Reinstall the Manager web application.
  3. The Manager default user requires write access to the Internet Information Services web application installation directory so that Manager web applications can be updated automatically. Check that the correct permissions are allocated.

Applying patches to synchronization projects

CAUTION: Patches do not change customizations in synchronization projects. This mean that conflicts may occur if patches are applied to synchronization projects, which have been customized. This may cause loss of data.

Before you apply a patch

  1. Read the patch description to decide whether it provides the necessary improvements for the synchronization project.
  2. Check whether conflicts with customizations could occur.
  3. Create a backup of the database so that you can restore the original state if necessary.
  4. Deactivate the synchronization project.

NOTE: If you have set up synchronization projects for connecting cloud application in the Universal Cloud Interface, update the target system schema in these synchronization projects before you apply the patches. Use the Synchronization Editor.

To apply patches

  1. Open the synchronization project in the Synchronization Editor.

  2. Select Edit | Update synchronization project... from the menu.

  3. Select the patches to apply under Available patches. Multi-select is possible.

    In the Patch details view, patches are listed in the order in which they will be applied.

  4. Click Apply selected patches.

  5. Enter any user input as prompted.

  6. If necessary, use the patch log to check whether customization need to be reworked.

  7. If required, rework customizations in the synchronization configuration.

  8. Run a consistency check.

  9. Simulate the synchronization.

  10. Activate the synchronization project.

  11. Save the changes.

NOTE: A patch does not take effect until the changes associated with it are saved in the database. If consistency check or simulation errors occur that cannot be corrected, you can dismiss the patch changes by reloading the synchronization project without saving the changes.

For more detailed information about updating synchronization projects, see the One Identity Manager Target System Synchronization Reference Guide.

See also:

Verifying successful installation

To determine if this version is installed

  • Start the Designer or the Manager and select the menu item Help | Info.

    The System information tab gives you an overview of your system configuration.

    The following version numbers for modules and the application version 8.0 2017-11-04-162 indicate that this version is installed.

    ServiceNow module

    2017.0011.0004.0000

    All other modules

    2017.0011.0004.0200

This service pack updates all files that shipped with One Identity Manager 8.0.

Related Documents