entuity oracle enterprise manager guide · oracle enterprise manager oracle enterprise manager...

North America Headquarters4 Mount Royal Avenue

Suite 340

Marlborough, MA 01752

Tel: +1 508 357 6344

Fax: +1 508 357 6358

EMEA Headquarters9a Devonshire Square

London,

EC2M 4YN

Tel: +44 (0)20 7444 4800

Fax: +44 (0)20 7444 4808

USER GUIDE

www.entuity.com 0000-0165-PD059_entuity_integ_oracle_enterprise_manager.rev1.fm

Entuity® 16.5Network Management Plug-in forOracle® Enterprise Manager

The Entuity Network Management Plug-in for Oracle® Enterprise Manager addsthe network component to Enterprise Manager’s application stack.

Entuity

Entuity

The Entuity product and its related documentation are protected by copyright and distributed under licenses restrictinguse, copying, distribution and decompilation. Unless you have negotiated with Entuity specific terms and conditionsfor using its product and associated documentation, such use shall be governed by Entuity's standard licence terms, acopy of which is distributed with the product.

Entuity may make improvements and/or changes to the product(s) and/or program(s) described in this publication atany time. These changes will be incorporated into new editions of the relevant publication.

Entuity®, SurePath®, Eye of the Storm®, InSight Center®, Green IT Perspective™, Network Delivery Perspective™ and ServiceDelivery Perspective™ are registered trademarks of Entuity. All other trademarks are the property of their respectiveowners.

License terms and conditions of use for Entuity and included third party software can be found on the Entuity server atentuity_home/licenseTerms/. A listing of these third party trademarks, references and software included with Entuityis available through its web UI.

Entuity

Contents

1 Integrate Entuity with Oracle Enterprise ManagerOracle Enterprise Manager .......................................................................................7Network Management Plug-in for Oracle Enterprise Manager ................................7

Module Availability ...............................................................................................8Module Security ...................................................................................................8

2 Manage the Entuity Oracle Enterprise Manager Plug-inFiles for Network Management Plug-in for Oracle Enterprise Manager ..................9Preparing for Deployment ......................................................................................10

Using HTTPS with Self-Certified Certificates .....................................................10Uploading the Entuity Plug-in Archives ..................................................................11Deploying the Entuity Plug-ins ...............................................................................11

Deploying a Plug-in to the Oracle Enterprise Manager Management Server ..11Deploying a Plug-in to the Oracle Enterprise Manager Management Agent ...14

Adding Entuity Instances for Monitoring ................................................................14Adding Entuity Network Manager Instances ..........................................................14

Verifying and Validating the Entuity Network Manager Plug-in ........................19Adding Entuity Network Service Instances ............................................................20

Finding an Entuity Network Service identifier ...................................................21Adding Entuity Network Services ......................................................................22Verifying and Validating the Entuity Network Service Plug-in ..........................24

Undeploying the Plug-ins .......................................................................................25Remove a Target ...............................................................................................25Undeploy a Plug-in from an Agent ....................................................................26Undeploy a Plug-in from a Management Server ..............................................26Remove a Plug-in from Oracle Enterprise Manager .........................................26

3 Forward Events to Oracle Enterprise ManagerConfiguring Entuity snmpforward ...........................................................................28

Using the Sample Configuration .......................................................................28

4 Use Entuity From Oracle Enterprise ManagerUsing the Entuity Network Manager .......................................................................31Using Entuity Network Services .............................................................................33

5 Entuity Reporting From Oracle Enterprise Manager

Entuity® Network Management Plug-in for Oracle® Enterprise Manager Guide 3

Entuity

Running Reports from Oracle Enterprise Manager ................................................36Device Inventory Report ....................................................................................36Devices by Manufacturer Report .......................................................................38

Launching Entuity Network Reports .......................................................................38Green IT Perspective .........................................................................................39Network Delivery Perspective ...........................................................................40Service Delivery Perspective .............................................................................41Branch Office Perspective .................................................................................42Multiple Branch Office Perspective ...................................................................43

A Entuity Events in Oracle Enterprise Manager .....................................................45AvailMonitor Low View Device Reachability ...........................................................45AvailMonitor Normal View Device Reachability ......................................................45Network Outage ......................................................................................................46Network Outage Cleared ........................................................................................47Service Down ..........................................................................................................48Service State Off .....................................................................................................48Service State Unknown ...........................................................................................48Service Up ...............................................................................................................49

B Integration Configuration Files .............................................................................50snmpforward_oem.cfg ............................................................................................50startup_O/S_site_specific.cfg .................................................................................52

Index ............................................................................................................................53


Entuity


FiguresFigure 1 Logging in to Oracle Enterprise Manager .....................................12Figure 2 Available Plug-ins ...........................................................................13Figure 3 Enterprise Summary ......................................................................16Figure 4 Overview of Setup Page ................................................................16Figure 5 Search and Select Targets ............................................................17Figure 6 Import Entuity Management Plug-in ..............................................18Figure 7 Add an Entuity Network Manager Instance ...................................18Figure 8 Added an Entuity Network Manager Instance ...............................19Figure 9 Network Services on an Entuity Network Manager Instance ........20Figure 10 Finding Service Identifiers .............................................................22Figure 11 Overview of Setup Page ................................................................23Figure 12 Import Entuity Management Plug-in ..............................................23Figure 13 Add an Entuity Network Service Instance .....................................24Figure 14 Selecting an Agent .........................................................................24Figure 15 Network Service Status History .....................................................25Figure 16 SNMP Trap Forwarding Integration Architecture ..........................27Figure 17 Entuity Network Manager ..............................................................32Figure 18 Entuity Server Inventory Page .......................................................33Figure 19 Enterprise Summary of Entuity Network Services ........................33Figure 20 Entuity Network Service All Metrics ...............................................34Figure 21 Drilling Down into Entuity Network Services .................................35Figure 22 Device Inventory Report ................................................................37Figure 23 Device Inventory by Manufacturer Report .....................................38Figure 24 Green IT Perspective .....................................................................40Figure 25 Network Delivery Perspective ........................................................41Figure 26 Service Delivery Perspective .........................................................42Figure 27 Branch Office Perspective .............................................................43Figure 28 Multiple Branch Office Perspective ................................................44

Entuity


TablesTable 1 Oracle Enterprise Manager Integration Files ....................... 9Table 2 Entuity Network Manager Agent Configuration ................... 15Table 3 Adding an Entuity Network Service Instance....................... 20Table 4 Overview of Entuity Server ................................................... 31Table 5 Device Inventory Parameters ............................................... 36Table 6 Device Inventory Report ....................................................... 37Table 7 Mapping Event Severity Levels ............................................ 45Table 8 snmpforward Configuration File........................................... 52

1 Integrate Entuity with Oracle Enterprise Manager

Entuity® network management provides a top-down segmented view of a network by grouping physical and virtual network components together that support a specific business function. The integration with Oracle Enterprise Manager allows these network services to be associated with the other hardware and software components managed by Oracle Enterprise Manager that constitute a complete application view of service delivery. This powerful association allows enterprises to quickly detect network problems affecting application service delivery that are otherwise hidden from their view.

Oracle Enterprise Manager

Oracle Enterprise Manager provides management capabilities across the entire application stack of an enterprise's IT infrastructure, e.g. hardware, middleware, databases, applications, and IT services made available to the (end) business user.

