You are on page 1of 13

Foglight for Oracle 5.7.5.

1
Monitoring Oracle Database Systems
Getting Started Guide

2015 Dell Inc.
ALL RIGHTS RESERVED.
This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a
software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the
applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or
mechanical, including photocopying and recording for any purpose other than the purchasers personal use without the written
permission of Dell Inc.
The information in this document is provided in connection with Dell products. No license, express or implied, by estoppel or
otherwise, to any intellectual property right is granted by this document or in connection with the sale of Dell products. EXCEPT
AS SET FORTH IN THE TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, DELL ASSUMES NO
LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
NON-INFRINGEMENT. IN NO EVENT SHALL DELL BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR
INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS
OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF DELL HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES. Dell makes no representations or warranties with respect to the accuracy or completeness of
the contents of this document and reserves the right to make changes to specifications and product descriptions at any time
without notice. Dell does not make any commitment to update the information contained in this document.
If you have any questions regarding your potential use of this material, contact:
Dell Inc.
Attn: LEGAL Dept
5 Polaris Way
Aliso Viejo, CA 92656
Refer to our web site (software.dell.com) for regional and international office information.
Patents
Foglight is protected by U.S. Patents # 7,979,245 and 8,175,862. Additional Patents Pending.
Foglight for VMware is protected by U.S. Patents # 8,175,863 and 8,364,460. Additional Patents Pending.
Foglight for Hyper-V is protected by U.S. Patents # 8,175,863 and 8,364,460. Additional Patents Pending.
Foglight for Resource Optimization is protected by U.S. Patents # 8,171,201 and 8,332,571.
For more information, go to http://software.dell.com/legal/patents.aspx.
Trademarks
Dell, the Dell logo, and Foglight, IntelliProfile, PerformaSure, and Tag and Follow are trademarks of Dell Inc. "Apache HTTP
Server", Apache, "Apache Tomcat" and "Tomcat" are trademarks of the Apache Software Foundation. Google is a registered
trademark of Google Inc. Chrome, Android, and Nexus are trademarks of Google Inc. Red Hat, JBoss, the JBoss logo, and Red
Hat Enterprise Linux are registered trademarks of Red Hat, Inc. in the U.S. and other countries. CentOS is a trademark of Red
Hat, Inc. in the U.S. and other countries. Microsoft, .NET, Active Directory, Internet Explorer, Hyper-V, SharePoint, SQL Server,
Windows, Windows Vista and Windows Server are either registered trademarks or trademarks of Microsoft Corporation in the
United States and/or other countries. AIX, IBM, and WebSphere are trademarks of International Business Machines Corporation,
registered in many jurisdictions worldwide. Sun, Oracle, Java, Oracle Solaris, and WebLogic are trademarks or registered
trademarks of Oracle and/or its affiliates in the United States and other countries. SPARC is a registered trademark of SPARC
International, Inc. in the United States and other countries. Products bearing the SPARC trademarks are based on an
architecture developed by Oracle Corporation. OpenLDAP is a registered trademark of the OpenLDAP Foundation. HP is a
registered trademark that belongs to Hewlett-Packard Development Company, L.P. Linux is a registered trademark of Linus
Torvalds in the United States, other countries, or both. MySQL is a registered trademark of MySQL AB in the United States, the
European Union and other countries. Novell and eDirectory are registered trademarks of Novell, Inc., in the United States and
other countries. VMware, ESX, ESXi, vSphere, vCenter, vMotion, and vCloud Director are registered trademarks or trademarks
of VMware, Inc. in the United States and/or other jurisdictions. Sybase is a registered trademark of Sybase, Inc. The X Window
System and UNIX are registered trademarks of The Open Group. Mozilla and Firefox are registered trademarks of the Mozilla
Foundation. "Eclipse", "Eclipse Foundation Member", "EclipseCon", "Eclipse Summit", "Built on Eclipse", "Eclipse Ready" "Eclipse
Incubation", and Eclipse Proposals" are trademarks of Eclipse Foundation, Inc. IOS is a registered trademark or trademark of
Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries. Apple, iPad, iPhone, Xcode, Mac OS,
and Safari are trademarks of Apple Inc., registered in the U.S. and other countries. Ubuntu is a registered trademark of
Canonical Ltd. Symantec and Veritas are trademarks or registered trademarks of Symantec Corporation or its affiliates in the
U.S. and other countries. YAST is a registered trademark of SUSE LLC in the United States and other countries. Citrix and
XenDesktop are trademarks of Citrix Systems, Inc. and/or one or more of its subsidiaries, and may be registered in the United
States Patent and Trademark Office and in other countries. AlertSite and DjClick are either trademarks or registered
trademarks of Boca Internet Technologies, Inc. Samsung, Galaxy S, and Galaxy Note are registered trademarks of Samsung
Electronics America, Inc. and/or its related entities. MOTOROLA is a registered trademarks of Motorola Trademark Holdings,
LLC. The Trademark BlackBerry Bold is owned by Research In Motion Limited and is registered in the United States and may be
pending or registered in other countries. Dell is not endorsed, sponsored, affiliated with or otherwise authorized by Research
In Motion Limited. Other trademarks and trade names may be used in this document to refer to either the entities claiming the
marks and names or their products. Dell disclaims any proprietary interest in the marks and names of others.

Legend

CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions are not followed.

WARNING: A WARNING icon indicates a potential for property damage, personal injury, or death.

IMPORTANT NOTE, NOTE, TIP, MOBILE, or VIDEO: An information icon indicates supporting information.

Foglight Getting Started Guide


Updated - June 2015
Software Version - 5.7.5.1
Contents

Installing Foglight for Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5


Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Installing Foglight for Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Installing Foglight for Oracle and Foglight Management Server Together . . . . . . . . . 6
Installing the Cartridge by Adding it to a Cartridge Inventory of an Existing Foglight
Management Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Configuring Foglight for Oracle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8


SQL Performance Investigator Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Operating System Extension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Granting Permissions to Oracle Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Foglight-Specific Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Preparing a sudo Environment for UNIX and Linux Users . . . . . . . . . . . . . . . . . . . . . . .11
Permissions for monitoring Windows OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

About Dell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Contacting Dell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Technical support resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

Foglight for Oracle 5.7.5.1


4
Getting Started Guide
1
Installing Foglight for Oracle

Welcome to the Foglight for Oracle Getting Started Guide. This guide is a quick guide for the installation and
use of Foglight for Oracle, from the planning stage up to the actual monitoring of database instances. This
document details first the installation prerequisites, including the required permissions, and then the actual
monitoring of database instances. This guide is intended for Oracle database administrators.
Foglight for Oracle is Dell Software's powerful diagnostic and problem resolution tool for Microsoft Oracle
databases. This Foglight cartridge delivers a global view that provides a visual instance health check, and
enables a drill-down style diagnostic workflow to investigate the performance of monitored Oracle instances
and databases. This chapter describes the installation of Foglight for Oracle, from the planning stage up to the
actual installation.

Installation Prerequisites
Before starting the installation of Foglight for Oracle, ensure that the following conditions are met:
Having the required permissions; for details, see Permissions on page 10.
Using a supported system and platform. Foglight for Oracle's system requirements and supported
platforms are identical to those of Foglight Management Server. For details, see Foglight System
Requirements and Platform Support Guide.
Using a Foglight license that allows cartridges to be installed. Alternatively, use the embedded trial
license. Ensure that the pre-existing Foglight license that is being used allows cartridge installation. If a
license that does not allow cartridge installation is used, the installation wizard cannot proceed beyond
the Foglight for Oracle Management Server License screen, which requires specifying the type of license
to be installed.
Using an available external database:
IMPORTANT: The available external database requirement is relevant only if you plan to install a
new Foglight Management Server.

If you plan to install Foglight Management Server on an external database, ensure that this database is
running. The supported external database platforms and versions are as follows:
Oracle
PostgresSQL
SQL Server
MySQL
Preparing in advance an Oracle user to be used for monitoring the discovered instances. The Oracle user
is created exclusively for monitoring a specific database, and has limited execution capabilities. The
details of this Oracle user are entered in the Connection Details dialog box when running the Database
Discovery wizard. For more information, refer to Installing Foglight for Oracle on page 6. This user must
be granted the privileges required for monitoring the database. These privileges can be granted only by
a user with a SYSDBA server role.

Foglight for Oracle 5.7.5.1


5
Getting Started Guide
Installing Foglight for Oracle
Foglight for Oracle runs on the Foglight Management Server, which is its operation framework. Therefore,
Foglight Management Server must be installed before installing the cartridge.
The installation of Foglight for Oracle can be carried out using either of the following scenarios:
Installing both Foglight for Oracle and Foglight Management Server. For details, see Installing Foglight
for Oracle and Foglight Management Server Together on page 6.
Installing Foglight for Oracle as a cartridge from within an existing Foglight Management Server. For
details, see Installing the Cartridge by Adding it to a Cartridge Inventory of an Existing Foglight
Management Server on page 6.

Installing Foglight for Oracle and Foglight


Management Server Together
Starting from version 5.5.8, a single executable file allows installing Foglight Management Server together with
Foglight for Oracle.

To run the combined installation file:


1 Copy the installation file appropriate to the operating system and the bit level (32-bit or 64-bit) to a
temporary directory on the requested host.

IMPORTANT: The combined installation file is named using the following convention:
Foglight- <version_number>_install_<operating system>-<instruction set><bit
level>Oracle<.exe/ .bin>.
For example: Foglight-5_7_5-FoglightForOracle-5_7_5_1_windows-
x86_64.exe or Foglight-5_7_5-FoglightForOracle-5_7_5_1_linux-
x86_64.bin.

2 If planning to use an external database for the Foglight Management Server Installation, ensure that this
database is running.
3 Follow the on-screen installation instructions.

Installing the Cartridge by Adding it to a Cartridge


Inventory of an Existing Foglight Management Server
Foglight for Oracle runs on the Foglight Management Server, which is its operation framework. Therefore,
Foglight Management Server must be installed before installing the cartridge. The installation of Foglight for
Oracle can be carried out using either of the following scenarios:
Installing both Foglight for Oracle and Foglight Management Server.
Installing Foglight for Oracle as a cartridge from within an existing Foglight Management Server.
A single executable file allows installing Foglight Management Server together with Foglight for Oracle.

To run the combined installation file:


1 Copy the installation file suitable for the operating system and the bit level (32-bit or 64-bit) to a
temporary directory on the requested host.
2 If planning to use an external database for the Foglight Management Server Installation, ensure that this
database is running.
3 Follow the on-screen installation instructions.

Foglight for Oracle 5.7.5.1


6
Getting Started Guide
To install Foglight for Oracle as a cartridge:
1 Copy the cartridge's car file (DB_Oracle_VersionNumber.car; for example, DB_Oracle- 5_7_5_1.car),
which is included in the installation media, to your local computer.
2 Log in to the Foglight browser interface.
3 In the browser interface, on the navigation panel, click Dashboards > Administration > Cartridges >
Cartridge Inventory.
4 On the Cartridge Inventory dashboard, click Browse to find the car file on your local computer.
5 Click Install Cartridge.
IMPORTANT: The combined installation file is named using the following convention: Foglight-
<version_number>_FoglightForOracle--<version_number>_<operating system>-<bit
level><.exe/.bin>.
For example: Foglight-5_7_5-FoglightForSQL-Oracle- 5_7_5_1_windows-x86_64.exe.

Foglight for Oracle 5.7.5.1


7
Getting Started Guide
2
Configuring Foglight for Oracle

After successful installation of Foglight for Oracle, when entering the Foglight Management Server, no instances
are displayed. The Foglight for Oracle agent (DB_Oracle) allows you to monitor the database performance on
each server where the application is installed. The agent installer allows monitoring of existing and running
instances for Foglight monitoring.

To discover database instances, when no instance is monitored:


1 On the navigation panel, click Homes > Databases.
2 Click Monitor > Oracle in the upper left corner of the Databases View. The Monitor Oracle Instance
dialog box appears.
NOTE: If a user-defined database group is currently selected, the databases table's title displays
the name of this group instead of All; however, all newly discovered or created databases are
added to the general (All) group of databases.

3 Choose the agent manager on which the agent will be running. The default is the agent manager with the
least agents installed.
Click the Monitoring agent will run from host <agent manager>. A dialog box appears with a list of
all agent managers connected to the Foglight management server.
Select the appropriate host name and click Set.
IMPORTANT: You have the option set this host as the default for all future installations.

4 Use the Connection Details section to select the requested method for entering connection details:
TNS - used for selecting a database from the tnsnames.ora file by clicking Load file.
Host - Manually enter Host, port and either service name or SID.
5 Use the Login Credentials section to specify the username and password to be used for monitoring the
Oracle instance.
6 Select an Alarm Sensitivity Level to determine what level of alarms the system will store and display for
this instance. The default is Normal. Alarm levels include:
Essential - Store and display only critical or fatal alarms.
Normal - Store and display most alarms - essential and best practices; only critical and fatal
Statistical alarms.
Tuning - Store and display all Oracle alarms sent to Foglight.
7 Optional - In the Monitoring Extensions pane, click the SQL PI monitoring extension. You are prompted to
choose the Agent Manager on which the SQL PI repository will be installed.
8 Optional -In the Monitoring Extensions pane, click the Operating System link. To configure the extension,
choose the connection details of the host on which the Oracle instance is running:
Local user - using the same credentials that were used to launch the Agent Manager.
Windows - the user name (in the domain\user name format) and password, used for logging in to a
Windows-based monitored host.
SSH (DSA) - using the SSH private key, generated via the DSA algorithm.
SSH (RSA) - using the SSH private key, generated via the RSA algorithm.

