IBM(R) Tivoli(R) Monitoring for Virtual Environments: NetApp 7.2.0.3-TIV-ITM_NETAPP-IF0001

Copyright International Business Machines Corporation 2016.
All rights reserved.

Component: IBM(R) Tivoli(R) Monitoring for Virtual Environments:
NetApp Storage Agent, Version 7.2.0 Fix Pack 3.

Component ID: 5724L92NA

Interim Fix: 0001, 7.2.0.3-TIV-ITM_NETAPP-IF0001

Date: March 15, 2016

Contents
========
1.0 General description
2.0 Enhancements
3.0 Architecture and prerequisites
4.0 Image directory contents
5.0 Installation instructions
6.0 Additional installation information
7.0 Known problems and workarounds
8.0 Additional product information
9.0 Notices


1.0 General description
=======================
This fix provides tolerance support for the OnCommand Unified
Manager (OCUM) 6.x environment.


2.0 Enhancements
================
With OCUM 6.x, NetApp has changed the way of monitoring the storage
resources.

- If you work in the OCUM 6.x environment, then read the "2.1
Prerequisites" section for information about version compatability,
agent configuration, and the supported and unsupported attributes.

- If you work with the Data Fabric Manager 5.x or earlier, then you need
not read the information that is mentioned in the "2.1 Prerequisites"
section.

2.1 Prerequisites
-----------------
- To monitor the performance counters, you must configure the
OnCommand API Services with the OCUM and Performance Manager.

- To obtain performance data from the OnCommand API Services,
the configured user must be of the type "administrator" or
"monitor". These user types have default permissions to execute
the rest API.

- Versions of the OnCommand API Services, OCUM, and the
Performance Manager must be compatible.
For example, to configure API Service V 1.0, pair OCUM
V 6.2, 6.1, or 6.0 with Performance Manager V 1.1.
For compatible product versions, see the interoperability matrix tool:
http://mysupport.netapp.com/matrix/#search

Note: For more details about installing and configuring the
OCUM, OnCommand Performance Manager, and the
OnCommand API Services, see the Installation and
Setup Guide of the respective component.

2.1.1 Configuration values
--------------------------
For both local and remote configuration, you must provide the
configuration values for the agent to operate. Use the following
values to configure OnCommand API Service (Data Source):
- Server (KNU_API_SERVICES_HOST_ADDRESS)
The host name or IP address of the NetApp API services
server.
- User Name (KNU_API_SERVICES_USERNAME)
A user name on the OCUM API services server that has
sufficient privileges to collect monitoring.
- Password (KNU_API_SERVICES_PASSWORD)
The password for the user name in this section.


2.2 Supported and unsupported attributes
----------------------------------------
This section lists the supported and unsupported attributes
for tolerance support for OCUM 6.x:

1. Aggregates attribute group

Supported attributes:
---------------------
- Aggregate Name
- Run Status
- Size Available
- Size Total
- Size Used
- Percent Used
- Total Space Committed
- Committed Warehouse
- Perf Warehouse
- Size Warehouse
- User Reads
- User Writes
- User Read Blocks
- User Write Blocks
- CP Read Blocks
- Total Transfers
- CP Reads
- File Rate
- Block Rate


Unsupported attributes:
-----------------------
- Aggregate Type
- Composite Status
- Host Name
- Perf Status

2. Disks attribute group

Supported attributes:
---------------------
- Disk Name
- Disk Size
- Aggregate Name
- Disk Type
- Size Warehouse
- File Rate
- User Reads
- User Writes
- CP Reads
- Disk Busy
- Total Transfers


Unsupported attributes:
-----------------------
- Host Name
Note: Except the "Host Name" and "Disk UID or WWN", all other attributes
from this attribute group are supported only if the
OCUM API Service V 1.1 is configured with the compatible
components that are listed in the "2.1 Prerequisites" section.

3. LUNs attribute group

Supported attributes:
---------------------
- LUN Path
- LUN Size
- Volume Name
- Size Warehouse
- Read Ops
- Write Ops
- Other Ops
- Total Ops
- Read Data
- Write Data
- Average Latency
- Performance Warehouse


Unsupported attributes:
----------------------
- Composite Status
- Host Name
- Perf Status

4. Volumes attribute group

Supported attributes:
---------------------
- AFS Available
- AFS Total
- AFS Used
- Overwrite Reserve Available
- Overwrite Reserve Total
- Overwrite Reserve Used
- Run Status
- Snapshot Reserve Available
- Snapshot Reserve Total
- Snapshot Reserve Used
- Volume Name
- Volume Size
- Volume State
- Volume Type
- AFS Percent Used
- Snapshot Reserve Percent Used
- Max Percent Used
- Read Latency
- Write Latency
- Other Latency
- Composite Latency
- Read Ops
- Write Ops
- Other Ops
- Total Ops


Unsupported attributes:
-----------------------
- AFS Data
- Aggregate Name
- Composite Data Rate
- Composite Status
- Host Name
- Perf Status
- Perf Warehouse
- Read Data
- Write Data
- Aggregate Name
- Autosize Enabled
- Is Dedupe Enabled
- Maximum Size

2.2 Unsupported attribute groups
---------------------------------
Following attribute groups are no longer supported
for tolerance support for OCUM 6.x:

1. Host FCP Targets attribute group
2. Host Network Interfaces attribute group
3. Hosts attribute group
4. Qtrees attribute group


3.0 Architecture and prerequisites
==================================
For information about the operating system certification, see
the IBM Software Product Compatibility Reports (SPCR):
http://www-969.ibm.com/software/reports/compatibility/clarity/index.html

3.1 Prerequisites for this fix
------------------------------
The prerequisite level for this fix is as follows:
- IBM Tivoli Monitoring for Virtual Environments NetAPP Agent,
version 7.2 Fix Pack 3.


4.0 Image directory contents
============================
This fix image contains the following files:

- 7.2.0.3-TIV-ITM_NETAPP_IF0001.README - This ReadMe file
- 7.2.0.3-TIV-ITM_NetApp-IF0001.tar.gz - Fix archive .gz format

Note: The content in the .gz files are identical for both the operating
systems. Same installer will work for windows and non-windows operating
systems.

The fix archive file contains the following folders:
agent
app_support

5.0 Installation instructions
=============================
Use the following steps to install this fix.

5.1 Before installing the fix
-----------------------------
- The prerequisites listed under section 3.1 entitled 'Prerequisites
for this fix' must be installed before installing this fix.

- For the purpose of this ReadMe, the symbol <CANDLEHOME> is the
IBM Tivoli Monitoring installation directory. The default value
for CANDLEHOME is '/opt/IBM/ITM' on UNIX systems and 'C:\IBM\ITM'
on Windows systems.

5.2 Agent and Application support installation and configuration
----------------------------------------------------------------
For information about agent installation, configuration, and application
support, see the 'Agent installation and configuration' chapter of the
IBM Tivoli Monitoring for Virtual Environments Agent for NetApp
Storage Version 7.2.3 User's Guide.


6.0 Additional installation information
=======================================

6.1 Installation instructions for agent baroc file
--------------------------------------------------

There are no updates to the baroc files included in this fix or
any of the superseded fixes. No additional installation steps are
required.

6.2 Verifying the update
------------------------
1. To verify that the agent was updated correctly, use the tacmd
command to view the current version of the agent after the agent
is restarted. You need to log in to a Tivoli Enterprise
Monitoring Server before viewing the agent version.

For example:
On UNIX systems, where $CANDLEHOME is the IBM Tivoli Monitoring
installation directory. The default location is '/opt/IBM/ITM'.

> $CANDLEHOME/bin/tacmd login -s <server>
-u <itmuser>
-p <password>
> $CANDLEHOME/bin/tacmd listSystems -t NU

On a Windows system, where %CANDLE_HOME% is the IBM Tivoli
Monitoring installation directory. The default location
is 'C:\IBM\ITM'.

> %CANDLE_HOME%\bin\tacmd login -s <server>
-u <itmuser>
-p <password>

> %CANDLE_HOME%\bin\tacmd listSystems -t NU

Note:
- The component (-t) for the tacmd listSystems command is
specified as two characters (NU), not three characters (KNU).

When the agent is updated, the agent version will be:
07.20.03.01


2. To verify whether the agent support files were updated correctly,
use the "kincinfo" command on Windows systems or the "cinfo"
command on Linux or UNIX systems. The following sample output
shows the versions of the Tivoli Enterprise Portal Server,
Tivoli Enterprise Monitoring Server, or Tivoli Enterprise Portal
Desktop systems after this fix is applied.

On UNIX or Linux systems:
-------------------------
To validate that all components are installed, run the
following command:

./cinfo -i

On Windows systems:
-------------------
To validate that all components are installed, run the
following command:

%CANDLE_HOME%\InstallITM\kincinfo -i

For example:
> %CANDLE_HOME%\InstallITM\kincinfo -i

********** Friday, January 29, 2016 3:04:52 AM ***********
User : Administrator Group : NA
Host Name : ESX6V9 Installer : Ver: 063003000
CandleHome : C:\IBM\ITM
Installitm : C:\IBM\ITM\InstallITM
*************************************************************
...Product Inventory
.
.
.
NU KNU(64-bit) CMA/Monitoring Agent for NetApp Storage
WIX64 Version: 07.20.03.01 Build: 201601290304

7.0 Known problems and workarounds
==================================
None.


8.0 Additional product information
==================================
None.


9.0 Copyright and trademark information
=======================================
A current list of IBM trademarks is available on the Web at "Copyright
and trademark information" at www.ibm.com/legal/copytrade.shtml.


10.0 Notices
============
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION
"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Some jurisdictions do not allow disclaimer of express or implied
warranties in certain transactions, therefore, this statement may not
apply to you.

This information could include technical inaccuracies or typographical
errors. Changes are periodically made to the information herein; these
changes will be incorporated in new editions of the publication. IBM
may make improvements and/or changes in the product(s) and/or the
program(s) described in this publication at any time without notice.

Microsoft, Windows, and Windows Server are trademarks of Microsoft
Corporation in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or
registered trademarks of Oracle and/or its affiliates.

UNIX is a registered trademark of The Open Group in the United States
and other countries.

Linux is a registered trademark of Linus Torvalds in the United States,
other countries, or both.

Other company, product, or service names may be trademarks or service
marks of others.

Third-Party License Terms and Conditions, Notices and Information
-----------------------------------------------------------------
The license agreement for this product refers you to this file for
details concerning terms and conditions applicable to third party
software code included in this product, and for certain notices and
other information IBM must provide to you under its license to
certain software code. The relevant terms and conditions, notices and
other information are provided or referenced below. Please note that
any non-English version of the licenses below is unofficial and is
provided to you for your convenience only. The English version of the
licenses below, provided as part of the English version of this file,
is the official version.

Notwithstanding the terms and conditions of any other agreement you
may have with IBM or any of its related or affiliated entities
(collectively "IBM"), the third party software code identified below
are "Excluded Components" and are subject to the following terms and
conditions:

- the Excluded Components are provided on an "AS IS" basis
- IBM DISCLAIMS ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND
CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT
NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE
AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE
- IBM will not be liable to you or indemnify you for any claims
related to the Excluded Components
- IBM will not be liable for any direct, indirect, incidental,
special, exemplary, punitive or consequential damages with respect
to the Excluded Components.