Supported Versions
Target device version 12.3.X
REST API version using 12.3.X

Introduction

NetApp SolidFire overview

SolidFire storage is an interconnection of hardware and software designed for complete automation and management of an entire SolidFire storage system.

NetApp SolidFire Architecture:

The following diagram shows the basic layout of the SolidFire Storage System and how it connects to a network:

Cluster, Nodes, and Drives

Cluster

A cluster is the hub of a SolidFire Storage System and is made up of a collection of nodes. You must have at least four nodes in a cluster (five or more nodes are recommended) in order for SolidFire storage efficiencies to be realized. A cluster appears on the network as a single logical group and can then be accessed as block storage.

Creating a new cluster initializes a node as communications owner for a cluster and establishes network communications for each node in the cluster. This process is performed only once for each new cluster.

One can increase the scalability of the cluster by additional nodes upto 100. Adding additional nodes doesn’t cause any interruption of the service and the cluster automatically uses the performance and capacity of the new node.

The following diagram illustrates the basic Ip Address layout for the cluster.

Administrators and hosts can access the cluster using virtual IP addresses. Any node in the cluster can host the virtual IP addresses. The Management Virtual IP (MVIP) enables cluster management through a 1GbE connection, while the Storage Virtual IP (SVIP) enables host access to storage through a 10GbE connection.

These virtual IP addresses enable consistent connections regardless of the size or makeup of a SolidFire cluster. If a node hosting a virtual IP address fails, another node in the cluster begins hosting the virtual IP address.

Nodes

Nodes are individual hardware components that are grouped into a cluster to be accessed as block-storage. There are two types of nodes in the SolidFire Storage system. They are Storage Nodes and Fibre-Channel Nodes.

Storage Nodes

A SolidFire storage node is a server containing a collection of drives that communicate with each other through the Bond10G network interface. Drives in the node contain block and metadata space for data storage and data management.

Storage nodes have the following characteristics:

  • Each node has a unique name. If a node name is not specified by an administrator, it defaults to SF-XXXX, where XXXX is four random characters generated by the system.
  • Each node has its own high-performance non-volatile random access memory (NVRAM) write cache to improve overall system performance and reduce write latency.
  • Each node is connected to two networks, storage and management, each with two independent links for redundancy and performance. Each node requires an IP address on each network.
  • You can create a cluster with new storage nodes, or add storage nodes to an existing cluster to increase storage capacity and performance.
  • You can add or remove nodes from the cluster at any time without interrupting service.

Fibre Channel(FC) Nodes

SolidFire Fibre Channel nodes provide connectivity to a Fibre Channel switch, which you can connect to Fibre Channel clients. Fibre Channel nodes act as a protocol converter between the Fibre Channel and iSCSI protocols; this enables you to add Fibre Channel connectivity to any new or existing SolidFire cluster.

Fibre Channel nodes have the following characteristics:

  • Fibre Channel switches manage the state of the fabric, providing optimized interconnections.
  • The traffic between two ports flows through the switches only; it is not transmitted to any other port.
  • Failure of a port is isolated and does not affect operation of other ports.
  • Multiple pairs of ports can communicate simultaneously in a fabric.

Drives

A storage node contains one or more physical drives that are used to store a portion of the data for the cluster. The cluster utilizes the capacity and performance of the drive after the drive has been successfully added to a cluster.

A storage node contains two types of drives:

  1. Volume metadata drives- volume metadata drives store the compressed information that defines each volume, clone, or snapshot within a cluster. The total metadata drive capacity in the system determines the maximum amount of storage that can be provisioned as volumes. The maximum amount of storage that can be provisioned is independent from how much data is actually stored on the block drives of the cluster. Volume metadata drives store data redundantly across a cluster using Double Helix data protection.

    Note: Some system event log and error messages refer to volume metadata drives as slice drives.

  2. Block drives- block drives store the compressed, de-duplicated data blocks for server application volumes. Block drives make up a majority of the storage capacity of the system. The majority of read requests for data already stored on the SolidFire cluster, as well as requests to write data, occur on the block drives. The total block drive capacity in the system determines the maximum amount of data that can be stored, taking into account the effects of compression, thin provisioning, and de-duplication.

SolidFire Element OS Features

The SolidFire Element Operating System (OS) comes preinstalled on each node. SolidFire Element OS includes the following features:

  • SolidFire Helix™ self-healing data protection
  • Always on, inline, real-time deduplication
  • Always on, inline, real-time compression
  • Always on, inline, reservation-less thin provisioning
  • Fibre Channel node integration
  • Management Node
  • LDAP capability for secure login functionality
  • Guaranteed volume level Quality of Service (QoS): Minimum IOPS, Maximum IOPS, IOPS burst control
  • nstant, reservation-less deduplicated cloning
  • Volume snapshots: i) Snapshots of individual volumes, ii) Scheduling snapshots of a volume or group of volumes, iii) Consistent snapshots of a group of volumes, iv) Cloning multiple volumes individually or from a group snapshot
  • Integrated Backup and Restore for volumes
  • Real-Time Replication for clusters and volumes
  • Native multi-tenant (VLAN) management and reporting: i) Virtual Routing and Forwarding (VRF), ii) Tagged Networks
  • Proactive Remote Monitoring through Active IQ
  • Complete REST-based API management
  • Granular management access/role-based access control
  • Virtual Volumes (VVols) support for VMware® vSphere®
  • Volume and system level performance and data usage reporting
  • VASA support
  • VMware vSphere® (VAAI) support

Use Cases

Discovery Use Cases:

  • Provides resource visibility to the administrator to view and manage resources available (Ex: Cluster, Nodes, Drives, Volume Accounts and Volumes) under different resource types
  • Publishes relationships between resources to have a topological view and ease of maintenance

Monitoring Use Cases:

  • Provides metrics related to Memory Utilization, Performance Utilization and so on for different resources
  • Concern alerts will be generated for each metric to notify the administrator regarding the issue with the resource

Resource Hierarchy:

Cluster
— Nodes
    — Drive
— Volumes Accounts
    — Volumes

Pre-requisites

  • Classic gateway version should be equal or greater than 13.0.1.

Default monitoring configurations

NetApp SolidFire 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 the below activity before installing the app 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 SolidFire. 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-solidfire NetApp SolidFire Cluster - 1 (i.e, appName = netapp-solidfire, nativeType = NetApp SolidFire Cluster, version = 1)

  2. Default Global Templates

    OpsRamp has a Global Template for each Native Type of NetApp SolidFire. We 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: netapp-solidfire NetApp SolidFire Cluster Template - 1 (i.e, appName = netapp-solidfire, nativeType = NetApp SolidFire Cluster, version = 1)

  3. Default Global Monitors

    OpsRamp has a Global Monitors for each Native Type which has monitoring support. We 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: SolidFire Cluster Monitor netapp-solidfire NetApp SolidFire Cluster 1 (i.e, monitorKey = SolidFire Cluster Monitor, appName = netapp-solidfire, nativeType = NetApp SolidFire Cluster, version = 1)

Application Migration

  1. Check for the gateway version as a prerequisite step - classic gateway-12.0.1 and above.
    Notes:

    • You only have to follow these steps when you want to migrate from sdk 1.0 to sdk 2.0.
    • 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 integration & View the Netapp SolidFire details sections of this document.
  2. Once all discoveries are completed with the sdk 2.0 applicaion, follow any one of the approaches.

    • Direct uninstallation of the sdk1.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
}

Configure and install the integration

  1. From All Clients, select a client.
  2. Go to Setup > Integrations and Apps > Integrations.
  3. Click Manage Apps.
    Notes:
    • If there are already installed applications, it will redirect to the INSTALLED APPS page where all the installed applications are displayed.
    • If there are no installed applications, it will navigate to the ADD APP page.
NetApp Solidfire
  1. Click + ADD on the INSTALLED APP page. The ADD APP page displays all the available applications along with the newly created application with the version.
    Note: You can even search for the application using the search option available. Also you can use the All Categories option to search
NetApp Solidfire
  1. Click ADD in the netapp-solidfire application.
  2. In the Configurations page, click + ADD. The Add Configuration page appears.
  3. Enter the below mentioned BASIC INFORMATION:
Object NameDescription
NameEnter the name for the integration
IP Address/Host NameIP address/host name of the target.
PortPort

Note: Default port is 443
CredentialsSelect the credentials from the drop-down list.

Note: Click + Add to create a credential.

Notes:

  • By default the Is Secure checkbox is selected.
  • Select the following:
    • App Failure Notification: if turned on, you will be notified in case of an application failure.
    • Event Polling: enables integrating third party alerts into OpsRamp using further configurations.
    • Alert On Root Resource: alerts generated by on root resource
  • Below are the default values set for:
    • Alert Severity: Possible values of Alert Severity Filter configuration property are warning, critical, error.
    • Alert Severity Mapping: Possible values of Alert Severity Mapping Filter configuration property are “critical":“Critical”, “error”:“Critical”, “warning”:“Warning”.
  1. In the Custom Attributes section, select the custom attribute key and value from the dropdown boxes.
    Note:
    • The custom attribute that you add here will be assigned to all the resources that are created by the configuration.
    • You can add a maximum of 5 custom attributes (key and value pair).
    • The custom attribute that you add should be created at the client level.
  2. 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.
  3. In the DISCOVERY SCHEDULE section, select Recurrence Pattern to add one of the following patterns:
    • Minutes
    • Hourly
    • Daily
    • Weekly
    • Monthly
  4. 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.

  1. Click NEXT
  2. In the Installation page, select an existing registered gateway profile, and click FINISH.
NetApp Solidfire

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

Modify the Configuration

View the NetApp SolidFire details

To view the resource information, go to Infrastructure > Resources > Storage >NetApp Cluster and click on your created cluster name. You can navigate to the Attributes tab to view the discovery details, and Metrics tab to view the metric details for NetApp SolidFire.

NetApp Solidfire
NetApp Solidfire

View resource attributes

The discovered resource(s) are displayed under Attributes. In this page you will get the basic information about the resources such as: Resource Type, Native Resource Type, Resource Name, IP Address etc.

NetApp Solidfire

View resource metrics

To confirm NetApp SolidFire 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.
NetApp Solidfire

Resource Filter Input keys

NetApp SoldFire app Resources are filtered and discovered based on below keys.

Resource TypeResource Type
All TypesresourceName
hostName
aliasName
dnsName
ipAddress
macAddress
os
make
model
serialNumber
NetApp SolidFire ClusterCluster UniqueID
Storage Virtual Ip
Management Interface Ip
Storage Interface Ip
MVIP Vlan Tag
SVIP Vlan Tag
Cluster Nodes Ips
NetApp SolidFire NodeNode ID
Storage Ip
Management Interface Ip
Storage Interface Ip
Role
Chassis Type
Node Type
NetApp SolidFire Volume AccountVolume Ids
Account Id
NetApp SolidFire VolumeVolume ID
IQN
Scsi EUI DeviceID
Scsi NAA DeviceID
Volume Consistency GroupUUID
Remote VolumeID
Remote VolumeName

Supported Metrics

ComponentMetric NameMetric Display NameUnits
Clustersolidfire_cluster_ReadsSolidFire Cluster ReadOpsrops
solidfire_cluster_WritesSolidFire Cluster WriteOpswops
solidfire_cluster_ReadBytesSolidFire Cluster ReadBytesBps
solidfire_cluster_WriteBytesSolidFire Cluster WriteBytesBps
solidfire_cluster_PercentageUtilizationSolidFire Cluster Utilization Percentagepercent
solidfire_cluster_TotalCapacitySolidFire Cluster Total CapacityGB
solidfire_cluster_UsedCapacitySolidFire Cluster Used CapacityGB
solidfire_cluster_ClusterPairStatusSolidFire Paired Cluster Status
Nodessolidfire_node_ClusterBytesInNode Cluster Bytes InBps
solidfire_node_ClusterBytesOutNode Cluster Bytes OutBps
solidfire_node_ClusterNetworkUtilizationCluster Network Utilizationpercent
solidfire_node_StorageNetworkUtilizationStorage Network Utilizationpercent
solidfire_node_StorageBytesInNode Storage Bytes InBps
solidfire_node_StorageBytesOutNode Storage Bytes OutBps
solidfire_node_MgmtBytesInNode Management Bytes InBps
solidfire_node_MgmtBytesOutNode Management Bytes OutBps
solidfire_node_CpuUtilizationNode CPU Utilizationpercent
solidfire_node_UsedMemoryNode Memory UsedGB
Volumessolidfire_volume_account_StatusSolidFire Volume Account Status
solidfire_volume_ReadsSolidFire Volume Readsrops
solidfire_volume_WritesSolidFire Volume Writeswops
solidfire_volume_ReadBytesSolidFire Volume Read BytesBps
solidfire_volume_WriteBytesSolidFire Volume Write BytesBps
solidfire_volume_ReadLatencySolidFire Volume Read Latencymicrosec
solidfire_volume_WriteLatencySolidFire Volume Write Latencymicrosec
solidfire_volume_PercentageUtilizationSolidFire Volume Utilization Percentagepercent
solidfire_volume_UnalignedWritesSolidFire Volume Unaligned Writeswps
solidfire_volume_UnalignedReadsSolidFire Volume Unaligned Readsrps
solidfire_volume_snapshot_TotalSizeSolidFire Volume Snapshot TotalSizeGB
solidfire_volume_snapshot_StatusSolidFire Volume Snapshot Status
solidfire_volume_ReplicationStatusSolidFire Remote Volume Replication Status
solidfire_volume_TotalCapacitySolidFire Volume Total CapacityGB
solidfire_volume_StatusSolidFire Volume Status
Storage Drivessolidfire_drive_TotalCapacitySolidFire Drive Total CapacityGB
solidfire_drive_UsedCapacitySolidFire Drive Used CapacityGB
solidfire_drive_UsedMemorySolidFire Drive Used MemoryGB
solidfire_drive_StatusSolidfire Drive Status

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.
  • SolidFire Event/Alert Polling will be started only if the user enables Event Polling in configuration.
  • Possible values of Alert Severity Filter configuration property are warning, critical and error.
  • OpsRamp has given sample mappings to map SolidFire Severity with OpsRamp Severities as part of the Event/Alert Severity Mapping configuration file. Users can modify them as per their use-case at any point of time from the SDK application configuration page. Possible OpsRamp Severities are Critical, Warning, Ok, Info.
  • In NetApp Solidfire is not getting the resource name for drive resources. So we have given the drive resource name as a combination of driveId, nodeId and chassis-slotExample : 1.1.1(driveId.nodeId.chassis-slot).
  • This application supports only Classic gateway. Not supported with Cluster gateway.
  • Component level thresholds can be configured on each resource level.
  • No support of showing activity log and applied time.
  • No support for the option to get Latest snapshot metric.