Oracle OSWatcher Black Box

OSWatcher (oswbb) is a collection of UNIX shell scripts intended to collect and archive operating system and network metrics to aid support in diagnosing performance issues. OSWatcher operates as a set of background processes on the server and gathers OS data on a regular basis, invoking such Unix utilities as vmstat, netstat and iostat.

Installing with TAR file

RHEL 6/7

  1. Upload the oswbbxxx.tar file.

    mkdir /u01/oswatcher
    tar -xvf /soft/oswbb840.tar -C /u01/oswatcher

  2. (Option), traceroute the RAC private network.

    Copy Exampleprivate.net to private.net. /u01/oswatcher/oswbb/private.net

    ######################################################################
    #Linux Example
    ######################################################################
    echo "zzz ***"`date`
    traceroute -r -F rac01-priv
    traceroute -r -F rac02-priv
    ######################################################################
    rm locks/lock.file

  3. Configure OSWBB to run in the background, collect data every 2 seconds, and save the collected data for 72 hours.

    nohup /u01/oswatcher/oswbb/startOSWbb.sh 2 72 gzip &

  4. Configure the OSWBB task to start automatically on boot.

    vi /etc/rc.local
    nohup /u01/oswatcher/oswbb/startOSWbb.sh 2 72 gzip &

  5. Stop OSWBB.

    /u01/oswatcher/oswbb/stopOSWbb.sh

  6. Generate performance charts in Java.

    java -jar oswbba.jar -i /u01/oswatcher/oswbb/archive

  7. Uninstall.

    rm -rf /u01/oswatcher/oswbb

Installing with RPM package

RHEL 8/9/10

~]# dnf install oswatcher

~]$ cat /etc/sysconfig/oswatcher
# The directory where oswatcher logs should be kept
DATADIR=/var/log/oswatcher
# The interval (in seconds) between runs runs of statistics collections
INTERVAL=10
# The maximum age (in hours) of the various log files
MAXAGE=1
# An optional program used to compress the log files
ZIP=gzip