Chat now with support
Chat with Support

Identity Manager 9.2.1 - Release Notes

Updating One Identity Manager to version 9.2.1

Updating One Identity Manager to version 9.2.1

IMPORTANT: Note the Advice for updating One Identity Manager.

To update an existing One Identity Manager installation to version 9.2.1

  1. Run all the consistency checks in the Designer in Database section.

    1. Start the Consistency Editor in the Designer by selecting 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. Select the Consistency check > Run menu item to start testing.

      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. Run 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.

    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. Complete the One Identity Manager Service on the update server.

  4. Make a backup of the One Identity Manager database.

  5. Check whether the database's compatibility level is set the 150 and change it if necessary.

  6. Run the One Identity Manager database schema update.

    • Start the Configuration Wizard on the administrative workstation and follow the instructions.

      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 as you used for initially installing 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 8.0.x to version 9.2.1, use an installation user with permissions for this permissions concept. For more detailed information about permissions, see the One Identity Manager Installation Guide.

      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. Update the One Identity Manager Service on the update server.

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

    2. Change to the Installation tab. Select the Edition you have installed.

    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 login information of the One Identity Manager Service. Specify the service account to use.

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

  10. Update other installations on workstations and servers.

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

To update synchronization projects to version 9.2.1

  1. If you have set up synchronization projects for connecting cloud applications in the Universal Cloud Interface, update the target system schema in these synchronization projects using the Synchronization Editor.

  2. 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 projects is queued in the Job queue to do this. To run the process, the One Identity Manager Service must be started on all synchronization servers.

    • Check whether the DPR_Migrate_Shell process 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 9.2.1

  • 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 Designer Web Portal to version 9.2.1

NOTE: Ensure that the application server is updated before you update the Web Designer Web Portal.

  • To update the Web Designer Web Portal automatically, connect to the runtime monitor http://<server>/<application>/monitor in a browser and start the web application update.

  • To manually update the Web Designer Web Portal, uninstall the existing Web Designer Web Portal installation and reinstall the Web Designer Web Portal. For more instructions, see the One Identity Manager Installation Guide.

To update an API Server to version 9.2.1

  • After updating the One Identity Manager database schema, restart the API Server. The API Server is updated automatically.

To update the Operations Support Web Portal to version 9.2.1

  • (As from version 8.1.x) After updating the API Server, the Operations Support Web Portal is also current.

  • (As from version 8.0.x)

    1. Uninstall the Operations Support Web Portal.

    2. Install an API Server. For more instructions, see the One Identity Manager Installation Guide.

To apply changes from version 9.2.1 to your HTML applications

  1. Load the current source code from the One Identity Github repository.

  2. Pull the changes from the v92 branch into your repository.

  3. Compile your HTML application and fix any compilation errors that may occur.

    For more information, see the One Identity Manager HTML5 Development Guide.

  4. Check whether your HTML application still work properly.

  5. Deploy the new version of your HTML application.

    For more information, see the One Identity Manager HTML5 Development Guide.

To update the Manager web application to version 9.2.1

  1. Uninstall the Manager web application

  2. Reinstall the Manager web application.

  3. The Internet Information Services default user requires write permissions to the Manager 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 alter custom changes in synchronization projects. This means that conflicts may occur if patches are applied to synchronization projects that have been customized. It 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. (Optional) Deactivate the synchronization project.

NOTE: If you update existing synchronization projects, the connection parameters from the default variable set are always used. Ensure that the variables in the default variable set contain valid values.

NOTE: If you have set up synchronization projects for connecting cloud applications 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. In the Synchronization Editor, open the synchronization project.

  2. Select the Edit > Update synchronization project menu item.

  3. In Available patches, select the patches you want to apply. Multi-select is possible.

    In Details - Installation summary, all patches are displayed in order of installation.

  4. Click Apply selected patches.

  5. Enter any user input as prompted.

  6. Use the patch log to check whether customizations need to be reworked.

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

  8. Run a consistency check.

  9. Simulate the synchronization.

  10. (Optional) 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 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 Help > Info menu item.

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

    The version number 2023.0009.0002.0100 for all modules and the application version 9.2 v92-252751 indicate that this version is installed.

Additional resources

Additional information is available from the following:

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating