Identity Manager 8.0 - Installation Guide

About this Guide One Identity Manager Overview Installation Prerequisites Installing the One Identity Manager Installing and Configuring the One Identity Manager Service Updating the One Identity Manager Installing and Updating a One Identity Manager Application Server Installing, Configuring and Maintaining the Web Portal Installing the Operations Support Web Portal Installing and Updating the Manager Web Application Logging into One Identity Manager Tools Troubleshooting Appendix: One Identity Manager Authentication Modules Appendix: Creating a One Identity Manager Database for a Test or Development Environment from a Database Backup Appendix: Manager Web Application Extended Configuration Appendix: Machine Roles and Installation Packages Appendix: Settings for a New SQL Server Database

Before You Start Installing One Identity Manager

Before You Start Installing One Identity Manager

  • Before installing the One Identity Manager ensure that the minimal hardware and software requirements are met on workdesks and servers.
  • End all programs and service components otherwise installation cannot begin.

NOTE: There is a separate upgrade package for updating from One Identity Manager version 6.x to One Identity Manager version 7.0. Direct your inquiries to 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

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.

To install One Identity Manager components

  1. Execute the program autorun.exe from the root directory on the One Identity Manager installation medium.
  2. Switch to the Installation tab, select the edition and click Install.
  3. The installation wizard is started. Select the language for the installation wizard on the start page and click Next.
  4. Confirm the conditions of the license.
  5. Specify the data for installation source and target on the Installation settings page.

    • Select the directory with the installation files under Installation source.
    • Select the directory into which to install the One Identity Manager files under Installation folder.

      NOTE: To make set more options, click on the arrow button next to the text box. Here, you can specify whether you are installing on a 64-bit or a 32-bit operating system.

      Do not set any more options for a default installation.

    • Set the option Select installation modules from existing database of installation data about the existing One Identity Manager database should be loaded.

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

    • To add more One Identity Manager modules to the selected edition, set the option Add more modules to the selected Edition.
    • Click Next.
  6. Select the additional modules to install on the Module selection page and click Next.

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

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

    NOTE: This page is only displayed if you have set the option Select installation modules from database.

    1. Select the connection in "Select connection".

      - OR -

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

      Table 17: SQL Server 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.

      Table 18: Oracle 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.
    2. Select the authentication module in "Authentication method" and enter the login data for system identification.

      The login data you require depends on the authentication module selected.

    3. Click Next.
  8. Specify machine roles on the Assign machine roles page and click Next.

    NOTE: Machine roles which match One Identity Manager modules are already selected. All machine subroles are selected when you select the machine role. You can deselect individual packages.
  1. You can start different programs for further installation on the last page of the install wizard.
    • To run the One Identity Manager installation, start the Configuration Wizard and following the Configuration Wizard instructions.

      NOTE: Only run this step on the workstation on which you start the One Identity Manager installation.

    • Start the program Job Service Configuration to configure the One Identity Manager Service.

      NOTE: Only run this step on servers on which the One Identity Manager Service is installed.

  1. Click Finish to close the installation wizard.
  2. Close the autorun program.

The One Identity Manager is installed for all user accounts on the workstation or server. In the default installation the 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

Installing One Identity Manager on a Windows Terminal Server

Installing One Identity Manager on a Windows Terminal Server

To install One Identity Manager tools on a Windows terminal server you need to ensure that the Windows terminal server has been fully installed and configured. This includes profile handling in particular as well as permissions for Windows terminal server use.

NOTE: Ensure that in an Active Directory Domain, users also have relevant permissions to use the Windows terminal server self.

To install One Identity Manager components on a Windows terminal server

  1. Log in with a user account, which has administrator permissions on the Windows terminal server.

    Log in through a console connection is recommended. This is called by

    Start/Run: mstsc /Console /v:<servername>

    where <servername> must be replaced by the terminal server's server name (without leading "\").

  2. Open the command line console (CMD.exe) and switch the Windows terminal server into software installation mode with help of the command CHANGE USER /INSTALL.
  3. Start the One Identity Manager Installation Wizard and install the One Identity Manager components as described.
  4. End the software installation mode on the Windows terminal server with the command CHANGE USER /EXECUTE in the command line console.

After the installation is complete, anyone who is an authorized Windows terminal server user can start the One Identity Manager tools and use them.

For more information about software installation on Windows terminal servers, refer to the Windows operating system documentation you are using.

Related Topics

Installing and Configuring a One Identity Manager Database

Installing and Configuring a One Identity Manager Database

The following prerequisites must be fulfilled on the workstation from which you want to start the One Identity Manager database setup:

  • Installing the "Configuration Wizard" program

    Use the install wizard to install the program. To do this, select the installation type "Workstation" and the installation package "Configuration" in the install wizard.

  • Access the installation source

    NOTE: If you copy the installation files to a repository, you must ensure the directory tree remains intact.

In order to set up a database on a database server for use in the One Identity Manager environment use the "Configuration Wizard". The database systems SQL Server or Oracle Database can be implemented. Installation and configuration under SQL Server and Oracle Database is similar.

The Configuration Wizard executes the following steps.

  1. Installs the One Identity Manager schema in a database.

    The One Identity Manager schema can be installed in an existing database. Alternatively, the Configuration Wizard can create a new database and install the One Identity Manager schema.

  2. Creates administrative system users and permissions groups.
  3. Installing and configuring a One Identity Manager Service with direct access to the database for handling SQL processes and automatic server software updates.

NOTE: Further steps are executed in One Identity Manager depending on the Edition and Configuration Wizard modules.

Other steps are required to configure the One Identity Manager database following the schema installation:

  • Configure the database for a test, development or live system.
  • Other system settings may be required for putting individual functions into operation in One Identity Manager.

    Use configuration parameters to configure the behavior of the system's basic settings. One Identity Manager provides default settings for different configuration parameters. Check the configuration parameters and modify them as necessary to suit your requirements.

    Configuration parameters are defined in the One Identity Manager modules. Each One Identity Manager module can also install configuration parameters. You can find an overview of all configuration parameters in the category Base data | General | Configuration parameters in the Designer.

  • In certain circumstances, it is necessary to store encrypted information in the One Identity Manager database. Use the program "Crypto Configuration" to do this.
  • You can log changes to data and information from process handling in One Identity Manager. All entries logged in One Identity Manager are initially saved in the One Identity Manager database. The proportion of historical data to total volume of a One Identity Manager database should not exceed 25%. Otherwise performance problems may arise. You must ensure that log entries are regularly removed from the One Identity Manager database and archived.

    For more information about process monitoring and process history, see the One Identity Manager Configuration Guide. For more information about archiving data, see the One Identity Manager Data Archiving Administration Guide.

Detailed information about this topic
Related Topics
Related Documents