Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance, Installation Guide v1.4.1
Table of Contents
Introduction.............................................................................................................................. 1
About the Oracle ZFS Storage Appliance Plug-in................................................................. 2
Software Requirements........................................................................................................... 2
Prerequisites for Monitoring Oracle ZFS Storage Appliances.............................................. 3
Configuring the Oracle ZFS Storage Appliance.................................................................... 3
Configuring for Clustered Appliances.................................................................................... 4
Configuring Database-to-Appliance Mappings ..................................................................... 4
Plug-in Management in the Oracle Enterprise Manager Cloud Control 12c Environment..5
Deploying the Plug-in............................................................................................................. 5
Adding Instances for Monitoring............................................................................................ 7
Adding Clustered Systems for Monitoring............................................................................. 8
Viewing Metrics and Reports................................................................................................. 8
Upgrading the Plug-in........................................................................................................... 10
Un-deploying the Plug-in...................................................................................................... 10
Metric and Collection Information....................................................................................... 11
Metric Collections on Datasets............................................................................................. 17
Metric Collections on Pools, Projects and Shares............................................................... 18
Reports................................................................................................................................... 18
Default Threshold Values..................................................................................................... 20
Stateless Alerts...................................................................................................................... 24
Oracle ZFS Storage Appliances Alerts................................................................................. 25
Communicating Performance Issues to the Appliance Administrator.................................25
Troubleshooting Monitoring Deployments........................................................................... 26
Metric Collection Errors....................................................................................................... 29
Oracle ZFS Storage Appliance Audit Logs......................................................................... 31
Host Agent Logs .................................................................................................................. 32
Additional Resources............................................................................................................ 33
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide v1.4.1
Introduction
The Oracle ZFS Storage Appliance Plug-in extends Oracle Enterprise Manager Cloud Control
to add support for monitoring Oracle ZFS Storage Appliances. This guide provides an overview
of the plug-in and how to install and deploy it for monitoring Oracle ZFS Storage Appliances.
This guide is written for the Oracle Enterprise Manager Cloud Control administrator. As Cloud
Control administrator, you will communicate closely with the Oracle ZFS Storage Appliance
storage administrator to discuss performance and analysis of database deployments on the
Oracle ZFS Storage Appliance.
If you need additional information about the operation of plug-ins for the Oracle Enterprise
Manager Cloud Control product, see the Oracle Enterprise Manager Concepts Guide. You can
download the document, as well as other related documentation, from the Oracle Web site
(see the section at the end of this document).
Important: Oracle Enterprise Manager Cloud Control was previously called Oracle Enterprise
Manager Grid Control (versions 10g and 11g). These older versions are no longer being
supported, but users familiar with them should note that references to grid control are now
replaced with cloud control. These legacy versions' documentation still reflects the old
terminology.
Also note that the Sun ZFS Storage Appliance is now called the Oracle ZFS Storage
Appliance, and similarly to the Oracle Enterprise Manager software, legacy Appliance Kit
software versions and their documentation may still reflect the former name. References to
Sun ZFS Storage Appliance, Sun ZFS Storage 7000, and Sun ZFS Backup Appliance all refer
to the same family of Oracle ZFS Storage Appliances.
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
Ties together Oracle databases deployed on NFS shares from Oracle ZFS
Storage Appliances
When you configure the Oracle ZFS Storage Appliance to be monitored by Oracle
Enterprise Manager Cloud Control, an analytics worksheet and datasets are enabled. The
worksheet and datasets help bridge a Cloud Control administrator's view of the appliance
to the storage administrator's more detailed view. This enables both administrators to be
fully conversant in discussing performance or analysis of database deployments on the
appliance.
Software Requirements
Deployment of the Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS
Storage Appliance requires that the following software versions already be installed:
Note: Additional software requirements, such as the correct Java version in Cloud Control,
are met through the required applications listed, provided the correct versions are
installed. The plug-in can be installed on any operating system in which Enterprise
Manager Cloud Control is running.
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
Install the Oracle Enterprise Manager Cloud Control environment. Be sure to pay
attention to security sections in the Oracle Enterprise Manager Administrator's
Guide.
Configure the Oracle ZFS Storage Appliances for monitoring using the workflow
included with Oracle ZFS Storage Appliances, as identified in the next section.
Full DNS name that is used to locate the system and corresponds
to the IP address.
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
Port that is used by the BUI (typically 215 unless your company
has a requirement to change management ports).
Important: If you are going to deploy/upgrade to v1.4.x of the plugin, you must carry out
the following additional steps:
1. Log in to the BUI and go to the Configuration/Users tab.
2. Click to edit the Oracle Agent User name field.
3. Uncheck Kiosk user if it is checked.
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
1. Set up the software library path (if you have not already done this).
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
(a) From a terminal window on the server hosting Oracle Enterprise Manager 12c ,
create a new directory for the software library; for example:
/home/oracle/swlib1.
(b) In the Oracle Enterprise Manager console, go to Enterprise>Provisioning and
Patching> Software Library>Actions>Administration and click Add Button.
(c) In the popup window, enter
and /home/oracle/swlib1.
swlib1
(d) Wait a minute or so. Then, on the Oracle Enterprise Manager host, verify that
the following directory structure was created under /home/oracle/swlib1:
[oracle@aie-4200i swlib1]$ ls
0
11
14
17
22
25
12
28
15
30
18
33
66
69
71
9 1
53
56
59
61
64
67
72 10
20
43
46
49
51
54
57
62
36
23
39
65
13
26
41
68
29
16
70
44
31
19
21
47
34
24
5
37
27
52
4
55
42
32
58
45
35
60
48
38
63
50
40
(d) Download the plug-in file ( *.opar file) to a directory; for example:
/home/oracle/12g_plugins
(e) Upload the plug-in using the emcli command as shown in the following
example:
./emcli import_update -file=
"/home/oracle/12g_plugins/12.1.0.1.0_oracle.sun.oss7_2000_0.opar" -omslocal
Note: On a Windows system, the emcli command does not require any quotes.
To deploy the plug-in on the Oracle Enterprise Manager using the Oracle Enterprise
Manager console, complete these steps:
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
1. Go to Setup > Extensibility > Self Update. Click on Plugin. Make sure Oracle ZFS
Storage Appliances is listed as Downloaded. Select it and click on Actions > Readme
for the details of the plug-in.
2. Click on the Plug-in tab or Setup > Extensibility > Plugin. Expand the Servers,
Storage and Network category.
3. Select the plug-in Oracle ZFS Storage Appliances from the table displayed in step
2 and select: Actions > Deploy On > Management Servers.
4. In the popup window, enter the Repository Password and click Continue.
5. Wait until the prerequisite checks are done. Click Next and then Deploy.
An emcli command is displayed that can be run to monitor the status of the deployment
and let you know when it has completed successfully. For example:
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
settings and how to manage them are included in the section Metric and Collection
Information later in this document.
Viewing Metrics
As a rule, more point in time information is available in raw metric information than in
reports. Reports are focused on information that database administrators can use to
analyze database performance and storage capacity.
To view the raw information collected from an Oracle ZFS Storage Appliance:
1. Log in to Enterprise Manager Cloud Control.
2. Go to Targets > All Targets and select the Oracle ZFS Storage Appliance as the
target.
3. From the target's home page, select Oracle ZFS Storage Appliance > Monitoring >
All Metrics.
4. View the categories and information collected from the last collection interval.
The raw metric information that you have access to can be found in Table 1: Metric and
Collection Information.
Accessing Reports
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
2.
3.
Note: If you are upgrading the Plug-in from v1.x to v1.4.x, you must ensure that you are
on Oracle Enterprise Manager 12.1.0.3.0 and the following steps are performed.
After importing v1.4.x of the Plug-in and deploying it on an Oracle Enterprise Manager
Management Service and Management Agent, you must restart Oracle Enterprise
Manager's Management Service. The steps to do so are:
1.
Log in to the host where Oracle Enterprise Manager's
Management Service is residing.
2.
Navigate to where Oracle Enterprise Manager's Management
Service is installed (typically in a folder called Middleware).
3.
Navigate to Middleware/oms/bin and run the following two
commands:
emctl stop oms
emctl start oms
10
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
An emcli command that you can run from the command prompt to monitor the status of
the undeployment activity is displayed.
5. To remove the plug-in from the management servers, repeat preceding steps 1-4
while selecting Management Servers in step 3.
To permanently delete the plug-in:
1. Go to Setup > Extensibility > Self Update > Plug-ins.
2. Under the Servers, Storage and Network category, select Oracle ZFS Storage
Appliances.
3. Select Actions > Remove. This will remove the plug-in permanently from the
system.
METRIC NAME
POLLING
UPLOAD FREQUENCY
! = CONDITIONS ENABLED)
APPLIANCE DATASET
INTERVAL
TO EM REPOSITORY
(MINUTES)
(X=DISABLED BY DEFAULT)
Response
Status
Monitoring Prerequisite
Status!
N/A
30
Message
thresholds.
X
Share Identifier*
Available (GB)
Total Allocated (GB)
20
Data (GB)!
11
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC NAME
POLLING
UPLOAD FREQUENCY
! = CONDITIONS ENABLED)
APPLIANCE DATASET
INTERVAL
TO EM REPOSITORY
(MINUTES)
(X=DISABLED BY DEFAULT)
Project Identifier*
20
Workflow
Available (GB)
whenever there is a
severity change on the
thresholds.
Service Name*
60
Workflow
Service Status!
whenever there is a
severity change on the
thresholds.
Storage Pool*
Pool Owner
Pool Status
20
Data Profile
Available (GB)
12
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC NAME
POLLING
UPLOAD FREQUENCY
! = CONDITIONS ENABLED)
APPLIANCE DATASET
INTERVAL
TO EM REPOSITORY
(MINUTES)
(X=DISABLED BY DEFAULT)
X
X
Cache ARC
Size (MB)!
arc.size
30
Cache L2ARC
Size (MB)!
arc.l2_size
30
CPU
Utilization %!
cpu.utilization
30
io.ops
30
io.ops[latency]
30
KB per Second!
io.bytes
30
Network Device
KB per Second!
nic.kilobytes
30
NFSv2 Ops
nfs2.ops
30
NFSv3 Ops
nfs3.ops
30
nfs3.ops[latency]
30
nfs4.ops[latency]
30
NFSv4 Ops
nfs4.ops
30
13
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC NAME
POLLING
UPLOAD FREQUENCY
! = CONDITIONS ENABLED)
APPLIANCE DATASET
INTERVAL
TO EM REPOSITORY
(MINUTES)
(X=DISABLED BY DEFAULT)
X
SMB Ops
smb.ops
30
smb.ops[latency]
30
iSCSI Ops
iscsi.ops
30
iscsi.ops[latency]
30
Protocol*
60
Workflow
Group Name*
Address
Initiator Or Target
X
Activity*
arc.accesses[hit/miss]
arc.accesses[hit/miss]
Activity*
arc.l2_accesses[hit/miss]
arc.l2_accesses[hit/miss]
Share*
arc.accesses[share]
arc.accesses[share]
Share*
arc.l2_accesses[share]
arc.l2_accesses[share]
NFS V3 Share*
nfs3.ops[share]
nfs3.ops[share]
NFS V4 Share*
nfs4.ops[share]
nfs4.ops[share]
Direction*
nic.kilobytes[direction]
nic.kilobytes[direction]
Device*
nic.kilobytes[device]
30
30
30
30
30
30
30
30
Share
X
14
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC NAME
POLLING
UPLOAD FREQUENCY
! = CONDITIONS ENABLED)
APPLIANCE DATASET
INTERVAL
TO EM REPOSITORY
(MINUTES)
(X=DISABLED BY DEFAULT)
Network Interface
nic.kilobytes[device]
Interface*
net.kilobytes[interface]
net.kilobytes[interface]
Cluster State!
30
60
Performance
Workflow
whenever there is a
severity change on the
thresholds.
Product Model
Workflow
60
Share Identifier*
60
Share Type
Mount Point
Data Profile
Data Compression
Cache Usage
NFS
CIFS
15
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC NAME
POLLING
UPLOAD FREQUENCY
! = CONDITIONS ENABLED)
APPLIANCE DATASET
INTERVAL
TO EM REPOSITORY
(MINUTES)
(X=DISABLED BY DEFAULT)
IP Network Interfaces
Interface*
60
Workflow
IP Address*
CIDR
IP Version
Management Enabled
IP Network Interface to Datalink
Interface*
Relationship
60
Workflow
Datalink*
Jumbo Frames
IP Datalink to Device
Datalink*
Relationship
60
Workflow
Link*
Class
IP Network Devices
Network Device*
Device Speed!
Workflow
60
Device Up!
Problem ID*
Time Stamp
Workflow
20
20
Alert Description!
Alert Log Problem Type!
Fault Log Contents
Problem ID*
Time Stamp
Workflow
Description!
Fault Log Problem Type!
Problem Log Contents
UUID*
Description!
Workflow
20
20
Problem Severity!
Problem Log Code!
Replication Activity
Problem ID*
16
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC NAME
POLLING
UPLOAD FREQUENCY
! = CONDITIONS ENABLED)
APPLIANCE DATASET
INTERVAL
TO EM REPOSITORY
(MINUTES)
(X=DISABLED BY DEFAULT)
Time Stamp
Replication Description!
Workflow
17
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
You can use the previous steps to disable a dataset collection at any time.
Note: Once you enable the metric collection for any dataset, you must ensure that the
storage administrators also enable the same dataset on the Oracle ZFS Storage
Appliances; otherwise you will start receiving metric collection errors.
Please follow the same steps shown previously for enabling dataset metrics if you would
like to collect information on these metrics.
Note: Metrics and information presented on charts can take up to 60 minutes to populate
as a result of polling intervals for relatively static information. Also, due to differing polling
cycles between statistics, some information can populate prior to other information.
Reports
The following table lists available reports and the information they can provide on the
Oracle ZFS Storage Appliances status.
18
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
TABLE 2: REPORTS
REPORT
DESCRIPTION
PURPOSE
Contains a series of graphs that give a high-level view Provides at-a-glance status of the system.
of system throughput and clients accessing the
system. It is important to note whether a system is Up
or Down. Up means the management interface is
available and simple properties can be queried that
do not require login. Down means the management
interface is not available. If a system is set up with
more than one interface that allows access to the
data path, it could be Down when the data path
interface is still accessible. The management
interface being flagged as Down is sufficient to
warrant attention to the system.
on appliances
database deployment.
hours.
the interfaces.
19
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
REPORT
DESCRIPTION
PURPOSE
Federated Database to
Similar to the Database to Appliance Mapping Report, Provides a detailed view of how all
Appliances.
Storage>Network Attached
Storage group
COMPARISON
WARNING
CRITICAL
PURPOSE
N/A
N/A
OPERATOR
Matches
Matches
N/A
N/A
Type
N/A
YES
Allocated
Appliances Capacity Totals/Pool Used
80
90
Percentage
Appliances Capacity Totals/Quota
Allocations
>=
N/A
N/A
20
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC/COLUMNS
COMPARISON
WARNING
CRITICAL
PURPOSE
N/A
N/A
OPERATOR
Appliances Capacity
>=
Totals/Reservations
Appliances Capacity Totals/Spare
thresholds.
<=
Disks
>=
N/A
N/A
Project Quota
Appliances Logical Status/Reserved
N/A
N/A
>=
N/A
N/A
>=
80
90
Percentage Used
<=
N/A
N/A
Reserved
N/A
N/A
N/A
YES
Allocated
>=
80
90
Percentage Used
Appliances Project Status/Reserved
N/A
>=
N/A
N/A
Quota
Appliances Project Status/Unused
the thresholds.
<=
N/A
N/A
Reserved
Cache ARC
>=
N/A
N/A
21
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC/COLUMNS
COMPARISON
WARNING
CRITICAL
PURPOSE
N/A
N/A
OPERATOR
>=
>=
N/A
N/A
Cache L2ARC
>=
N/A
N/A
>=
N/A
N/A
>=
N/A
N/A
N/A
N/A
CPU Utilization %
>=
80.00%
90.00%
>=
N/A
N/A
>=
N/A
N/A
>=
N/A
N/A
Matches
N/A
N/A
Matches
N/A
N/A
Type
<=
N/A
N/A
22
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC/COLUMNS
COMPARISON
WARNING
CRITICAL
PURPOSE
N/A
N/A
OPERATOR
IP Network Device/Device Up
>=
N/A
N/A
>=
N/A
N/A
Monitoring Prerequisite/Status
N/A
Network Device
>=
N/A
N/A
>=
N/A
N/A
>=
N/A
N/A
NFSv2 Ops
>=
N/A
N/A
NFSv3 Ops
>=
N/A
N/A
>=
N/A
N/A
>=
N/A
N/A
NFSv4 Ops
>=
N/A
N/A
>=
N/A
N/A
>=
N/A
N/A
23
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
METRIC/COLUMNS
COMPARISON
WARNING
CRITICAL
PURPOSE
AKCS_
AKCS_
OWNER
STRIPPED
OPERATOR
States
Matches
N/A
N/A
Matches
N/A
N/A
Code
Problem Log Contents/Problem
Matches
N/A
Severity
Major|
Critical
Response/Status
N/A
Down
Replication Activity/Replication
Matches
N/A
Description
SMB Ops
>=
N/A
Replication
of.*
N/A
Stateless Alerts
Most of the alerts that are set in the preceding table are stateful alerts. They will be
automatically cleared once the underlying conditions are cleared. F or example, if a
threshold of 20 is set for SMB Ops, an alert will be triggered once the value crosses 20,
and cleared once the value drops below 20.
However, there are a few special cases where the alerts cannot be cleared automatically.
In these scenarios, these alerts are defined as stateless and you must manually clear
them. All alerts from the following metrics are stateless alerts:
Alert Log
Fault Log
24
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
Problem Log
Replication
25
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
collection cycle averaged over the period, resulting in a much less dramatic performance
curve).
Using the worksheet and/or other datasets available to the storage administrator, you can
analyze the cause down to the hardware or software component level. In the event of a
resource contention issue, you can study levels of client access to determine how and
when individual clients are accessing a system, along with the resources they are
accessing. These can include network interfaces, logical resources (such as shares), and
more.
When initial communication is complete, the storage administrator should complete the
analysis of the problem and propose a way to resolve a disruption in quality of service. If
the problem is not likely associated with the Oracle ZFS Storage Appliance, the storage
administrator can provide this information.
26
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
SOLUTION
If the appliance previously reported as Up but is now indicating it is Down, this is an indication
that the management path is no longer available on the target Oracle ZFS Storage Appliance.
be monitored.
The data path might still be available on the appliance, but this critical problem must be
addressed.
If this is the first time an appliance was added and it has never reported as being Up, an error
could have been made when setting up the instance for monitoring. Check the following:
Is the port number correct? The Oracle ZFS Storage Appliance default port is 215.
Note: The Up/Down indicator does not require authentication to the target Oracle ZFS
Storage Appliance, so the user ID and password are not relevant here.
Checking the value of the Response Metric should show 0. This indicates that the Agent
properly invoked the metric collection program, but the metric collection program could not
connect to the target Oracle ZFS Storage Appliance given the parameters in the Monitoring
Configuration.
After determining 0 is shown in the field, ensure the appliance is available at the configured IP
address in the monitoring configuration. However, if the value of Response Metric is a 1, the
appliance is likely available. In this case, refresh the Cloud Control page reporting that the
appliance is down. It will likely return to "Up".
Appliance is Up, but all metrics are
Check the metric collection errors. (See Table 4: Common Metric Collection Errors.) The most
common problem is misconfiguration of the password for the oracle_agent user within
the Oracle Enterprise Manager Cloud Control environment.
For most metric collection errors, a summary message and Java Stack Trace is generated
and viewable by clicking the Metric Collection Errors link under the Home Page reports, then
clicking through the text Exception. The initial summary message will contain information
about the problem.
27
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
PROBLEM
SOLUTION
Determine what metrics are not being collected. Most likely, it is a group of metrics such as:
L2ARC Activity
There are usually three reasons for selective metrics not being collected:
A component does not exist on a system This is common with the L2ARC metrics. In
this case, you will not receive a metrics collection error; rather, the Last Upload time on the
All Metrics page will remain empty (or include a -).
The Configure for Oracle Enterprise Manager Monitoring workflow was not run on
the target Oracle ZFS Storage Appliance. This problem embodies in metrics that
are not collected by default on a target appliance, such as those listed above. In
this case, Metric Collection Errors will occur within the Oracle Enterprise Manager
Cloud Control until the target Oracle ZFS Storage Appliance is correctly
configured (See Table 4: Common Metric Collection Errors.)
The layout of filesystems and their values are collected at different intervals than the capacity
information for them. In the worst case, a metric could be as much as 60 minutes out of sync
with a storage appliance. If you have a need for real-time information, refer to the Oracle ZFS
be out of sync.
Metrics and information about system values are collected in varying intervals. In the worst
case, a metric could be as much as 60 minutes out of sync with a storage appliance. If you
system.
have a need for real-time information, refer to the Oracle ZFS Storage Appliance BUI.
Be sure you are running the configuration script as a user with root access (or equivalent)
28
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
PROBLEM
SOLUTION
The host, database, or both are not being monitored by Cloud Control. Install the proper
agents on the host to ensure that storage attached to the system is being monitored.
Refer to the Oracle Enterprise Manager Cloud Control documentation for information on
monitoring host and database assets. See the Oracle Enterprise Manager Cloud Control
documentation listed in the Additional References section at the end of this document .
iSCSI and Fibre Channel mappings are not supported in this release.
PROBLEM / SOLUTION
login denied
Problem: The user ID/password combination on the target Oracle ZFS Storage Appliance is
incorrect.
Possible causes:
The target Oracle ZFS Storage Appliance does not have the proper user ID and
role.
Solution:
Change the monitoring configuration to use the proper user ID/password provided by the
storage administrator, or reconfigure the target Oracle ZFS Storage Appliance to use the
correct oracle_agent password.
29
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
PROBLEM / SOLUTION
Problem: The parameters passed to the Oracle ZFS Storage Appliance are invalid.
Possible causes:
Resources from a monitored cluster head failed to the secondary head, for which
the storage administrator did not run the Configuration workflow.
Solution:
Run the Configuration workflow on the target Oracle ZFS Storage Appliance and
recreate the worksheet.
Ask the storage administrator to ensure that all of the datasets in the created
worksheet are being collected properly.
Possible causes:
metric.
Solution:
Ask the storage administrator to enable the dataset on the Oracle ZFS Storage
Appliance.
Disable the collection of this dataset metric with the following steps:
1.
2.
3.
4.
5.
30
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
PROBLEM / SOLUTION
Problem: A workflow that collects and returns metrics to the Agent cannot be found on the
Oracle ZFS Storage Appliance.
Possible causes:
The oracle_agent user (or user that you configured in the Monitoring
Configuration) does not have workflow.*.* read authorization.
An Oracle ZFS Storage Appliance is being used without the workflow on it, either
because the version of the Oracle ZFS Storage Appliance software is incorrect,
or the workflow was removed by a storage administrator.
Solution:
1.
Run the Unconfiguration workflow on the target Oracle ZFS Storage Appliance
and remove the oracle_agent user.
2.
Run the Configuration workflow on the target Oracle ZFS Storage Appliance and
recreate the oracle_agent user.
3.
4.
workflow failed
Contact the Support Center if the Agent fails to start collecting the dataset again.
Problem: The Agent is accessing an Oracle ZFS Storage Appliance, but the workflow is
failing in some way.
Possible causes:
A problem in the metric collection logic is causing it to fail on the Oracle ZFS
Storage Appliance.
Solution:
Run the Configuration workflow on the Oracle ZFS Storage Appliance and recreate the
worksheet.
If you are still receiving this error after recreating the worksheet, contact the Support Center.
31
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
Description
%AGENT_HOME%/sysman/emd/oracle_zfs_plugin/logs/
{target_ip}/sun_storage_7000_pipe.log*
%AGENT_HOME%/sysman/log/emagent.trc*
%AGENT_HOME%/sysman/log/*
Note: When interacting with the Support Center or developers within your own help desk,
include the sun_storage_7000_pipe.log* files and emagent.trc* files for reference.
32
Oracle Enterprise Manager System Monitoring Plug-in for Oracle ZFS Storage Appliance Installation Guide, v1.4.1
Additional Resources
http://docs.oracle.com/cd/B10501_01/em.920/a96674/toc.htm
33
Copyright 2013, Oracle and/or its affiliates. All rights reserved. This document is provided for
information purposes only and the contents hereof are subject to change without notice. This document is
Installation Guide
not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally
or implied in law, including implied warranties and conditions of merchantability or fitness for a particular
purpose. We specifically disclaim any liability with respect to this document and no contractual obligations
are formed either directly or indirectly by this document. This document may not be reproduced or
Oracle Corporation
World Headquarters
500 Oracle Parkway
Redwood Shores, CA 94065
U.S.A.
transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior
written permission.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be
trademarks of their respective owners.
Worldwide Inquiries:
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks
Phone: +1.650.506.7000
are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD,
Fax: +1.650.506.7200
Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced
Micro Devices. UNIX is a registered trademark licensed through X/Open Company, Ltd. 0611
oracle.com