D Setting up a Connection to the Enterprise Manager Repository

This appendix describes how you can set up a connection to the Oracle Enterprise Manager Repository. This is necessary when you want KPIs defined for the applications, suites, and services that comprise your business applications to be reported as events in Incident Manager. The use of Incident Manager is described in Oracle Enterprise Manager Cloud Control Administrator's Guide. The use of the business application facility is described in Oracle Enterprise Manager Cloud Control Oracle Fusion Middleware Management Guide:

http://docs.oracle.com/cd/E24628_01/install.121/e24215/toc.htm

D.1 Introduction

Oracle Enterprise Manager supports the monitoring of business applications. These represent logical services or applications, and unify the dedicated performance monitoring, diagnostics, and reporting capabilities available through RUEI with that available through Oracle Enterprise Manager. The alerts generated by KPIs defined for the applications, suites, and services that comprise your business applications are reported as events in Incident Manager. For more information about the advantages of using Enterprise Manager to monitor KPIs see the Oracle Enterprise Manager Cloud Control Oracle Fusion Middleware Management Guide.

After completing the procedure described here, register the RUEI system in Enterprise Manager using the procedure described in the chapter "Monitoring Business Applications" of the Oracle Enterprise Manager Cloud Control Oracle Fusion Middleware Management Guide.

If you change any setting described in this Appendix, you must restart the system using the RUEI System Reset Wizard:

  1. Select System, then Maintenance, and then System reset.

  2. Select Reapply latest configuration option and click Next to apply the changes you have made.

D.2 Creating a RUEI User for Communication with Enterprise Manager

In order for RUEI to communicate with Enterprise Manager, you must create a RUEI user with the Enterprise Manager access permission. Creating this system user using the RUEI user interface is described in Chapter 14 Managing Users and Permissions of the Oracle Real User Experience Insight User's Guide.

  1. Log into RUEI as an administrator user.

  2. Select System, then User management, and click the Add new user command button in the taskbar.

  3. Complete the wizard, ensuring that you create a system user, with the Enterprise Manager access permission.

    Note:

    You are not prompted to enter this user's credentials when registering RUEI with Enterprise Manager.

D.3 Creating a non-sysman Enterprise Manager Repository User

During the process of registering RUEI with Enterprise Manager, you must provide the credentials of an Enterprise Manager repository user. If you do not want to use the sysman user credentials, you can create a non-sysman user as follows:

  1. Log into the RUEI server as the ruei user.

  2. Section 2.3, "Unpacking the RUEI Software" describes how to unpack the RUEI software. Copy the resulting /root/RUEI/121/sql_scripts directory from the RUEI server to the Enterprise Manager repository server.

  3. Run SQL*Plus as the sysman user in the sql_scripts directory on the Enterprise Manager repository server and create the user using the following script:

    SQL> @create_em_user_for_event.sql

    Note:

    After completing the procedure described here, set up RUEI as described in the chapter "Monitoring Business Applications" of the Oracle Enterprise Manager Cloud Control Oracle Fusion Middleware Management Guide using the username and password you entered in step 3.

D.4 Setting Up a Connection to Oracle Enterprise Manager

The required procedure consists setting up RUEI to use the mkstore utility and restarting RUEI.

Configure RUEI to use the mkstore utility:

  1. Determine the location of the mkstore utility. This utility is included with the Oracle Database and Oracle Client runtime. In both cases, it is located in $ORACLE_HOME/bin.

    Note:

    If you are using a remote database, install the Oracle Client runtime software on the RUEI system to ensure the availability of the mkstore utility.

  2. Edit the /etc/ruei.conf file and add the following line, where mkstore_location is the path determined in step one:

    export MKSTORE_BIN=mkstore_location