1. Home
  2. Knowledge Base
  3. Documentation
  4. NetAppDocs Data Collection

Please review the following and the necessary syntax to collect data from either your NetApp 7-Mode or Clustered Data ONTAP system(s).  The steps provided will generate compressed XML files that can be uploaded to Red8 to be parsed and have documentation generated. All processing occurs on the Windows workstation where these commands are executed and no performance load will occur on your NetApp system.

Requirements & Setup

To use, make sure that your workstation meets the following requirements (click the links to download those items).  Please note that both the NetApp Data ONTAP PowerShell Toolkit and NetAppDocs-Lite are updated periodically and that you should always download and use the latest versions:

Your NetApp controller(s) should be running any of the following:

  • Data ONTAP 7.2.x, 7.3.x, 8.0.x (7-Mode), 8.1.x, 8.2.x, 8.3.x, 9.x

After you have installed the above, run PowerShell in administrator mode (Right-click on PowerShell and select Run as Administrator).  Once in PowerShell, the following command only needs to be entered once (persistent across PowerShell launches):

PS C:> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned

Respond Yes and proceed.  The next command must be entered every time you start a PowerShell instance (non-persistent):

PS C:> Import-Module NetAppDocs-Lite

DATA Collection

Presuming that the root (7-Mode) or admin (cDOT) credentials are the same across all systems, the next command will cache the login and store in a variable for use in the data collection. Alternatively, you can use your Active Directory domain credentials, provided that AD authentication has been properly established for your system(s).  If using domain credentials, use the syntax NetBIOS Domain Name\User Name (i.e. – AD\JohnDoe).

PS C:> $Credentials = Get-Credential

The next command will collect data from the cluster(s) specified and generate separate XML files for each.  This syntax assumes the presence of a C:\Output directory.  If not present, either create the directory or substitute with the output directory of your choice.

NOTE: If the cluster name(s) does not work then use the cluster management IP address(es). Likewise, for 7-Mode, if the hostnames do not work then use the IP address of the controllers.

7-Mode

PS C:> Get-NtapFilerData -Name 'controller1', 'controller2', 'controller3', 'controller4' -Credential $Credentials -Verbose | ForEach-Object { $_ | Export-CompressedClixml -Path "C:\Output\$($_.SystemName).xml" }

cDOT

PS C:> Get-NtapClusterData -Name 'ntap-cluster1', 'ntap-cluster2', 'ntap-cluster3' -Credential $Credentials -Verbose | ForEach-Object { $_ | Export-CompressedClixml -Path "C:\Output\$($_.SystemName).xml" }

When all data collection is complete, collect all of the files and rename the file(s) using the syntax yyyymmdd-company-filename.gz. This is very important as it is the only way Red8 will be able to associate the data collection with your organization. Upload the compressed file to Red8 using the following: Red8 Uploads.

If you have any issues or questions please feel free to ask.

Was this article helpful?

Related Articles