Home > DBA, Unix/Linux > Oracle OSWatcher tool and yast for EM Grid Control

Oracle OSWatcher tool and yast for EM Grid Control


These days I configured Oracle OSWatcher tool and yast package for EM Grid Control used to manage and monitor Oracle servers. I want to share how quickly to configure and start using them on Linux.



OSWatcher invokes system utilities like ps, top, iostat, vmstat, netstat and collects data according to the specified parameters. You can download it from Metalink.

unzip it to OSWatcher directory you would use($OSWATCHER_HOME)

tar -xvf oswbb4.0.tar



OSWatcher has been renamed to OSWatcher Black Box to avoid the confusion with the too many tools with this name. OSWatcher Black Box Analyzer(OSWbba ) is a graphing and analysis utility which comes bundled with OSWbb v4.0.0 and higher. For OSWbba you need java version 1.4.2 or higher.

Put next lines in the profile needed by OSWatcher:

export JAVA_HOME=$ORACLE_HOME/jdk/jre
export PATH=$JAVA_HOME/bin:$PATH
alias oswatch=’java -jar $OSWATCHER_HOME/oswbba.jar -i $OSWATCHER_HOME/archive’



Let’s start it with nohup in background and configure to take snapshots with the system utilities at every 5 minutes for the last 24 hours.

nohup ./startOSWbb.sh 300 24 &


What it does is subdirs in $OSWATCHER_HOME/archives like oswiostat, oswmeminfo, oswmpstat, oswnetstat, oswprvtnet, oswps, oswslabinfo, oswtop, oswvmstat where result .dat files with collected data for each hour reside. OSWbba parses all the archive files and you invoke it from the alias created in the profile:

$ oswatch

Starting OSW Black Box Analyzer V4.0
OSWatcher Black Box Analyzer Written by Oracle Center of Expertise
Copyright (c)  2012 by Oracle Corporation

Parsing Data. Please Wait…

Parsing file …iostat_12.02.16.0100.dat …
Parsing file …vmstat_12.02.16.0100.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:



Yast(Yet Another Setup Tool) is needed if you need to administer a linux host through Enterprise Manager Grid Control. Download yast from here.

tar -xvf yast_el5_x86_64.tar
cd yast_el5_x86_64


Start it in the commandline:







Here is how it looks like in EM Grid Control:









Categories: DBA, Unix/Linux
  1. Rino
    March 4, 2012 at 6:33 pm

    hi. only recently i use OSwatcher using “nohup ./OSWbb.sh 600 7” expecting the script to finish after 7 hours. when i checked the archive directory (and the nohup.out) file, it’s still running after 12 hours!

    did i understood the docs wrong?

    appreciate any help.

  2. March 4, 2012 at 9:18 pm


    With your configuration it should take snaphots at every 10 minutes for the last 7 hours. It will not stop running after 7 hours. The result files will be overwritten.


  3. edgar
    May 23, 2012 at 1:12 am

    where download the yast rpm ? to integred with Grid control

  4. edgar
    May 23, 2012 at 1:23 am

    ready !! thanks

  1. No trackbacks yet.

Leave a Reply

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

WordPress.com Logo

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

Google photo

You are commenting using your Google 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 )

Connecting to %s

%d bloggers like this: