NetApp Active IQ Unified Manager

Application Version and Upgrade Details

Introduction

NetApp Active IQ Unified Manager

NetApp® OnCommand® Unified Manager is a graphical management product that provides comprehensive monitoring and key management capabilities for NetApp ONTAP® systems to help manage the availability, capacity, protection, and performance risks of your storage systems.

You can deploy Unified Manager on a Linux server, on a Windows server, or as a virtual appliance on a VMware host.

Storage resources in a 2-node cluster:

Physical storage resources

Refers to the physical storage objects provided by ONTAP. Physical storage resources include disks, clusters, storage controllers, nodes, and aggregates.

Logical storage resources

Refers to the storage resources provided by ONTAP that are not tied to a physical resource. These resources are associated with a storage virtual machine (SVM, formerly known as Vserver), and they exist independently of any specific physical storage resource such as a disk, array LUN, or aggregate.

Cluster

A cluster consists of one or more nodes grouped together as (HA pairs) to form a scalable cluster. Creating a cluster enables the nodes to pool their resources and distribute work across the cluster, while presenting administrators with a single entity to manage. Clustering also enables continuous service to end users if individual nodes go offline.

Node

A node is a controller in a cluster. It is connected to other nodes in the cluster over a private management cluster network. It is also connected to the disk shelves that provide physical storage for the Data ONTAP system or to third-party storage arrays that provide array LUNs for Data ONTAP use.

Volume

Volumes are data containers that enable you to partition and manage your data. Understanding the types of volumes and their associated capabilities enables you to design your storage architecture for maximum storage efficiency and ease of administration.

Volumes are the highest-level logical storage object. Unlike aggregates, which are composed of physical storage resources, volumes are completely logical objects.

Aggregate

An aggregate is a collection of disks (or partitions) arranged into one or more RAID groups. It is the most basic storage object within ONTAP and is required to allow for the provisioning of space for connected hosts.

SVM

Storage Virtual Machines (SVMs) contain data volumes and one or more LIFs (logical interfaces) through which they serve data to the clients.

A cluster can have one or more SVMs with FlexVol volumes and SVMs with Infinite Volume.

Namespace

A namespace is a logical grouping of volumes that are joined together at junction points to create a single, logical file system that derives from the Storage Virtual Machine (SVM) root volume. Each SVM has a namespace.

Prerequisites

• OpsRamp Classic Gateway 14.0.0 and above.
• OpsRamp NextGen Gateway 14.0.0 and above.
  Note: OpsRamp recommends using the latest Gateway version for full coverage of recent bug fixes, enhancements, etc.
• Hardware: VMware ESXi with 2 VMs - Memory 8GB , CPU’s 2 No’s, Hard Disk 50 GB for each VM.
• Software: ONTAP Simulator 9.8 & Active IQ Unified manager 9.9- Available.

Resource Hierarchy

 NetApp Active Iq Unified Manager

 NetApp Cluster

     → Cluster Nodes
        → Aggregates
        → Storage Ports
        → Ethernet Ports
               → Logical Interfaces(LIF’s)
        → FCP Adapters
               → FC Interfaces
      → Storage Virtual Machine/SVM
         → Storage Volumes
            → Storage Luns
            → QTrees
               → Disks
         → Shelves

Application Migration

1. As per the prerequisite step, check for the gateway version as - classic gateway-12.0.1 and above.
   Notes:
   • To migrate from sdk 1.0 to sdk 2.0 follow these steps. Note: For first time installation below steps are not required.
     • Application name should be the same.
     • Disable all installed integrations configurations for that application. This is to make sure no discovery and monitoring requests are processed.
     • Install and add the configuration to that sdk 2.0 application.
       Note: refer to Configure and Install the Netapp ActiveIQ Unified Manager Integration & View the NetApp ACTIVE IQ details sections of this document.
2. Once all discoveries are completed with the sdk 2.0 application, follow any one of the approaches.

• Direct uninstallation of the sdk 1.0 adaptor application through the uninstall API with skipDeleteResources=true in the post request.

End-Point:

https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}

Request Body:

    {
        "uninstallReason": "Test",
        "skipDeleteResources": true
     }

(OR)

• Delete the configuration one by one through the Delete adaptor config API with the request parameter as skipDeleteResources=true

End-Point: https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/config/{configId}?skipDeleteResources=true.

• Finally, uninstall the adaptor application through API with skipDeleteResources=true in the post request.

End-Point:

https://{{host}}/api/v2/tenants/{tenantId}/integrations/installed/{installedIntgId}

Request Body:

    {
        "uninstallReason": "Test",
        "skipDeleteResources": true
    }

Supported Metrics

Default Monitoring Configurations

NetApp Active IQ Unified Manager application has default Global Device Management Policies, Global Templates, Global Monitors and Global metrics in OpsRamp. You can customize these default monitoring configurations as per your business use cases by cloning respective Global Templates and Global Device Management Policies. OpsRamp recommends performing this activity before installing the application to avoid noise alerts and data.

1. Default Global Device Management Policies

   OpsRamp has a Global Device Management Policy for each Native Type of NetApp Active IQ Unified Manager. You can find those Device Management Policies at Setup > Resources > Device Management Policies, search with suggested names in global scope. Each Device Management Policy follows below naming convention:

   {appName nativeType - version}

   Ex: netapp-active-iq-unified-manager NetApp Cluster - 1 (i.e, appName = netapp-active-iq-unified-manager, nativeType = NetApp Cluster, version = 1)

2. Default Global Templates

   OpsRamp has a Global Templtemplate for each Native Type of NetApp Active IQ Unified Manager. You can find those templates at Setup > Monitoring > Templates, search with suggested names in global scope. Each template follows below naming convention:

   {appName nativeType 'Template' - version}

   Ex: etapp-active-iq-unified-manager NetApp Cluster Template - 1 (i.e, appName = netapp-active-iq-unified-manager, nativeType = NetApp Cluster, version = 1)

3. Default Global Monitors

   OpsRamp has a Global Monitors for each Native Type which has monitoring support. You can find those monitors at Setup > Monitoring > Monitors, search with suggested names in global scope. Each Monitors follows below naming convention:

   {monitorKey appName nativeType - version}

   Ex: NetApp AIQM Cluster Monitor netapp-active-iq-unified-manager NetApp Cluster 1 (i.e, monitorKey = NetApp AIQM Cluster Monitor, appName = netapp-active-iq-unified-manager, nativeType = NetApp Cluster, version = 1)

Configure and Install the Netapp ActiveIQ Unified Manager Integration

1. From All Clients, select a client.
2. Navigate to Setup > Account.
3. Select the Integrations and Apps tab.
4. The Installed Integrations page, where all the installed applications are displayed. If there are no installed applications, it will navigate to the Available Integrations and Apps page.
5. Click + ADD on the Installed Integrations page. The Available Integrations and Apps page displays all the available applications along with the newly created application with the version.
   Note: Search for the application using the search option available. Alternatively, use the All Categories option to search.

6. Click ADD in the Netapp ActiveIQ Unified Manager application.
7. In the Configurations page, click + ADD. The Add Configuration page appears.
8. Enter the below mentioned BASIC INFORMATION

Notes:

• By default the Is Secure checkbox is selected.
• IP Address/Host Name and Port Should be accessible from Gateway.
• App Failure Notifications: if turned on, you will be notified in case of an application failure that is, Connectivity Exception, Authentication Exception.
• Alert Configuration: map alert configuration for third party alerts into OpsRamp.
• Alert On Root Resource: Alerts generated on root resource.
• Below are the default values set for:
  • Alert Severity: possible values of Alert Severity Filter configuration property are new,obsolete,acknowledged,resolved.
  • Alert Severity Mapping: possible values of Alert Severity Mapping Filter configuration property are “new”:{“critical”: “Critical”,“error”: “Critical”,“warning”: “Warning”,“information”: “Info”,“normal”: “Info”},“acknowledged”: {“critical”: “Critical”,“error”: “Critical”,“warning”: “Warning”,“information”: “Info”,“normal”: “Info”},“obsolete”: {“critical”: “Ok”,“error”: “Ok”,“warning”: “Ok”,“information”: “Ok”,“normal”: “Ok”},“resolved”: {“critical”: “Ok”,“error”: “Ok”,“warning”: “Ok”,“information”: “Ok”,“normal”: “Ok”}.

9. Select the below mentioned Custom Attribute:

Note: The custom attribute that you add here will be assigned to all the resources that are created by the integration. You can add a maximum of five custom attributes (key and value pair).

10. In the RESOURCE TYPE section, select:
    • ALL: All the existing and future resources will be discovered.
    • SELECT: You can select one or multiple resources to be discovered.
11. In the DISCOVERY SCHEDULE section, select Recurrence Pattern to add one of the following patterns:
    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly
12. Click ADD.

Now the configuration is saved and displayed on the configurations page after you save it.
Note: From the same page, you may Edit and Remove the created configuration.

13. Click NEXT.
14. Below are the optional steps you can perform on the Installation page.

• Under the ADVANCED SETTINGS, Select the Bypass Resource Reconciliation option, if you wish to bypass resource reconciliation when encountering the same resources discovered by multiple applications.

  Note: If two different applications provide identical discovery attributes, two separate resources will be generated with those respective attributes from the individual discoveries.

• Click +ADD to create a new collector by providing a name or use the pre-populated name.

15. Select an existing registered profile.

16. Click FINISH.

The application is now installed and displayed on the INSTALLED INTEGRATION page. Use the search field to find the installed application.

Modify the Configuration

• See Modify an Installed Integration or Application article.

  Note: Select the NetApp Active IQ Unified Manager application.

View the NetApp Active IQ details

The discovered resource(s) are displayed in Infrastructure > Resources > Storage > NetApp Cluster > Resources. You can navigate to the Attributes tab to view the discovery details, and Metrics tab to view the metric details for NetApp Active IQ.

View resource metrics

To confirm NetApp Active IQ monitoring, review the following:

• Metric graphs: A graph is plotted for each metric that is enabled in the configuration.
• Alerts: Alerts are generated for metrics that are configured as defined for integration.

Resource Filter Input keys

NetApp Active Iq Unified Manager application Resources are filtered and discovered based on below keys

Supported Alert Custom Macros

Customize the alert subject and description with below macros then it will generate alert based on customisation.

Supported macros keys:

Risks, Limitations & Assumptions

• Application can handle Critical/Recovery failure notifications for below two cases when user enables App Failure Notifications in configuration
  • Connectivity Exception
  • Authentication Exception
• Application will not send any duplicate/repeat failure alert notification until the already existing critical alert is recovered.
• Using metrics for monitoring the resources and generating alerts when the threshold values are breached.
• Application cannnot control monitoring pause/resume actions based on above alerts
• NetApp Active Iq Unified Manager Event/AlertPolling will be started only if the user enables App Failure Notifications in configuration.
• Possible values of Alert Severity Filter configuration property are warning, critical and error.
• OpsRamp has given sample mappings to map NetApp Active Iq Unified Manager Severity with OpsRamp Severities as part of the Event/Alert Severity Mapping configuration file.

• This application supports both Classic Gateway and NextGen Gateway.
• No support of showing activity logs.
• The Template Applied Time will only be displayed if the collector profile (Classic and NextGen Gateway) is version 18.1.0 or higher.

References

NetApp-Active-IQ - version 9.9 (Sample responses from Swagger)

Swagger Link: https://library.netapp.com/ecmdocs/ECMLP2876865/html/index.html#/datacenter/metrics_svm_get_by_key