Overview
DataFabric® Manager Data Collector (dfmdc) is a tool to collect data used by NetApp support when troubleshooting DataFabric Manager issues. The tool runs various dfm command, gathers up the log files, then consolidates them into a single compressed tar image which can be uploaded to NetApp for analysis. DataFabric Manager license is required on DFM host.
Installation
Unzip (untar) the distribution anywhere on the DFM host. No other configuration is needed. Included in the distribution includes Perl source code as well as binaries for both Windows and Solaris for those systems who may have difficulty running Perl scripts.
Usage
Usage is as follows:
dfmdc[.pl] [-nlq] [-d dir] [-c case#] [-f filer[,filer…]]
The .pl extension is needed if using the Perl source. It is not needed if running the binaries.
-n : This flag does not gather the DFM logs. By default, the tool gathers the logs.
-l : This flag *only* gathers the DFM logs and the command outputs will not be gathered.
-q: Quiet mode. By default, the tool will print out progress. If this flag is set, no such output will be displayed
-d dir : This flag allows the user to specify an output directory for the output file, as well as the temporary files which are deleted when the tool completes. By default, it uses the current working directory.
-c case #: This flag will prepend the given case # to the name of the final tarball that is created. This is useful if the tarball is to be uploaded to NetApp for analysis.
-f filer: By default no filer diagnostics are gathered. This flag will collect a dfm host diag for each filer listed.
1. Running DFMDC in Windows
Run the tool from the desired location. First check the details by verifying the version of DFMDC.
C:\Users\Administrator\Downloads\DFMDCv3>DFMDCv30.exe -v
Version : DFMDC 3.0 / 06NOV12
The complete usage details are mentioned above. To start the diagnostics run the following:
C:\Users\Administrator\Downloads\DFMDCv3>DFMDCv30.exe -c <case number> -f <file name/ip>
The diagnostics will begin and the following are the steps followed.
Running dfm version
Running MS INFO on Windows 2008 (in the case of a 2008 server)
Running dfm option list
Running dfm backup diag
Running dfm snmp list
Running dfm alarm list
Running dfm volume list
Running dfm perf data list -v
Running dfm volume list -a
Running dfm qtree list -a
Running dfm qtree list
Running dfm agent list -a
Running dfm aggr list
Running dfm lun list
Running dfm aggr list -a
Running dfm lun list -a
Running dfm host list
Running dfm backup list
Running dfm custom report list -C
Running dfm license list
Running dfpm policy list
Running dfpm dataset list
Running dfpm dataset list -m
Running dfpm dataset list -R
Running dfpm dataset status
Running dfpm dataset snapshot list
Running dfpm respool list
Running dfpm relationship list -xa
Running dfpm service list
Running dfm hs list -a
Running dfm hs diag
Running dfm hs controller list
Running dfm hs plugin list
Running dfm vm list -a
Running dfm vmdatastore list -a
Running dfm hypervisor list -a
Running dfm vcenter list -a
Running dfm datacenter list -a
Running dfm vdisk list -a
Running dfbm primary host list
Running dfbm primary dir list
Running dfbm secondary host list
Running dfbm secondary volume list
Running dfbm schedule list
Running dfbm job list
Running dfm diag
Running dfm host diag 10.100.1.42
Gathering Logs from C:\Program Files\NetApp\DataFabric Manager\DFM\log
Moved to C:/Users/Administrator/Downloads/DFMDCv3/dfmdc_logs.tgz
Creating final tarball
Compressing final zip file
DEB: DELETED 11 files
Please upload the file <case number>.zip to http://upload.netapp.com/to-ntap.
2. Running DFMDC in Linux (RHEL)
Before running ensure that there is enough permission for file to be executed.
Example of a permission denied whiile running the file
[root@test]# dfmdcv30_unix.pl
bash: /usr/bin/dfmdcv30_unix.pl: Permission denied
a. Checking the permissions of the file
[root@test]# ls -l dfmdcv30_unix.pl
-rw-r–r– 1 testuser test 30136 Apr 23 16:15 dfmdcv30_unix.pl
b. Changing the permissions of the file
[root@test]# chmod 777 dfmdcv30_unix.pl
c. Verifying the change
[root@test]# ls -l dfmdcv30_unix.pl
-rwxrwxrwx 1 testuser test 30136 Apr 23 16:15 dfmdcv30_unix.pl
Checking the version of DFM. This will also ensure that we have a running version before performing the diagnostics.
[root@test]# ./dfmdcv30_unix.pl -v
Version : DFMDC 3.0 / 06NOV12
Running the diagnostics
[root@test]# ./dfmdcv30_unix.pl -c <case number>
7-Mode
Running dfm version
Running dfm diag
Running dfm option list
Running dfm version
Running dfm license list
Running dfm snmp list
Running dfm ldap list
Running dfm network list
Running dfm alarm list
Running dfm report list -C
Running dfm user list
Running dfm script list
Running dfm backup list
Running dfm backup status
Running dfm backup schedule get
Running dfm backup diag
Running dfm database get
Running dfm agent list -a
Running dfbm options list
Running dfbm primary host list
Running dfbm primary dir list
Running dfbm secondary host list
Running dfbm secondary volume list
Running dfbm schedule list
Running dfbm job list
Running dfpm policy list
Running dfpm dataset list
Running dfpm dataset list -m
Running dfpm dataset list -R
Running dfpm dataset status
Running dfpm dataset snapshot list
Running dfpm relationship list -xa
Running dfpm respool list
Running dfpm respool list -l
Running dfpm respool list -m
Running dfpm job list
Running dfpm job list -x
Running dfpm service list
Running dfm aggr list
Running dfm volume list
Running dfm qtree list
Running dfm lun list
Running dfm aggr list -a
Running dfm volume list -a
Running dfm qtree list -a
Running dfm lun list -a
Running dfm vm list -a
Running dfm vmdatastore list -a
Running dfm vcenter list -a
Running dfm datacenter list -a
Running dfm vdisk list -a
Running dfm hypervisor list -a
Running dfm hs list -a
Running dfm host list
Running dfm host list -a
Skipping triggering of AutoSupport for Controllers.
To enable pass the -a option.
Running dfm perf data list -h
Running dfm perf data list
Running dfm perf data list -v
Running dfm perf threshold list
Running dfm perf threshold list -x
Running dfm perf template list
Running PERF ARCHIVE DIR SIZE
Running PERF ARCHIVE DIR LIST
Running uname -n
Running uname -s
Running uname -r
Running uname -i
Running uname -m
Running uname -a
Cat /proc/cpuinfo
Cat /proc/meminfo
Cat /etc/SuSE-release
Cat /etc/redhat-release
Running mount
Cat /etc/fstab
Cat /proc/scsi/scsi
Cat /proc/diskstats
Running /sbin/fdisk -l
Disk /dev/sdb doesn’t contain a valid partition table
Disk /dev/sdc doesn’t contain a valid partition table
Disk /dev/sdd doesn’t contain a valid partition table
Disk /dev/sde doesn’t contain a valid partition table
Running pvdisplay
Running vgdisplay
Running lvdisplay
Cat /proc/mdstat
Running dmesg
Collecting /var/log
tar: Removing leading `/’ from member names
Collecting /etc
tar: Removing leading `/’ from member names
tar: Removing leading `/’ from hard link targets
Gathering Logs from /opt/NTAPdfm/log
Creating final tarball
tar: Removing leading `/’ from member names
Final tarball done.
DEB: DELETED 19 files
Please upload the archive <case number>.dfmdc.tar to support.
Where do I get this?
The software can be downloaded using the following link.
http://support.netapp.com/NOW/download/tools/dfmdc/
Note: To download the tool you would require a valid NetApp account.