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

Please review the following programs and the necessary syntax to collect data from either your NetApp 7-Mode or Clustered Data ONTAP system(s). The steps provided will generate XML files that can be compressed and 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, Active Directory domain credentials can be used, 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 systems(s) specified and generate separate compressed XML files for each. This syntax expects 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 hostname(s) do not work then use the IP address(es) of the controller(s).

7-Mode

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

cDOT

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

When all data collection is complete compress and name the file using the syntax yyyymmdd-company-filename.extension. 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