Foglight for Oracle 5.7.5.1


8
Getting Started Guide
SSH (login credentials) - the user name and password used for logging in to a UNIX-based
monitored host.
9 Optional - In the Monitoring Extensions pane, click Collect VM statistics. To configure the extension,
select the connection details of the vCenter or ESX on which the Oracle instance is running:
The name of IP address of the vCenter server that hosts the Oracle instance virtual machine, or
the name of its parent ESX server
The port number used by the vCenter server system or by ESX server for listening to the
connections from the vSphere Client (default: 43).
The name and password of the user that has the privileges required for connecting to the vCenter
server or ESX server and retrieving information.
10 Click Monitor.
IMPORTANT: If the monitoring verification fails click the message that is displayed on the Status
column and resolve the issue according to the instructions that appear in the dialog box. For
example, (for example: insufficient privileges, incorrect credentials or an Agent Manager that
reached its full monitoring capacity.

11 When the installation completes successfully, the Monitoring Initialized Successfully dialog box appears.
Click Add another Database or Finish to exit.

SQL Performance Investigator Extension


SQL Performance Investigator allows you to rapidly identify bottlenecks, anomalies, and application trends by
focusing on top resource consumers and providing multi-dimensional SQL domain drilldowns.
SQL PI allows you to:
Monitor real-time Oracle database performance at a glance
Gather and diagnose historical views
Identify and ananticipate performance issues
Analyze and optimize execution plan changes
Compare day-to-day values to identify anomalies and application changes

IMPORTANT: If the monitoring verification fails click the message that is displayed on the Status column
and resolve the issue according to the instructions that appear in the dialog box. For example, insufficient
privileges, incorrect credentials or an Agent Manager that reached its full monitoring capacity.

The Use this option to discover your Oracle instances link is for discovering and enabling several instances in
one monitoring process.

NOTE: SQL Performance Investigator requires a license. If you are using a trial version and would like to
request pricing, contact https://software.dell.com/register/57891?. SQL PI requires a repository
database that is installed automatically on the Agent Manager.

Operating System Extension


Monitoring the operating system allows you to identify resource consumption and provides a full view of the
server health. An Infrastructure agent, which is created automatically as part of the monitoring process,
monitors the operating system.
NOTE: The Operating System extension is enabled by default.

Foglight for Oracle 5.7.5.1


9
Getting Started Guide
3
Permissions

Granting Permissions to Oracle Users


Permissions are granted on the object levels, by granting Select to allow accessing the following objects:
Table 1. Permission granted to these objects

X$KTFBFE gv_$archived_log v_$sga_dynamic_components


X$KTFBUE gv_$archive_dest v_$system_event
X$KSPPI gv_$lock v_$logfile
X$KSPPCV gv_$session v_$asm_diskgroup
obj$ gv_$instance v_$recovery_file_dest
fet$ gv_$sql v_$asm_template
ts$ gv_$session_wait v_$sga_dynamic_components
file$ gv_$sysstat v_$sgainfo
recyclebin$ gv_$pq_sysstat v_$sgastat
user$ gv_$archive_dest v_$sga
uet$ gv_$instance_cache_transfer v_$system_event
dba_constraints gv_$undostat v_$event_name
dba_objects gv_$rman_configuration v_$sqlarea
dba_cons_columns gv_$rman_output v_$sesstat
dba_sequences gv_$temp_extent_pool v_$statname
dba_tables gv_$sort_segment v_$sess_time_model
dba_segments gv_$rman_status_current v_$undostat
dba_sequences v_$fixed_table v_$datafile
dba_extents v_$archived_log v_$tablespace
dba_users v_$asm_diskgroup v_$rowcache
dba_rollback v_$asm_disk v_$librarycache
dba_jobs v_$asm_diskgroup_stat v_$dbfile
dba_db_links v_$asm_disk_stat v_$standby_log
dba_profiles v_$asm_operation v_$dataguard_status
dba_roles v_$temp_extent_pool v_$archive_dest
dba_role_priv v_$lock v_$process
dba_sys_privs v_$session v_$dispatcher
dba_synonyms v_$instance v_$instance_cache_transfer
dba_tab_columns v_$sql v_$open_cursor
dba_tab_privs v_$session_wait v_$pq_sysstat
dba_views v_$enqueue_statistics v_$filestat
dba_indexes v_$enqueue_stat v_$tempstat
dba_data_files v_$segstat v_$tempfile

Foglight for Oracle 5.7.5.1


10
Getting Started Guide
Table 1. Permission granted to these objects
dba_free_space v_$parameter v_$rman_status
dba_objects v_$resource v_$temp_space_header
dba_temp_files v_$process v_$flash_recovery_area_usage
dba_jobs v_$log v_$controlfile
dba_tablespaces v_$database v_$result_cache_statistics
dba_tab_privs v_$log_history v_$pgastat
dba_jobs v_$spparameter v_$transaction
dba_scheduler_jobs v_$sysstat v_$segment_statistics
dba_jobs_running v_$system_event v_$osstat
dba_scheduler_running_jobs v_$logfile v_$iostat_file
dba_directories v_$asm_diskgroup v_$sysmetric
dba_undo_extents v_$recovery_file_dest
dba_libraries v_$asm_template

Foglight-Specific Views
Foglight retrieves metrics for space fragmentation, initialization parameters, and backup jobs from the Oracle
X$% objects for display in various dashboards. Because only users with a SYSDBA authorization can directly run
queries against Oracle's X$% objects, Foglight creates its own views for the required queries and grants select
on QUEST views to the foglight user used for monitoring. In so doing, Foglight helps keep the privilege
requirements for the foglight user minimal, thereby denying the user system-related privileges.
The Foglight standard is to use an X_QUEST prefix in the name of all newly created views. Specifically, Foglight
creates the views listed below.
X_QUEST_$RMAN_STATUS_CURRENT
X_QUEST_$KSPPCV
X_QUEST_$KSPPI
X_QUEST_$KTFBUE
X_QUEST_$KTFBFE
A Foglight deployment does not create any objects that write data to SYS schema or anywhere else within the
database; Foglight objects on the database are limited to views, synonyms, and so on. As a result, these objects
do not alter the IO performance characteristics of any tablespace.

Preparing a sudo Environment for UNIX and


Linux Users
Foglight for Oracle supports using sudo on the various Linux and UNIX operating systems where it runs. The
binary files that should be included per each of Foglight for Oracles supported platforms in order to enable
using sudo are as follows:
HP-UX
Execute permissions:
bdf uptime sar netstat vmstat ps hostname awk /usr/sbin/ ioscan uname
getconf iostat lsnrctl
Read permissions: /var/adm/syslog/syslog.log

Foglight for Oracle 5.7.5.1


11
Getting Started Guide
AIX
Execute permissions: df iostat uptime netstat vmstat ps hostname awk lsdev
lsattr oslevel pagesize uname lsnrctl
Solaris
Execute permissions: df iostat uptime netstat vmstat ps hostname awk mpstat /
usr/sbin/prtconf uname pagesize lsnrctl
Linux
Execute Permissions: df iostat uptime sed ps hostname awk free uname /proc/
vmstat vmstat netstat getconf lsnrctl
Read Permissions: /proc/net/dev /proc/stat /proc/vmstat on Linux >= 2.6 /proc/
cpuinfo getconf

Permissions for monitoring Windows OS


Detailed information about the permissions required for monitoring Windows OS can be found in the Foglight
Agent Manager Guide. For more information refer to:
Monitoring with WMI: http://edocs.quest.com/foglight/575/doc/Core/FglAMInstallation/
AdvancedConfig.04.php
Monitoring with WinRM: http://edocs.quest.com/foglight/575/doc/Core/FglAMInstallation/
AdvancedConfig.22.php

Foglight for Oracle 5.7.5.1


12
Getting Started Guide
About Dell

Dell listens to customers and delivers worldwide innovative technology, business solutions and services they
trust and value. For more information, visit www.software.dell.com.

Contacting Dell
Technical support:
Online support
Product questions and sales:
(800) 306-9329
Email:
info@software.dell.com

Technical support resources


Technical support is available to customers who have purchased Dell software with a valid maintenance
contract and to customers who have trial versions. To access the Support Portal, go to
https://support.software.dell.com/.
The Support Portal provides self-help tools you can use to solve problems quickly and independently, 24 hours a
day, 365 days a year. In addition, the portal provides direct access to product support engineers through an
online Service Request system.
The site enables you to:
Create, update, and manage Service Requests (cases)
View Knowledge Base articles
Obtain product notifications
Download software. For trial software, go to Trial Downloads.
View how-to videos
Engage in community discussions
Chat with a support engineer

Foglight for Oracle 5.7.5.1


13
Getting Started Guide

You might also like