Oracle Enterprise Manager provides automation and simplification of many administrative and operational tasks, e.g. management of configuration, monitoring the health of key IT assets. A major benefit of Oracle Enterprise Manager is automation of early detection and isolation of problems that can severally impact availability of IT assets when left unattended. Oracle Enterprise Manager’s knowledge of a large portion of the entire application stack allows operators to understand how problems emanating from one layer impact the other layers and how to best prioritize their remedy.

Network Management Plug-in for Oracle Enterprise Manager

Entuity Network Management Plug-in for Oracle Enterprise Manager adds the network component to Oracle Enterprise Manager’s application stack. This integration requires a valid license and inclusion of configuration files to Entuity. The integration includes:

Two management plug-in archives: Entuity Network Manager allows Oracle Enterprise Manager to access Entuity’s

network performance data, including the receiving of event information through forwarded traps. This plug-in includes two inventory reports and provides links back to key pages and perspectives within Entuity.

Entuity Network Service allows Oracle Enterprise Manager to include Entuity network infrastructure service state data in to its service management.

A sample configuration file for configuring Entuity to forward traps to Oracle Enterprise Manager.

In summary, the Entuity integration with Oracle Enterprise Manager allows users to:

Understand how well the network layer supports IT assets monitored in Oracle Enterprise Manager


Entuity Network Management Plug-in for Oracle Enterprise Manager

View key network issues detected by Entuity directly within the Oracle Enterprise Manager interface in the form of (important) network alerts

View a list of network services that the network has to support and monitor their current and historical status directly within Oracle Enterprise Manager. Entuity network services automate the monitoring of the impact of low-level infrastructure performance on business services and applications.

Include network services as a component of Oracle Enterprise Manager managed services, allowing for clear identification of the state of the network infrastructure underpinning the delivery of each service

Understand the health of the network by reporting the reachability of Entuity business views, which are master sets of devices

Generate network performance information in Oracle Enterprise Manager using Entuity data

View network inventory, with Entuity providing for devices under its management key inventory information, e.g. manufacturer, model, firmware version

Launch the Entuity web UI directly from Oracle Enterprise Manager for simplification of work flows, easy drilldown, when troubleshooting network problems

Launch Entuity Business Perspectives, network dashboards for business users and senior staff, directly from Oracle Enterprise Manager, and also launch Entuity’s report center which contains an extensive set of network related reports

Add an abstraction of a network monitoring point (Entuity server) as a managed target within Oracle Enterprise Manager, to monitor the health of your network infrastructure.

Module Availability

This integration is available with Entuity. (For details on Entuity’s technical specification see the Entuity Getting Started Guide.) Entuity Integration Module for Oracle Enterprise Manager is approved for use with Oracle Enterprise Manager 12c.

Module Security

Entuity access permissions are granted based on view membership according to the standard Entuity security model. The Entuity user account you use when configuring the Entuity agent in Oracle Enterprise Manager determines the data Entuity can forward to it.

The events Entuity can forward are determined by the user account used with the Entuity event forwarding function, snmpforward.


2 Manage the Entuity Oracle Enterprise Manager

Plug-in

Entuity recommend you configure the Entuity Network Management Plug-in for Oracle Enterprise Manager in this sequence:

1) Set up Oracle Enterprise Manager, and ensure it is running.

2) Set up your Entuity server. (See the Entuity Getting Started Guide.)

3) Configure the integration by adding Entuity as a target to the Oracle Enterprise Manager server. (Follow the instructions in this chapter.)

4) When required setup Entuity to forward events to Oracle Enterprise Manager.

Files for Network Management Plug-in for Oracle Enterprise Manager

To successfully implement the Entuity plug-in for Oracle Enterprise Manager you must obtain from your Entuity representative an Entuity license. Entuity includes the plug-in management archives, a readme file and a sample file for configuring event forwarding.

Entuity recommend you always consult the Oracle Enterprise Manager documentation when configuring Oracle Enterprise Manager.

Filename Description

12.1.0.1.0_entuity.eye.xsvc_2000_0.opar, 12.1.0.1.0_entuity.eye.xsvr_2000_0.opar

Management plug-in archives for Entuity which you should have ready in a location Oracle Enterprise Manager can import from.These files are located in entuity_home\integ\OracleEM.

deploy.readme Includes the latest Oracle Enterprise Manager integration notes. This readme is located in entuity_home\integ\OracleEM.

license.dat The Entuity license file must include the Oracle Enterprise Manager key.

snmpforward_oem.cfg snmpForward is the utility for forwarding Entuity events. This sample configuration file defines the events forwarded to Oracle Enterprise Manager. (See the Entuity User and System Administrator Guide and the Entuity System Administrator Reference Manual.)

startup_O/S_site_specific.cfg

Includes a section that configures snmpforward, ensuring it always runs when Entuity runs. A sample configuration section can be copied from snmpforward_oem.cfg.

Table 1 Oracle Enterprise Manager Integration Files

�

h


Entuity Preparing for Deployment

Preparing for Deployment

Before you deploy the plug-in:

Ensure Entuity is installed and licensed for Oracle Enterprise Manager. When running the Entuity webserver using the https protocol with a certificate from an

unrecognized authority, register the certificate. (See Using HTTPS with Self-Certified Certificates.)

Set-up in Entuity the user accounts Oracle Enterprise Manager requires to access Entuity. (See the Entuity User and System Administrator Guide.)

Ensure Oracle Enterprise Manager 12c is the version to which you are installing the integration.This integration requires that you setup the Oracle Enterprise Manager Command Line Interface (emcli) and a repository for management plug-in archives. (See the Oracle Enterprise Manager documentation.)

Using HTTPS with Self-Certified Certificates

You can configure Entuity to run under HTTPS using certificates from recognized certification authorities or self-certified certificates. When using Entuity with a certificate that is not from a recognized certification authority, then you must register a certificate trust with the agent monitoring the Entuity components.

For example, to register a certificate (in a Linux environment):

1) Change directory to the AGENT_HOME/bin directory, where AGENT_HOME is the agent directory containing all of the files required to configure and run the Oracle Management Agent on this host, for example /opt/oracle/Middleware/agent/agent_inst/.

2) Register the certificate:

./emctl secure add_trust_cert_to_jks -password welcome -trust_certs_loc <MyCACert.txt> -alias privateAuth

where:

-trust_certs_loc parameter must contain the path and filename of the trusted_certs.txt file. This file must only contain certificates in base64 format and no special characters or empty lines.

3) When the certificate is registered stop and then restart the agent.

From the AGENT_HOME/bin directory enter:

emctl stop agent

emctl start agent

Entuity recommend you always consult the Oracle Enterprise Manager documentation when configuring Oracle Enterprise Manager.

�

h


Entuity Uploading the Entuity Plug-in Archives

Uploading the Entuity Plug-in Archives

To upload the management plug-in archives for Entuity to the Oracle Enterprise Manager:

1) Copy from the Entuity server the management plug-in archives to a temporary folder on the Oracle Enterprise Manager.

Specifically copy to /tmp from entuity_home/integ/OracleEM these files:

12.1.0.1.0_entuity.eye.xsvc_2000_0.opar12.1.0.1.0_entuity.eye.xsvr_2000_0.opar

2) From the command line import the plug-ins.

These instructions setup an alias to emcli, jdk and import the plug-in archives from a tmp folder:

alias emcli=/home/oracle/gcmiddleware/oms/bin/emcli

export JAVA_HOME=/home/oracle/gcmiddleware/oms/jdk

emcli import_update -file=/tmp/12.1.0.1.0_entuity.eye.xsvr_2000_0.opar-omslocal

emcli import_update -file=/tmp/12.1.0.1.0_entuity.eye.xsvc_2000_0.opar-omslocal

Deploying the Entuity Plug-ins

After uploading the management plug-ins you must first deploy them to the management server before you can deploy them to management agents.

Deploying a Plug-in to the Oracle Enterprise Manager Management Server

To deploy an Entuity management plug-in archive to a management server:

1) Login to Oracle Enterprise Manager Cloud Control as a super administrator.


Entuity Deploying the Entuity Plug-ins

Figure 1 Logging in to Oracle Enterprise Manager

Oracle Enterprise Manager displays its home page.

2) Click Setup >Extensibility >Plug-ins.

Oracle Enterprise Manager displays the list of available plug-ins.


Entuity Deploying the Entuity Plug-ins

Figure 2 Available Plug-ins

3) Highlight the required plug-in and from the context menu click Deploy-on > Management Servers.

Oracle Enterprise Manager displays the Deploy Plug-in on Management Servers page.

4) Confirm the plug-in Name and Version and enter the Repository SYS Password.

5) Click Continue.

Oracle Enterprise Manager reports on the progress of the prerequisite checks for plug-in deployment.

6) When the checks are successful click Next.

Oracle Enterprise Manager displays details of the plug-in and available management servers.

7) Click Deploy.

Oracle Enterprise Manager starts to deploy the plug-in.

8) You can select Show status to follow its progress, or Close for Oracle Enterprise Manager to close the Deploy Plug-in on Management Servers page.


Entuity Adding Entuity Instances for Monitoring

Deploying a Plug-in to the Oracle Enterprise Manager Management Agent

When a plug-in has been deployed to a management server then it can be deployed to management agents.

To deploy an Entuity management plug-in archive to a management agent:

1) From the Oracle Enterprise Manager click Setup >Extensibility >Plug-ins.


2) Highlight the required plug-in and from the context menu click Deploy-on > Management Agent.

Oracle Enterprise Manager displays the Deploy Plug-in on Management Agent page.

3) From Selected Management Agent select Add...

Oracle Enterprise Manager displays the Search and Select dialog.

4) Highlight the agents to which you want to deploy the agent and then choose Select.

5) Specify other required details on the Deploy Plug-in on Agents dialog box.

6) Click Continue.

Oracle Enterprise Manager reports on the progress of the prerequisite checks for plug-in deployment.

7) When the checks are successful click Next.

Oracle Enterprise Manager displays details of the plug-in and available management servers.

8) Click Deploy.

Oracle Enterprise Manager starts to deploy the plug-in. Deployment occurs in parallel on all selected agents.

9) You can click Show status to follow its progress, or Close for Oracle Enterprise Manager to close the Deploy Plug-in on Management Agents page.

Adding Entuity Instances for Monitoring

After successfully deploying the plug-ins, Entuity Network Manager and Entuity Network Service, you can add them to Cloud Control for central monitoring and management. For each Entuity server that you want to include to Oracle Enterprise Manager, first add it as a server plug-in target. It is through its Services metrics page that you can identify the service identifiers you require when adding instances of the service plug-in.

Adding Entuity Network Manager Instances

When adding an Entuity Network Manager instance you must specify the Entuity server and enter details of the user account Oracle Enterprise Manager uses to access it. It is the


Entuity Adding Entuity Network Manager Instances

permissions of this Entuity user account that determine the potential network objects visible to Oracle Enterprise Manager.

To add an Entuity Network Manager instance:


Oracle Enterprise Manager displays its home page

2) Click Setup >Add Target >Add Targets Manually.

Oracle Enterprise Manager displays the Overview of Setup page.

Attribute Description

Name Name of the Entuity server in Oracle Enterprise Manager.

Type Set by the management plug-in to Entuity Network Service, Entuity Network Manager. It is not user definable.

Hostname Hostname of the Entuity webserver. By default the webserver uses port 80, for http and port 443, for https. When the Entuity webserver is running on a different port to these you must specify the port by adding a colon after the hostname and then the port number, e.g. century:82.

Protocol (http/https) Protocol the Entuity webserver uses.

User User account Oracle Enterprise Manager uses to access Entuity server.

Password Entuity user account password.

SNMP Trap Source IP address used by Entuity’s SNMP trap forwarding process, snmpforward. Entuity can use multiple IP addresses, this should be set to allow Oracle Enterprise Manager to correctly associate the trap sender with the Entuity server.This IP address must be the same as the IP address set in snmpforward_oem.cfg through agent_addr.It is only required when configuring the Entuity Network Manager plug-in.

Table 2 Entuity Network Manager Agent Configuration



Figure 3 Enterprise Summary

3) Select Add Non-Host Targets by Specifying Target Monitoring Properties.

Oracle Enterprise Manager displays Import Management Plug-in fields.

Figure 4 Overview of Setup Page



4) For Target Type select Entuity Network Manager, and then for Monitoring Agent select the magnifying Search icon.

Oracle Enterprise Manager displays a Search and Select dialog from which you can select the target agent.

Figure 5 Search and Select Targets

5) Highlight the target agent and click Select.

Oracle Enterprise Manager updates the Add Targets Manually page.



Figure 6 Import Entuity Management Plug-in

6) Click Add Manually ... .

7) Complete the Entuity Network Manager properties.

8) Click Test Connection, to test the connection details for the Entuity Network Manager.

Figure 7 Add an Entuity Network Manager Instance

If the connection fails check the Entuity properties, for example when the Entuity webserver is running on a non-standard port ensure you have specified that port. For example, if running on port 90 on the host century, hostname is century:90.

9) Click Ok, to confirm and save the connection details.

Oracle Enterprise Manager displays the Agent status and details page, and a confirmation message that the target server has been successfully added.



Figure 8 Added an Entuity Network Manager Instance

Verifying and Validating the Entuity Network Manager Plug-in

After waiting a few minutes for the plug-in to start collecting data you can verify and validate Oracle Enterprise Manager is properly monitoring the plug-in target. You can also view the service details that you require when adding Entuity Network Service instances.

To verify and validate the plug-in:

1) Click Targets > All Targets.

2) From the list of monitored targets select the new Entuity target. Oracle Enterprise Manager displays the home page for this Entuity server, from which you can view:

The current status of the Entuity server. A bar chart showing up to ten views on the Entuity server, along with the percentage

of reachability to the network infrastructure components within those views. A chart showing the overall status of the network services on the Entuity server, and

the list of services currently down. A list of active alerts that have been forwarded from the Entuity server, and which have

not been cleared or deleted. A selection of hyperlinks to quickly launch various parts the Entuity web UI.

You should also check the two reports, Device Inventory and Device by Manufacturer.


Entuity Adding Entuity Network Service Instances

Figure 9 Network Services on an Entuity Network Manager Instance

Adding Entuity Network Service Instances

When adding an Entuity Network Service instance you must specify the Entuity server, enter details of the user account Oracle Enterprise Manager uses to access it and the service identifier. It is the permissions of this Entuity user account that allow Oracle Enterprise Manager access to the state of the specified service.


