Chat now with support
Chat with Support

Identity Manager 8.1 - 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 Error handling Appendix: Creating a One Identity Manager database for a test or development environment from a database backup Appendix: Extended configuration of the Manager web application Appendix: Machine roles and installation packages Appendix: Settings for a new SQL Server database

Log files and exceptions

The log files are displayed in the Runtime Monitor.

  • All log files generated by the web application are displayed on the Log files tab.

    You can filter these file and search by strings. The log files exist in physical form in the log directory defined by the configuration in the configuration file of the web application, usually ./Logs).

  • The Exceptions tab display log messages that contain exception errors. These messages are sorted by exception error and in descending order of frequency. The top exception error in the list is the error that occurs most frequently.

NOTE: The Web Installer writes important events to the log file of the application. You can view this log file in the Windows event display.

Related Topics

Maintenance mode

To carry out maintenance work, switch the web application to maintenance mode. You use maintenance mode, for example, to enable an update at a particular time.

No new sessions are permitted in maintenance mode. Current sessions are not affected. While maintenance work is being performed, users who view the web application are displayed the contents of the Maintenance.html file, which is located in the installation directory of the web application. You can edit this file to display details of the maintenance work for the user.

To switch the web application to maintenance mode

  1. Open the Runtime Monitor in the browser.
  2. On the Status tab, click Start maintenance mode.

To end maintenance mode

  1. Open the Runtime Monitor in the browser.
  2. On the Status tab, click End maintenance mode.

Maintenance mode can also be activated by creating the file App_Data\Maintenance.mode in the installation directory of the web application, and terminated by deleting this file.

Related Topics

Using the performance indicators for monitoring

When you install a web application, performance counters are registered, which provide information about the state of the application.

Performance indicators can be installed later.

NOTE: Prerequisites for this are that the web application is installed on a Windows Server and has sufficient permissions to offer performance indicators. It may be necessary to add the application pool user account to the local group Performance monitoring user for this. Apart from this, the web application must be running in order to select the performance indicators.

To post-install performance indicators

  1. Open the Web Designer Configuration Editor.
  2. Click Web settings and Create Windows performance counters.

    After this is successfully completed, an installation prompt is displayed.

  3. Confirm the prompt with OK.

To view performance counters

  1. Log in to the server on which the web application is installed.
  2. Start performance monitoring of Windows.
  3. In the dialog box on the left-hand side, select Performance monitoring.
  4. In the display area for performance monitoring, click .
  5. In the Add Counters dialog, under Available Counters, select One Identity Manager Web Portal and add to the entry.

    This displays performance indicators for the web application. The following indicators are available.

    Table 48: Performance indicators

    Performance indicator

    Description

    AJAX calls

    Number of HTTP queries processed asynchronously.

    Objects

    Number of active database objects.

    Exceptions

    Number of exception errors that have occurred.

    Forms

    Number of active forms.

    HTML requests

    Number of HTML page requests.

    PID

    Number of process IDs.

    Contexts

    Number of active module objects.

    Sessions

    Number of active sessions.

    Sessions total

    Total number of sessions since the application started.

  6. Enter any new performance indicators you wish and select the web application under Instances of selected object:.

    TIP: Only the web applications that have started are displayed for selection. If you install a new web application, it may take a few minutes before the list of available web applications including the new one is available.

Installing and updating the Manager web application

Manager functionality can be provided by web applications. Before installation ensure that the minimal hardware and software prerequisites are fulfilled on the server.

Detailed information about this topic
Related Documents