Sei sulla pagina 1di 42

EMC Symmetrix Adapter Installation

and Configuration Guide


vCenter Operations Manager 1.0

This document supports the version of each product listed and


supports all subsequent versions until the document is replaced
by a new edition. To check for more recent editions of this
document, see http://www.vmware.com/support/pubs.

EN-000836-03

EMC Symmetrix Adapter Installation and Configuration Guide

You can find the most up-to-date technical documentation on the VMware Web site at:
http://www.vmware.com/support/
The VMware Web site also provides the latest product updates.
If you have comments about this documentation, submit your feedback to:
docfeedback@vmware.com

Copyright 2012 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual
property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents.
VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks
and names mentioned herein may be trademarks of their respective companies.

VMware, Inc.
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com

VMware, Inc.

Contents

EMC Symmetrix Installation and Configuration Guide 5


Updated Information 7

1 Introduction to the EMC Symmetrix Adapter 9


How the EMC Symmetrix Adapter Collects Data 9
EMC Symmetrix Adapter Operation 9
How the EMC Symmetrix Adapter Selects Metrics 10

2 Installing the EMC Symmetrix Adapter 21

Install the Adapter in a Standalone Installation 21


Install the Adapter in a vApp Installation 22
EMC Symmetrix Adapter Folders and Files 22

3 Configuring the EMC Symmetrix Adapter 25


Overview of Configuration Steps 25
Install EMC Solutions Enabler 26
Configuring and Running the storstpd Daemon 26
Periodically Archive TTP Data Files 31
Main Input Folder and Data File Requirements 32
TTP File Tag Format Requirements 32
Add an Adapter Instance 33
Configuring Adapter Properties 34

4 Troubleshooting the EMC Symmetrix Adapter 37

Troubleshooting an EMC Symmetrix Adapter Instance 37


Viewing System Log Files 38
EMC Symmetrix Adapter Classes 38

Index 41

VMware, Inc.

EMC Symmetrix Adapter Installation and Configuration Guide

VMware, Inc.

EMC Symmetrix Installation and Configuration


Guide

The EMC Symmetrix Installation and Configuration Guide provides information about installing and configuring
the EMC Symmetrix adapter. The EMC Symmetrix adapter is an embedded adapter for
vCenter Operations Manager.

Intended Audience
This information is intended for anyone who wants to install or configure the EMC Symmetrix adapter.

VMware, Inc.

EMC Symmetrix Adapter Installation and Configuration Guide

VMware, Inc.

Updated Information

The EMC Symmetrix Adapter Installation and Configuration Guide is updated with each release of the product or
when necessary.
This table provides the update history of the EMC Symmetrix Adapter Installation and Configuration Guide.
Revision

Description

EN-000836-03

n
n

EN-000836-02
EN-000836-01

Renamed the Text File Input Data Folder field to EMC Symmetrix Main Input Folder and added examples
of file paths for remote machines. See Add an Adapter Instance, on page 33.
n
n
n
n

EN-000836-00

Changed the product name to reflect licensing changes in the 5.6 release.
Added Metrics the Adapter Filters Out, on page 11 and Recommended Metrics to Collect, on
page 11.

Added an example to the topic How the EMC Symmetrix Adapter Collects Data, on page 9.
Updated the prerequisites in the topics Install the Adapter in a Standalone Installation, on
page 21 and Install the Adapter in a vApp Installation, on page 22.
Added the topic TTP File Tag Format Requirements, on page 32.
Added troubleshooting steps to the topic Troubleshooting an EMC Symmetrix Adapter Instance, on
page 37.

The EMC Symmetrix Adapter Technical Note is now the EMC Symmetrix Adapter Installation and Configuration
Guide. The following technical changes are included in this revision.
n The topic Install EMC Solutions Enabler, on page 26 now requires the standalone version of EMC
Solutions Enabler.
n The topics Main Input Folder and Data File Requirements, on page 32 and Test Main Input Folder
and File Access, on page 37 now require the user account that runs the Collector service to have read
and write permission to the TTP data files.
n The topic daemon_options File Properties, on page 26 now recommends disabling the
ttp_disk_metrics property. It also describes the use_compression property.
n The topic Run the storstpd Daemon, on page 31 now directs you to run the storstpd daemon on
the host and not on the Service Processor.
The EMC Symmetrix Adapter Technical Note was the initial release of this document.

VMware, Inc.

EMC Symmetrix Adapter Installation and Configuration Guide

VMware, Inc.

Introduction to the EMC Symmetrix


Adapter

The EMC Symmetrix adapter is an embedded adapter for vCenter Operations Manager. The adapter collects
performance data for Symmetrix storage arrays from TTP-formatted ASCII files. The EMC Symmetrix adapter
can support multiple instances of a Symmetrix installation.
This chapter includes the following topics:
n

How the EMC Symmetrix Adapter Collects Data, on page 9

EMC Symmetrix Adapter Operation, on page 9

How the EMC Symmetrix Adapter Selects Metrics, on page 10

How the EMC Symmetrix Adapter Collects Data


The EMC Symmetrix adapter collects performance data from TTP data files. The EMC Symmetrix adapter does
not process relationships or change events.
The EMC Solutions Enabler STP daemon (storstpd), exports the TTP data files to a main input folder.
Subfolders under the main input folder contain the TTP data files for each Symmetrix array. The name of the
subfolder is the array ID.
For example, if the main input folder is C:\SYMMETRIX_DATA and the array ID is 000194900272, the storstpd
daemon exports the TTP file for the array to the C:\SYMMETRIX_DATA\000194900272 subfolder.
Each instance of the EMC Symmetrix adapter is associated with a main input folder. Each adapter instance has
only one main input folder. You specify the path to the main input folder when you add the adapter instance
in vCenter Operations Manager.

EMC Symmetrix Adapter Operation


When you start collection for an EMC Symmetrix Adapter instance, the vCenter Operations Manager Collector
service spawns a thread to process the TTP data files for the instance.
The adapter moves TTP data files from the main input folder to an instance-specific data input subfolder under
the work folder. The name of the adapter instance is part of the data input folder name, for example,
data_input_adapterinstance.
If the data files are compressed, the adapter expands the files before it moves them to the work folder. The
adapter supports compressed data files in ZIP and GZ formats. After the files are in the work folder, the adapter
begins processing the files.

VMware, Inc.

EMC Symmetrix Adapter Installation and Configuration Guide

A time stamp is part of each data file name. The file processing thread sorts the files by time stamp. The adapter
reads each file by a separate thread from a thread pool. You can configure the size of the thread pool by
modifying the DATA_FILE_READ_THREAD_POOL_SIZE property in the adapterinstance.properties file.
NOTE The adapter avoids working with corrupted files by ignoring the most recent file. The most recent file
is the only file that might still be in use by the file generator process.
After the monitoring interval elapses, the adapter calls the Collect method and signals the file processing thread
to pause. The adapter waits in a loop while it checks for the file processing thread to pause. The file processing
thread checks periodically for a signal from the adapter. When it determines that the pause signal is on, the
file processing thread allows the Collect method to proceed by signaling that the cache is ready for collection.
The Collect method processes the cached data and pushes it into the File System Database (FSDB).
During processing, the adapter moves data files to a temp subfolder under the data_input_adapterinstance
folder. If the Collector service stops before it can push all of the cached data into the FSDB, data is not lost. The
data files in the temp folder appear in the data input folder at the start of the next collection cycle. At the end
of the collection cycle, the adapter deletes the data files in the temp folder and sends a signal to the file processing
thread to resume.
Because data file processing occurs during the intervals of data collection, this data collection mechanism
produces a smooth CPU use curve.

