Installing and running the FirstLook utility to gather performance data.

Article:TECH188410  |  Created: 2012-05-09  |  Updated: 2012-07-31  |  Article URL http://www.symantec.com/docs/TECH188410
Article Type
Technical Solution

Product(s)

Environment

Problem



Installing and running the FirstLook utility to gather performance data.


Solution



The FirstLook package gathers general system performance data by executing Operating System level commands.
 
Such commands include:
 
  • iostat
  • netstat
  • sar

and other Operating System specific commands useful for relevant data collection.
 
The FirstLook script should be executed while the performance issue in question is occurring.
 
The FirstLook package can be located in /opt/VRTSspt/FirstLook or obtained from the Veritas / Symantec ftp site.
 
 
The procedure to download the package follows:
 
# ftp ftp.veritas.com
 
The username to login is: symsupport
The password to login is: iS*pp8rT1

Set binary mode:
 
ftp> bin
 
Change directory to the location of the FirstLook package:
 
ftp> cd /pub/support
 
250 "/pub/support" is new cwd.
 
Download the package:
 
ftp> get FirstLook.tar.gz
 
ftp> quit
 

 
Unpack the package in an appropriate directory:
 
bash-3.00# gunzip FirstLook.tar.gz
 
bash-3.00# tar xfp FirstLook.tar
 

 
To execute FirstLook, invoke start_look. For example, executing FirstLook on Solaris:
 
bash-3.00# ./start_look -l
 
NOTE:
 
1. Always use the -l option to get lockstat data unless system is VERY heavily loaded.
 
2. Note - do not run more than one hour, the logs will overwrite after 60 minutes.
 
3. Try to start the script 5 minutes before the performance issue is expected to be seen.
 

 
Files will be saved in /vx_install/FirstLook/Flook_<date_time>_logs
 
*Example
 
saving FirstLook config info
 
os is type 3 5.10
 
saving patch information
 
Segmentation Fault - core dumped
 
saving package information
 
saving mount information
 
saving modinfo information
 
saving vxprint
 
starting logger in dispatcher class: RT
 

 
Optionally, it is possible to confirm that the FirstLook process is running:
 
bash-3.00# ps -ef | grep look
 
root 19984 1 0 08:58:19 pts/1 0:00 /bin/ksh /vx_install/FirstLook/Flook_sol
 

 
After enough time to collect useful information, or if the performance issue is intermittent and has stopped, stop FirstLook:
 
bash-3.00# ./stop_look
 
Once the process has stopped (60 seconds, or so), the results will be packaged into a tar file:
 
bash-3.00# ls -hl *.tar
 
-rw-r--r-- 1 root root 2.2M May 13 09:01 Flook_05_13_09_09:00:18_logs.tar
 

 
The FirstLook output file should be uploaded to ftp.veritas.com/incoming for analysis by Symantec Technical Support.
 

 



Legacy ID



324967


Article URL http://www.symantec.com/docs/TECH188410


Terms of use for this information are found in Legal Notices