Automatic version control is integrated into the One Identity Manager, ensuring that One Identity Manager components are always consistent with each other and with the database. If program extensions that change the structure are implemented, for example, table extensions, the database needs to be updated.
You need to update the database if hotfixes and service packs for your installed version of the One Identity Manager are available or complete version updates. In addition, you are repeatedly required to transfer custom changes from a development database into the live database.
The One Identity Manager schema is customized by loading so-called ‘transport packages’. One Identity Manager recognizes the following types of transport packages that can be copied to the database depending on requirements.
|
IMPORTANT: Test changes in a test system before you load a transport package in a productive system. |
Transport Package Type | Description | Tool Used | ||
---|---|---|---|---|
Migration package |
Migration packages are provided by for the initial database schema installation, for service pack and complete version updates. A migration package contains all the necessary tables, data types, database procedures and the default One Identity Manager configuration. |
Configuration Wizard | ||
Hotfix package |
Hotfix packages are provided to load individual corrections to the default configuration such as templates, scripts, processes or files into the database.
|
Database Transporter Software Loader | ||
Custom configuration package |
A custom configuration package is used to exchange customer specific changes between the development, test and productive system database. This transport package is created by the customer and loaded into the database. |
Database Transporter |
|
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. |
|
IMPORTANT: Test changes in a test system before you load a migration package in a productive system. |
Use the Configuration Wizard to update the One Identity Manager database if you have received a service pack or complete version update.
The program "Configuration Wizard" updates the database depending on the current version of the One Identity Manager database and transfers the actual version into the version history.
During the update, calculation tasks are queued in the database. These are processed by the DBQueue Processor. Processing calculation tasks may take some time depending on the amount of data and system performance. This is particularly the case, if you save large amounts of historical data in the One Identity Manager database such as change data or data from process handling. Therefore, ensure that you have configured an appropriate procedure for archiving the data before you update the database. For more information about archiving data, see the One Identity Manager Data Archiving Administration Guide.
|
NOTE: Always start the on an administrative workstation! |
|
IMPORTANT: Ensure that the administrative system user who is going to compile the database, has a password, before you update the schema to version 8.0. Otherwise the schema update cannot be completed successfully. |
Use the Configuration Wizard to update the One Identity Manager database if you have received a service pack or complete version update.
|
NOTE:
|
|
NOTE: Always start the on an administrative workstation! |
|
IMPORTANT: Ensure that the administrative system user who is going to compile the database, has a password, before you update the schema to version 8.0. Otherwise the schema update cannot be completed successfully. |
To update a database
- OR -
Select the SQL Server database system under Add new connection and enter the database connection data.
Data | Description |
---|---|
Server |
Database server. |
Windows authentication |
Specifies whether Windows authentication is used. This type of authentication is not recommended. If you decide to use it anyway, ensure that your environment supports Windows authentication. |
User |
Database user. |
Password |
Database user password. |
Database |
Database. |
|
NOTE: Use Extended to make further changes to the database connection configuration settings. |
Select the directory with the installation files in the "Installation source" section.
Configuration modules and version information are shown in the Product description page.
Select the additional module on the Select configuration modules page.
|
NOTE: This page is only shown if you set the option Add more modules. |
|
NOTE: If you add more modules, your custom administrative users obtain the permissions for this module. |
Other users with existing connections to the database are displayed on the Active sessions page.
Error that prevent processing the database are displayed on the Database check page. Correct the error before you continue updating.
The installation steps are shown in the Processing database page. Installation and configuration of the database is automatically carried out by the
.
|
TIP: Set the option Advanced to obtain detailed information about processing steps and the migration log. |
You can configure the vendor notification on the page, Configure vendor notification.
If vendor notification is enabled, One Identity Manager generates a list of system settings once a month and sends it to One Identity. This list does not contain any personal data. The list will be reviewed by our customer support team who will look for material changes in a proactive effort to identify potential issues before they materialize on your system. The lists may be used by our R&D staff for analysis, diagnosis, and replication for testing purposes. We will keep and refer to this information for as long as your company remains on support for this product.
To use the function, set the option Enable vendor notification and enter your company's contact email address in Email address for contact.
The email address is used as the sender address for notifying vendors.
Use the Configuration Wizard to update the One Identity Manager database if you have received a service pack or complete version update.
|
NOTE: Always start the on an administrative workstation! |
|
IMPORTANT: Ensure that the administrative system user who is going to compile the database, has a password, before you update the schema to version 8.0. Otherwise the schema update cannot be completed successfully. |
To update a database user
- OR -
Select the Oracle Database database system under Add new connection and enter the database connection data.
Data | Description |
---|---|
Direct access (without Oracle client) | Set this option for direct access.
Deactivate this option for access via Oracle Clients. Which connection data is required, depends on how this option is set. |
Server | Database server. |
Port | Oracle instance port. |
Service name | Service name. |
User | Oracle database user. |
Password | Database user password. |
Data source | TNS alias name from TNSNames.ora. |
|
NOTE: Use Extended to make further changes to the database connection configuration settings. |
Select the directory with the installation files in the "Installation source" section.
Configuration modules and version information are shown in the Product description page.
Select the additional module on the Select configuration modules page.
|
NOTE: This page is only shown if you set the option Add more modules. |
|
NOTE: If you add more modules, your custom administrative users obtain the permissions for this module. |
Other users with existing connections to the database are displayed on the Active sessions page.
Error that prevent processing the database are displayed on the Database check page. Correct the error before you continue updating.
The installation steps are shown in the Processing database page. Installation and configuration of the database is automatically carried out by the
.
|
TIP: Set the option Advanced to obtain detailed information about processing steps and the migration log. |
You can configure the vendor notification on the page, Configure vendor notification.
If vendor notification is enabled, One Identity Manager generates a list of system settings once a month and sends it to One Identity. This list does not contain any personal data. The list will be reviewed by our customer support team who will look for material changes in a proactive effort to identify potential issues before they materialize on your system. The lists may be used by our R&D staff for analysis, diagnosis, and replication for testing purposes. We will keep and refer to this information for as long as your company remains on support for this product.
To use the function, set the option Enable vendor notification and enter your company's contact email address in Email address for contact.
The email address is used as the sender address for notifying vendors.
Click Finish on the last page of the Configuration Wizard.
© 2023 One Identity LLC. ALL RIGHTS RESERVED. Feedback Terms of Use Privacy