Chat now with support
Chat with Support

Identity Manager 9.3 - Installation Guide

About this guide One Identity Manager overview Installation prerequisites Installing One Identity Manager Installing and configuring the One Identity Manager Service Automatic updating of One Identity Manager Updating One Identity Manager Installing additional modules for a existing One Identity Manager installation Installing and updating an application server Installing and updating an API Server Installing and updating the Manager web application Logging in to One Identity Manager tools Troubleshooting Advanced configuration of the Manager web application Machine roles and installation packages Configuration parameters for the email notification system How to configure the One Identity Manager database using SQL Server AlwaysOn availability groups

Displaying the contents of a transport package with the Database Transporter

You can display the contents of a transport package with the Database Transporter before you import.

NOTE: Always start the Database Transporter on an administrative workstation.

To display the contents of a transport package

  1. Start the Launchpad and log in to the One Identity Manager database.

  2. In the Change & Extend > Change, extend and prepare the data model section, select the Transport custom modifications entry and click Run.

    This starts the Database Transporter program.

  3. Select Show transport file.

  4. Select the transport package file browser and click Open.

  5. Click Next on the Select transport file page.

  6. The contents of the transport file are displayed on the Show transport file page.

    • To display the sequence in which the objects are imported

      1. Click + to select an entry in the transport file and select Sort in import order from the context menu.

      2. Click OK and enter the connection credentials for the database. This step is only required when you established the first in the order.

        The order in which the entry's objects are imported into the database is found.

      3. Repeat this step for all other entries for which you want to determine the import order.

    • To display the objects required for an import in the target environment, select the entry for the .xml file and select Show required objects from the context menu.

      Objects that are dependent on another object that is not part of the transport package are highlighted.

  7. To end the program, click Finish on the last page.

TIP: You can start the import of the transport package from display mode. On the Show transport file page, click the name of the transport package and use the Import context menu.

Related topics

Importing transport packages with the Database Transporter

IMPORTANT: Test changes in a test system before you install a hotfix in a live system.

NOTE:

  • Use a copy of the production database for testing.

  • You can display the contents of a transport package with the Database Transporter before you import.

  • To import transport packages with the Database Transporter, users require the Transport_Import program function.

  • Start Database Transporter on an administrative workstation.

  • The database is set to single-user mode for the duration of the import. Close as many existing connections to the database as possible before starting the import. It is not mandatory to close the One Identity Manager Service connections. However, ensure that there are no processes running when the import is going to start.

  • When you import a transport package with schema extensions, the database is set to maintenance mode. Objects cannot be processed in the database during this time.

  • When you import a transport package with the Database Transporter, the import date and description, the database version, and the transport package name are recorded in the transport history of the target database.

To import a transport package

  1. Start the Launchpad and log in to the One Identity Manager database.

  2. In the Change & Extend > Change, extend and prepare the data model section, select the Transport custom modifications entry and click Run.

    This starts the Database Transporter program.

  3. Select Import transport file on the home page.

  4. On the Select the database connection page, check the One Identity Manager database connection data and change it if necessary.

  5. Select the transport package file browser and click Open.

  6. Specify your import options on Select transport file.

    • Create an import log file: Enable this option to create a log file for the data import. The log file is saved in the output directory of the transport file.

    • Import objects singly and ignore errors: Enable this option to import objects individually. Errors, which might occur during importing are ignored and displayed when importing is complete. If you do not enable this option, the import procedure is canceled when errors occur.

    • Ignore default data differences: Enable this option to ignore changes to default data. If you do not enable this option, the import procedure is canceled if changes to default data are included.

  7. Import steps and import progress are displayed on the Importing transport data page. The import procedure can take some time. Calculation tasks are queued for the DBQueue Processor on termination.

    NOTE: During import, if the expected value does not match with the actual value in the database, the Merge conflict dialog opens. For each conflict, you must decide which value is committed to the database.

    • If you want to keep database value, enable Current database value.

    • If you want the value from the transport package to overwrite the database value, enable Transport value.

  8. If changes have been made to the system configuration, for example, processes, or scripts imported, you have to compile the database after the tasks have been processed. Compilation is started automatically once importing is complete.

  9. To end the program, click Finish on the last page.

    NOTE: Use the button to save any errors that occur whilst importing.

Related topics

Importing files with the Software Loader

IMPORTANT: Test changes in a test system before you install a hotfix in a live system.

