Community

Data ONTAP SMI-S Agent 5.1 - Configure NetApp SMI-S provider with SCVMM 2012 R2 using Virtual Machine Manager PowerShell Cmdlets.

The NetApp Data ONTAP SMI-S Agent allows administrators to manage and monitor NetApp FAS storage systems through open standard protocols and classes defined by two organizations:

 

  • Distributed Management Task Force (DMTF)
  • Storage Networking Industry Association (SNIA)

 

The Data ONTAP Storage Management Initiative Specification (SMI-S) Agent is a command-based interface that detects and manages platforms that run Data ONTAP. SMI-S Agent uses web-based enterprise management (WBEM) protocols, which allow you to manage, monitor, and report on storage elements.

 

Data ONTAP SMI-S Agent 5.1 Features

 

  • Complies with the SMI-S 1.5 and SMI-S 1.6 specifications set by SNIA.

 

  • Manages and monitors NetApp storage systems.

   

    • Support for Data ONTAP 7.3.5 or later for 7-Mode systems.
    • Support for clustered Data ONTAP 8.2.1

 

  • Supports provisioning of SAN and NAS environments for NetApp storage systems using Microsoft SCVMM 2012 R2

 

  • Support for Windows Server 2012 R2

 

  • Copy Offload (ODX) provisioning from SCVMM 2012 R2

 

    • Copy offload provides a mechanism to perform full-file or subfile copies between two directories residing on remote servers, where the server can be same or different. Here, the copy is created by copying data between the servers (or same server if both source and destination files are on same server) without the client reading the data from the source and writing to the destination. This reduces the client/server processor/memory utilization and minimizes network I/O bandwidth. With Windows Server 2012, Microsoft introduces a copy offload mechanism, which allows you to offload the activity of copying files between two servers to the storage system. DATA ONTAP SMI-S 5.1 supports ODX with System Center 2012 R2 and Clustered DATA ONTAP 8.2

 

  • Supports lifecycle indications that monitor SMI-S operations.

 

    • Win2012/R2 client will register for lifecycle indications to monitor create/delete/modify on objects like volume, storage system, LUN, disk, igroup, initiators, lun-map.

 

  • Supports ASUP™ reporting.
    • This feature allows to send ASUP data for the SMI-S host, how many filers are managed by the SMI-S agent etc

 

  • Support for Virtual Fibre Channel Adapters

 

  • Support for IPv6
    • SMI-S 5.1 now supports IPv6 communication between filer - SMIS Agent – SCVMM. Basically, you can add a filer's IPv6 address to SMIS Agent and manage SMIS Agent with SCVMM using it's IPv6 address.

 


Data ONTAP SMI-S Agent can be installed on both Windows® and Linux® platforms. This SMI-S integration is designed to allow end-to-end discovery of logical and physical objects and the associations between them, add capacity to hosts/clusters, and rapidly provision VMs using the SAN and SMB 3.0 protocol.

 

The SMI-S Agent interface can also be used to allow simple tasks to be accomplished using System Center Virtual Machine Manager (SCVMM) to create and deploy new storage to individual hosts or clusters.

 

Compliance to SMI-S standards is defined by the Conformance Test Program set by SNIA. Data ONTAP   SMI-S Agent 5.1 is compliant with SMI-S 1.5 and 1.6 specifications.

 

In Part-1 of this tutorial i will show you steps which can be used to configure the NetApp SMI-S provider with SCVMM using Virtual Machine Manager powershell cmdlets and create storage classifications.

 

If the Windows firewall is enabled on the SMI-S server, then create firewall exceptions to allow the following TCP and UDP ports inbound.

 

  • Data ONTAP SMI-S Agent CIMOM HTTP rule TCP: 5988 inbound (allows SCVMM 2012 to communicate with SMI-S on the SMI-S server via http)
  • Data ONTAP SMI-S Agent CIMOM HTTPS rule TCP:5989 inbound (allows SCVMM 2012 to communicate with SMI-S on the SMI-S server via https)
  • Data ONTAP SMI-S Agent SLP rule UDP:427 inbound (Service Location Protocol (SLP) is used for SMI-S multicast and broadcast discovery )

 

