Description

Starting from FirstLook version 3.0, vxfsstat is collected by default on Linux and Solaris.   On AIX and HP-UX you will still need to follow the previous instruction to create the two files named "vxfsfiles" and "vxfsmounts".

How to check the FirstLook version:
Please check the file "revhistory" and not the file "REV".   For example,

# cat REV
1.10.2            <<< this version is not accurate

# tail -20 revhistory              <<< check the revhistory file instead
......
1.11            - e2310014
                  Removing call to 'crashinfo'

3.0             - Re-write linux and solaris collection to make collection more relevant.
                - Removed most of sar collection
                - Added slabtop, slabinfo, and meminfo for linux
                - Added but disabled sysrq thread dump function within phase 2 loop (serial execution)
                - Added "-x" option to disable any vx related stats collection (by default, script will detect vxvm and vxfs)   <<< vxfsstat is collected by default
                - Added "-z" option to tar, so all default collections are compressed
                - Added "vxdisk path" output in system folder for easier device mapping.
                - Added "-e" option for extended collection(merged scripts from PEG group) which includes continuous collection and binary vxfsstat output

3.0.1           - Modified Solaris collection such that lockstat is enabled by default.             <<< the correct version number
                - Removed "-H" hold events from lockstat to eliminate aggregation drop warnings
                - vxfsstat text version output is on by default


Prior to FirstLook version 3.0, by default FirstLook doesn't collect Veritas File System (VxFS) vxfsstat statistics.   In order to collect vxfsstat statistics, please create the following files in the same directory under which FirstLook locates.   For example,

# echo "VxFS Mount Point"  > vxfsmounts
# echo "VxFS Mount Point" > vxfsfiles

Please replace "VxFS Mount Pont" with any one of the VxFS filesystem mount points.  Since the collected statistics is global to all the VxFS filesystems, any one of the VxFS filesystem mount points will suffice.   For example, if "/volvxfs" is one of the mount points, then

# echo /volvxfs > vxfsmounts
# echo /volvxfs > vxfsfiles

When FirstLook is started with the above two files, an additional message will be printed to indicate that FirstLook is collecting vxfsstat statistics.

# ./start_look
Files will be saved in /root/FirstLook/FirstLook/Flook_Sep_13_10:52:53_logs
saving FirstLook config info
********** Warning: vxfsstat is enabled **********           <<< additional message
os is type 2 2.6
.....

Please note that by default Firstlook only collects the text version of vxfsstat stats.  In order to have the detailed analysis of the VxFS performance, the vxfsstat binary stats output will be required.  Please uncomment the "vxfsstat -w" command in the script file vxfs_stuff to collect vxfsstat binary stats output.

Script file vxfs_stuff:

#Execute vxfsstat (binary data mode) base on mount -v output
#
if [ -r $LOCATION/$LOGDIR/system/vxfsmounts ]
then
#Only need 1 filesystem since we only collect shared stats.
# cat $LOCATION/$LOGDIR/system/vxfsmounts | while read MP junk junk
MP=`cat $LOCATION/$LOGDIR/system/vxfsmounts |head -1`
# do
# echo "$adt $MP" > $LOCATION/$LOGDIR/vxfsstat.$(echo $MP | sed -e 's/\//_/g').$PWATCH

##### Uncomment the following command "vxfsstat -w" to collect the vxfsstat binary output ####
 /opt/VRTS/bin/vxfsstat -w $LOCATION/$LOGDIR/vxfsstat.$(echo $MP | sed -e 's/\//_/g').$PWATCH -c 5 -t 1 $MP 

 /opt/VRTS/bin/vxfsstat -bi -c5 -t1 $MP >> $LOCATION/$LOGDIR/vxfsstat_bi.$PWATCH
 /opt/VRTS/bin/vxfsstat -v -e1 -c5 -t1 $MP >> $LOCATION/$LOGDIR/vxfsstat_v.$PWATCH
# done
fi