To deploy files

  1. Hotfix packages that contain modified files are deployed as a Zip file. Unpack the Zip file in a temporary directory on the administrative workstation.

  2. Copy the files to the installation directory on your administrative workstation.

    Make sure that the directory structure is preserved. For example, copy *.exe files or *.dll files to the %ProgramFiles%\One Identity\One Identity Manager directory. Copy the Zip files for Angular projects (Html_<MMM>.zip) to the %ProgramFiles%\One Identity\One Identity Manager\imxweb directory.

  3. Start the Software Loader on the administrative workstation and import the file into the One Identity Manager database.

    NOTE: When you select the root directory in the Software Loader, ensure this does not create any unintended directory trees or delete directories that are still required.

To import files into a One Identity Manager database

  1. Start the Launchpad and log in to the One Identity Manager database.

  2. In the Change & Extend > Change, extend and prepare the data model section, select the Import files for software update entry and click Run.

    This starts the Software Loader program.

  3. Select Import into database on the home page.

  4. On the Connect to database page, check the One Identity Manager database connection data and change if necessary.

  5. Specify the file to be imported on Select files.

    1. Select the base directory where the files can be found.

      The status and file size of all the files in the selected directory are displayed in the file list.

      Table 24: Meaning of the status
      State Meaning

      Version unknown

      The file belongs to the known files but has not yet been loaded into the database. There is no version information in the database.

      Unknown file

      The file is new. The file is in the list of known files but has not been loaded in the database yet. There is no version information in the database.

      Version OK

      The file version matches the version in the database.

      Version modified

      The file version has changed with respect to the version in the database.

    2. Select the files you want to load into the One Identity Manager database.

      TIP:

      • Click a column in the table header to order the display by the selected column.

      • Press Shift + select or Ctrl + select to select more than one file.

      • To quickly select all files with Changed version as their status, select Open all directories and Open all modified files in the context menu. Files in subdirectories are only selected if the higher-level directories have already been opened.

  6. On the Select change label page, assign a change label to make it easier to exchange files between various databases, such as the test, development, and production databases.

    1. Select Assign files to following change label.

    2. Use the button next to the option to select the change label.

  7. The files are loaded straight from the One Identity Manager database.

  8. Specify other file settings on Assign machine roles.

    1. Assign the files to the machine role.

    2. (Optional) For more file settings, click ... next to the file names.

      Table 25: Other file settings
      Setting Description

      Source directory

      Path to the installation source directory.

      Create backup

      A copy must be made of the file during the automatic software update.

      No update

      The file is not updated by the automatic software update.

  9. To end the program, click Finish on the last page.

For more information about the Software Loader, see the One Identity Manager Operational Guide.

Related topics

Installing additional modules for a existing One Identity Manager installation

To add more One Identity Manager modules to an existing One Identity Manager installation, perform the following steps:

  1. Install the One Identity Manager components included in the module on workstations and servers.

    Update the workstation to be used to start the One Identity Manager database schema installation with the installation wizard. All other workstations and servers obtain the new components through automatic software updates. Use the installation wizard to manually update individual workstations and servers.

  2. Install the module in the One Identity Manager database.

    IMPORTANT: When a module is post-installed, all other modules in the database are also processed. If support sent you hotfixes for this version, then these hotfixes must also be reinstalled.

    NOTE: It is not recommended to perform an upgrade of the existing modules to a new One Identity Manager version and install additional modules at the same time. This may cause dependencies between modules to be constructed incorrectly. First update the existing modules to the new One Identity Manager version. Then restart the Configuration Wizard and install the additional modules.

    NOTE: If you add more modules, your custom administrative users obtain the permissions for this module.

To install components of a module on the workstation

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

  2. Switch to the Installation section. Select the edition that you installed.

  3. Click Install.

    This starts the installation wizard.

  4. Follow the installation instructions. In the process, note the following:

    1. On the Installation settings page, enter the following information:

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

      • Installation directory: Select your current installation directory. Otherwise, the components are not updated and a new installation is created in the second directory instead.

      • Add further modules to the selected edition: Enable the option.

    2. On the Module selection page, select the additional module to install.

    3. If you update the workstation that is going to start the One Identity Manager database schema, you can start the Configuration Wizard on the last page of the installation wizard.

To install the module extensions in the One Identity Manager database

  1. Start the Configuration Wizard on the administrative workstation.

  2. On the Configuration Wizard home page, select the Update database option and click Next.

  3. Follow the installation instructions. In the process, note the following:

    • Configuration modules and version information are shown on the Product description page.

      1. Confirm that you have an up-to-date backup of database.

      2. Confirm that the database consistency checks were run.

      3. Set the Add more modules option.

    • On the Select configuration module page, select the additional module.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating