IBM Support

IBM Tivoli Monitoring for Virtual Environment - NetApp Agent

Release Notes


Abstract

What's new in IBM Tivoli Monitoring for Virtual Environment - NetApp Agent

Content

  1. NetApp version support
  2. NetApp Agent releases
  3. Interim Fixes
  4. General considerations
  5. Common questions
  6. Common problems

NetApp version support

Release Version NetApp agent version Supported Data Fabric or Unified managers*
7.2 FP3 7.2 FP3 3.7, 4.x, 5.x
7.2 FP6 7.3 FP1 3.7, 4.x, 5.x, 6.x, 7.x, 9.4, 9.5, 9.6
7.2 FP7 7.3 FP2 3.7, 4.x, 5.x, 6.x, 7.x, 9.4, 9.5, 9.6
7.2 FP8 7.3 FP3 9.7, 9.8, 9.9
7.2 FP9 7.3 FP4 9.10 Onwards
7.2 FP10 7.3 FP5 9.12, 9.13
7.2 FP11 7.3 FP6 9.14
* Following is the list of the names the ONTAP Storage System Manager is referred to as depending upon the software version.
  • Data Fabric Manager (DFM) - Version 5.x
  • OnCommand Unified Manager - Version 6.x to 9.5
  • Active IQ Unified Manager- Version 9.6

NetApp Agent Releases

NetApp Agent v7.3 FP6 (ITMfVE Downloadable version 7.2 FP11) (Released 20 December 2024)

The following enhancements were made in this release:
  • The Agent is supported to Monitor the Active IQ Unified Manager 9.14
  • Upgraded ITM SDK to version 6.3 FP7 SP18
  • Upgraded Agent JRE to version 1.8.0_441
Download Link:https://www.ibm.com/support/pages/node/7179127.
Part Number: M0P48EN

NetApp Agent v7.3 FP5 (ITMfVE Downloadable version 7.2 FP10) (Released 26 January 2024)

The following enhancements were made in this release:
  • The Agent is supported to Monitor the Active IQ Unified Manager 9.12
  • The Agent is supported to Monitor the Active IQ Unified Manager 9.13
  • Upgraded ITM SDK to version 6.3 FP7 SP14
  • Upgraded Agent JRE to version 1.8.0_351
  • Added Support for RHEL 9 operating system.
Download Link: https://www.ibm.com/support/pages/node/7110406
Part Number: M0H0CEN

NetApp Agent v7.3 FP4 (ITMfVE Downloadable version 7.2 FP9) (Released 15 November 2022)

The following enhancements were made in this release:
  • The Agent is supported to Monitor the Active IQ Unified Manager 9.9
  • The Agent is supported to Monitor the Active IQ Unified Manager 9.10
  • The Agent is supported to Monitor the Active IQ Unified Manager 9.11
  • Upgraded ITM SDK to version 6.3 FP7 SP13
  • Upgraded Agent JRE to version 1.8.0_331
  • Added Support for Windows 2022 Server SE and DE Operating Systems
Download Link: https://www.ibm.com/support/pages/node/6837589
Part Number: M08C0EN

NetApp Agent v7.3 FP3 (ITMfVE Downloadable version 7.2 FP8) (Released 30 July 2021)

The following enhancements were made in this release:
  • This agent is redesigned to support Active IQ 9.7 later versions, all the existing attribute groups are continuing to support except those the API calls are deprecated on the Active IQ Unified Manager.
  • This agent is not supported to monitor setups before Active IQ to 9.7, upgrade from the previous agent release to this one is recommended only if you have an Active IQ version of 9.7 or later.
  • Updates in existing attribute groups:
    Attributes Addition Deprecation
    Cluster
    • Read_Throughput
    • Write_Throughput
    • Read_Latency
    • Write_Latency
    • Read_Iops
    • Write_Iops
    Aggregate
    • Read_Throughput
    • Write_Throughput
    • Host_Name
    • Aggregate_Type
    • Perf_Status
    • Composite_Status
    • Total_Transfers
    • CP_Reads
    • File_Rate
    • User_Read_Blocks
    • User_Write_Blocks
    • CP_Read_Blocks
    • Block_Rate
    • Perf_Warehouse
    • Utilization
    • CP_Read_Latency
    Qtree
    • SVM_Name
    • Security_Style
    • Export_Policy_Name
    • Host_Name
    • Disk_Space_Limit
    • Soft_Limit
    • Space_Used
    • Space_Percent_Used
    • File_used
    • File_limit
    • Files_Percent_Used
    • Total_Ops
    • CIFS_Ops
    • NFS_Ops
    Cluster node
    • Net_Data_Recv
    • Net_Data_Sent
    • CPU_Busy
    • Avg_Processor_Busy
    • Write_Throughput
    • Read_Ops
    • Other_Ops
    • Max_Aggregate_Utilization
    • Sys_Avg_Latency
    • Total_Throughput
    • Utilization
    • Sys_Read_Latency
    • Sys_Write_Latency
    • Read_Throughput
    LUN
    • Perf_Status
    • HOST_NAME
    • Composite_Status
    • Read_Ops
    • Write_Ops
    • Other_Ops
    • Total_Ops
    • Read_Data
    • Write_Data
    • Avg_Latency
    • Perf_Warehouse
    Disk
    • Host_Name
    • Total_Transfers
    • User_Reads User_Writes
    • CP_Reads File_Rate
    • User_Read_Blocks
    • User_Write_Blocks
    • CP_Read_Blocks
    • Block_Rate
    • User_Read_Latency
    • User_Write_Latency
    • CP_Read_Latency
    • Composite_Latency
    • Disk_Busy
    • Perf_Warehouse
    • Total_Latency
    • Total_Throughput
    • Guaranteed_Read_Latency
    • Total_Ops
    • Guaranteed_Write_Latency
    • Used_Size
    • Is_Virtual
    • Is_Offline
    • Serial_Number
    • Size_Per
    Volume
    • Host_Name Perf_Status
    • Composite_Status
    • Is_Dedupe_Enabled
    • AFS_Data
    • AFS_Warehouse
    • Read_Data Write_Data
    • Composite_Data_Rate
    • Perf_Warehouse
    • CIFS_Other_Ops
    • iSCSI_Read_Ops
    • NFS_Other_Latency
    • NFS_write_ops
    • CIFS_write_latency
    • NFS_read_ops
    • NFS_other_ops
    • NFS_Write_Latency
    • CIFS_read_ops
    • CIFS_read_latency
    • CIFS_write_ops
    • CIFS_other_latency
    • NFS_read_latency
    Storage VM
    • cifs_latency cifs_ops
    • iscsi_read_ops
    • iscsi_write_ops
    • net_recv_data
    • net_sent_data
    • net_recv_packet
    • net_sent_packet
    • net_total_packets
    • net_total_throughput
    • net_recv_errors
    • net_sent_errors
    • total_latency total_ops
    • type volume_bytes_avail
    • volume_bytes_used
    • volume_bytes_total
    • export_policy_enabled
    • maximum_volumes
    • iscsi_node_name
    • fcp_node_name
    • cifs_authentication_style
  • The event mechanism is enhanced to show only the latest events that occur after the agent has started, no history lookup to query the old events available on the Active IQ Unified Manager.
  • Logging is enhanced with precise information about the connection failure of both sources.
  • We have updated workspaces as follows:
    • NetApp Agent:
      • Deleted: “Host Status View”.
      • Removed navigation link from “Aggregates Status view”, “Luns Status view” and “Volumes Status view”.
    • Clustered Details:
      • Deleted: “Performance Details view “, “Throughput view”.
    • Disks Summary:
      • Deleted: “Total Throughput view”.
      • Deleted the workspace Disk details and also removed the navigation Link from Disk Summary to Disk Details.
    • Vserver Details:
      • Deleted: “Network Error”, and “Network Utilization” views.
Download Link: https://www.ibm.com/support/pages/node/6474485
Part Number: G0231EN

NetApp Agent v7.3 FP2 (ITMfVE Downloadable version 7.2 FP7) (Released 23 April 2021)

The following enhancements were made in this release:
  • Added Prerequisite checker support to enable scanning of prerequisites before installation.
  • Defect fixed in generating SDA jars for an agent.
  • If the connection fails, the agent would continuously attempt connection to the data source without limit every 30 seconds. Such agent behavior remains even though the user removed the environment variable KNU_DATA_PROVIDER_CONNECTION_RETRY_COUNT or set it to 0. To have a limited number of connection attempts, the environment variable KNU_DATA_PROVIDER_CONNECTION_RETRY_COUNT must be set to a valid nonzero value.
  • Agent JRE is upgraded to version: 1.8.0_241.
Download Link: https://www.ibm.com/support/pages/node/6442093
Part Number: CC9VJEN

NetApp Agent v7.3 FP1 (ITMfVE Downloadable version 7.2 FP6) (Released 11 May 2020)

The following enhancements were made in this release:
  • New attribute groups:
    • DataSource
    • Cluster Node
    • Clusters
    • Vserver
    • Events
  • Updates in existing attribute groups:
    • Aggregates
      • Aggregate_Key
      • CP_Read_Latency
      • Latency
      • Node_Name
      • Throughput
      • UserWriteLatency
      • UserReadLatency
      • Utilization
    • Volumes
      • Aggregate_Key
      • Avg_latency
      • Autogrow_Increment_Size
      • CIFS_Other_Ops
      • CIFS_write_latency
      • CIFS_read_ops
      • CIFS_read_latency
      • CIFS_write_ops
      • CIFS_other_latency
      • Is_Snapshot_Autodelete_Enabled
      • iSCSI_Read_Ops
      • Key
      • NFS_Other_Latency
      • NFS_write_ops
      • NFS_read_ops
      • NFS_other_ops
      • NFS_Write_Latency
      • NFS_read_latency
      • Quota_Committed_Space
      • Read_throughput
      • Size_Used
      • Size_Used_Percent
      • Total_throughput
      • Total_Latency
      • Volume_Style
      • vServer_Key
      • Write_throughput
    • LUNs
      • LUN_Key
      • Qtree_Key
      • StorageVM_Key
      • Volume_Key
    • Disk
      • Aggregate_Key
      • Container_Type
      • Cluster_Key
      • Failed_Reason
      • Guaranteed_Read_Latency
      • Guaranteed_Write_Latency
      • Is_Virtual
      • Is_Offline
      • Key
      • Node_Name
      • Node_Key
      • Serial_Number
      • Size_Per
      • Total_Latency
      • Total_Throughput
      • Total_Ops
      • Used_Size
      • Volume_Name
    • Qtree
      • Qtree_Key
      • StorageVM_Key
      • Volume_Key
  • The entire UI for the NetApp agent is enhanced to show a more graphical representation of key attributes. According to the new features offered by OnCommand or Active IQ Unified Manager, UI changes are also applicable for existing workspaces of Aggregates, Qtrees, Disks, Volume, and Luns.
  • Each workspace is updated to show its associated list of Events to allow an administrator to know how critical a storage entity is and where the administrative action is required on priority.
  • The Qtree Detail workspace has been deprecated since this release.
  • The Configuration panel is enhanced to accept a port for the OnCommand API Service.
  • Each attribute’s help text is updated to indicate the source of data, whether it is collected from OCUM or OCUM API Services.
  • Agent JRE is upgraded to Java 8.
  • Retry count to limit connection attempts with the data source:
    If the connection fails, add a limit on the number of retries the agent attempts to connect to the data source (OnCommand Unified Manager). The default for retry attempts is 6. This value can be changed by setting the following variable in the agent instance-specific environment file:
    KNU_DATA_PROVIDER_CONNECTION_RETRY_COUNT
    After exhausting the limit of configured connection attempts, if an agent fails to connect to the data source, it will stop attempting to connect and log the following message in the data provider log: 
    NO MORE ATTEMPTS OF CONNECTION; STOPPING THE DATA COLLECTION, TO RESUME MONITORING PLEASE RESTART THE AGENT. TO HAVE MORE ATTEMPT OF CONNECTIONS, RESET THE VALUE OF THE VARIABLE KNU_DATA_PROVIDER_CONNECTION_RETRY_COUNT
Part number: CC8RPEN

Build refresh Date: 20 November 2020
APAR included: IJ28978
Abstract: SDA support for NetApp agent.
Description:
NetApp agent is not defined as a self-describing agent, so the user needs to install the application support manually.

NetApp Agent v7.2 FP3 (ITMfVE Downloadable version 7.2 FP3) (Released 15 June 2015)

The following enhancements were made in this release:
  • New attributes groups
    • Disks
    • Host FCP Targets
    • Qtress
  • New or changed attributes in the following attribute group:
    • Hosts
  • New or changed workspaces
    • Disks
    • Disk Detail
    • Host Detail
    • Host SAN Performance
    • Qtrees
    • Qtree Detail
  • New or changed views
    • FCP Targets    
  • New or changed situations
    • Disks
    • Qtress   
Part Number: CN8C9EN
Latest Interim Fix: 7.2.0.3-TIV-ITM_NETAPP-IF0001 (see Interim Fixes). 
 

Interim Fixes/Fix Pack (on Fix Central)

NetApp Agent v7.1.0-TIV-ITM-NETAPP-IF0001

NetApp Agent v7.2.0.3-TIV-ITM-NETAPP-IF0001

IBM Tivoli Monitoring for Virtual Servers: NetApp 7.3.0.3-TIV-ITM_NETAPP-IF0001

General considerations

NetApp Storage Agent v7.1.0

  • The prerequisite is IBM Tivoli Monitoring V6.2.2 Fix Pack 2 or later.
  • The agent package on Passport Advantage and Extreme Leverage is:
    IBM Tivoli Monitoring for Virtual Environments 7.1 VMware VI, KVM, NetApp Storage, and NMA Agents and Support Files Windows and Linux English (CI56TEN)

Functions of the monitoring agent

The NetApp Storage agent provides the following functions:   

  • Displays the health and performance of NetApp and IBM N series storage systems.
    You can use the NetApp Storage agent to visualize the capacity, latency, and throughput performance metrics of NetApp and IBM N series storage systems.
  • Helps identify poorly performing storage system objects.
    The NetApp Storage agent collects several important performance metrics for four important NetApp storage objects: hosts (filers), aggregates, volumes, and logical unit numbers (LUNs). The agent sorts object lists by performance metrics to show the least healthy or busiest objects at the top; and displays trend graphs of the same performance metrics when showing an object in detail.
  • Interoperates with the VMware VI agent.
    The NetApp Storage agent inter-operates with the IBM Tivoli® Monitoring for Virtual Servers Agent for VMware VI and provides data sharing and workspace linking between the NetApp Storage agent and the VMware VI agent. The detailed workspaces for NFS data stores in the VMware VI agent show detailed data about the related NetApp volume. When you click a link from that VMware VI data store workspace, it takes you to the detailed workspace of the related volume in the NetApp Storage agent.
  • Helps isolate VM guest performance problems.
    You can use the NetApp agent to isolate performance problems in the NetApp storage systems, and with the VMware VI agent, you can see how the storage system problems affect the VM guest performance. Links within the NetApp Storage agent workspaces make it easy to navigate to the hierarchy of the NetApp storage system objects where you can see the status and performance metrics of related objects.
  • Performs discovery and monitoring with the DFM server focal point.
    Each agent instance connects to a single NetApp DFM server. The DFM server discovers the objects in the NetApp storage system. Only one set of user credentials is required to monitor all the objects in the storage system. Further agent instances can monitor extra DFM servers that allow operational monitoring of large NetApp storage installations from a single Tivoli Enterprise Portal.

Common questions

  • How do I change the default port that the NetApp Storage Agent uses to connect to the NetApp(R) DataFabric Manager (DFM) server?

Common problems

  1. Data not displaying in workspaces.
    • If the knu_data_provider_<instance>_0.log has this line: 
      SEVERE: FactoryInterfaceController$3.uncaughtException: Class loading error; cannot continue
      Ensure that manageontap.jar is in the data provider's classpath, then verify that the manageontap.jar file is copied to the agent installation directory (see the User's Guide).
    • Verify that the DFM server user ID and password are correct.
    • Verify that the DFM user has GlobalRead authority.
  2. The NetApp Storage Agent shows objects but not their performance data.
    • Verify that the DFM server is given the user ID and password of each host.
    • Verify that the hosts are configured to collect performance data.
  3. The VMware VI Agent does not show the Volume data on the data store detail workspace.
    • The datastore must be NFS mounted and must be NetApp storage.
    • The NetApp Storage agent's managed system name (MSN) must be supplied in the configuration of the VMware VI agent.
  4. Enabling NetApp agent to work with various protocols configured on OnCommand components:
    https://www.ibm.com/support/pages/node/712261
  5. Configuring NetApp agent to communicate with OnCommand Unified Manager 9.x version.
    https://www.ibm.com/support/pages/node/957471
  6. Netapp Storage Agent reports are not supported on OnCommand Unified Manager (OCUM) Version 6.x and later versions.
    https://www.ibm.com/support/pages/node/6445727

[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SS9U76","label":"Tivoli Monitoring for Virtual Environments"},"ARM Category":[{"code":"a8m50000000CljRAAS","label":"NetApp Storage agent"}],"ARM Case Number":"","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All versions","Edition":"","Line of Business":{"code":"LOB67","label":"IT Automation \u0026 App Modernization"}}]

Document Information

Modified date:
24 December 2024

UID

ibm12801655

Page Feedback