Chat now with support
Chat with Support

Identity Manager 8.1.5 - 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 and updating an application server Installing the API Server Installing, configuring, and maintaining the Web Portal Installing and updating the Manager web application Logging in to One Identity Manager tools Troubleshooting Creating a One Identity Manager database for a test or development environment from a database backup Advanced configuration of the Manager web application Machine roles and installation packages

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.
  3. Set up the server, which handles the SQL processes.
    1. The server must be entered in the database as a Job server with the SQL processing server server function.
    2. 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.
    1. The server must be entered in the database as a Job server with the server function Update server.
    2. A One Identity Manager Service with direct access to the One Identity Manager database must be installed and configured on the server.
NOTE: You can proceed with setting up a SQL processing server and the update server using the Configuration Wizard.

You can also install the following:

  • Additional workstations.

  • Additional servers with the One Identity Manager Service.

  • An application server.

  • The Web Portal on a web server.

  • The Password Reset Portal on a web server.

    For more detailed 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

  • Additional web services like SPML Web service or SOAP Web Service.

    For detailed information about installing the web services, see the One Identity Manager Configuration Guide.

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

  • Use the installation wizard to install the One Identity Manager components on workstations for the first time.
  • 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 execution 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 execution 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. Videos containing additional information are available in the One Identity Manager Containerization video series available at www.YouTube.com/OneIdentity. For detailed information about Docker, see https://www.docker.com/.

Table 15: Available One Identity Manager Docker images

Docker image

Description

oneidentity/oneim-job

This image executes 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 executes 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 executes an instance of the 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 executes 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 programs and service components otherwise installation cannot begin.

NOTE: A separate upgrade package is available for the update from One Identity Manager version 6.x to One Identity Manager version 7.0. For all inquiries, contact the support desk. To access the Support Portal, go to https://support.oneidentity.com/identity-manager/.

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: On Linux operating systems, use of oneidentity/oneim-installer docker images is recommended.

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

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, select the edition, and click Install.

  3. This starts the installation wizard. On the start page, select the language for the installation wizard.

  4. Confirm the conditions of the license.

  5. 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 additional changes to the 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.

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

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

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

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

    1. Select the connection in the Select a database connection pane.

      - OR -

      Click Add new connection, select a system type, and enter connection data.

      Table 16: SQL Server database connection data
      Data Description

      Server

      Database server.

      Windows authentication

      Specifies whether 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

      SQL Server login name.

      Password

      SQL Server login password.

      Database

      Database.

    2. In the Authentication method pane, select the authentication module and enter the login data for the system user ID.

      The login data required depends on which authentication module you select.

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

    NOTE: The machine roles appropriate for the One Identity Manager modules are activated. All machine subroles are selected when you select the machine role. You can deselect individual packages.
  9. 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.

  10. 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 work station 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: Execute 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