Scalability Considerations
The EMC Symmetrix adapter must be able to process data files at least as quickly as the files are generated or
it will fall behind and fail under overload conditions.
When the adapterinstance.properties file is configured correctly, data files accumulate in the input folder
under overload conditions and when collection stops. If the adapter can scale to the data load, it should process
the existing files faster than it processes the newly generated files and catch up when collection restarts.
If the adapter cannot handle the load, you can either upgrade the server or reduce the number of data files that
the file generation process creates. The adapter does not have control over the number of generated data files.
You can determine the scalability of the adapter by checking the number of files in the main input folder. The
number of files should become stable over time.

How the EMC Symmetrix Adapter Selects Metrics


The storstpd daemon, which generates the TTP data files, determines which metrics to export to the files.
Each Symmetrix array is a resource kind and each Symmetrix entity type is a resource attribute group in
vCenter Operations Manager. SymmetrixArray is the only resource kind.
The EMC Symmetrix adapter retrieves groups, instances, and attribute names from the METRIC section of the
TTP data file. The adapter describe.xml file does not describe resource kinds, groups, or attributes.
This excerpt is from a TTP data file:
<METRIC: System>
symid,long,Key,ArchiveLast
ios per sec,longlong,ConvertToRate,ArchiveStats,sortDescending
...
ResourceKind="SymmetrixArray"
ResourceGroup="System"
InstanceName="<value-of-symid-read-from-DATA-section>"
MetricName="ios per sec"

You can configure the metrics to export to the TTP data files by enabling metrics properties in the
daemon_options file. See daemon_options File Properties, on page 26.

10

VMware, Inc.

Chapter 1 Introduction to the EMC Symmetrix Adapter

For a list of the metrics that you should collect, see Recommended Metrics to Collect, on page 11.

Metrics the Adapter Filters Out


The EMC Symmetrix adapter filters out metrics in these groups, even if the associated properties are enabled
in the daemon_options file.
n

Devices

Thin Pool Info

Disks

ORS-Device

DGRP-Detail

CP-DevDetail

SGRP-Detail

Recommended Metrics to Collect


The EMC Symmetrix adapter should collect certain metrics. For troubleshooting purposes, Level 1 metrics are
more important than Level 2 metrics.
NOTE Except for the metrics that it filters out, the EMC Symmetrix adapter collects all of the metrics that the
storstpd daemon exports to the TTP data files, regardless of whether the metrics are recommended.

VMware, Inc.

11

EMC Symmetrix Adapter Installation and Configuration Guide

Table 1-1. Recommended Metrics


Resource
Group

Group Instance Name

Level 1 Metrics

Level 2 Metrics

System

symid

ios_per_sec

prefetched_tracks_per_sec

reads_per_sec
writes_per_sec
hits_per_sec
read_hits_per_sec
write_hits_per_sec
Kbytes_read_per_sec
Kbytes_writte_per_sec
seq_reads_per_sec
delayed_dfw_per_sec
number_write_pending_tracks
system_max_wp_limit
number_used_permacache_slots
symmetrix_timestamp

destaged_tracks_per_sec
deferred_writes_per_sec
number_format_pending_tracks
number_free_permacache_slots
cash_track_size
version_write_pending_count

CP_DevTotals

12

symid | cache_partition

random_ios_per_sec
random_reads_per_sec
random_writes_per_sec
random_hits_per_sec
random_read_hits_per_sec
random_write_hits_per_sec
seq_reads_per_sec
seq_read_hits_per_sec
seq_writes_per_sec
seq_write_hits_per_sec
Kbytes_read_per_sec
Kbytes_written_per_sec
write_pending_count
max_write_pending_threshold
num_invalid_tracks
Mone_invalid_tracks
Mtwo_invalid_tracks
Mthree_invalid_tracks
Mfour_invalid_tracks

VMware, Inc.

Chapter 1 Introduction to the EMC Symmetrix Adapter

Table 1-1. Recommended Metrics (Continued)


Resource
Group

Group Instance Name

Level 1 Metrics

Level 2 Metrics

CP_Stats

symid | cache_partition

donation_time

target_cache_percentage

write_pending_limit

min_cache_percentage
max_cache_percentage
cache_slots_used
pct_cache_used
write_pending_count
cache_age_gt_one_min
cache_age_gt_onezero_min
cache_age_gt_one_hour
cache_hit_ages_one
cache_hit_ages_two
cache_hit_ages_three
cache_hit_ages_four
cache_hit_ages_five
cache_hit_ages_six
cache_hit_ages_seven
cache_hit_ages_eight
cache_slot_ages_one
cache_slot_ages_two
cache_slot_ages_three
cache_slot_ages_four
cache_slot_ages_five
cache_slot_ages_six
cache_slot_ages_seven
cache_slot_ages_eight
destage_slot_age
age_non_wp_slots
total_replace_slots
writes_to_young_non_wp_slots
writes_to_all_non_wp_slots
acquired_slot_count
donation_give_count
donation_take_count
destaged_slot_count

random_ios_per_sec
random_reads_per_sec
random_writes_per_sec
seq_reads_per_sec
seq_writes_per_sec
Kbytes_read_per_sec
Kbytes_written_per_sec
write_pending_count

random_hits_per_sec
random_read_hits_per_sec
random_write_hits_per_sec
seq_read_hits_per_sec
seq_write_hits_per_sec
max_write_pending_threshold
num_invalid_tracks
Mone_invalid_tracks
Mtwo_invalid_tracks
Mthree_invalid_tracks
Mfour_invalid_tracks

DGRP_Totals

VMware, Inc.

symid | device_group

13

EMC Symmetrix Adapter Installation and Configuration Guide

Table 1-1. Recommended Metrics (Continued)


Resource
Group

Group Instance Name

Dir_RE_Compre
ssion_Stats

symid |
director_number

total_compressed_bytes_received

Dir_SE_Interface
_Stats

symid |
director_number |
director_interface_num
ber

mtu
received_packets_per_sec
received_octets_per_sec
received_errors_per_sec
transmitted_packets_per_sec
transmitted_octets_per_sec
transmitted_errors_per_sec
received_rate
transmitted_rate
maximum_received_rate
maximum_transmitted_rate

Dir_SE_Networ
k_Stats

symid |
director_number

Dir_SE_TCP_Sta
ts

symid |
director_number

Directors_BE

symid |
director_number

14

Level 1 Metrics

Level 2 Metrics
total_compressed_bytes_send
total_uncompressed_bytes_received
total_uncompressed_bytes_send
Speedlimit_group_number
director_number
active_state
speedlimit
bandwidth

ip_packets_received_per_sec
ip_packets_delivered_per_sec

number_of_interfaces
icmp_messages_received_per_sec
icmp_messages_transmitted_per_sec
tcp_segments_received_per_sec
tcp_segments_transmitted_per_sec
udp_packets_received_per_sec
udp_packets_transmitted_per_sec
total_send_queue_length
total_receive_queue_length
maximum_rtt
total_transmitted_segments_per_sec
total_received_segments_per_sec

ios_per_sec
reads_per_sec
writes_per_sec
hits_per_sec
requests_per_sec
average_lruzero_fall_thru_time
port_zero_io_per_sec
port_zero_Kbytes_per_sec
port_one_io_per_sec
port_one_Kbytes_per_sec

syscall_count_per_sec
syscall_time_per_sec
syscall_remote_dir_count_per_sec
syscall_rdf_dir_count_per_sec
prefetched_tracks_per_sec
tracks_not_used_per_sec
tracks_used_per_sec
short_misses_per_sec
long_misses_per_sec
interval_time
accumulated_director_idle_time
accumulated_all_port_idle_time
accumulated_port_zero_idle_time
accumulated_port_one_idle_time

VMware, Inc.

Chapter 1 Introduction to the EMC Symmetrix Adapter

Table 1-1. Recommended Metrics (Continued)


Resource
Group

Group Instance Name

Level 1 Metrics

Level 2 Metrics

symid |
director_number

ios_per_sec

syscall_time_per_sec

reads_per_sec
writes_per_sec
hits_per_sec
requests_per_sec
syscall_count_per_sec
read_misses_per_sec
system_write_pending_events_per_se
c
device_write_pending_events_per_sec
slot_collisions_per_sec
accumulated_port_zero_idle_time
accumulated_port_one_idle_time

syscall_remote_dir_count_per_sec
syscall_rdf_dir_count_per_sec
interval_time
accumulated_director_idle_time
accumulated_all_port_idle_time
accumulated_queue_depth_range_zero
accumulated_queue_depth_range_one
accumulated_queue_depth_range_two
accumulated_queue_depth_range_three
accumulated_queue_depth_range_four
accumulated_queue_depth_range_five
accumulated_queue_depth_range_six
accumulated_queue_depth_range_seven
accumulated_queue_depth_range_eight
accumulated_queue_depth_range_nine
queue_depth_count_range_zero
queue_depth_count_range_one
queue_depth_count_range_two
queue_depth_count_range_three
queue_depth_count_range_four
queue_depth_count_range_five
queue_depth_count_range_six
queue_depth_count_range_seven
queue_depth_count_range_eight
queue_depth_count_range_nine

Directors_RDF

symid |
director_number

ios_per_sec
reads_per_sec
writes_per_sec
requests_per_sec
system_wp_disconnects_per_sec
device_wp_disconnects_per_sec
Kbytes_received_per_sec
Kbytes_sent_per_sec
link_utilization
accumulated_director_idle_time

hits_per_sec
syscall_count_per_sec
syscall_time_per_sec
syscall_remote_dir_count_per_sec
syscall_rdf_dir_count_per_sec
read_misses_per_sec
slot_collisions_per_sec
interval_time
accumulated_all_port_idle_time
accumulated_port_zero_idle_time
accumulated_port_one_idle_time

LRUStatus

symid | LRUid

total_requests_per_sec
reads_per_sec
writes_per_sec
hits_per_sec
locks_per_sec

ORS_Port

symid | port_name

host_Mbytes_per_second
RCopy_Mbytes_per_second

Ports_FE

symid | port_name

ios_per_sec
throughput_in_Kbytes_per_sec

Directors_FE

VMware, Inc.

host_ios_per_sec
RCopy_ceiling
RCopy_devices

15

EMC Symmetrix Adapter Installation and Configuration Guide

Table 1-1. Recommended Metrics (Continued)


Resource
Group
RDF_Director

16

Group Instance Name

Level 1 Metrics

Level 2 Metrics

symid |
director_number

length_of_queue

read_hits_per_sec

Kbytes_read_per_sec
Kbytes_written_per_sec
reads_per_sec
writes_per_sec
avg_io_service_time_long_ms
avg_io_service_time_short_ms

rewrites_per_sec
num_of_active_tasks

VMware, Inc.

Chapter 1 Introduction to the EMC Symmetrix Adapter

Table 1-1. Recommended Metrics (Continued)


Resource
Group

Group Instance Name

Level 1 Metrics

Level 2 Metrics

RDF_Group

symid | rdf_group

length_of_queue

cycle_number

active_sizeone
cycle_timeone
Kbytes_read_per_sec
Kbytes_written_per_sec
reads_per_sec
writes_per_sec
avg_io_service_time_long_ms
avg_io_service_time_short_ms

write_foldingone
write_foldingtwo
write_foldingthree
write_foldingfour
write_foldingfive
write_foldingsix
write_foldingseven
write_foldingeight
write_foldingnine
write_foldingonezero
write_foldingoneone
write_foldingonetwo
write_foldingonethree
write_foldingonefour
write_foldingonefive
write_foldingonesix
write_foldingoneseven
write_foldingoneeight
write_foldingonenine
write_foldingtwozero
transmission_timeone
transmission_timetwo
transmission_timethree
transmission_timefour
transmission_timefive
transmission_timesix
transmission_timeseven
transmission_timeeight
transmission_timenine
transmission_timeonezero
transmission_timeoneone
transmission_timeonetwo
transmission_timeonethree
transmission_timeonefour
transmission_timeonefive
transmission_timeonesix
transmission_timeoneseven
transmission_timeoneeight
transmission_timeonenine
transmission_timetwozero
restore_timeone
restore_timetwo
restore_timethree
restore_timefour
restore_timefive
restore_timesix
restore_timeseven
restore_timeeight
restore_timenine
restore_timeonezero

VMware, Inc.

17

EMC Symmetrix Adapter Installation and Configuration Guide

Table 1-1. Recommended Metrics (Continued)


Resource
Group

Group Instance Name

Level 1 Metrics

Level 2 Metrics
restore_timeoneone
restore_timeonetwo
restore_timeonethree
restore_timeonefour
restore_timeonefive
restore_timeonesix
restore_timeoneseven
restore_timeoneeight
restore_timeonenine
restore_timetwozero
active_sizetwo
active_sizethree
active_sizefour
active_sizefive
active_sizesix
active_sizeseven
active_sizeeight
active_sizenine
active_sizeonezero
active_sizeoneone
active_sizeonetwo
active_sizeonethree
active_sizeonefour
active_sizeonefive
active_sizeonesix
active_sizeoneseven
active_sizeoneeight
active_sizeonenine
active_sizetwozero
cycle_timetwo
cycle_timethree
cycle_timefour
cycle_timefive
cycle_timesix
cycle_timeseven
cycle_timeeight
cycle_timenine
cycle_timeonezero
cycle_timeoneone
cycle_timeonetwo
cycle_timeonethree
cycle_timeonefour
cycle_timeonefive
cycle_timeonesix
cycle_timeoneseven
cycle_timeoneeight
cycle_timeonenine
cycle_timetwozero
read_hits_per_sec
rewrites_per_sec
num_of_active_tasks

18

VMware, Inc.

Chapter 1 Introduction to the EMC Symmetrix Adapter

Table 1-1. Recommended Metrics (Continued)


Resource
Group

Group Instance Name

Level 1 Metrics

Level 2 Metrics

RDF_Link

symid |
director_number |
link_number

echo_delay
send_operations
received_operations
Kbytes_read_per_sec
Kbytes_written_per_sec
reads_per_sec
writes_per_sec
avg_io_service_time_long_ms
avg_io_service_time_short_ms

send_accumulated_time
received_accumulated_time
read_hits_per_sec
rewrites_per_sec
num_of_active_tasks

RDF_System

symid