Name Name of the Entuity service in Oracle Enterprise Manager.

Type Set by the management plug-in to Entuity Network Service. It is not user definable.

Table 3 Adding an Entuity Network Service Instance



Finding an Entuity Network Service identifier

When you want Oracle Enterprise Manager, through the Entuity Services plug-in, to monitor one or more Entuity services, take a note of their service identifier. The service identifier is required when adding an Entuity Network Service.

From the Entuity web UI you can find a service’s identifier through its URL, for example:

http://century/webUI/serviceDetails.do?view=CIO%20London%20Office&serverId=aa2287e3-19ac-4d2c-876a-b1e7b6-fa059e&serviceId=17417

where serviceId is the unique identifier of the service.

The service identifier is also available when you have the Entuity server managed through the Entuity Network Manager. To find an Entuity Network Service identifier:

1) Navigate to the summary page of the Entuity Network Manager target.

2) From the Target drop-down select Monitoring > All Metrics

3) From the metric types listed under the Entuity server select Network Services.

4) Oracle Enterprise Manager displays details og the Entuity network services, including Service ID.

Hostname Hostname of the Entuity webserver. By default the webserver uses port 80, for http and port 443, for https. When the Entuity webserver is running on a different port to these you must specify the port by adding a colon after the hostname and then the port number, e.g. century:82.

Protocol (http/https) Protocol the Entuity webserver uses.

User User account Oracle Enterprise Manager uses to access Entuity server.

Password Entuity user account password.

Service Id Unique identifier of the Entuity service. You can identify available services and their identifiers through the Entuity Network Manager instance’s Service metrics page.


Table 3 Adding an Entuity Network Service Instance



Figure 10 Finding Service Identifiers

Adding Entuity Network Services

To add an Entuity Network Service instance:


Oracle Enterprise Manager displays its home page

2) Click Setup >Add Target >Add Targets Manually.

Oracle Enterprise Manager displays the Overview of Setup page.

3) Click Add Non-Host Targets by Specifying Target Monitoring Properties.

Oracle Enterprise Manager displays Import Management Plug-in fields.

4) For Target Type click Entuity Network Service, and then for Monitoring Agent select the magnifying Search icon.

Oracle Enterprise Manager displays a Search and Select dialog from which you can select the target agent.



Figure 11 Overview of Setup Page

5) Highlight the target agent and press Select.

Oracle Enterprise Manager updates the Add Targets Manually page.

Figure 12 Import Entuity Management Plug-in

6) Select Add Manually ... .

7) Complete the Entuity Network Manager properties.

8) Select Test Connection, to test the connection details for the Entuity Network Manager.



If the connection fails check the Entuity properties, for example when the Entuity webserver is running on a non-standard port ensure you have specified that port. For example, if running on port 90 on the host century, hostname is century:90.

Figure 13 Add an Entuity Network Service Instance

9) Click Ok, to confirm and save the connection details. Oracle Enterprise Manager displays a the Agent status and details page, and a confirmation message that the target server has been successfully added.

Figure 14 Selecting an Agent

Verifying and Validating the Entuity Network Service Plug-in

After waiting a few minutes for the plug-in to start collecting data you can verify and validate Oracle Enterprise Manager is properly monitoring the plug-in target:

To verify and validate the plug-in:

1) Select Targets > All Targets.

2) From the list of monitored targets select the new Entuity Target Name. Oracle Enterprise


Entuity Undeploying the Plug-ins

Manager displays the home page for this Entuity network service, from which you can view:

The current status of the Entuity service. A list of active alerts that Oracle Enterprise Manager has raised against the service. A selection of hyperlinks to quickly launch the Entuity home and Service Details page.

The service does not have any associated reports.

Figure 15 Network Service Status History

Undeploying the Plug-ins

When you want to remove the Entuity management plug-ins:

If you have associated Entuity Network Service instances to systems, ensure you first delete these systems.

Remove all Entuity Network Manager and Entuity Network Service instances from the agent monitoring configuration.

Undeploy the Plug-in from all agents, and then undeploy from the management server. Remove the Plug-in.

Remove a Target

To remove an Entuity target from an Agent:

1) Log in to Enterprise Manager Cloud Control as a Super Administrator.

2) Select Targets > All Targets.

3) Highlight the Entuity Network Manager or Entuity Network Service target that you want


Entuity Undeploying the Plug-ins

to remove.

4) From the context menu select Target Set-up >Remove Target and then select Yes in the Confirmation dialog.

Undeploy a Plug-in from an Agent

To undeploy a plug-in from an Agent:

1) From the Oracle Enterprise Manager select Setup >Extensibility >Plug-ins.


2) Highlight the Entuity Network Manager and Entuity Network Service plug-in you want to remove and from the context menu select Undeploy From and Management Agent.

Oracle Enterprise Manager displays the Undeploy Management Plug-in page. You must confirm your credentials to remove an agent.

3) Check all the Agents that are currently deployed with the Entuity Network Manager and Entuity Network Service plug-ins and select OK.

4) You must undeploy the plug-in from every Agent in the system to completely remove it from the enterprise.

Undeploy a Plug-in from a Management Server

To undeploy a plug-in from a management server:

1) From the Oracle Enterprise Manager select Setup >Extensibility >Plug-ins.


2) Highlight the Entuity Network Manager and Entuity Network Service plug-in you want to remove and from the context menu select Undeploy From and Management Servers.

Oracle Enterprise Manager displays the Undeploy Management Plug-in page. You must confirm your credentials to remove a plug-in.

3) Check all the servers that are currently deployed with the Entuity Network Manager and Entuity Network Service plug-ins and click OK.

Remove a Plug-in from Oracle Enterprise Manager

After undeploying a plug-in from management agents and management servers you can remove it from Oracle Enterprise Manager. To remove a plug-in from Oracle Enterprise Manager:

1) From the Oracle Enterprise Manager select Setup > Extensibility > Self Update.

2) Select the plug-in folder.

3) Highlight the pig-in and from the Actions menu select Delete.


3 Forward Events to Oracle Enterprise Manager

You can configure Entuity to automatically forward events to the Oracle Enterprise Manager server. Entuity includes a sample configuration file, with default settings that restrict the number of event types Entuity forwards.

Figure 16 SNMP Trap Forwarding Integration Architecture

An overview of Entuity’s SNMP Trap Forwarding integration is:

1) Entuity generates event data.

2) Entuity configures the event data ready for forwarding.

The snmpforward configuration specifies the trap forwarding filter, for example the type of events that can be forwarded as traps if they occur in the specified view.

3) snmpforward sends data to Oracle Enterprise Manager.


Entuity Configuring Entuity snmpforward

4) Oracle Enterprise Manager accepts the traps data, recognizing the originating Entuity server from the trap source’s IP address.

5) From the Entuity home page Oracle Enterprise Manager users can view Entuity event data as mapped alerts.

Configuring Entuity snmpforward

Configuration of the SNMP trap forwarding process, snmpforward, is through two files:

entuity_home\etc\startup_O/S_site_specific.cfg, which contains a section that references the forwarding configuration file, and a routing section within it, applied to an instance of snmpforward. When Entuity starts, snmpforward also starts using the defined configuration.

snmpforward configuration file. Entuity includes a sample configuration file entuity_home\etc\snmpforward_oem.cfg. It configures the events to forward, the user accounts to use and the Oracle Enterprise Manager server.

