Chat now with support
Chat with Support

Identity Manager 9.0 LTS - 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

Installing One Identity Manager

The following steps are required to install One Identity Manager:

  1. Install One Identity Manager tools on the administrative workstation on which the One Identity Manager database schema installation will be started.

  2. Install and configure the One Identity Manager database with the Configuration Wizard.

  3. Set up the server, which handles the SQL processes.

    • The server must be entered in the database as a Job server with the SQL processing server server function.

    • A One Identity Manager Service with direct access to the One Identity Manager database must be installed and configured on the server.

    NOTE: Multiple SQL processing servers can be set up to spread the load of SQL processes.

  4. Set up an update server for automatic software updating of other servers.

    • The server must be entered in the database as a Job server with the server function Update server.

    • A One Identity Manager Service with direct access to the One Identity Manager database must be installed and configured on the server.

  5. Setting up and configuring the Database Agent Service

    The Database Agent Service controls processing of DBQueue Processor tasks. The Database Agent Service is deployed through the One Identity Manager Service plugin. Alternatively, the Database Agent Service can be run from the DatabaseAgentServiceCmd.exe command line program.

NOTE: You can proceed with setting up a SQL processing server and the update server using the Configuration Wizard. You can also set up the Database Agent Service with the Configuration Wizard.

You can also install the following:

  • Additional workstations.

  • Additional servers with the One Identity Manager Service.

  • An application server.

  • An API Server with HTML web applications.

  • The Web Designer Web Portal on a web server.

  • The Password Reset Portal on a web server.

    For more information about installing and configuring the Password Reset Portal, see the One Identity Manager Web Application Configuration Guide.

  • The Manager web application on a web server

You can install and update One Identity Manager using the following methods:

  • Use the installation wizard to install the One Identity Manager components on workstations for the first time.

  • To install and update the One Identity Manager database, use the Configuration Wizard.

  • Use the installation wizards to install the One Identity Manager Service on servers for the first time or remote with the Server Installer.

  • Update an existing installation use the auto update software.

  • Use the installation wizard to manually update individual workstations and servers.

NOTE: One Identity provides various Docker images for simple and standardized installation and running of individual Docker components in One Identity Manager containers.

Detailed information about this topic

One Identity Manager Docker images

One Identity provides various Docker images for simple and standardized installation and running of individual One Identity Manager components in Docker containers. One Identity Manager Docker images, together with detailed information about the usage and configuration of the individual images are available in the One Identity Docker repository. For videos with additional information, see the One Identity Manager Containerization video series at www.YouTube.com/OneIdentity. For more information about Docker, see https://www.docker.com/.

Table 14: Available One Identity Manager Docker images

Docker image

Description

oneidentity/oneim-job

This image runs an instance of a One Identity Manager Service. When started, it downloads the necessary files for a specific Job server. This behavior can be controlled using encrypted values and environment variables.

oneidentity/oneim-appserver

This image runs an instance of the One Identity Manager application server. When started, it downloads the necessary files from the configured One Identity Manager database. This behavior can be controlled using encrypted values and environment variables.

oneidentity/oneim-web

This image runs an instance of the Web Designer Web Portal. When started, it downloads the necessary files from the configured One Identity Manager database. This behavior can be controlled using encrypted values and environment variables.

oneidentity/oneim-installer

This image contains a simple installation program that can be used in derived images to create the file structure for One Identity Manager applications.

oneidentity/oneim-api

This image runs an instance of the API Server. When started, it downloads the necessary files from the configured One Identity Manager database. This behavior can be controlled using encrypted values and environment variables.

Before you start installing One Identity Manager

Before you start installing One Identity Manager:

  • Ensure that the workstations and servers meet the minimal hardware and software requirements.

  • End all program and service components otherwise installation cannot begin.

Detailed information about this topic

Installing One Identity Manager components

An installation wizard is available to help you through the installation of One Identity Manager components on workstations and servers.

NOTE: Always start installing administration and configuration tools on an administrative workstation if possible.

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

To install the One Identity Manager components

  1. Launch autorun.exe from the root directory of the One Identity Manager installation medium.

  2. Switch to the Installation tab and select an edition.

  3. Click Install.

    This starts the installation wizard.

  4. Select the language for the installation wizard on the start page and click Next.

  5. Confirm the conditions of the license.

  6. On the Installation settings page, enter the following information.

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

    • Installation directory: Select the directory in which you want to install the files for One Identity Manager.

      NOTE: To make further configuration settings, click on the arrow button next to the input field. Here, you can specify whether you are installing on a 64-bit or a 32-bit operating system.

      For a standard installation, no further configuration settings are necessary.

    • Select installation modules using the database: Set this option to load the installation data using the existing One Identity Manager database.

      NOTE: Leave this option empty to install the workstation on which you start the One Identity Manager schema installation.

    • Add further modules to the selected edition: Set this option to add additional One Identity Manager modules to the selected edition.

  7. Enter the database connection data on Connect to database.

    NOTE: This page is only shown if you have set the Select installation modules with existing database option.

    • Select the connection in Select a database connection.

      - OR -

    • Click Add new connection, select the SQL Server system type, and enter the connection data.

      • Server: Database server.

      • (Optional) Windows Authentication: Specifies whether the integrated 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: The user's SQL Server login name.

      • Password: Password for the user's SQL Server login.

      • Database: Select the database.

  8. On the Module selection page, also select the modules to be installed.

    NOTE: This page is only shown if you set the option Add more modules to the selected Edition.

  9. On the Assign machine roles page, define the machine roles.

    NOTE: The machine roles appropriate for the One Identity Manager modules are enabled. All machine subroles are selected when you select the machine role. You can deselect individual packages.

  10. On the Install WebView2 page you are prompted to install Microsoft Edge WebView2. The user interface of some One Identity Manager components requires Microsoft Edge WebView2 to display certain content.

    NOTE: This page is only shown if you want to install One Identity Manager components that are expecting WebView2 and WebView2 is not yet installed.

  11. On the Change service properties page, you can change the name, display name and the description for installing the One Identity Manager Service.

    NOTE: This page is only shown if you have selected the Server | Job Server machine role.

  12. You can start different programs for further installation on the last page of the install wizard.

    • To install the One Identity Manager schema, start the Configuration Wizard and follow the Configuration Wizard instructions.

      NOTE: Perform this step only on the workstation on which you start the installation of the One Identity Manager schema.

    • To create the configuration of the One Identity Manager Service, start the Job Service Configuration program.

      NOTE: Run this step only on servers on which you have installed the One Identity Manager Service.

  1. Click Finish to close the installation wizard.

  2. Close the autorun program.

One Identity Manager is installed for all user accounts on the workstation or server. In the default installation, One Identity Manager is installed under:

  • %ProgramFiles(x86)%\One Identity (on 32-bit operating systems)

  • %ProgramFiles%\One Identity (on 64-bit operating systems)

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating