Tools and Utilities - Expert Oracle RAC Performance Diagnostics and Tuning - page 158

Installing OSW is simple and straightforward. Download the tar file from Metalink 1 and untar the file at the
appropriate location. For example, keeping a mount point for tools will help easy management.

tar xvf osw.nnn.tar

Figure 6-15 illustrates the directory structure for OSW. All of the shell scripts are located under the OSW
directory ( OSW_HOME ) and the outputs generated by oswatcher are located under the archive directory. Underneath
this are subdirectories for each O/S metric. OSW is not cluster-aware, meaning that OSW will have to be configured on
all nodes in the cluster and data collection enabled on all nodes.

osw osw

data data

locks src src profile profile gif tmp tmp archive archive analysis analysis locks gif

oswvmstat oswvmstat oswtop oswtop oswslabinfo oswslabinfo oswps oswps oswprvtnet oswprvtnet oswnetstat oswnetstat oswmpstat oswmpstat oswiostat oswiostat

Figure 6-15. OSW directory structure

Since this is a shell script, collection can be done either as a foreground process or in the background. To enable
data collection in the background, submit the primary script with the nohup option.

To start the OSW as a foreground process, use startOSW.sh . 1.

To stop the OSW foreground process, use stopOSW.sh . 2.

3. To submit the process in the background, use

nohup ./startOSW.sh n1 n2 &

where n1 is the interval for each snapshot and n2 is the retention period.

4. To generate graphs for the data collected using OSWg, use

java -jar oswg.jar -I < complete path for the archive directory location>
OSWg requires a Windows type of server.
Data is collected to the archive folder under OSW_HOME . If this directory needs to be moved or copied to another
location to retain specific data, OSW will create the archive folder and all subfolders automatically.

1 Metalink Note #: 301137.1 - O/S Watcher User Guide.