Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
EN-000836-03
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
Index 41
VMware, Inc.
VMware, Inc.
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.
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.
VMware, Inc.
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
VMware, Inc.
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.
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.
For a list of the metrics that you should collect, see Recommended Metrics to Collect, on page 11.
Devices
Disks
ORS-Device
DGRP-Detail
CP-DevDetail
SGRP-Detail
VMware, Inc.
11
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.
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
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.
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
16
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.
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
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.
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
20
VMware, Inc.
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
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.
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.
VMware, Inc.
21
Verify that the build number in the Adapter Version column for the adapter matches the build number in
the TGZ file that you downloaded.
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
On the Update tab, click Browse to locate the temporary folder and select the PAK file.
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
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.
22
VMware, Inc.
File
conf
emc_symmetrix.properties
Contains adapter-level
configuration properties.
describe.xml
version.txt
history.txt
work
adapterinstance.properties
lib
VMware, Inc.
Subfolder
Description
23
24
VMware, Inc.
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
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
What to do next
Configure and run the storstpd daemon. See Configuring and Running the storstpd Daemon, on
page 26.
26
VMware, Inc.
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
Allowed Values
Default Setting
Description
autorestart
enable or disable
enable
log_level
error, info,
debug,verbose, or
warning
warning
logfile_type
dated or wrap
wr
dated
VMware, Inc.
Number
1000 (1000-KB)
27
Allowed Values
Default Setting
Description
logfile_retention
Number
logfile_perms
r, n, or rw
rw
28
Property
Allowed Values
Default Setting
Description
dmn_service_processor
_de0
0 to 30
dmn_run_spa
disable or enable
enable
dmn_run_smc
disable or enable
enable
dmn_run_ttp
disable or enable
enable
dmn_run_ttp_on_sp
disable or enable
enable
VMware, Inc.
Allowed Values
Default Setting
Description
dmn_run_rtc
disable or enable
enable
dmn_rtc_data_encode
disable or enable
disable
dmn_root_location
/var/symapi/stp
on Linux
C:\Program
Files\\EMC\\SYM
API\\stp on
Windows
dmn_symmids
Comma-separated
list of Symmetrix
IDs
None
dmn_max_arrays
1 to 50
dmn_remote_mode
disable or enable
disable
dmn_remote_address
Valid IP address
None
dmn_remote_port
Valid IP port
2707
Allowed
Values
Default
Setting
ttp_retention_days
0 to 365
30
ttp_disk_space_threshold
1 to 99
80
VMware, Inc.
Description
29
Allowed
Values
Default
Setting
ttp_collection_interval
Number
15
ttp_collect_iterations
Number
ttp_archive_time
HH:MM
00:00
ttp_archive_interval
0 to 24
Description
30
Property
Default Setting
Description
ttp_sys_metrics
enable
ttp_dev_metrics
enable
ttp_dir_metrics
enable
ttp_disk_metrics
enable
ttp_port_metrics
enable
ttp_rdfa_metrics
enable
ttp_ors_metrics
enable
ttp_dgdev_metrics
disable
ttp_stdev_metrics
enable
ttp_cpt_metrics
enable
VMware, Inc.
Default Setting
Description
ttp_cpdev_metrics
disable
ttp_rdfsys_metrics
enable
ttp_rdfdir_metrics
enable
ttp_rdflnk_metrics
disable
ttp_rdfdev_metrics
enable
ttp_rdfgrp_metrics
enable
ttp_se_tcp_metrics
disable
ttp_se_nw_metrics
disable
ttp_se_nwi_metrics
disable
ttp_re_sg_metrics
disable
ttp_re_nwc_metrics
disable
ttp_tp_dev_metrics
enable
ttp_tp_metrics
disable
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.
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
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.
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.
ttp is the file extension. For compressed files, the file extension depends on the compression type, which
32
VMware, Inc.
In the following METRIC tag examples, the resource group name is System.
<METRIC: System>
<METRIC: SymStats51,1.0.001,Symmetrix,System>
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
Select EMC Symmetrix Adapter from the Adapter Kind drop-down menu.
Type a name for the adapter in the Adapter Instance Name text box.
VMware, Inc.
33
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
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.
10
11
12
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.
34
VMware, Inc.
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
true
COMPRESSION_TYPE
ZIP
MAX_NUMBER_OF_DATA_POINTS_IN_CACHE
100000
SECONDS_DATA_FILE_READ_TIMEOUT
600
BACKUP_COMPRESSED_INPUT_FILES_AFTER_PROC
ESSING
false
AUTOMATICALLY_DELETE_XML_AND_BIN_FILES
true
VMware, Inc.
35
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
20
36
DATA_FILE_READ_THREAD_POOL_SIZE
10
SECONDS_DATA_FILE_READ_SLEEP
20
VMware, Inc.
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
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.
VMware, Inc.
Verify that the adapter instance can access the main input folder.
a
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
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.
38
Class
Description
com.integrien.adapter3.symmetrix.EMCSymmetrixAdapter
com.integrien.adapter3.symmetrix.EMCSymmetrixConstants
com.integrien.adapter3.symmetrix.MetaDataFileWorkItem
com.integrien.adapter3.symmetrix.DataFileWorkItem
com.integrien.adapter3.symmetrix.DataFileProcessor
com.integrien.adapter3.symmetrix.utils.DummyFileGenerator
com.integrien.adapter3.symmetrix.utils.EMCSymmetrixUtils
com.integrien.adapter3.symmetrix.properties.EMCSymmetrixPr
operties
com.integrien.adapter3.symmetrix.properties.InstanceProper
ties
com.integrien.adapter3.symmetrix.exceptions.EMCSymmetrixEx
ception
VMware, Inc.
Description
com.integrien.adapter3.symmetrix.objects.DataPointObject
com.integrien.adapter3.symmetrix.objects.LunDataPointObjec
t
com.integrien.adapter3.symmetrix.objects.ResourceMetricObj
ect
com.integrien.adapter3.symmetrix.objects.TimestampedParent
Resource
com.integrien.adapter3.symmetrix.objects.TTPFile
com.integrien.adapter3.symmetrix.objects.TTPMetric
VMware, Inc.
39
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
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.