Note: Installing SMI-S Agent on the server in which SCVMM is installed is not supported.

 

The SMI-S Agent can easily be run within another virtual machine because only IP connectivity to the SCVMM/SCOM server and NetApp storage controllers is needed.

 

The SCVMM 2012 server must be installed on a separate physical or virtual server than the SMI-S server, and both servers must be members of the same Active Directory domain.

 

To add storage device in the SCVMM console you would need to install and configure SMI-S Agent.

 

First of all install the Data ONTAP SMI-S agent and make sure the SMIS service is running.

 

Next you would need to add a CIM server user, this would be the local administrator account on the SMI-S server.

Next you would need to add the storage system to the repository using the SMIS command, you would get an error message if the Netapp storage system already exists in SMIS repository.

 

 

  You can verify if SMIS is properly configured via.

 

 

And run a test to show the list of luns or volumes etc.

 

 

Once we install and configure Data ONTAP SMI-S Agent, we will start with the steps to integrate it with SCVMM.

 

Open the Virtual Machine Manager Command Shell in “Run as Administrator” Mode:

 

 

Create a VMM Run as Account for SMI-S, The UserName and Password provided should be as the same credentials as the SMI-S local user account on the NetApp SMI-S server.

 

$Creds = Get-Credential

$RunAsAccount = New-SCRunAsAccount -Name "SMIS-Administrator" -Credential $Creds

 

The first command uses the Get-Credential cmdlet to prompt you to supply a user name and password and stores the credentials in the $Credential variable.

The second command creates a Run As account named SMIS-Administrator using the credentials provided in $Creds.

 

 

Adding NetApp SMI-S provider using HTTP protocol

 

Type in the below set of commands, modify the parameters based on your environment.

 

# Get the SMIS Run As Account.

$RunAsAcct = Get-SCRunAsAccount -Name *smis*

 

# Add the SMI-S Storage Provider to SCVMM console.

  Add-SCStorageProvider –NetworkDeviceName ` "http://cloud2012dc.virtualcloud.com" -TCPPort 5988 -Name "cloud2012dc.virtualcloud.com" -RunAsAccount $RunAsAcct

 

Once executed, the Storage Provider will be available in SCVMM, in Fabric > Storage > Providers.

 

Adding NetApp SMI-S provider using HTTPS protocol with SSL Connection

 

Type in the below set of commands.

 

# Get the SMIS Run As Account.

$RunAsAcct = Get-SCRunAsAccount -Name *smis*

 

 

# Get the Certificate Details.

$CRT = Get-SCCertificate -Computername "cloud2012dc.virtualcloud.com" -TCPPort 5989

 

 

# Add the SMI-S Storage Provider to SCVMM console.

Add-SCStorageProvider –NetworkDeviceName ` "https://cloud2012dc.virtualcloud.com" -TCPPort 5989 -Name "cloud2012dc.virtualcloud.com" -RunAsAccount $RunAsAcct

 

It is recommended to use HTTPS protocol, enable Secure Sockets Layer (SSL)  for secure communication between the storage controller and the SMI-S Agent.

 

Importing the Data ONTAP SMI-S Agent for NetApp and create storage classifications.

 

#Shows the StorageSubSystems objects which are registered with SMI-S and also verifies the operational status

Get-StorageSubSystem

 

#Import storage providers that are installed and registered on a VMM management server.

Import-SCStorageProvider

 

#Refreshes all the cache for the storage provider and associated child objects.

Update-StorageProviderCache

 

#Create Storage Classifications. A storage classification defines the capabilities of a storage pool. For example, a classification of Gold could be associated with storage pools that have the highest performance and availability.

New-SCStorageClassification -Name "Platinum" -Description "SSD Disks" -RunAsynchronously

 

 

I hope that you have enjoyed this blog entry  and have found this information helpful.

 

In the next series of blogs i would be talking about various use cases and powershell scripts which can be used to utilize  SCVMM - Data ONTAP SMI-S integration for effective Hyper-V storage management. Some of these include SCVMM Rapid Provisioning using SAN Copy (NetApp Flexclone), Provisioning CIFS shares for Hyper-V over SMB 3.0, Leverage SCVMM 2012 R2 Offload Data Transfer feature for VM Rapid Provisioning using SCVMM.

 

Good Luck !

 

Thanks,

Vinith

 

 

 

Comments
NetApp Employee on ‎2014-01-29 07:20 AM

This is so cool.

on ‎2014-03-03 08:02 AM

Hello,

I am trying to follow your guide, but I am getting errors, after I create the local user, when I try to register the filer, it gives back an error because the syntax is:

Add storage device(s)

"smis add <storage_device> <storage_device_user> [-t http|https]"

and you are using another syntax.

The SMI-S version we have is

C:\Program Files (x86)\Ontap\smis\pegasus\bin>smis.cmd version

ONTAP_SMIAgentSoftware.InstanceID="ONTAP:5.1"

Thank you

vinith Former NetApp Employee on ‎2014-03-03 08:08 AM

Hello Miguel,

Please  use the below syntax to add a 7-mode / C-mode controller.

smis addsecure 10.238.190.14 root netapp1!

smis addsecure 10.238.190.86 vsadmin netapp1!

on ‎2014-03-05 04:20 AM

Hello,

We installed it on a different VM and it worked, there must be something wrong with the other VM.

Now we are wondering if we can install it on a VM that has only the VMM (Virtual Machine Manager) console installed, this VM is different from the VMM server. Is this supported or does the SMI-S agent need to be installed on a VM totally different from any VMM component?

Thank you and regards

vinith Former NetApp Employee on ‎2014-03-05 05:53 AM

SMI-S agent need to be installed on a VM totally different from any VMM component, installation on the server where andy of VMM components are installed in not supported

on ‎2014-03-10 07:28 AM

Hello Vinith,

Finally got it working, thank you. How do I see igroups on the filers are mapped to the iSCSI names on the Hyper-V. I tried to mapp luns but I get errors that say that the hosts are not getting connected even though through SD all LUNs are mapped to individual igroups.

Another question, can you increase a LUN using the SMI-S Agent, I can't seem to figure out how to do this task.

Thank you and regards

vinith Former NetApp Employee on ‎2014-03-11 10:05 AM

Hello Miguel, Once you configure SMI-S connectivity with SCVMM you need to add the iscsi arrays to individual Hyper-V hosts and then proceed with LUN provisioning, no you cannot increase the LUN size with SCVMM-SMI-S integration. Please check my other series of blogposts for configuration related queries. https://communities.netapp.com/community/netapp-blogs/msenviro/blog/2014/02/15/data-ontap-smi-s-agent-51--use-netapp-smi-s-provider-for-hyper-v-hosts-...

on ‎2014-03-17 06:33 PM

Hello Vinith,

I'm having error below when adding storageprovider.

PS C:\Users\Administrator> Add-SCStorageProvider -NetworkDeviceName "<mydevicename>" -TCPPort

5988 -Name "name" -RunAsAccount $RunAsAcct

Add-SCStorageProvider : Cannot convert 'System.Object[]' to the type

'Microsoft.SystemCenter.VirtualMachineManager.RunAsAccount' required by parameter 'RunAsAccount'. Specified method is

not supported.

At line:1 char:157

+ ...  -RunAsAccount $RunAsAcct

+                    ~~~~~~~~~~

    + CategoryInfo          : InvalidArgument: (Smiley Happy [Add-SCStorageProvider], ParameterBindingException

    + FullyQualifiedErrorId : CannotConvertArgument,Microsoft.SystemCenter.VirtualMachineManager.Cmdlets.AddSCStorageP

   roviderCmdlet

Many thanks,

on ‎2014-03-18 01:22 AM

Hello,

You could create the RunAsAccount on the GUI, it is quite simple and then

just call that account on the powershell

Regards

De: Guest <xdl-communities@communities.netapp.com>

Para: Miguel Maldonado <miguelenrique.maldonado@es.logicalis.com>

Fecha: 18/03/2014 02:34

Asunto: Re: - Data ONTAP SMI-S Agent

5.1 - Configure NetApp SMI-S provider with SCVMM 2012 R2 using Virtual

Machine Manager PowerShell Cmdlets.

Data ONTAP SMI-S Agent 5.1 - Configure NetApp SMI-S provider with SCVMM

2012 R2 using Virtual Machine Manager PowerShell Cmdlets.

new comment by Guest - View all comments on this blog post

Hello Vinith,

I'm having error below when adding storageprovider.

PS C:\Users\Administrator> Add-SCStorageProvider -NetworkDeviceName

"" -TCPPort

5988 -Name "name" -RunAsAccount $RunAsAcct

Add-SCStorageProvider : Cannot convert 'System.Object[]' to the type

'Microsoft.SystemCenter.VirtualMachineManager.RunAsAccount' required by

parameter 'RunAsAccount'. Specified method is

not supported.

At line:1 char:157

+ ... -RunAsAccount $RunAsAcct

+ ~~~~~~~~~~

+ CategoryInfo : InvalidArgument: (

, ParameterBindingException

+ FullyQualifiedErrorId :

CannotConvertArgument,Microsoft.SystemCenter.VirtualMachineManager.Cmdlets.AddSCStorageP

roviderCmdlet

Many thanks,

Reply to this email to respond to Guest's comment.

ADVERTENCIA LEGAL Este mensaje va dirigido, de manera exclusiva, a su destinatario y contiene información confidencial y sujeta al secreto profesional, cuya divulgación no esta permitida por la ley. En caso de haber recibido este mensaje por error, le rogamos que, de forma inmediata, nos lo comunique mediante correo electrónico remitido a nuestra atención o a través del teléfono (+ 34) 91 766 90 69 y proceda a su eliminación, así como a la de cualquier documento adjunto al mismo. Asimismo, le comunicamos que la distribución, copia o utilización de este mensaje, o de cualquier documento adjunto al mismo, cualquiera que fuera su finalidad, están prohibidas por la ley. Le informamos, como destinatario de este mensaje, que el correo electrónico y las comunicaciones por medio de Internet no permiten asegurar ni garantizar la confidencialidad de los mensajes transmitidos, así como tampoco su integridad o su correcta recepción, por lo que el emisor no asume responsabilidad alguna por tales circunstancias. Si no consintiese en la utilización del correo electrónico o de las comunicaciones vía Internet le rogamos nos lo comunique y ponga en nuestro conocimiento de manera inmediata. Logicalis Spain se refiere a Logicalis Group, (prívate company limited by guarantee, de acuerdo con la legislación del Reino Unido) y a su red de delegaciones, cada una de las cuales es una entidad independiente. En www.logicalis.com se ofrece una descripción detallada de la estructura legal de Logicalis Groups y sus delegaciones. PRIVILEGED AND CONFIDENTIAL This message is intended exclusively for the person to whom it is addressed and contains privileged and confidential information protected from disclosure by law. If you are not the addressee indicated in this message, you should immediately delete it and any attachments and notify the sender by reply e-mail or by phone (+ 34 91 766 90 69). In such case, you are hereby notified that any dissemination, distribution, copying or use of this message or any attachments, for any purpose, is strictly prohibited by law. We hereby inform you, as addressee of this message, that e-mail and Internet do not guarantee the confidentiality, nor the completeness or proper reception of the messages sent and, thus, the sender does not assume any liability for those circumstances. Should you not agree to the use of e-mail or to communications via Internet, you are kindly requested to notify us immediately. Logicalis Spain refers to one or more of Logicalis Group, a UK private company limited by guarantee, and its network of regional locations, each of which is a legally separate and independent entity. Please see www.logicalis.com for a detailed description of the legal structure of Logicalis Group and its regional locations.

on ‎2014-07-25 08:25 AM

Hi Team

Can some one help me with the documentation of the set of classes and profiles supported by the Data ONTAP SMI-S agent and Data ON TAP Cluster mode. Much appreciate your help.

Sirisha

on ‎2014-08-29 01:59 AM

Hi,

Very great article !!!

Just a comment for french users, with french Windows : the command "smis add "filer_ip_addr" won't work...

You can try :

cimcli ci -n root/ontap ONTAP_FilerData hostName="filer_ip_addr" userName=root password="P@ssw@rd" port=443 comMechanism=HTTPS -u "smis_user" -p "P@ssw@rd"

in 7-Mode.

Ludovic