Oracle’s OSWatcher Utility

OSWatcher is a tool for the analysis of the data produced  such linux utilities as top, iostat, vmstat, netstat commands. It provides the analysed data as a graphic with OSWg tool . Tool developed by Oracle and can be downloaded via metalink (
1- Download the file called oswbb402.tar  from this metalink note ( “OS Watcher Black Box User Guide [ID 301137.1]” . Copy tar file to Linux  /oracle/ora11g directory as “oracle” os user.
2- Extract tar file with “oracle” user
# tar xvf oswbb402.tar
3- Change directory to /oracle/ora11g/oswbb
# cd /oracle/ora11g/oswbb
4- Now, start OSWatcher utility using script. There are two parameters of this script. Specify the first parameter with the time interval and the second parameter to determine how many hours of data collected. Works with the default values you run without any value.
# ./
Info…You did not enter a value for snapshotInterval.
Info…Using default value = 30
Info…You did not enter a value for archiveInterval.
Info…Using default value = 48
Testing for discovery of OS Utilities…
VMSTAT found on your system.
IOSTAT found on your system.
MPSTAT found on your system.
NETSTAT found on your system.
TOP found on your system.
Testing for discovery of OS CPU COUNT
OSWbb is looking for the CPU COUNT on your system
CPU COUNT will be used by oswbba to automatically look for cpu problems
CPU COUNT found on your system.
Discovery completed.
Starting OSWatcher Black Box v4.0.2 on Sat Apr 14 22:55:05 EEST 2014
With SnapshotInterval = 30
With ArchiveInterval = 48
OSWatcher Black Box – Written by Carl Davis, Center of Expertise, Oracle Corporation
For questions on install/usage please go to MOS (Note:301137.1)
If you need further assistance or have comments or enhancement
requests you can email me
Starting Data Collection…
oswbb heartbeat:Sat Apr 14 22:55:10 EEST 2014
oswbb heartbeat:Sat Apr 14 22:55:40 EEST 2014
oswbb heartbeat:Sat Apr 14 22:56:10 EEST 2014
oswbb heartbeat:Sat Apr 14 22:56:40 EEST 2014
oswbb heartbeat:Sat Apr 14 22:57:10 EEST 2014
oswbb heartbeat:Sat Apr 14 22:57:40 EEST 2014
oswbb heartbeat:Sat Apr 14 22:58:10 EEST 2014
oswbb heartbeat:Sat Apr 14 22:58:40 EEST 2014
5- Stop OSWatcher utility using script.
# ./
All collected data is stored in archive directory.
6- Login to Linux as “oracle” user. To view data that is collected in graphics, start OSWg tool as follows.
# export PATH=$ORACLE_HOME/jdk/bin:$PATH
# java -jar oswbba.jar -i archive
Starting OSW Black Box Analyzer V4.0.2
OSWatcher Black Box Analyzer Written by Oracle Center of Expertise
Copyright (c) 2014 by Oracle Corporation
Parsing Data. Please Wait…
Parsing file BAKUDBTSTORA1_iostat_12.04.14.2200.dat …
Parsing file BAKUDBTSTORA1_iostat_12.04.14.2300.dat …
Parsing file BAKUDBTSTORA1_vmstat_12.04.14.2200.dat …
Parsing file BAKUDBTSTORA1_vmstat_12.04.14.2300.dat …
Parsing file BAKUDBTSTORA1_top_12.04.14.2200.dat …
Parsing file BAKUDBTSTORA1_top_12.04.14.2300.dat …
Parsing Completed.
Enter 1 to Display CPU Process Queue Graphs
Enter 2 to Display CPU Utilization Graphs
Enter 3 to Display CPU Other Graphs
Enter 4 to Display Memory Graphs
Enter 5 to Display Disk IO Graphs
Enter 6 to Generate All CPU Gif Files
Enter 7 to Generate All Memory Gif Files
Enter 8 to Generate All Disk Gif Files
Enter L to Specify Alternate Location of Gif Directory
Enter T to Specify Different Time Scale
Enter D to Return to Default Time Scale
Enter R to Remove Currently Displayed Graphs
Enter P to Generate A Profile
Enter A to Analyze Data
Enter Q to Quit Program
Please Select an Option:4
Files containing the data will be parsed first.Then, faced with a menu as shown above. For example, to see the status of the memory, press 4 button and then the [ENTER] key. The memory status screen appears with the relevant graph.

Referance link:


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: