Chat now with support
Chat with Support

Identity Manager 9.1.2 - 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 the API Server Installing, configuring, and maintaining the Web Designer Web Portal 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

Importing files with the Software Loader

IMPORTANT: Test changes in a test system before you install a hotfix in a productive 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 view, select the Import files for software update entry and click Start.

    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 database, development database and productive database.

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

    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.

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: This updates the database with an additional module. After installing the extra module, all the other database module are processed.

    If support sent you hotfixes for this version, then these hotfixes must also be reinstalled.

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:

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

      1. Set the Add more modules option.

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

      3. Confirm that the database consistency checks were run.

    2. On the Select configuration modules page, select the additional module.

Related topics

Installing and updating an application server

The application server provides a connection pool for accessing the database. Clients send their queries to the application server, which processes the objects, for example, by determining values using templates and sending the results back to the clients. The data from the application is sent to the database when an object is saved.

Before installation ensure that the minimal hardware and software prerequisites are fulfilled on the server.

NOTE: On Linux operating systems, use of oneidentity/oneim-appserver docker images is recommended.

Detailed information about this topic

Tips for installing an application server

  • If you want to run the One Identity Manager Service or the Designer through an application server, the application server requires sufficient permissions for a configuration user. Use the SQL Server login to connect to the One Identity Manager database and to authenticate against the One Identity Manager database when you install the application server.

  • To limit permissions for end users, you can make other application servers available that use the SQL Server login for end users.

  • To use the Web Portal or full text search in the Manager, you need an application server with a search service installed on it.

  • Start the application server installation locally on the server.

  • Use the QBM | AppServer | SessionTimeout configuration parameter to add the timeout in hours, after which inactive application server sessions are closed. The default value is 24 hours. In the Designer, edit the configuration parameter.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating