Identity Manager 8.0 - Installation Guide

Table of Contents

About this Guide One Identity Manager Overview

One Identity Manager Editions One Identity Manager Architecture One Identity Manager Tools Which Components and Front-ends Work with an Application Server?

Installation Prerequisites

Minimum System Requirements for the Database Server

Additional System Requirements for Implementing an SQL Server Database Additional System Requirements for Implementing an Oracle Database

Minimum System Requirements for Administrative Workstations Minimum System Requirements for the Service Server Minimum System Requirements for the Web Server Minimum System Requirements for the Application Server Users and Permissions for One Identity Manager Permissions for SQL Server Database Users Permissions for Oracle Database Users Setting up Permissions for Creating an HTTP Server Communications Port and Firewall Configuration

Installing the One Identity Manager

Before You Start Installing One Identity Manager Installing One Identity Manager Components

Installing One Identity Manager on a Windows Terminal Server

Installing and Configuring a One Identity Manager Database

Starting the Configuration Wizard Creating a New SQL Server Database Using an Existing Empty SQL Server Database Setting up a new Oracle Database User Using an Existing Empty Oracle Database User Editing the Database Entering System Data Installing the One Identity Manager Service for the Database Configuring a One Identity Manager Database for Testing, Development or Production Encrypting Data in a Database

Creating a New Database Key and Encrypting Database Data Modifying a Database Key and Encrypting Database Data Re-encrypting Database Data Decrypting Database Data Advice for Working with an Encrypted One Identity Manager Database

Vendor Notification in One Identity Manager

Enabling Vendor Notification Checking for Vendor Notification Disabling Vendor Notification

Installing and Configuring the One Identity Manager Service

Displaying the One Identity Manager Service Log File Changing the User Account or One Identity Manager Service Start Type The One Identity Manager Service in a Cluster

Registering the One Identity Manager Service in a Cluster Installing and Configuring the One Identity Manager Service in a Cluster

Updating the One Identity Manager

Updating One Identity Manager Components

Updating One Identity Manager Components with the Installation Wizard

Updating the One Identity Manager Database

Updating the One Identity Manager Database with the Configuration Wizard

Updating the SQL Server Database Updating the Oracle Database user Editing the Database during Update

Installing a Hotfix in the One Identity Manager Database

Displaying Contents of a Transport Package with the Database Transporter Importing a Transport Package with the Database Transporter Importing Files with the Software Loader

Automatic Updating of the One Identity Manager

Basics for Automatic Update Implementing Automatic Software Update

Installing and Updating a One Identity Manager Application Server

Installing a One Identity Manager Application Server Updating a One Identity Manager Application Server Displaying One Identity Manager Application Server Status Uninstalling a One Identity Manager Application Server

Installing, Configuring and Maintaining the Web Portal

Installing the Web Portal Installing the Web Portal over the Command Line Compiling the Web Portal from the Command Line Uninstalling the Web Portal Configuring the Web Portal

Database Connection Web project Log Automatic update Web Settings Cache Debugger Service Search Service

Web Portal Maintenance

Runtime Monitoring Security Viewing Log Files and Exceptions Using Automatic Updating for the Web Portal Maintenance Mode Manual Updating Monitoring with Help from Performance Counters

Installing the Operations Support Web Portal Installing and Updating the Manager Web Application

Installing the Manager Web Application Updating the Manager Web Application Uninstalling the Manager Web Application

Logging into One Identity Manager Tools

Logging into a One Identity Manager Database as a Database User Logging into One Identity Manager Administration Tools as a System User Enabling other Authentication Modules Enabling other Login Languages Password Expiry Checking Authentication

Troubleshooting

Displaying the Transport History and Testing the One Identity Manager Version Handling Errors and Warnings during System Compilation Checking data consistency DBQueue Processor does not Process Tasks Error: Enter email address in configuration parameter Database error 50000: Job queue is not empty. This may cause in deadlocks while compiling database. Error: Database error migrating a database in an SQL Server AlwaysOn availability group

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

General known issues Database Connection Security Debugging Performance File Download ASP.Net Basic Settings Directories Application Pool Plugins Load Balancing Single Sign-On

Appendix: Machine Roles and Installation Packages Appendix: Settings for a New SQL Server Database

Runtime Monitoring

Installing, Configuring and Maintaining the Web Portal > Web Portal Maintenance > Runtime Monitoring

The One Identity Manager web application contains a runtime monitoring tool. This tool can access the web application through a special URL:

http://<server>/<application>/monitor.

Security

Installing, Configuring and Maintaining the Web Portal > Web Portal Maintenance > Security

Access to this page is configured through the following settings in the web application's configuration file (web.config). The default setting only allows members of the administrator role to access the runtime monitor.

<?xml version="1.0"?>

<authorization>

<allow roles="BUILTIN\Administrators" />

<deny users="*" />

</authorization>

For more information about changing this setting, see the ASP.NET documentation.

Viewing Log Files and Exceptions

Installing, Configuring and Maintaining the Web Portal > Web Portal Maintenance > Viewing Log Files and Exceptions

The Log files tab of the Runtime Monitor allows you to view log files generated by web applications. You can filter these file and search by strings. The log files are saved physically in the log directory, which is defined in the configuration (for example, "./Logs").

The Exceptions tab of the Runtime Monitor enables you to view the log messages relating to exceptions. These messages are collected by exception and sorted by frequency of occurrence. The first exception in the list is the most commonly occurring exception.

NOTE: The Web Installer writes important events to the Windows application log file. You can view this log file in the Windows Event Viewer if there are problems or errors during the Web Portal installation.

Using Automatic Updating for the Web Portal

Installing, Configuring and Maintaining the Web Portal > Web Portal Maintenance > Using Automatic Updating for the Web Portal

Using Automatic Updating for the Web Portal

The One Identity Manager web application is integrated into automatic updating of One Identity Manager.

Important: A software update means the web application will be restarted. Automatic update of the web application contains the following steps:

The web application recognizes that a new software version is available in the database.
New files are copied from the database into temporary directories on the server.
The Updater.exe is started. It waits until the web application process is shutdown. (For more information about automatic shutdown, see the IIS documentation).
Updater.exe copies the files from the temporary directories into the web application directory.

Related Topics

Related Documents

© 2019 One Identity LLC. ALL RIGHTS RESERVED. Feedback Terms of Use Privacy