total_numof_sessions
total_numof_rone_sessions
numof_rone_active_sessions
numof_rone_msc_active_sessions
numof_rone_msc_sessions
numof_rone_cache_slots_in_use
total_numof_rtwo_sessions
numof_rtwo_active_sessions
numof_rtwo_msc_active_sessions
numof_rtwo_msc_sessions
numof_rtwo_cache_slots_inuse

RDFAStats

VMware, Inc.

symid |
ra_group_number |
rdfa_session_indicator |
rdfa_active_indicator

avg_cycle_time
duration_of_last_cycle
time_since_last_switch
active_cycle_size

19

EMC Symmetrix Adapter Installation and Configuration Guide

20

VMware, Inc.

Installing the EMC Symmetrix Adapter

The procedure you follow to install the EMC Symmetrix adapter depends on whether you have a
vCenter Operations Manager Standalone or vApp installation.
This chapter includes the following topics:
n

Install the Adapter in a Standalone Installation, on page 21

Install the Adapter in a vApp Installation, on page 22

EMC Symmetrix Adapter Folders and Files, on page 22

Install the Adapter in a Standalone Installation


If you have a standalone installation, you install the EMC Symmetrix adapter by extracting the adapter
installation files from a TGZ file and running an installation utility.
Prerequisites
n

Download the adapter installation TGZ file anonymously from ftp://ftp.integrien.com/.

Make a note of the build number in the TGZ file name. The build number appears after the adapter name,
for example, adaptername-buildnumber.tgz.

Read the release notes that are included with the TGZ file.

Procedure
1

Open the TGZ file and extract the TAR file to a temporary folder on your vCenter Operations Manager
server.

In the temporary folder, open the TAR file and extract and run the installer for your operating system
platform.

Log in to the Custom user interface as an administrator.

Select Admin > Support.

On the Info tab, find the Adapters Info pane and click the Describe icon ( ).
The Describe icon is located at the top right of the Adapters Info pane.

Click Yes to start the describe process and click OK.


The Custom user interface finds the adapter files, gathers information about the abilities of the adapter,
and updates the user interface with information about the adapter. If you have remote collectors, it installs
the adapter on the remote collectors.
The describe process might take several minutes. When the describe process is finished, the adapter
appears in the Adapters Info pane. The build number is in the Adapter Version column.

VMware, Inc.

21

EMC Symmetrix Adapter Installation and Configuration Guide

Verify that the build number in the Adapter Version column for the adapter matches the build number in
the TGZ file that you downloaded.

Install the Adapter in a vApp Installation


If you have a vApp installation, you install the EMC Symmetrix adapter from a PAK file.
Prerequisites
n

Download the adapter installation PAK file anonymously from ftp://ftp.integrien.com.

Make a note of the build number in the PAK file name. The build number appears after the adapter name,
for example, adaptername-buildnumber.pak.

Read the release notes that are included with the PAK file.

Procedure
1

Save the PAK file in a temporary folder.

Log in to the Admin user interface as the admin user.


For example: https://ipaddress/admin/

On the Update tab, click Browse to locate the temporary folder and select the PAK file.

Click Update and click OK to confirm the update.


The Admin user interface uploads the PAK file. The upload might take several minutes.

Read and accept the EULA and click OK.

Click OK to confirm and start the update process.


The update might take several minutes. Status information appears on the Update tab when the update
is finished.

Log in to the Custom user interface as an administrator.


For example: https://ipaddress/vcops-custom/

Select Admin > Support.

On the Info tab, find the Adapters Info pane and click the Describe icon ( ).
The Describe icon is located at the top right of the Adapters Info pane.

10

Click Yes to start the describe process and click OK.


The Custom user interface finds the adapter files, gathers information about the abilities of the adapter,
and updates the user interface with information about the adapter.
The describe process might take several minutes. When the describe process is finished, the adapter
appears in the Adapters Info pane. The build number is in the Adapter Version column.

11

Verify that the build number in the Adapter Version column for the adapter matches the build number in
the PAK file that you uploaded.

EMC Symmetrix Adapter Folders and Files


The installer places the EMC Symmetrix adapter files in the emc_symmetrix_adapter3 folder.
The emc_symmetrix_adapter3 folder contains several subfolders and files.

22

VMware, Inc.

Chapter 2 Installing the EMC Symmetrix Adapter

Table 2-1. EMC Symmetrix Adapter Folders, Subfolders, and Files


Folder

File

conf

emc_symmetrix.properties

Contains adapter-level
configuration properties.

describe.xml

Describes the adapter.

version.txt

Contains version information.

history.txt

Contains the history of the


adapter changes.
data_input_adapterinstance

work

adapterinstance.properties
lib

VMware, Inc.

Subfolder

Description

Instance-specific subfolder that


contains data input files. Contains
a temp subfolder.
Contains instance-level
configuration properties.
Empty folder.

23

EMC Symmetrix Adapter Installation and Configuration Guide

24

VMware, Inc.

Configuring the EMC Symmetrix


Adapter

Before you configure the EMC Symmetrix adapter, you must install EMC Solutions Enabler, configure and run
the storstpd daemon, and schedule a process to archive TTP files. To configure the adapter, you add an adapter
instance in vCenter Operations Manager. You can optionally tune adapter operation by modifying adapterlevel and instance-level configuration properties.
This chapter includes the following topics:
n

Overview of Configuration Steps, on page 25

Install EMC Solutions Enabler, on page 26

Configuring and Running the storstpd Daemon, on page 26

Periodically Archive TTP Data Files, on page 31

Main Input Folder and Data File Requirements, on page 32

TTP File Tag Format Requirements, on page 32

Add an Adapter Instance, on page 33

Configuring Adapter Properties, on page 34

Overview of Configuration Steps


You must perform the configuration steps in a particular order.
1

Install EMC Solutions Enabler. See Install EMC Solutions Enabler, on page 26.

Configure and run the storstpd daemon. See Configuring and Running the storstpd Daemon, on
page 26.

Periodically archive TTP files. See Periodically Archive TTP Data Files, on page 31.

Verify that the main input folder, TTP data files, and TTP file tags meet certain requirements. See Main
Input Folder and Data File Requirements, on page 32 and TTP File Tag Format Requirements, on
page 32.

Add an adapter instance in vCenter Operations Manager and start collection. You can create multiple
instances of the EMC Symmetrix adapter. See Add an Adapter Instance, on page 33.

(Optional) Modify adapter-level and instance-level configuration properties. See Configuring Adapter
Properties, on page 34.

VMware, Inc.

25

EMC Symmetrix Adapter Installation and Configuration Guide

Install EMC Solutions Enabler


To use the EMC Symmetrix adapter, you must install EMC Solutions Enabler version 7.2 or later. EMC Solutions
Enabler provides Symmetrix Application Programming Interface (SYMAPI) shared libraries for use by
Solutions Enabler applications, including TTP.
The EMC Symmetrix adapter is tested with EMC Solutions Enabler version V7.3.0.1 (Edit Level: 1214).
IMPORTANT You must install the standalone version of EMC Solutions Enabler. The EMC Solutions Enabler
virtual appliance does not support TTP data file generation.
Procedure
1

In a Web browser, go to http://powerlink.emc.com.

Sign in to an existing EMC account or register for a new EMC account.

Download and install EMC Solutions Enabler version 7.2 or later.

What to do next
Configure and run the storstpd daemon. See Configuring and Running the storstpd Daemon, on
page 26.

Configuring and Running the storstpd Daemon


To configure the storstpd daemon, you set properties in the daemon_options configuration file. You use
SYMCLI commands to run the daemon after it is configured.

daemon_options File Properties


The daemon_options file contains configuration properties for the storstpd daemon. On Windows, the
daemon_options file is installed in the C:\Program Files\EMC\SYMAPI\config folder. On Linux, the
daemon_options file is installed in the /var/symapi/config folder.

Recommended daemon_options Settings


Disable collections for Storage Performance Analyzer (dmn_run_spa property) and Storage Management
Console (dmn_run_smc property). Because the EMC Symmetrix adapter filters out device and disk-level data,
also disable the ttp_dev_metrics and ttp_disk_metrics properties.
The following daemon_options file example shows all of the recommended settings. These are these settings
that VMware uses during adapter testing.
storstpd:dmn_run_spa = disable
storstpd:dmn_run_smc = disable
storstpd:dmn_run_ttp = enable
storstpd:dmn_run_ttp_on_sp = disable
storstpd:dmn_run_rtc = disable
storstpd:ttp_collection_interval = 1
storstpd:ttp_rdflnk_metrics = enable
storstpd:ttp_se_tcp_metrics = enable
storstpd:ttp_se_nw_metrics = enable
storstpd:ttp_dev_metrics = disable
storstpd:ttp_disk_metrics = disable
storstpd:ttp_dgdev_metrics = enable
storstpd:ttp_se_tcp_metrics = enable
storstpd:ttp_se_nw_metrics = enable

26

VMware, Inc.

Chapter 3 Configuring the EMC Symmetrix Adapter

storstpd:ttp_se_nwi_metrics = enable
storstpd:ttp_re_sg_metrics = enable
storstpd:ttp_re_nwc_metrics = enable
storstpd:ttp_rdflnk_metrics = enable
storstpd:ttp_se_tcp_metrics = enable
storstpd:ttp_se_nw_metrics = enable
storstpd:use_compression = enable

Common Daemon Properties


These properties apply to all EMC Solutions Enabler daemons.
Table 3-1. Common Daemon Properties
Property

Allowed Values

Default Setting

Description

autorestart

enable or disable

enable

Determines whether to use a watchdog mechanism,


for example, the storwatchd daemon on Linux, to
restart a daemon if it crashes.

log_level

error, info,
debug,verbose, or
warning

warning

Messages that have a severity equal to or greater


than the level specified by this property are logged.
NOTE Specify debug or verbose only under the
direction of EMC Customer Support.

logfile_type

dated or wrap

wr

The style of log file.


wrap

Maintain the stornnnn.log0 and


stornnnn.log1 log files. Logging
alternates between the files and
switches each time a file reaches
the maximum size specified by the
logfile_sizeparameter property.
You can use the file modification
time to determine the current file.

dated

Use separate log files for each day.


A time stamp is part of the file
name, for example,
storapid_20041130.log. The
files do not have a size limit.

On Linux, log files are in the /var/symapi/log


folder. On Windows, log files are in the
C:\\Program Files\\EMC\\SYMAPI\\log folder.
logfile_size

VMware, Inc.

Number

1000 (1000-KB)

For wrap type log files, specifies how large, in


kilobytes, to allow each log file to grow before
switching to the alternate file.

27

EMC Symmetrix Adapter Installation and Configuration Guide

Table 3-1. Common Daemon Properties (Continued)


Property

Allowed Values

Default Setting

Description

logfile_retention

Number

For dated type log files, specifies the maximum


number of days to keep log files before deleting
them. The number of days must be greater than
zero.

logfile_perms

r, n, or rw

rw

By default, anyone can read or write to log files. For


example, log file permissions on Linux are
rwxrwxrwx. You can use this property to override
the default behavior.
rw

(Default) Anyone can read and


write.

The owner (root) can read and


write. Other users can only read.

The owner (root) can read and


write. Other users cannot read or
write.

storstpd Daemon Properties


These properties apply only to the storstpd daemon.
Table 3-2. storstpd Daemon Properties

28

Property

Allowed Values

Default Setting

Description

dmn_service_processor
_de0

0 to 30

Amount of time, in minutes, that storstpd delays


before collecting data. This property enables other
applications or tasks that start when the system
boots to run before collection begins.
NOTE This property is ignored if storstpd runs on
a host.

dmn_run_spa

disable or enable

enable

Determines whether storstpd starts the


components required to support the Storage
Performance Analyzer (SPA) application.
NOTE This property is ignored if storstpd runs on
the Service Processor because SPA support is not
available.

dmn_run_smc

disable or enable

enable

Determines whether storstpd starts the


components required to support the Storage
Management Console (SMC) application.
NOTE This property is ignored if storstpd runs on
the Service Processor because SMC support is not
available.

dmn_run_ttp

disable or enable

enable

Determines whether storstpd starts the


components required to support TTP collection on a
host.

dmn_run_ttp_on_sp

disable or enable

enable

Determines whether storstpd starts the


components required to support TTP collection on
the Service Processor.
NOTE If you enable this property on the Service
Processor, the daemon creates two collection files.
One file contains the normal full collection and the
other file contains an SRDF/A-only collection.

VMware, Inc.

Chapter 3 Configuring the EMC Symmetrix Adapter

Table 3-2. storstpd Daemon Properties (Continued)


Property

Allowed Values

Default Setting

Description

dmn_run_rtc

disable or enable

enable

Determines whether storstpd starts the


components required for real-time metrics
collection.

dmn_rtc_data_encode

disable or enable

disable

Determines whether storstpd compresses or


encodes real time data.

dmn_root_location

Full file path

/var/symapi/stp
on Linux
C:\Program
Files\\EMC\\SYM
API\\stp on
Windows

The full file path that storstpd uses as the root


directory for file creation. If the specified path does
not exist, storstpd uses the default path.

dmn_symmids

Comma-separated
list of Symmetrix
IDs

None

Set of Symmetrix arrays for which storstpd collects


statistics. If this property is null, storstpd collects
statistics for all local symids.
NOTE You can specify shortcuts.

dmn_max_arrays

1 to 50

Maximum number of arrays on which storstpd can


collect. If the number of local arrays specified in the
dmn_symmids property exceeds this value, or if the
dmn_symmids property is null and the number of
local arrays exceeds this value, no collections run.

dmn_remote_mode

disable or enable

disable

Determines whether storstpd establishes a remote


connection instead of operating locally. For remote
connections, you must specify a valid IP address and
port in the dmn_remote_address and
dmn_remote_port properties.
NOTE This property is ignored if storstpd runs on
the Service Processor.

dmn_remote_address

Valid IP address

None

IP address to use to establish a remote SYMAPI


connection.
NOTE This property is ignored if the
dmn_remote_mode property is set to disable.

dmn_remote_port

Valid IP port

2707

IP port to use to establish a remote SYMAPI


connecction.
NOTE This property is ignored if the
dmn_remote_mode property is set to disable.

TTP Packager Properties


These properties apply to the TTP packager.
Table 3-3. TTP Packager Properties
Property

Allowed
Values

Default
Setting

ttp_retention_days

0 to 365

30

Number of days that storstpd retains TTP collection


files.

ttp_disk_space_threshold

1 to 99

80

The disk space consumption threshold percentage.


storstpd does not allow TTP or BTP disk space
consumption to rise above this percentage.

VMware, Inc.

Description

29

EMC Symmetrix Adapter Installation and Configuration Guide

Table 3-3. TTP Packager Properties (Continued)


Property

Allowed
Values

Default
Setting

ttp_collection_interval

Number

15

How frequently, in minutes, storstpd collects TTP


statistics.
If storstpd runs on the Service Processor, the
minimum interval is 1 minute.
If storstpd runs on a host that has SPA enabled, the
minimum interval is 5 minutes. On a host that has
SPA disabled, the minimum interval is 2 minutes if
SMC is enabled and 1 minute if SMC is disabled.
NOTE If storstpd runs on the Service Processor, only
a qualified EMC Performance Guru should use
collection intervals of less than 5 minutes.

ttp_collect_iterations

Number

Number of TTP collection iterations. storstpd stops


collection after it reaches this value. If this property is
set to 0 (the default), this property is ignored.

ttp_archive_time

HH:MM

00:00

Time of day that storstpd archives TTP collection


files.

ttp_archive_interval

0 to 24

If storstpd archives TTP collection files, the number


of hours between each archive cycle. For example, if
you set ths property to 4, storstpd archives TTP files
every 4 hours.
You must enable auto_archive. hist_archive_time is
ignored.

Description

TTP Packager Metrics Properties


These properties determine the categories for which storstpd collects TTP counters. You can set these
properties to enable or disable.
Table 3-4. TTP Packager Category Property Categories

30

Property

Default Setting

Description

ttp_sys_metrics

enable

System performance category.

ttp_dev_metrics

enable

Device performance category.


NOTE If you enable this property, you must disable the
ttp_dev_metrics, ttp_dgdev_metrics, and ttp_cpdev_metrics
properties.

ttp_dir_metrics

enable

Director performance category.

ttp_disk_metrics

enable

Disk performance category.

ttp_port_metrics

enable

Director port performance category.

ttp_rdfa_metrics

enable

RDFA performance category.

ttp_ors_metrics

enable

Open Replicator performance category.

ttp_dgdev_metrics

disable

Device group performance category.


NOTE If you enable this property, you must disable the
ttp_dev_metrics, ttp_sgdev_metrics, and ttp_cpdev_metrics
properties.

ttp_stdev_metrics

enable

Storage group performance category.


NOTE If you enable this property, you must disable the
ttp_dev_metrics, ttp_dgdev_metrics, and ttp_cpdev_metrics
properties.

ttp_cpt_metrics

enable

Cache partition performance category.

VMware, Inc.

Chapter 3 Configuring the EMC Symmetrix Adapter

Table 3-4. TTP Packager Category Property Categories (Continued)


Property

Default Setting

Description

ttp_cpdev_metrics

disable

Cache partition device performance category.


NOTE If you enable this property, you must disable the
ttp_dev_metrics, ttp_dgdev_metrics, and ttp_sgdev_metrics
properties.

ttp_rdfsys_metrics

enable

RDF system performance category.

ttp_rdfdir_metrics

enable

RDF director performance category.

ttp_rdflnk_metrics

disable

RDF link performance category.

ttp_rdfdev_metrics

enable

RDF device performance category.

ttp_rdfgrp_metrics

enable

RDF group performance category.

ttp_se_tcp_metrics

disable

Dir-SE TCP connection statistics category.

ttp_se_nw_metrics

disable

Dir-SE TCP connection statistics category.

ttp_se_nwi_metrics

disable

Dir-SE N/W interface statistics category.

ttp_re_sg_metrics

disable

Dir-RE speedlimit group statistics category.

ttp_re_nwc_metrics

disable

Dir-RE N/W compression statistics category.

ttp_tp_dev_metrics

enable

TP pool device statistics category.

ttp_tp_metrics

disable

TP pool statistics category.

Run the storstpd Daemon


When you start the storstpd daemon, the daemon begins collecting performance data and exporting TTP data
files to the main input folder. You must run the storstpd daemon on the host, not on the Service Processor.
Prerequisites
Configure the storstpd daemon. See daemon_options File Properties, on page 26.
Procedure
1

On the host where you installed EMC Solutions Enabler, run the SYMCLI command
stordaemon start storstpd to start the daemon.

To verify that the daemon is running, run the SYMCLI command stordaemon list.

What to do next
Schedule a process to archive the TTP files. See Periodically Archive TTP Data Files, on page 31.

Periodically Archive TTP Data Files


You can run a SYSMCLI command on the host where you installed EMC Solutions Enabler to archive TTP data
files. To periodically archive the TTP data files, use operating system features to run the command repeatedly.
Prerequisites
Configure and run the storstpd daemon. See Configuring and Running the storstpd Daemon, on page 26.
Procedure
n

On Linux, run the SYMCLI command path_to_symcli_bin/stordaemon action storstpd -cmd archive
with a crontab.
For example: 2-57/5 * * * * path-to-symcli-bin/stordaemon action storstpd -cmd archive

VMware, Inc.

31

EMC Symmetrix Adapter Installation and Configuration Guide

On Windows, create a script that contains the SYMCLI command

path_to_symcli_bin\stordaemon action storstpd -cmd archive and use the Task Scheduler to run the

script repeatedly.
What to do next
Verify that the main input folder and data files meet certain requirements. See Main Input Folder and Data
File Requirements, on page 32.

Main Input Folder and Data File Requirements


The main input folder and data files must meet certain requirements.

Access Requirements
The main input folder and data files must meet the following access requirements:
n

The adapter instance must be able to access the main input folder. The main input folder can be on the
same machine as the adapter instance or on a remote machine.

The user account that runs the vCenter Operations Manager Collector service must have read and write
permission to the main input folder.

The user account that runs the vCenter Operations Manager Collector service must have read and write
permission to the TTP data files.

If the main input folder is on a remote Windows machine, you must share the folder before you add the
adapter instance. Do not map the main input folder. Windows services do not work with mapped drives.

If the main input folder is on a remote Linux machine, you must mount the folder to the Collector server
before you add the adapter instance.

Data File Name and Format Requirements


The data files must be TTP-formatted ASCII files. The TTP data file names in the main input folder must be in
the format T1_yyyyMMDD_HHmmSS_arrayId.ttp
n

T1 is the file prefix.

yyyyMMDD_HHmmSS is the time stamp.

arrayID is the Symmetrix array ID.

ttp is the file extension. For compressed files, the file extension depends on the compression type, which

can be either ZIP or GZ.


The following examples are valid TTP data file names:
T1_20110520_190635_000194900287.ttp
T1_20110520_190635_000194900287.ttp.gz

TTP File Tag Format Requirements


The adapter parses the METRIC, DATA, and TIMESTAMP tags in TTP files to obtain metric definitions and
data. These tags must meet certain requirements.

METRIC Tag Format


For the adapter to parse the resource group name in the METRIC tag, the name must be the only item, or, if
there are multiple items, the last item in the METRIC tag.

32

VMware, Inc.

Chapter 3 Configuring the EMC Symmetrix Adapter

In the following METRIC tag examples, the resource group name is System.
<METRIC: System>
<METRIC: SymStats51,1.0.001,Symmetrix,System>

DATA Tag Format


For the adapter to parse the resource group name in the DATA tag, the name must be the only item, or, if there
are multiple items, the second to the last item in the DATA tag.
The following DATA tag examples correspond to the previous METRIC tag examples. The resource group
name in the examples is System.
<DATA: System>
<DATA: SymStats51,1.0.001,Symmetrix,System,1>

TIMESTAMP Tag Format


For the adapter to parse the time stamp in the TIMESTAMP tag, the time stamp must be in the following format:
<TIMESTAMP: yyyyMMdd,HHmmss>

The following example shows a valid TIMESTAMP tag.


<TIMESTAMP: 20110513,103004>

Add an Adapter Instance


You must add an adapter instance for the EMC Symmetrix adapter in vCenter Operations Manager. The
adapter instance defines the adapter type and specifies the location of the main input folder. You can create
multiple adapter instances.
Prerequisites
n

Install the EMC Symmetrix adapter. See Chapter 2, Installing the EMC Symmetrix Adapter, on
page 21.

Install EMC Solutions Enabler. See Install EMC Solutions Enabler, on page 26.

Configure and run the storstpd daemon. See Configuring and Running the storstpd Daemon, on
page 26.

Periodically archive TTP files. See Periodically Archive TTP Data Files, on page 31.

Verify that the main input folder and TTP data files meet certain requirements. See Main Input Folder
and Data File Requirements, on page 32.

Procedure
1

Log in to the Custom user interface as an administrator.

Select Environment > Configuration > Adapter Instances.

Select the collector to use from the Collector drop-down menu.


Unless you added additional collectors, the only available collector is vCenter Operations Server. You
can change the name of this collector when you install the standalone version.

Select EMC Symmetrix Adapter from the Adapter Kind drop-down menu.

Click the Add New Adapter Instance icon.

Type a name for the adapter in the Adapter Instance Name text box.

VMware, Inc.

33

EMC Symmetrix Adapter Installation and Configuration Guide

Type the path to the main input folder in the EMC Symmetrix Main Input Folder text box.
Windows example where the folder is on the local machine:
C:\public\SYMMETRIX_DATA

Windows example where the folder is on a remote machine:


\\remote-host\public\SYMMETRIX_DATA

Linux example where the folder is on the local machine:


/usr/SYMMETRIX_DATA

Linux example where a remote folder is mounted on the local machine:


/mnt/SYMMETRIX_DATA

In this example, /mnt is the mounted file system from the remote machine.
8

Select true from the Auto Discovery drop-down menu to enable auto discovery.
Because the data that the EMC Symmetrix adapter collects is not known before collection begins, manual
discovery is not applicable to this adapter.
NOTE You might want to disable auto discovery during testing and debugging to stop the adapter from
retrieving new resources.

Click Test to test the availability of the main input folder.

10

Click OK to save your configuration.

11

Start collection for the adapter instance.

12

Select Environment > Environment Overview.

In the left pane, expand Adapter Instances and click EMC Symmetrix Adapter Instance.

On the List tab, select the EMC Symmetrix Adapter instance resource and click the Start Collecting
icon.

Verify that the work folder appears under the emc_symmetrix_adapter3 folder and that it contains the
data_input_adapterinstance subfolder and adapterinstance.properties file.
vCenter Operations Manager creates the data_input_adapterinstance subfolder and
adapterinstance.properties file for the adapter instance when you start collection.

What to do next
To tune adapter instance operation, you can modify adapter-level and instance-level properties. See
Configuring Adapter Properties, on page 34.

Configuring Adapter Properties


Each adapter instance has an instance-specific configuration file that contains properties that affect only that
particular adapter instance. An adapter-level configuration file contains properties that affect all adapter
instances.
NOTE In a vApp installation, you modify the properties files on the Analytics virtual machine.

34

VMware, Inc.

Chapter 3 Configuring the EMC Symmetrix Adapter

Adapter-Level Properties
Adapter-level properties affect all instances of the EMC Symmetrix adapter. You define adapter-level
properties in the emc_symmetrix.properties file in the conf folder.
Table 3-5. Adapter-Level Properties
Property

Description

Default

INPUT_DATA_FILES_ARE_COMPRESSED

Set this property to true if the data files in


the main input folder are compressed.

true

COMPRESSION_TYPE

Use this property to specify the


compression type of compressed data
files. Valid values are ZIP and GZ.

ZIP

MAX_NUMBER_OF_DATA_POINTS_IN_CACHE

When it reaches this limit, the adapter


pauses data file processing until the next
cycle of collection consumes the cache.
Increase or decrease this limit based on
the memory size of the Collector server
where the adapter runs.
Decrease the cache size if the server runs
low on memory. Increase the cache size if
the message Warn: File processor is
PAUSED because data size is
big... appears in the log file.

100000

SECONDS_DATA_FILE_READ_TIMEOUT

Amount of time, in seconds, that the


adapter is allowed to read a data file. If the
adapter needs more time to finish reading
a data file, the process is interrupted and
the Collect method pushes the data
already in cache to the FSDB.
The purpose of this value is to break a
nonresponding read thread.

600

BACKUP_COMPRESSED_INPUT_FILES_AFTER_PROC
ESSING

Determines whether to back up


compressed data files.
Set this property to true only during
adapter testing. Backing up data files is
not necessary in a production
environment.
NOTE Manually delete backup files after
you finish adapter testing. Backup files
have a .processed extension.

false

AUTOMATICALLY_DELETE_XML_AND_BIN_FILES

The process that creates TTP files might


generate XML and BIN files in the main
input folder. This property determines
whether to delete those files.
Set this property to true in a production
environment.

true

VMware, Inc.

35

EMC Symmetrix Adapter Installation and Configuration Guide

Instance-Level Properties
Instance-level properties affect only a particular EMC Symmetrix adapter instance. Each adapter instance has
an instance-level properties file called adapterinstance.properties in the work folder.
Table 3-6. Instance-Level Properties
Property

Description

Default

MAX_NUMBER_OF_DATA_FILES_IN_WORK_FOLD
ER

When it reaches this limit, the adapter instance


stops moving data files from the main input
folder to the work folder. This limit gives the
data file processor time to finish processing
existing data files in the work folder.

20

During data overload conditions, this limit


causes files to accumulate in the main input
folder instead of in the work folder. If files
accumulate in the main input folder, adjust the
file generator process.
At a minimum, the value of this property
should be equal to the number of arrays for the
adapter instance.

36

DATA_FILE_READ_THREAD_POOL_SIZE

Size of the data file read thread pool. Fine tune


this value so that the adapter instance
processes all of the files in the main input
folder in one monitoring cycle and files do not
accumulate in the folder.
The optimum value for this property depends
on several factors, including the number of
files to process per collection cycle and the
number of CPU cores on the server.

10

SECONDS_DATA_FILE_READ_SLEEP

Sleep time, in seconds, for the data read loop.


Decrease this value if either the number of data
files to read or the time to process files
increases.
The sleep time should be shorter than the
monitoring interval.

20

VMware, Inc.

Troubleshooting the EMC Symmetrix


Adapter

Known troubleshooting information can help you diagnose and correct problems with the EMC Symmetrix
adapter. Log files contain valuable information about adapter instance operation.
This chapter includes the following topics:
n

Troubleshooting an EMC Symmetrix Adapter Instance, on page 37

Viewing System Log Files, on page 38

EMC Symmetrix Adapter Classes, on page 38

Troubleshooting an EMC Symmetrix Adapter Instance


Perform these general troubleshooting steps to diagnose and correct problems with an EMC Symmetrix
adapter instance.
n

View the collection status and collection state for the adapter instance resource on the Environment
Overview page in vCenter Operations Manager.

If the adapter is not creating resources, verify that it can access the main input file. See Test Main Input
Folder and File Access, on page 37.

Verify that that the TTP files meet formatting requirements. See Main Input Folder and Data File
Requirements, on page 32 and TTP File Tag Format Requirements, on page 32.

Verify that the storstpd daemon is exporting each array ID TTP file to the corresponding subfolder under
the main input folder.

Verify that the files in the array ID subfolders have the correct file extensions. If the file extensions are not
correct, make sure that the INPUT_DATA_FILES_ARE_COMPRESSED and COMPRESSION_TYPE properties are set
properly. These property settings can change after an adapter update. See Adapter-Level Properties, on
page 35.

Check the adapter and collector logs for errors. See Viewing System Log Files, on page 38.

Test Main Input Folder and File Access


The EMC Symmetrix adapter must be able to access the main input folder and TTP data files.
Procedure
1

VMware, Inc.

Verify that the adapter instance can access the main input folder.
a

Select Environment > Configuration > Adapter Instances.

Select the adapter instance and click theEdit Selected Adapter Instance icon.

Verify that the path to the main input folder in the Text File Input Data Folder text box is correct.

37

EMC Symmetrix Adapter Installation and Configuration Guide

Click Test to test the availability of the main input folder.

Click Cancel.

If the adapter instance cannot access the main input folder, make sure that the folder is set up correctly.
a

Verify that the user account that runs the vCenter Operations Manager Collector service has read and
write permission to the main input folder.

If the main input is on a remote Windows machine, make sure that the folder is shared and is not
mapped to a drive letter.

If the main input folder is on a remote Linux machine, make sure that folder is mounted to the
Collector server.

Verify that the user account that runs the Collector service has read and write permission to the TTP data
files.
If the Collector service cannot read and write to the TTP data files, it cannot lock the files and lock error
messages appear in the log file.

Viewing System Log Files


You can view EMC Symmetrix adapter errors in the adapter and Collector log files. You can view log files in
the Custom user interface or in an external log viewer.
The logging level is set to ERROR by default. To troubleshoot issues, set the logging level to INFO. To view
detailed messages, including micro steps, queries, and returned results, set the logging level to DEBUG.
NOTE If you set the logging level to DEBUG, log files can become large very quickly. Set the logging level to
DEBUG only for short periods of time.
For information about viewing log files and modifying logging levels, see the online help.

EMC Symmetrix Adapter Classes


The EMC Symmetrix Adapter uses certain adapter classes.
Table 4-1. EMC Symmetrix Adapter Classes

38

Class

Description

com.integrien.adapter3.symmetrix.EMCSymmetrixAdapter

Adapter entry class. Contains the main


functionality methods.

com.integrien.adapter3.symmetrix.EMCSymmetrixConstants

Holds all of the constant values that the adapter


uses.

com.integrien.adapter3.symmetrix.MetaDataFileWorkItem

Work item (thread) to process a single


metadata file.

com.integrien.adapter3.symmetrix.DataFileWorkItem

Work item (thread) to process a single data file.

com.integrien.adapter3.symmetrix.DataFileProcessor

Main file processing thread class. Spawns work


items.

com.integrien.adapter3.symmetrix.utils.DummyFileGenerator

Dummy input file generator. Used for testing.

com.integrien.adapter3.symmetrix.utils.EMCSymmetrixUtils

Utility class for methods that the adapter uses.

com.integrien.adapter3.symmetrix.properties.EMCSymmetrixPr
operties

Reads configuration properties from the


emc_symmetrix.properties file.

com.integrien.adapter3.symmetrix.properties.InstanceProper
ties

Reads configuration properties from the


instance-level properties files.

com.integrien.adapter3.symmetrix.exceptions.EMCSymmetrixEx
ception

Adapter-specific exception class.

VMware, Inc.

Chapter 4 Troubleshooting the EMC Symmetrix Adapter

Table 4-1. EMC Symmetrix Adapter Classes (Continued)


Class

Description

com.integrien.adapter3.symmetrix.objects.DataPointObject

Object that represents a data point (resource,


metric, or value timestamp). All of the data
stored in cache is a set of this object.

com.integrien.adapter3.symmetrix.objects.LunDataPointObjec
t

Reserved for future use.

com.integrien.adapter3.symmetrix.objects.ResourceMetricObj
ect

Auxiliary class for rate calculation. Represents


a specific metric.

com.integrien.adapter3.symmetrix.objects.TimestampedParent
Resource

Used for metadata (resource relationship)


processing. Represents a parent resource in a
specific time.

com.integrien.adapter3.symmetrix.objects.TTPFile

Represents the necessary information cached


from a TTP file.

com.integrien.adapter3.symmetrix.objects.TTPMetric

Represents a metric and properties read from


TTP file, for example, isRate.

VMware, Inc.

39

EMC Symmetrix Adapter Installation and Configuration Guide

40

VMware, Inc.

Index

adapter classes 38
adapter instances 33
adapter-level properties 35
adapterinstance.properties file 9, 22, 33, 36
archiving TTP data files 31
audience information 5
autodiscovery 33
AUTOMATICALLY_DELETE_XML_AND_BIN_FI
LES property 35

history.txt file 22

lib folder 22
log files 38

BACKUP_COMPRESSED_INPUT_FILES_AFT
ER_PROCESSING property 35

C
Collect method 9
Collector service 9
conf folder 22
configuration steps 25
configuring adapter properties 34

D
daemon_options file 10, 26
DATA_FILE_READ_THREAD_POOL_SIZE
property 36
DATA_FILE_THREAD_POOL_SIZE property 9
data_input_adapterinstance folder 9, 22, 33
describe.xml file 10, 22

E
EMC Solutions Enabler 26
EMC Solutions Enabler STP daemon, See
storstpd daemon
emc_symmetrix_adapter3 folder 21, 22, 33
emc_symmetrix.properties file 22, 35
EMCSymmetrixAdapter_install.bin 21
EMCSymmetrixAdapter_install.exe 21

F
fitered metrics 11
folders and files 22
FSDB 9

VMware, Inc.

I
INPUT_DATA_FILES_ARE_COMPRESSED
property 35
installation steps 21
instance-level properties 36
introduction 9

M
main input folder 9, 32, 33, 37
manual discovery 33
MAX_NUMBER_OF_DATA_FILES_IN_WORK_
FOLDER property 36
MAX_NUMBER_OF_DATA_POINTS_IN_CACH
E property 35
metric selection 10

P
PAK file 22

R
recommended metrics 11
requirements
access 32
data file name and format 32

S
scalability considerations 10
SECONDS_DATA_FILE_READ_SLEEP
property 36
SECONDS_DATA_FILE_READ_TIMEOUT
property 35
standalone installation steps 21
stordaemon commands
action 31
list 31
start 31
storstpd daemon 9, 10, 26, 31

41

EMC Symmetrix Adapter Installation and Configuration Guide

T
temp folder 9
testing main input folder access 37
TGZ file 21
thread pools 9
troubleshooting 37
TTP data files 9, 31, 32
TTP file tag format requirements 32

U
updated information 7

V
vApp installation steps 22
version.txt fle 22

W
work folder 22

42

VMware, Inc.

Potrebbero piacerti anche