snmpforward_oem.cfg is backed-up to entuity_home\etc\bkp during Entuity upgrades, and the version in entuity_home\etc overwritten. When you use snmpforward_oem.cfg you should reapply your site specific changes after an upgrade, alternatively rename your snmpforward configuration file.

Using the Sample Configuration

This section details the changes required to use the sample configuration in entuity_home\etc\snmpforward_oem.cfg. To view more details on how to configure snmpforward for Oracle Enterprise Manager see Appendix B - Integration Configuration Files. (See the Entuity User and System Administrator Guide for snmpforward details.)

The sample integration allows forwarding of seven event types to Oracle Enterprise Manager. Events are specified in the [include_events] section of the snmpforward configuration file, using the event name to identify the event type. (For a full list of event names see the Entuity Events Reference Manual.)

The sample configuration forwards seven event types:

AvailMonitor Low View Device Reachability AvailMonitor Normal View Device Reachability Network Outage Network Outage Cleared Service Down Service State Off Service State Unknown Service Up.

�

h

�

h



To configure snmpforward to forward events as traps to an Oracle Enterprise Manager, configure sections:

1) From the snmpforward configuration file set the routing parameters:

[snmp_route_1]

agent_addr=127.0.0.1

where:

agent_addr, sets the IP address used by Entuity to forward traps. It must match the IP address entered when configuring the SNMP trap source in Oracle Enterprise Manager.

2) From the snmpforward configuration file, set the Entuity user account and view used by snmpforward:

[snmp_reader_1]

username=admin

view=Regional

where:

username is the Entuity user account used with snmpforward. view is the Entuity business view from which Entuity forwards events. You can only

specify one view.

3) From the destination section of the snmpforward configuration file, set the Oracle Enterprise Manager to which the traps are sent:

[snmp_dest_1]

host1=oracle_em_server:3872

where:

hostn specifies the IP address, or hostname, and SNMP port number, 3872, of the target Oracle Enterprise Manager server. You can specify one or more hosts.

4) Update the appropriate start configuration file (e.g. startup_win32_site_specific.cfg, startup_unix_site_specific.cfg) to initialize snmpforward when the Entuity server starts.

An example section is included in snmpforward_oem.cfg, which you can copy to the startup file:

[oem_snmpforward]

state=normal

capabilities=polling

type=command

start=${ENTUITY_HOME}${FPS}integ${FPS}SNMP${FPS}snmpforward${ENTUITY_HOME}${FPS}etc${FPS}snmpforward_oem.cfg snmp_route_1



directory=${LOGDIR}

is_critical=n

where the only parameter you might want to amend is:

start, which defines the location and name of the configuration file and routing section applied to snmpforward.

5) Stop and restart the Entuity server for the configuration changes to take effect.


4 Use Entuity From Oracle Enterprise Manager

The Entuity management plug-in archive includes two plug-in types:

Entuity Network Manager provides visibility into the network layer, adding a network monitoring component to the Oracle Enterprise Manager application stack

Entuity Network Service allows Oracle Enterprise Manager to include network infrastructure state data in to its service management.

Using the Entuity Network Manager

The Entuity Network Manager home page in Oracle Enterprise Manager provides visibility into the network layer. From this page you can:

Monitor the performance of the server, its availability, current status. Access summaries of network performance, e.g. device reachability, service delivery. View key events raised against objects on the network and also the server. Run targeted reports. Drill-down to Entuity web pages, e.g. view Green IT Perspective, Multiple Branch Office

Perspective.

To access an Entuity Network Manager home page:

1) From the list of monitored targets select the Entuity target.


General Status and availability of the Entuity server.

Network Service Status

Represents the current state of Entuity network services. An Entuity service is a logical grouping of network infrastructure components and tests required for a particular service to operate.

Bottom 10 Views by Device Reachability

Lists the views with the highest percentage of unreachable devices, as identified by a failure to respond to ping. Entuity views allow you to group managed objects according to your requirements, e.g. by organization structure, geographical location.

Alerts Events raised by Entuity and forwarded to Oracle Enterprise Manager. By default Entuity only sends a small subset of events, all events are available through Entuity Event Viewer.

Host Alerts Events related to Entuity server performance.

Related Links A series of links that drill-down to the Entuity server, opening key pages in it s web UI.

Reports A series of reports available from Oracle Enterprise Manager.

Table 4 Overview of Entuity Server


Entuity Using the Entuity Network Manager

Figure 17 Entuity Network Manager

2) From the Entuity Network Manager home page, you can view performance statistics, run reports and access Entuity.

From Related Links select Eye of the Storm to open the Entuity server. Depending upon your configuration you may be prompted for your user account details. When you successfully login Entuity displays its home page, by default the Inventory page.


Entuity Using Entuity Network Services

Figure 18 Entuity Server Inventory Page

Using Entuity Network Services

The Entuity Network Service home page includes availability statistics and direct access to two Service pages in Entuity. However the key benefit from the Entuity Network Service plug-in is the ability to assign it to systems which can then be assigned to Oracle Enterprise Manager services.

Figure 19 Enterprise Summary of Entuity Network Services



From the Metrics and Collection Settings page you can view the polling interval of the Entuity service status, by default every five minutes.

Figure 20 Entuity Network Service All Metrics

Entuity services can be integrated into Oracle Enterprise Manager services, with drill-back allowing for immediate investigation into any network failures underlying service delivery concerns.



Figure 21 Drilling Down into Entuity Network Services


5 Entuity Reporting From Oracle Enterprise Manager

The Entuity Network Manager home page in Oracle Enterprise Manager provides visibility into the network layer, adding to Oracle Enterprise Manager improved insight and deeper understanding of distributed transactions.

Running Reports from Oracle Enterprise Manager

Entuity Network Management Plug-in for Oracle Enterprise Manager includes two inventory reports that you can run from Oracle Enterprise Manager, Device Inventory and Device by Manufacturer. These reports use data in the Oracle Enterprise Manager database which is updated every five minutes.

To run an Entuity derived report from Oracle Enterprise Manager:

1) From the Entuity Network Manager home page select the Target > Information Publisher Reports.

Oracle Enterprise Manager displays the reports available for Entuity Network Manager, with Device Inventory report selected by default.

2) Select the report type, i.e. Device Inventory, Devices by Manufacturer.

Oracle Enterprise Manager displays the Specify Target for Report.

3) Enter the target and select Continue.

Oracle Enterprise Manager generates the report. When you select Device Inventory, Oracle Enterprise Manager includes all devices, running the report without a filter but are accessible using the Entuity login.

Device Inventory Report

This report lists all of the devices managed by the selected Entuity Server, which are accessible by the associated Entuity user account.

You can determine the scope of the report by specifying your report filter. By default all devices are included to the report.


Device Name Resolved device name or its IP address.

Manufacturer Network device manufacturers.

Description Manufacturers device description.

Location Text description of the physical location of the device that is contained on the device, e.g. Development Cabinet.

Table 5 Device Inventory Parameters


Entuity Running Reports from Oracle Enterprise Manager

Each row of the report details one device that meets the report criteria. You can sort the report on an attribute by selecting its column header.

Figure 22 Device Inventory Report

Name Description

Name System name or where not available the IP address.

