SCO OPENSERVER DISK I/O TRANSLATOR SHEET

 

Translator Activation Information

 

Name

SCO Disk

Full Path on Server

/usr/local/APT/SCO/DISK/aptx-sco-disk

Directory of Data Files

SAR data file location, usually /var/adm/sa

 

Installation

 

Gunzip and tar xf your downloaded distribution file.  Change permissions to your local APT user, for example (assuming user apt and group perf):

 

chown –R apt:perf /usr/local/APT/SCO

 

Grant the apt user execute permission on /usr/sbin/sar or alternate sar location.  Grant read and execute on sar data files and their directory, usually /var/adm/sa

 

Edit /usr/local/APT/SCO/DISK/disk-metrics.sco and add all monitored disks in the following format, where ID is a sequential number different for each disk:

 

disk ID name wd0

disk ID device wd-0

 

In this example, wd0 corresponds to wd-0. 

 

Enabling Data Collection

 

SCO APT Translator relies on sar to gather performance data.  SCO built-in script sa1 restricts permissions on sar files, therefore, it is recommended that you replace this script with the supplied modified APT script /usr/local/APT/SCO/DISK/sa1, as follows (as user root):

 

cp -p /usr/lib/sa/sa1 /usr/lib/sa/sa1.ORIG

cp –p /usr/local/APT/SCO/DISK/sa1 /usr/lib/sa/

 

Sar data collection (sadc) is not enabled by default.  To enable sar collection every 20 minutes, as root:

 

·        su – sys (become the “sys” user)

·        crontab –e (edit crontab file)

·        Insert the following line

0,20,40 * * * * /usr/lib/sa/sa1

 

When adding SCO Auto translator in APT console, specify /var/adm/sa as “Directory of data files”

 

Run “man sar”, “man sadc” or “man sa1” for more information