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:
- Microsoft Windows PowerShell v3.0 or higher
- Microsoft .NET Framework v4.0 or higher
- NetApp Data ONTAP PowerShell Toolkit
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):
Respond Yes and proceed. The next command must be entered every time you start a PowerShell instance (non-persistent):
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).
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.
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.