Running OSWbb

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

sudo ./startOSWbb.sh [frequency duration]

The optional frequency and duration arguments specify how often in seconds OSWbb collects data and the number of hours for which OSWbb runs. 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:

sudo ./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 previous output, 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:

sudo ./stopOSWbb.sh

OSWbb collects data in the directories that are under the oswbb/archive directory, which are described in the following table.

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

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