没有合适的资源?快使用搜索试试~ 我知道了~
OS Watcher Black Box User's Guide
需积分: 15 7 下载量 171 浏览量
2014-08-08
15:42:39
上传
评论 1
收藏 203KB PDF 举报
温馨提示
试读
17页
@Please Note: OSW has been renamed to OSWbb (OSWatcher Black Box) to prevent @confusion as there are several tools now within Oracle that share this same name. OSWbb now provides an analysis tool OSWbba which analyzes the log files produced by OSWbb. This tool allows OSWbb to be self-analyzing. This tool also provides a graphing capability to graph the data and to produce a htmp profile. See the "Graphing the Output" section below. To collect database metrics in addition to OS metrics consider running LTOM. To see an example of your system profiled with LTOM click here.
资源推荐
资源详情
资源评论
OSWbb
OS Watcher Black Box User's Guide
Carl Davis
Center of Expertise
August 22, 2012
@Please Note: OSW has been renamed to OSWbb (OSWatcher Black Box) to prevent
@confusion as there are several tools now within Oracle that share this same name.
OSWbb now provides an analysis tool OSWbba which analyzes the log files produced by OSWbb. This tool allows
OSWbb to be self-analyzing. This tool also provides a graphing capability to graph the data and to produce a htmp
profile. See the "Graphing the Output" section below.
To collect database metrics in addition to OS metrics consider running LTOM. To see an example of your system
profiled with LTOM click here.
Contents
Introduction
Overview
Supported Platforms
Gathering Diagnostic Data
Installing OSWbb
Uninstalling OSWbb
Setting up OSWbb
Starting OSWbb
Stopping OSWbb
Diagnostic Data Output
oswiostat
oswmpstat
oswnetstat
oswprvtnet
oswps
oswtop
oswvmstat
Graphing the Output
Known Issues
Download
Reporting Feedback
Sending Files To Support
file:///C:/oswbb_doc_maintainance/osw_ug2_1_13.html
1 of 17
10/3/2012 4:19 PM
Introduction
OS Watcher Black Box (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. OSWbb 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. OSWbb can be downloaded from this note. OSWbb is also included in the RAC-DDT script file,
but is not installed by RAC-DDT. For more information on RAC-DDT see <>. OSWbb is installed on each node
where data is to be collected. Installation instructions for OSWbb are provided in this user guide.
Back to Contents
Overview
OSWbb consists of a series of shell scripts. OSWatcher.sh is the main controlling executive, which spawns
individual shell processes to collect specific kinds of data, using Unix operating system diagnostic utilities. Control
is passed to individually spawned operating system data collector processes, which in turn collect specific data,
timestamp the data output, and append the data to pre-generated and named files. Each data collector will have its
own file, created and named by the File Manager process.
Data collection intervals are configurable by the user, but will be uniform for all data collector processes for a single
instance of the OSWbb tool. For example, if OSWbb is configured to collect data once per minute, each spawned
data collector process will generate output for its respective metric, write data to its corresponding data file, then
sleep for one minute (or other configured interval) and repeat. Because we are collecting data every minute, the
files generated by each spawned processes will contain 60 entries, one for each minute during the previous hour.
Each file will contain, at most, one hour of data. At the end of each hour, File Manager will wake up and copy the
existing current hour file to an archive location, then create a new current hour file.
The File Manager ensures only the last N hours of information are retained, where N is a configurable integer
defaulting to 48. File Manager will wake up once per hour to delete files older than N hours. At any time, the entire
output file set will consist of one current hour file, plus N archive files for each data collector process.
stopOSWbb.sh will terminate all processes associated with OSWbb, and is the normal, graceful mechanism for
stopping the tool's operation.
OSWbb invokes these distinct operating system utilities, each as a distinct background process, as data collectors.
These utilities will be supported, or their equivalents, as available for each supported target platform.
ps
top
mpstat
iostat
netstat
traceroute
vmstat
Back to Contents
Supported Platforms
OSWbb is certified to run on the following platforms:
AIX
Tru64
Solaris
HP-UX
Linux
file:///C:/oswbb_doc_maintainance/osw_ug2_1_13.html
2 of 17
10/3/2012 4:19 PM
Back to Contents
Gathering Diagnostic Data
Back to Contents
Installing OSWbb
OSWbb needs to be installed on each node, one installation per node. OSWbb should be installed manually by
using the following procedure:
NOTE: OSWbb is available through MOS and can be downloaded as a tar file. The user then copies the
file oswbb.tar to the directory where OSWbb is to be installed and issues the following commands.
tar xvf oswbb.tar
A directory named oswbb is created which houses all the files associated with OSWbb. OSWbb is now installed.
Back to Contents
Uninstalling OSWbb
To de-install OSWbb issue the following command on the oswbb directory.
rm -rf oswbb
Back to Contents
Setting up OSWbb
New in this release, is the ability to control the archive directory location where OSWbb stores the data it collects.
By default this directory is created under the oswbb directory where oswbb is installed. To change this location set
the UNIX environment variable OSWWBB_ARCHIVE_DEST to the location desired before starting the tool. Once
OSWbb is installed, scripts have been provided to start and stop the OSWbb utility. When OSWbb is started for the
first time it creates the archive subdirectory. The archive directory contains 7 subdirectories, one for each data
collector. Data collectors exist for top, vmstat, iostat, mpstat, netstat, ps and an optional collector for tracing private
networks. To turn on data collection for private networks the user must create an executable file in the oswbb
directory named private.net. An example of what this file should look like is named Example private.net with
samples for each operating system: solaris, linux, aix, hp, etc. in the oswbb directory. This file can be edited and
renamed private.net or a new file named private.net can be created. This file contains entries for running the
traceroute command to verify RAC private networks.
Example private.net entry on Solaris:
traceroute -r -F node1
traceroute -r -F node2
Where node1 and node2 are 2 nodes in addition to the hostnode of a 3 node RAC cluster. If the file private.net
does not exist or is not executable then no data will be collected and stored under the oswprvtnet directory.
OSWbb will need access to the OS utilities: top, vmstat, iostat, mpstat, netstat, and traceroute. These OS utilities
need to be install on the system prior to running OSWbb. Execute permission on these utilities need to be granted
to the user of OSWbb.
Back to Contents
file:///C:/oswbb_doc_maintainance/osw_ug2_1_13.html
3 of 17
10/3/2012 4:19 PM
Starting OSWbb
To start the OSWbb utility execute the startOSWbb.sh shell script from the directory where OSWbb was installed.
This script has 2 arguments which control the frequency that data is collected and the number of hour's worth of
data to archive.
ARG1 = snapshot interval in seconds.
ARG2 = the number of hours of archive data to store.
If you do not enter any arguments the script runs with default values of 30 and 48 meaning collect data every 30
seconds and store the last 48 hours of data in archive files.
Example 1:
./startOSWbb.sh 60 10
This would start the tool and collect data at 60 second intervals and log the last 10 hours of data to archive files.
Example 2:
./startOSWbb.sh
NOTE: This would use the default values of 30, 48 and collect data at 30 second intervals and log the
last 48 hours of data to archive files.
Example 3:
nohup ./startOSWbb.sh 60 10 &
This would start the tool, put the process in the background, enable to the tool to continue running after the session
has been terminated, collect data at 60 second intervals, and log the last 10 hours of data to archive files.
Back to Contents
Stopping OSWbb
To stop the OSWbb utility execute the stopOSWbb.sh command from the directory where OSWbb was installed.
This terminates all the processes associated with the tool.
Example:
./stopOSWbb.sh
Back to Contents
Diagnostic Data Output
As stated above, when OSWbb is started for the first time it creates the archive subdirectory under the OSWbb
installation directory. The archive directory contains 7 subdirectories, one for each data collector. These directories
are named oswiostat, oswmpstat, oswnetstat, oswprvtnet, oswps, oswtop, and oswvmstat. One file per hour will be
file:///C:/oswbb_doc_maintainance/osw_ug2_1_13.html
4 of 17
10/3/2012 4:19 PM
剩余16页未读,继续阅读
资源评论
o8xv0123
- 粉丝: 14
- 资源: 100
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功