Chat now with support
Chat with Support

Identity Manager 8.1.2 - 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

Displaying the One Identity Manager Service log file

The One Identity Manager Service log file can be displayed in a browser.

You call up the log file with the appropriate URL:

http://<server name>:<port number>

The default value is port 1880.

To open the One Identity Manager Service log file in the Job Queue Info

  1. Start the Job Queue Info program.
  2. In the Server state view, select the Job server and select the Open in browser context menu item.

    The One Identity Manager Service HTTP server for the Job server is queried and the various One Identity Manager Service services are displayed.

Figure 3: The One Identity Manager Service log file

The messages to be displayed on the web page can be filtered interactively. There is a menu on the website for this. Only text contained in the log file can be displayed in this case. For example, if the message type is Warning, messages with the Info message type cannot also be displayed if the relevant filter is selected.

The log output is color-coded to make it easier to identify.

Table 23: Log file color code
Color Meaning
Green Processing successful
Yellow Warnings occurred during processing
Red Fatal errors occurred during processing

NOTE: If you want to retain the color information to send by email, you need to save the complete web page.

Changing the user account or One Identity Manager Service start type

NOTE: In a default installation, the service is entered in the server’s service management with the name One Identity Manager Service.

To customize login data and the way the service is started

  1. Open the service management of the server and select the One Identity Manager Service in the list of services.

  2. Open service properties with the Properties context menu item.

  3. On the General tab, change the start type if necessary.

    The Automatic start type is recommended.

  4. Change the user account under which the service runs on the Login tab.

  5. Click Apply.

  6. Close the service's properties with OK.

  7. Start the service from the context menu item Start.

    If the One Identity Manager Service cannot be started, a corresponding message is written to the server event log.

NOTE: If you change the One Identity Manager Service user account, you must save the service's configuration file in the service’s install directory again.

NOTE: If you are working with an encrypted One Identity Manager database, see Advice on working with an encrypted One Identity Manager database.

Related topics

The One Identity Manager Service in a cluster

The idea of a cluster solution is to make the system highly available. The goal is to limit system failure to only a few seconds if a hardware or software component fails. This can be achieved with the installation of a Windows cluster solution (only possible with Enterprise servers). The following diagram shows such a solution.

Figure 4: Example of a cluster solution

This cluster is made up of two physical computers Server A and Server B that use the same disk array and have their own individual system hard drive. Every server has a Windows operating system. Both servers are installed identically so that in the case of failure one server can take over from the other.

All redundant system components are managed by the cluster manager. From an external point of view, the cluster is addressed as a single, virtual server Server C. The service or user that is accessing the service is automatically connected to the physical server that is currently carrying out the work in the cluster.

If one of the servers fails, then the redundant server in the cluster automatically takes over. The virtual server remains the contact partner; only the physical server that is running, changes.

Detailed information about this topic

Registering the One Identity Manager Service in a cluster

Once registered, the One Identity Manager Service is governed by cluster handling for site resilience and load balancing. The service is installed on a virtual server that simulates the cluster. All computer-related operations and service data operate, transparently, with the virtual server and not the real computer (cluster nodes). This also applies to clients that contact the service through the server name, for example RPC (ORPC, DCOM), TCP/IP (Winsock, Named Pipes), or HTTP.

Because the service is in the context of the virtual server, note the following facts:

  • The service-specific settings for the node on which the virtual server is located are replicated to all other nodes. Therefore, the service always has the same configuration irrelevant of the node on which it is actually started.
  • The service is always started only on the current node of the virtual server (the virtual server's current node). The service is stopped on all other nodes.
  • The service is booted and shutdown with the virtual server. If the cluster is not enabled, the service is stopped on all nodes.
  • Services on nodes are brought automatically in the required state (manual or stopped) before registration by the program.
Related topics
Related Documents