Call now: 252-767-6166  
Oracle Training Oracle Support Development Oracle Apps

 E-mail Us
 Oracle Articles
New Oracle Articles

 Oracle Training
 Oracle Tips

 Oracle Forum
 Class Catalog

 Remote DBA
 Oracle Tuning
 Emergency 911
 RAC Support
 Apps Support
 Oracle Support

 SQL Tuning

 Oracle UNIX
 Oracle Linux
 Remote s
 Remote plans
 Application Server

 Oracle Forms
 Oracle Portal
 App Upgrades
 SQL Server
 Oracle Concepts
 Software Support

 Remote S


 Consulting Staff
 Consulting Prices
 Help Wanted!


 Oracle Posters
 Oracle Books

 Oracle Scripts

Don Burleson Blog 







OSWatcher Analyzer Tips

RAC tuning tips

January 12,  2015


It can be a daunting task to wade through the collected metric values in the data files to determine where a performance problem exists. Oracle created the OSWatcher Analyzer (oswbba) tool to parse the data and produce charts to help tell the RAC performance story.


Also see my notes on os_watcher.


The Analyzer is a Java utility and on Unix or Linux needs an X Windows environment to execute. The java executable needs to be in the environment PATH.


[oracle@host01 bin]$ export PATH=$ORACLE_HOME/jdk/bin:$PATH


The oswbba is started as a Java program. The ?i parameter is required to point to the OSWatcher archive directory.



[oracle@host01 oswbb]$ java -jar oswbba.jar -i /home/oracle/oswbb/archive


Starting OSW Analyzer V7.3.0

OSWatcher Analyzer Written by Oracle Center of Expertise

Copyright (c)  2015 by Oracle Corporation


Parsing Data. Please Wait...


Scanning file headers for version and platform info...



Parsing file host01.localdomain_iostat_14.09.06.0300.dat ...

Parsing file host01.localdomain_iostat_14.09.06.0400.dat ...

Parsing file host01.localdomain_iostat_14.09.06.0500.dat ...


Parsing file host01.localdomain_ps_14.09.06.0300.dat ...

Parsing file host01.localdomain_ps_14.09.06.0400.dat ...

Parsing file host01.localdomain_ps_14.09.06.0500.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 Alter Graph Time Scale Only (Does not change analysis dataset)

Enter D to Return to Default Graph Time Scale

Enter R to Remove Currently Displayed Graphs


Enter A to Analyze Data

Enter S to Analyze Subset of Data(Changes analysis dataset including graph time scale)


Enter P to Generate A Profile

Enter X to Export Parsed Data to File

Enter Q to Quit Program


Please Select an Option:


After starting the Analyzer, various data files will be parsed and processed. The longer the retention period, the longer the parsing phase will take to complete. Additionally, the more data files to be parsed, the more memory is required in the user's session. If a java.lang.OutOfMemory error is raised, start the Analyzer with a larger java heap size with the ?jar parameter.


[oracle@host01 oswbb]$ java -jar ?Xmx512M oswbba.jar -i /home/oracle/oswbb/archive


After the data files are parsed, the user can select an option from the menu. If option 2 is selected to see CPU Utilization, the Analyzer utility will display a graph similar to the following.



Figure 8.6 OSWatcher Analyzer CPU Chart


If the user were to choose option 5 to display the disk I/O utilization, the Analyzer utility will ask for the disk device.


The Following Devices and Average Service Times Are Ready to Display:  


Device Name  Average Service Times in Milliseconds


sdd   0.73

sdb   0.67

sdc   0.36

sda   0.12

dm-0  0.06

dm-1  0.0


Specify A Case Sensitive Device Name to View (Q to exit):  


After the user enters an appropriate device, the Analyzer generates a chart.



Figure 8.7 OSWatcher Analyzer Disk I/O Chart


The Analyzer will keep all charts open until the user presses R on the option menu to remove the charts or Q to quit the utility.


One way to reduce the initial parsing time is to start the Analyzer with a shorter time frame other than parse all available files. The database administrator can specify begin and end times for analysis with the ?b and ?e parameters respectively.


[oracle@host01 oswbb]$ java oswbba.jar -i /home/oracle/oswbb/archive ?b Sep 06 05:00:00 2015 ?e Sep 06 10:00:00 2015 -s


The example above restricts the analysis time from 5 a.m. to 10 a.m. on September 6, 2015. If the database administrator had already started the Analyzer session, menu option S lets the analysis timeframe be modified to a subset of the entire data retention period, similar to the following.


Please Select an Option:S


Specify Analysis Start Time. Valid entry between Sep 06 03:58:56 2015 and Sep 07 19:30:09 2015

Example Format To Enter Time: Sep 06 03:58:56 2015  :Sep 06 05:00:00 2015


Specify Analysis End Time. Valid entry between Sep 06 03:58:56 2015 and Sep 07 19:30:09 2015

Example Format To Enter Time: Sep 07 19:30:09 2015  :Sep 06 10:00:00 2015


Dates accepted. Verifying valid begin/end data points...


The previous section discussed how to set up the OSWatcher to collect OS performance metrics from the system. This utility can complement but should not replace the Cluster Health Monitor.  Included with the OSWatcher is the OSWatcher Analyzer utility that can help the database administrator wade through all of the data points to help diagnose performance problems.



Learn RAC Tuning Internals!

This is an excerpt from the landmark book Oracle RAC Performance tuning, a book that provides real world advice for resolving the most difficult RAC performance and tuning issues.

Buy it  for 30% off directly from the publisher.

Hit Counter


Burleson is the American Team

Note: This Oracle documentation was created as a support and Oracle training reference for use by our DBA performance tuning consulting professionals.  Feel free to ask questions on our Oracle forum.

Verify experience! Anyone considering using the services of an Oracle support expert should independently investigate their credentials and experience, and not rely on advertisements and self-proclaimed expertise. All legitimate Oracle experts publish their Oracle qualifications.

Errata?  Oracle technology is changing and we strive to update our BC Oracle support information.  If you find an error or have a suggestion for improving our content, we would appreciate your feedback.  Just  e-mail:  

and include the URL for the page.


Burleson Consulting

The Oracle of Database Support

Oracle Performance Tuning

Remote DBA Services


Copyright © 1996 -  2020

All rights reserved by Burleson

Oracle ® is the registered trademark of Oracle Corporation.



Oracle Training at Sea
oracle dba poster

Follow us on Twitter 
Oracle performance tuning software 
Oracle Linux poster