OS Watcher Install & Run

Installing OSWbb

To install OSWbb:

1. Log on to My Oracle Support (MOS) at https://support.oracle.com.
2. Download the file oswbb601.tar, which is available at https://support.oracle.com/epmos/main/downloadattachmentprocessor?attachid=301137.1:OSW_file.
3. Copy the file to the directory where you want to install OSWbb, and run the following command:
   

   # tar xvf oswbb601.tar

   
   Extracting the tar file creates a directory named oswbb, which contains all the directories and files that are associated with OSWbb, including the startOSWbb.sh script.
4. If the ksh package is not already installed on your system, use yum to install it.
   

   # yum install ksh

5. Create a symbolic link from /usr/bin/ksh to /bin/ksh.
   

   # ln -s /bin/ksh /usr/bin/ksh

   
   This link is required because the OSWbb scripts expect to find ksh in /usr/bin.
6. To enable the collection of iostat information for NFS volumes, edit the OSWatcher.sh script in the oswbb directory, and set the value of nfs_collect to 1:
   

   nfs_collect=1

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.
NETSTAT found on your system.
TOP found on your system.
Testing for discovery of OS CPU COUNT
.
.
.
Starting Data Collection...
oswbb heartbeat: date/time
oswbb heartbeat: date/time + 60 seconds
.
.
.

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, and each entry in a file is preceded by the characters *** and a timestamp.