Manufacturer Manufacturer name is derived by matching the manufacturer number against the first 2500 Private Enterprise Codes compiled by the Internet Assigned Numbers Authority (http://www.iana.org/assignments/enterprise-numbers). Where the manufacturer code is not matched then the first part of the device name is taken, usually this is the manufacturer’s name.

Model The device model.

Description System description, which for a Cisco device is a parsed sysDescr with model, version and serial number.

Location Device SysLocation, or where not available it is left blank.

Table 6 Device Inventory Report


Entuity Launching Entuity Network Reports

Devices by Manufacturer Report

This report details the distribution of devices, by manufacturer, that are managed by the selected Entuity Server and accessible by the associated Entuity user account. This distribution is presented through a pie chart, with its key identifying:

Color codes used for each segment of the chart. Manufacturer name, as supplied by Entuity. (For details on how it is derived see the

Device Inventory Report.) Number of devices of that manufacturer.

Figure 23 Device Inventory by Manufacturer Report

Launching Entuity Network Reports

Entuity includes an extensive suite of reports available from its web UI. From Oracle Enterprise Manager there are direct links to the Entuity server and also to its perspectives. An Entuity perspective provides an important overview, with links to more detailed reports, on key components of the managed network.

These links are available from the EYE Network Manager’s home page:

EYE of the Storm, a link to the Entuity server. Green IT Perspective Network Delivery Perspective Service Delivery Perspective Branch Office Perspective Multiple Branch Office Perspective.

These links are available from the EYE Network Service’s home page:



EYE of the Storm, a link to the Entuity server. Service Details, a link to the Entuity Service Component page.

To launch an Entuity perspective from Oracle Enterprise Manager:

1) From the Entuity Network Manager home page Related Links section select the required perspective.

When this is the start of a new session you are prompted for a valid Entuity user account and password, otherwise Entuity displays the selected perspective.

Green IT Perspective

The Green IT Perspective provides an overview of workstation overnight shutdown compliance, with access to a detailed compliance report and other Green IT Perspective reports.

Access to these reports:

Green IT Perspective Detail report Workstations Shutdown Policy Compliance report Underutilized Servers report Spare Ports and Power Consumption report Known Power Consumption of Devices in Inventory report.



Figure 24 Green IT Perspective

Network Delivery Perspective

Network Delivery Perspective concisely displays an overall summary of network performance including reachability status and uptime values. It also includes summaries of services, applications, servers, and infrastructure device availability across the environment, charting for each outage, average and total unreachability.



Figure 25 Network Delivery Perspective

Service Delivery Perspective

The Service Delivery Perspective aggregates the behavior of all the services in a chosen view and displays, by default, a summary of the previous thirty-one days in the Regional view. You can also access the more detailed service reports; Service Inventory Report, Service Availability Report, Service Event History Report. For example, allowing information about availability of key services such as email, data center connectivity, VoIP services and resilient links to satellite offices and the Internet allows IT and business managers to quickly assess the quality of services that the IT infrastructure is providing to its business users.

You can also view service performance within the wider context of the managed infrastructure performance through the InSight Center’s Network Delivery Perspective.

3. Applications Availability ReportThis report identifies which Monitored Applications haveexperienced outages. Application reachabil ity ismonitored from Entuity servers using TCP port probingtechniques. The total duration of the outages are listedalong with details of which servers they are hosted on.Where the loss of Application reachability was observeredto have been attributable to either the hosting server ornetwork connections this is also indicated.

4. Server Availability ReportThis report identifies which Monitored Servers haveexperienced losses of reachability and/or uptime. Serverreachability is minitored from Entuity servers using ping(ICMP loopback). Uptime is monitored using thesysUptime SNMP metric. The times and durations of theoutages are displayed on a graphical timeline and listed ina tabular textual manner.

5. Infrastructure Device Availability ReportThis report identifies which routers, switches, firewallsand other non-server managed devices have experiencedlosses of reachability and/or uptime. Device reachability isminitored from Entuity servers using ping (ICMP loopback).Uptime is monitored using the sysUptime SNMP metric.The times and durations of the outages are displayed ona graphical timeline and listed in a tabular textual manner.

Report Guide

2. Service Availability ReportThis report identifies which Services have experiencedoutages. The times and durations of the outages arelisted along with details of which components and/or sub-services were responsible.

This redisplays the information in the Network DeliveryPerspective in a form suitable for printing.

1. Network Delivery Summary Report

Network Delivery Perspective (TM)

View: Regional Over the period 00:00 on Wed Nov 26 2012 - 00:00 on Thu Nov 27 2012

Services SummaryServices with outages:Total downtime:

Range In the range00s

Total duration

Overall Summary

1 Service

16 Applications

10 Servers

27 Infrastructure devices

100%

46%

100%

88.4%

N/A

N/A

100%

95.6%

(known for 10 servers)

Reachability / Status Uptime

Applications SummaryApps with outages:Total unreachability:

128d 15h 21m 36s

Servers SummaryServers with outages:Total unreachability:Average unreachabilityper server:

Infrastructure Devices SummaryDevices with outages:Total unreachability:Avg unreachabilityper device:

0-50.0%50.0-85.0%85.0-95.0%95.0-100%

0-50.0%50.0-85.0%85.0-95.0%95.0-100%

0-50.0%50.0-85.0%85.0-95.0%95.0-100%

0-50.0%50.0-85.0%85.0-95.0%95.0-100%

12 (75%) 8d 15h 21m 36s0 (0%) 0s0 (0%) 0s4 (25%) 0s

0 (0%) 0s0 (0%) 0s0 (0%) 0s10 (100%) 0s

3 (11.1%) 3d 0h 0m 0s0 (0%) 0s2 (7.4%) 3h 5m 17s22 (81.5%) 6m 3s

00s

0s

73d 3h 11m 20s

2h 47m 5s

See detailed report for servers

See detailed report for devices

Average downtimeper service: 0s

Average unreachabilityper application: 12h 57m 36s

(known for 23 devices)

Service status

Application reachability

Server reachability

Infrastructure device reachability

See detailed report for services

Network Delivery Summary

0s0s0s0s

0 (0%)0 (0%)0 (0%)1 (100%)

See detailed report for applications



Figure 26 Service Delivery Perspective

Branch Office Perspective

The Branch Office Perspective provides an overview of both the last sample and recent health of the network equipment at the selected branch office, allowing for easy discrimination of current and longer term issues.

Several aspects of the behavior of the WAN connectivity are covered and this also accommodates any redundancy, load balancing or dial-backup configuration. The reachability of all devices being monitored as part of the branch office view is also represented. Further details are displayed when the cursor is placed over any of the status icons, with drill down to the Branch Office Details report also available.

The report only includes an SLA quality section when the view includes Cisco IP SLA operations. Where multiple operations are configured for a branch office their results are listed separately, with drill downs to the IP SLA Details report available.

The Spare Switch Port Summary section covers all the devices in the branch office view that are classified as switches. There is also access to the Spare Ports report. A spare port is defined as a physical port that has been continuously operationally down for at least 40 days.



The green report guide panel provides report launch facilities in the context of the selected branch office view.

Figure 27 Branch Office Perspective

Multiple Branch Office Perspective

Multiple Branch Office Perspective provides an overview of the health of the network equipment in all of the branch offices that are accessible to the user. For each branch office you can drill down to the Branch Office Perspective, which inherits its timeframe from the Multiple Branch Office Perspective. From each icon you can drill down to the Branch Details report, click on a:

Connectivity icon, and the report details all of the connectivity measures for the branch. Reachability icon, and the report details device reachability for the branch. SLA Quality icon, and the report details all of the Cisco IP SLA operators for the branch.



Figure 28 Multiple Branch Office Perspective


Appendix A Entuity Events in Oracle Enterprise Manager

The sample configuration detailed through snmpforward_oem.cfg, forwards seven event types to the Oracle Enterprise Manager.

The integration maps Entuity severity levels to Oracle Enterprise Manager severity levels.

Entuity event severity and event description are configurable from the Entuity client, through the Preferences dialog. When you amend these settings from the client on the Entuity server the forwarded events include these changes.

AvailMonitor Low View Device Reachability

Entuity measures device reachability by pinging a monitored device’s IP management address every two minutes. Entuity raises this event when the number of devices responding to the ICMP ping and therefore reachable is, expressed as a percentage, below the Device Reachability threshold for the view.

Default severity level: severe, color code: orange.

Typical CausesHigh utilization of the area of the network where the devices within the view are.

ActionsInvestigate the devices within the view. If the device reporting the event is a router, then Telnet to the router to ascertain possible causes for the outage.

AvailMonitor Normal View Device Reachability

Entuity measures device reachability by pinging a monitored device’s IP management address every two minutes. Entuity raises this event when the number of devices responding to the ICMP ping and therefore reachable is, expressed as a percentage, is now above the Device Reachability threshold for the view.

EntuitySeverity / Description

Oracle Enterprise ManagerSeverity / Description

2 Information 1 Clear

4 minor 2 Warning

6 Major

8 Severe 3 Critical

10 Critical

Table 7 Mapping Event Severity Levels


Entuity Network Outage

Indicates device reachability within the view has returned to acceptable levels.

Default severity level: information, color code: green.

Typical CausesDevice reachability within the view has transitioned to be within the set threshold

ActionsNone.

Network Outage

Network Outage events are raised on information Entuity collects using traceroute and ICMP ping. It indicates an outage on your network, caused for example by node failure, unreachability of a managed port.

The Details column of the event indicates the particular category of the outage, how Entuity identifies the outage category is a product of how it handles traceroute data. Entuity discovers all IP addresses configured on a device and then determines which ports, if any, these IP addresses belong to. The success of this association is dependent on the structure of the SNMP MIB. Also if a port is unmanaged within Entuity then an IP address cannot be associated with the port.

Default severity level: critical, color code: red.

Typical CausesThe Details column in Event Viewer indicates the particular cause of the outage:

Managed IP On Device Unreachable: Indicates that an IP address is not responding to ping: The port for the IP address is not managed by Entuity but the device is managed by

Entuity. This may be caused by a routing problem, interface shutdown. Entuity cannot determine the port associated with the IP address because the IP

address is not fixed to a port. Port Unreachable: Indicates that an IP address that is associated with a port is not

responding to ping. When Entuity is managing the device through a network cloud, Entuity raises this event when some of the device’s IP addresses are down. Event details lists the unreachable IP addresses in the cloud.

Node Unreachable: Indicates that all of the IP addresses of a network node are not responding to ping. The node (typically a router or a switch) has transitioned to the down state.When Entuity is managing the device through a network cloud, Entuity raises this event when all of the device’s IP addresses are down. Event details lists the unreachable IP addresses in the cloud.

Entuity Server disconnected from network: Indicates that all discovered IP addresses are not responding to ping, suggesting the disconnection of the Entuity server from the network.


Entuity Network Outage Cleared

The Network Outage event is only raised against devices that are the root cause of the outage, the Device Unreachable event, when enabled, is raised against any device Entuity identifies as unreachable.

ActionsIn the Impacted column of Event Viewer Entuity displays a count of the nodes, servers and applications impacted by the port down or node failure. You can view the list of impacted objects - or at least those components for which you have permission to view - by from the context sensitive menu clicking Show Details.

When Entuity raises a network outage event the action you take depends upon the event type raised, on your network administrator role and whether you have physical access to the device. When event Details identifies the cause of the outage as:

Managed IP On Device Unreachable or Port UnreachableFor these two categories check that the relevant network is routable from Entuity. If the network is not routable and this is:

Intentional then to prevent the raising of this event consider excluding the network from Entuity management through Entuity's configuration settings.

A Port Unreachable network outage check the operation status of the port. If this is down it may indicate a damaged or pulled out cable or that the device at the other end of the link has failed.

Node UnreachableIf all of a device's IP addresses are not responding to ping and the device is also not responding to SNMP polling it is probable that the node has failed. You can review the incident history for the device, for example for fan failure and temperature incidents. If the device does not restart the only recourse is a physical inspection.

Entuity Server disconnected from networkFrom the Entuity server machine use the ping utility installed as part of its operating system to ping network devices. If ping fails to elicit a response check for Access Control Lists and firewalls that may be blocking ICMP ping. If ping succeeds check that the server's firewall permits applicationMonitor access, you may have to add a rule for the Entuity process.

Network Outage Cleared

Indicates an outage on your network, caused for example by node failure, unreachability of a managed port is now resolved.

Default severity level: information, color code: green.

Typical CausesThe Details column in Event Viewer indicates the particular network outage clearance:

Managed IP Address Reachable

�

h


Entuity Service Down

Indicates that the IP address is now responding to ping. The port for the IP address is not managed by Entuity, but the device is managed by Entuity.

Port ReachableIndicates that a port is once again responding to ping. For router ports a filter ensures only ports with an associated IP address are included.

Node ReachableIndicates that a node (typically a router or a switch) has transitioned to the up state. All of the IP addresses of a network node do not respond to ping.

Entuity Server connected to the networkIndicates a restored connection of the Entuity server to the network.

ActionsNone.

Service Down

Indicates the named service is down.

Typical CausesThe number of components failing in the service is sufficient to cause the service to fail.

ActionsClick Dashboards > Service Summary. You can view the current status of all services and then select the required service to drill down and view the status of its components.

Service State Off

Indicates the named service is now set to not generate a state. The event details indicate Status is set to None.

Typical CausesUser has amended the service configuration setting Type to None.

ActionsNone

Service State Unknown

Indicates the state of the named service is unknown.

Default severity level: severe, color code: orange.

Typical CausesThe state of one or more of the components in the service is unknown.


Entuity Service Up

ActionsClick Dashboards > Service Summary. You can view the current status of all services and then select the required service to drill down and view the status of its components.

Service Up

Indicates the named service is up, its state having previously been Down or Unknown.

Typical CausesThe state of enough components in the service is up, so the service is now available.

ActionsNone


Appendix B Integration Configuration Files

The Entuity integration module for Oracle Enterprise Manager uses a tailored snmpforward configuration to define the event types to forward, and an additional section to startup_O/S_site_specific.cfg. (For an overview and more details on the integration process see the Entuity User and System Administrator Guide.)

snmpforward_oem.cfg

[snmp_route_1]

reader=snmp_reader_1

dest=snmp_dest_1

format=snmp_ent_varbinds

enterprise=1.3.6.1.4.1.2626.1.1

specific=2059

agent_addr=127.0.0.1

eye_server_id=server.id

ssl_enabled=server.ssl_enabled

eye_webportnum=webportnum

eye_hostname=hostname

[snmp_reader_1]

username=admin

view=My Network

[snmp_dest_1]

host1=oracle_em_server:3872

[snmp_ent_varbinds]

${event.PAPIObjectID_index}

${entuity_variables.ENT_OBJ_DESCR}=${event.PAPIEventDescr}

${entuity_variables.ENT_OBJ_PRIORITY}:INT=${event.PAPIPriority}

${entuity_variables.ENT_OBJ_ATTR}:INT=${event.PAPIAttr}

${entuity_variables.ENT_IMPACT_TYPE}:INT=${event.PAPIImpact}

${entuity_variables.ENT_IMPACT_DESCR}=${event.PAPIImpactDescr}

${entuity_variables.ENT_EVENT_DETAILS}=${event.PAPIDetails}

${entuity_variables.ENT_EVENT_ID}=${event.PAPIEventID}

${entuity_variables.ENT_EVENT_DESCR}=${event.PAPIEventStr}


Entuity

${entuity_variables.ENT_EVENT_SEVERITY}:INT=${event.PAPISeverity}

# new varbinds for use by OEM

${entuity_variables.ENT_CORRELATION_GROUP}=${event.PAPICorrela-tionGroup}

${entuity_variables.OEM_EVENT_SEVERITY}=${event.PAPIOemSeverity}

# serverId

${entuity_variables.ENT_EVENT_SERVER_ID}=${event.PAPIObjectServerID}

# object summary link only populated for a device and port. UsePAPIObjectSummaryLink for EM 11 and PAPIObjectSummaryLinkRef for 12c

#${entuity_variables.ENT_EVENT_OBJECT_SUMMARY_LINK}=${event.PAPIOb-jectSummaryLink}

${entuity_variables.ENT_EVENT_OBJECT_SUMMARY_LINK}=${event.PAPIObject-SummaryLinkRef}

[entuity_variables]

ENT_OBJ_DESCR=1.3.6.1.4.1.2626.2.1.1.1.6

ENT_OBJ_PRIORITY=1.3.6.1.4.1.2626.2.1.1.1.5

ENT_OBJ_ATTR=1.3.6.1.4.1.2626.2.1.1.1.7

ENT_IMPACT_TYPE=1.3.6.1.4.1.2626.2.2.1.1.6

ENT_IMPACT_DESCR=1.3.6.1.4.1.2626.2.2.1.1.5

ENT_EVENT_DETAILS=1.3.6.1.4.1.2626.2.3.1.1.5.0

ENT_EVENT_DESCR=1.3.6.1.4.1.2626.2.3.1.1.9.0

ENT_EVENT_SEVERITY=1.3.6.1.4.1.2626.2.3.1.1.10.0

ENT_CORRELATION_GROUP=1.3.6.1.4.1.2626.2.3.1.1.11.0

OEM_EVENT_SEVERITY=1.3.6.1.4.1.2626.2.3.1.1.12.0

ENT_EVENT_ID=1.3.6.1.4.1.2626.2.3.1.1.3.0

ENT_EVENT_SERVER_ID=1.3.6.1.4.1.2626.2.3.1.1.13.0

ENT_EVENT_OBJECT_SUMMARY_LINK=1.3.6.1.4.1.2626.2.3.1.1.14.0

[include_events]

Service Down

Service Up

Service State Unknown

Network Outage

Network Outage Cleared

AvailMonitor Low View Device Reachability

AvailMonitor Normal View Device Reachability


Entuity

startup_O/S_site_specific.cfg

A new section to this file ensures snmpforward runs when Entuity runs, and the configuration to use.

[oem_snmpforward]

state=normal

capabilities=polling

type=command

start=${ENTUITY_HOME}${FPS}integ${FPS}SNMP${FPS}snmpforward${ENTUITY_HOME}${FPS}etc${FPS}snmpforward_oem.cfg snmp_route_1

directory=${LOGDIR}

is_critical=n

start, which defines the location and name of the configuration file and routing section applied to snmpforward.


specific Identifies the trap as an Entuity trap. The default is 2059, and should not be amended.

agent_addr IP address used by Entuity to forward traps. It should match the IP address entered when configuring the SNMP trap source in Oracle Enterprise Manager.

eye_server_id Identifies the particular Entuity server. server.id is set as part of Entuity’s installation process and is available from entuity.cfg. When it is undefined snmpforward does not run.

ssl_enabled Identifies whether the Entuity webserver uses HTTPS or HTTP. server.ssl_enabled is set by configure and is available from entuity.cfg.

eye_webportnum Identifies the port used by the webserver. webportnum is set by configure and is available from entuity.cfg.

eye_hostname Identifies the hostname used by the Entuity server. hostname is set by configure and is available from entuity.cfg. When eye_hostname is not set snmpforward uses the value set in agent_addr.

username Entuity user account used with snmpforward.

view Entuity business view from which Entuity forwards events. You can only specify one view.

hostn Specifies the IP address or hostname, and SNMP port number, 3872, of the target Oracle Enterprise Manager server. You can specify one or more hosts.

[include_events] Uses the event name to specify the types of events Entuity can forward to Oracle Enterprise Manager. (For a full list of event names see the Entuity Events Reference Manual.)

Table 8 snmpforward Configuration File


Entuity

Index

Numerics12.1.0.1.0_entuity.eye.xsvc_2000_0.opar 9

12.1.0.1.0_entuity.eye.xsvr_2000_0.opar 9

Aagent_addr

routing 29

All Metricsservice status 34

BBranch Office Perspective 38, 42

CCloud Control

add instances 14

Connection Failure 18, 24

DDevice Inventory Report 36

Device Reachabilityby view 31

Device UnreachableNetwork Outage 47

Deviceslocating 36name 36

Devices by Manufacturer Report 36, 38

Eemcli 10

Entuityaccessing 38, 39failure to connect 18, 24

entuity_serversee EYE Network Manager

entuity_service

see EYE Network Service

Eventsset for snmpforward 28, 52

EYE Network Manager 7instances 14service id 21test connection 18, 23verify 19

EYE Network Service 7All Metrics 34home page 33service id 21

GGreen IT Perspective 38, 39

HHTTPS

self certified certificates 10

IIP address

set for trap forwarding 52

MManaged Object

down 46, 48

Management Plug-inimporting 16, 22remove 26undeploy 25

Management Plug-in Archive 7deploying 11, 14obtaining 9

Multiple Branch Office Perspective 38, 43

NNetwork Delivery Perspective 38, 40

Network Outage


Entuity

Device Unreachable 47

Network Service Status 31

Node down 46, 48

OOracle Enterprise Manager

certified version 8, 10

PPing

ports unavailable 46, 48

Portsunavailable to ping 46, 48

SSecurity 8

Service Delivery Perspective 38, 41

Service Details 39

Service Id 21

Service Summary 48

Servicesevents 48, 49

SNMP Routeagent address 29

SNMP Trap Forwardingsee Trap Forwarding

snmpforward 8configuring 28Oracle Enterprise Manager 29

snmpforward_oem.cfg 9, 50backing up 28configuring 28

startup_O/S_site_specific.cfg 9, 52snmpforward 29

TTest Connection 18, 23

Trap Forwardingsee also snmpforward_oem.cfgintegration overview 27

set IP address used by Entuity 52


entuity oracle enterprise manager guide · oracle enterprise manager oracle enterprise manager...

Documents