Skip to main content
Version: On prem: 15.0.2

Upgrade guides

Planning the upgrade​

There are some prerequisites you need to fulfill:

  • You can't skip a major version. For example, if you want to upgrade from Omada Identity v11.1 to the latest version, you must first upgrade to Omada Identity v12.2 or v12.3.
  • You must upgrade one major version at a time.
  • You must always be on the latest patch version before upgrading to a new major version. Since v11.1 is the only patch version of v11, ensure you are on v11.1 before upgrading to v12.2 or v12.3.
  • Migration from Role Engine to Role & Policy Engine is required.
  • You need to save the connection string from the registry to run the Omada Enterprise Configuration Utility later.
  • You need to copy your PswEncryptionKey.

Handling installed hotfixes and changed files​

During the upgrade, the installer will overwrite any versioned files, for example, *.DLL files as well as the ODW SSIS packages. Hence, all hotfixes installed previously will be overwritten. If non-versioned files (for example *.JS or web.config) are changed, either due to a hotfix or manual editing, these files won't be overwritten automatically by the installer during the upgrade procedure.

You should remove the modified files (or restore the original ones) from the installation folder before running the upgrade. After the upgrade, apply your changes again to the files which you changed manually.

Note on changesets​

If you recorded any changesets before the update, these changesets can't be imported to the updated version. This means that you should import the changeset in the original environment and only then update Omada Identity to the newer version.

note

Moving changesets between versions isn't supported. However, it was previously possible to do so without errors in some cases.

important

To use the Access Request or the Approvals feature, you must install the Extend Access package.

Completing OPS jobs​

Before performing an upgrade, it is recommended to ensure that there are no pending OPS jobs. You can do it by stopping the RoPE service and waiting for any OPS jobs to complete before upgrading.

After upgrading, the settings must be committed to OPS from the system onboarding page for one of the onboarded systems.

Stopping services and creating backups​

  1. Make sure you have information on service accounts and your credentials available.

  2. Stop all running Omada Identity services, as well as any scheduled SSIS import jobs. In IIS, stop all Omada related Application Pools and Websites. You should stop the following services:

    • Omada Identity Suite Timer Service
    • Omada Provisioning Service
    • Omada Role and Policy Engine Service

  3. Stop the Omada Identity Enterprise Server portal.

  4. Create a backup of the Omada Provisioning Service installation folder.

  5. Create a backup of the Omada Role and Policy Engine installation folder.

  6. Create a backup of all the Omada Identity databases. Below you can find the default names of the relevant databases:

    • OIS
    • ES Audit database
    • Omada Source System Data DB
    • Omada Data Warehouse
    • Omada Data Warehouse Master
    • Omada Data Warehouse Staging
    • Provisioning Service
    • RoPE

Click on the available upgrade guide to upgrade your Omada Identity solution to the desired version: