8.2.4.2 Running OSWbb

The software described in this documentation is either in Extended Support or Sustaining Support. See https://www.oracle.com/us/support/library/enterprise-linux-support-policies-069172.pdf for more information.
Oracle recommends that you upgrade the software described by this documentation as soon as possible.

8.2.4.2 Running OSWbb

To start OSWbb, run the startOSWbb.sh script from the oswbb directory.

# ./startOSWbb.sh [frequency duration]

The optional frequency and duration arguments specifying how often in seconds OSWbb should collect data and the number of hours for which OSWbb should run. The default values are 30 seconds and 48 hours. The following example starts OSWbb recording data at intervals of 60 seconds, and has it record data for 12 hours:

# ./startOSWbb.sh 60 12
...
Testing for discovery of OS Utilities...
VMSTAT found on your system.
IOSTAT found on your system.
MPSTAT found on your system.
IFCONFIG 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.
CPU COUNT = 4

Discovery completed.

Starting OSWatcher Black Box v7.3.0  on date and time
With SnapshotInterval = 60
With ArchiveInterval = 12
...
Data is stored in directory: OSWbba_archive

Starting Data Collection...

oswbb heartbeat: date and time
oswbb heartbeat: date and time + 60 seconds
...

In the example, OSWbba_archive is the path of the archive directory that contains the OSWbb log files.

To stop OSWbb prematurely, run the stopOSWbb.sh script from the oswbb directory.

# ./stopOSWbb.sh

OSWbb collects data in the following directories under the oswbb/archive directory:

Directory	Description
`oswiostat`	Contains output from the iostat utility.
`oswmeminfo`	Contains a listing of the contents of `/proc/meminfo`.
`oswmpstat`	Contains output from the mpstat utility.
`oswnetstat`	Contains output from the netstat utility.
`oswprvtnet`	If you have enable private network tracing for RAC, contains information about the status of the private networks.
`oswps`	Contains output from the ps utility.
`oswslabinfo`	Contains a listing of the contents of `/proc/slabinfo`.
`oswtop`	Contains output from the top utility.
`oswvmstat`	Contains output from the vmstat utility.

OSWbb stores data in hourly archive files named system_name_utility_name_timestamp.dat. Each entry in a file is preceded by a timestamp.