SCO Doctor Products Release 2.0.0 Release Notes
SCO Doctor(TM) Products Release 2.0.0 Release Notes
for SCO OpenServer(TM) Release 5.x systems
NOTE:
The information in these notes is also available in the
SCO Doctor Release and Installation Notes,
provided with the SCO Doctor online documentation.
Table of Contents
About this book
This book provides the information you need to install
and configure any of the SCO® Doctor products: SCO Doctor
Lite(TM), SCO Doctor(TM), SCO Doctor for Networks(TM),
and SCO Agent for SCO Doctor.
You will find the information you need more quickly if you
are familiar with:
How this book is organized
This book describes:
Related documentation
SCO Doctor includes these Release and Installation
Notes (also available online), as well as the following books:
-
SCO Doctor User Guide
-
Provides information on how to use the SCO Doctor products.
Views, alerts, and action programs are described
in detail. There is special emphasis on the Tuning,
Config, and Tools menu options. The
relational database and daily management routines are also
described. (printed and online)
-
SCO Doctor Technical Reference
-
Documents all components of SCO Doctor products and
provides configuration options for customization.
(online only)
NOTE:
SCO Doctor products for SCO Release 3 platforms
(SCO Open Desktop®/SCO Open Server(TM) Release 3.0
or SCO UNIX® System V/386 Release 3.2v4.2 or later)
do not provide online documentation.
Typographical conventions
This publication presents commands, filenames,
keystrokes, and other special elements in these typefaces:
- Example . . . . . . . . Used for:
-
- lp or lp(C)
-
commands, device drivers, programs, and utilities (names,
icons, or windows); the
letter in parentheses indicates the reference manual section
in which the command, driver, program, or utility is documented
- /new/client.list
-
files, directories, and desktops (names, icons, or windows)
- root
-
system, network, or user names
- filename
-
placeholders (replace with appropriate name or value)
- <Esc>
-
keyboard keys
Exit program?
-
system output (prompts, messages)
- yes or
yes
-
user input
- ``Description''
-
field names or column headings (on screen or in database)
- Cancel
-
button names
- Edit
-
menu names
- Copy
-
menu items
- File --> Find --> Text
-
sequences of menus and menu items
- open or open(S)
-
library routines, system calls, kernel functions,
C keywords; the letter
in parentheses indicates the reference manual section
in which the file is documented
- $HOME
-
environment or shell variables
- SIGHUP
-
named constants or signals
- ``adm3a''
-
data values
- employees
-
database names
- orders
-
database tables
- buf
-
C program structures
b_b.errno
-
structure members
Chapter 1
SCO Doctor features
This chapter provides:
Overview of SCO Doctor features
SCO Doctor is an automatic facility that relieves you of
routine system management tasks, optimizes system performance,
and protects you from unexpected and costly crises.
Because accurate diagnosis is important
to effective system management, SCO Doctor uses a
powerful Inference Engine so SCO Doctor not only
recognizes problems,
but also diagnoses their causes before notifying you
and taking corrective action.
The four principle elements of the SCO Doctor system are:
-
Views and Reports
-
Alerts
-
Action programs
-
Relational databases
SCO Doctor for Networks, in addition to providing
all of the functionality in SCO Doctor, also allows you to manage
multiple remote systems from a centralized location, reducing
the system management load of network administrators
and support staff. SCO Doctor for Networks features include:
-
network-wide system monitoring, management, and reporting
-
remote software deployment
-
file transfer facilities
-
remote command execution
-
remote login
-
support for SNMP traps and provision for
extensive system query information through the SCO Doctor
enterprise MIB
SCO Doctor for Networks is lightweight, cost effective, and
runs over dial-up modems.
SCO Doctor Lite provides a subset of the functionality
available in SCO Doctor.
It offers system performance monitoring, screen printing,
alerting, and automatic system management for a single
UNIX server. It includes the SCO Doctor System
Management Knowledge Module, with up to 30 alert
routines for proactive management and a fixed set of
automatic action remedies. However, to obtain automatic diagnosis,
tips, and kernel tuning, and to extend
SCO Doctor to meet your requirements,
you need to use the unrestricted SCO Doctor product.
SCO Doctor and SCO Doctor Lite feature comparison
The following table compares the features of SCO Doctor Lite
to those of SCO Doctor and SCO Doctor for Networks:
--------------------------------------------------------------
| SCO Doctor | SCO Doctor and | Benefit |
| Lite Feature| SCO Doctor for | |
| | Networks Feature| |
|-------------|------------------|----------------------------|
| An efficient| An efficient | Complete information on |
| background | background data | the status and performance|
| data | collection agent| of the system from a |
| collection | | single, network-integrated|
| agent | | package. Integrate local |
| | | applications into |
| | | management regimes with |
| | | <1% CPU consumption. |
|-------------|------------------|----------------------------|
| Standard | Standard View | View any facet of a |
| View Library| Library | system's performance as a |
| | | table, graph, or time- |
| | | line. |
|-------------|------------------|----------------------------|
| Live | Live and | Allows comparison of your |
| monitoring | historical | system's current |
| | monitoring | performance with past |
| | | performance. |
|-------------|------------------|----------------------------|
| Print Screen| Print Screen and| Numerous reports available|
| | Report Library | for distribution or |
| | for live and | archiving. |
| | historical data | |
| | reporting | |
|-------------|------------------|----------------------------|
| Standard | Standard Alert | Easily add own alerts for |
| Alert | Library with | proactive management of |
| Library with| unlimited | any situation, as well as |
| limited | expansion | incorporate alerts from |
| support for | | other vendors. |
| expansion | | |
|-------------|------------------|----------------------------|
| Standard | Standard Action | Automatic management if |
| Action | Program Library | required, or ability to |
| Program | with unlimited | add action programs if |
| Library | expansion | management requirements |
| | | change. |
|-------------|------------------|----------------------------|
| | Remote Software | Distribute software |
| | Distribution | packages or files to |
| | | remote systems. (SCO |
| | | Doctor for Networks only) |
|-------------|------------------|----------------------------|
| | Kernel tuning | Intelligent automatic |
| | | tuning of kernel |
| | | parameters. |
| | Pager and email | Whenever an urgent system |
| | support for | problem is detected, |
| | alerts | receive pager or email |
| | | notification. |
|-------------|------------------|----------------------------|
| | SNMP browsing | Browse system data |
| | and traps | collected by SCO Doctor |
| | | from an SNMP console and |
| | | receive SCO Doctor alerts |
| | | as SNMP traps. (SCO |
| | | Doctor for Networks only) |
|-------------|------------------|----------------------------|
| | Intelligent | Interprets management data|
| | Diagnosis | and presents easy-to- |
| | | understand language |
| | | explanations. |
|-------------|------------------|----------------------------|
| | Intelligent Tips| Provides context-sensitive|
| | | management and tuning tips|
| | | as you need them. |
|-------------|------------------|----------------------------|
| | Multiple | Network management is |
| | security modes | secure. |
| | to control | |
| | network- and | |
| | user-level | |
| | access | |
|-------------|------------------|----------------------------|
| Fixed | Open | Easily customize or extend|
| architecture| architecture | SCO Doctor's data capture,|
| | | alerting, views, or |
| | | reports. |
|-------------|------------------|----------------------------|
Chapter 2
Installing, upgrading, and removing SCO Doctor products
This chapter describes:
SCO Doctor products and patches
The SCO Doctor media provides the following products and
patches (also called ``supplements''):
-
SCO Doctor Lite,
which provides system monitoring and management functionality
for a single machine on which the product is installed.
-
SCO Doctor,
a fully-featured system monitoring and management application
for a single machine on which the product is installed.
(See
Chapter 1, ``SCO Doctor features''
for the differences between the Lite and Full products).
-
SCO Doctor for Networks, which allows you to monitor
and manage the system on which the product is installed,
and any remote systems that have
SCO Agent for Doctor or SCO Doctor for Networks installed.
Note that client connection licenses are needed for
SCO Doctor for Networks to work with the any of the remote systems.
-
SCO Agent for SCO Doctor,
which is required on a system that
you want to monitor and manage from a system running
SCO Doctor for Networks.
-
the SCO Advanced Server SCOadmin Supplement, for
client connection licensing functionality on an
SCO OpenServer(TM) Release 5.0.0 system.
-
Support Level Supplement (SLS) NET382E,
for SNMP support on an SCO Release 3 system.
Before installing
There are several issues of which you should be aware
before installing SCO Doctor products and patches, including:
Hardware and software requirements
All SCO Doctor products work on the following SCO platforms:
-
SCO OpenServer(TM) Release 5, or
-
an SCO Release 3 system -- SCO Open Desktop/SCO Open
Server Release 3.0 or SCO UNIX System V/386 Release 3.2v4.2
or later
The SCO Doctor products have the following hardware requirements:
---------------------------------------------------------------------------
Product Hardware requirements
---------------------------------------------------------------------------
SCO Doctor - a minimum of a 486/33Mhz, or a pentium-class computer
for Networks - a minimum of 12MB of RAM; 16MB are recommended
- 15MB of free disk space
- for modem communication, a minimum of 9600 baud
---------------------------------------------------------------------------
SCO Doctor - a 386, 486, or pentium-class computer
Lite or - a minimum of 8MB of RAM; 16MB are recommended
SCO Doctor - 5MB of free disk space
---------------------------------------------------------------------------
SCO Agent - a 386, 486, or pentium-class computer
for SCO - a minimum of 8MB of RAM
Doctor - 5MB of free disk space
- for modem communication, a minimum of 9600 baud
---------------------------------------------------------------------------
SCO Doctor installation dependencies
Before installing an SCO Doctor product, you may need to:
Adding client connection licensing functionality
If you are using SCO OpenServer Release 5.0.0,
you must install the enhanced version of the SCOadmin
License Manager, (part of
the SCO Advanced Server SCOadmin Supplement patch),
before you can add client connection licenses for SCO Doctor.
It is recommended that you install this patch before
installing any SCO Doctor product.
NOTE:
You are not able to install this patch if you are using
SCO OpenServer Release 5.0.2 or later.
See also:
Using SCO Doctor SNMP functionality on SCO Release 3 platforms
If you want to use SCO Doctor's SNMP functionality
in a SCO Release 3 environment (SCO Open Desktop/Open Server
Release 3.0 or SCO UNIX 3.2v4.2 or later), you must install the
Support Level Supplement (SLS) NET382E.
NOTE:
Install the SLS NET382E
before installing any SCO Doctor product.
The SLS NET382E is included on
the SCO Doctor CD-ROM media
as disk images, from which you can create a set of installation
floppies.
``Installing the SLS NET382E patch''
describes how to do this, as well as how to install the
SLS NET382E.
For complete information on the SLS NET382E,
you can get a copy of the SLS NET382E documentation
(called net382e.ltr.z)
from the SCO World Wide Web site, in the
``Support Level Supplements (SLS)'' area
of the ``Services'' page:
http://www.sco.com/
or
ftp://ftp.sco.com/SLS
See also:
NIS and SCO Doctor products
If you are using NIS to distribute password,
group, hosts, and services files to client systems, you
have to manually create some entries for SCO Doctor products
on the server system. Once created
and propagated to all relevant client systems, you can
install the SCO Doctor product on the server and client systems.
NOTE:
-
You can ignore Steps 1 and 3 for SCO Doctor and SCO Doctor Lite.
-
You can ignore Step 1 for SCO Doctor for Networks and
SCO Agent if you are not using modems.
-
Create a user account (/etc/password entry) with
the following fields:
- Account name:
-
godoctor
- Group:
-
godoctor
- Login directory:
-
/
- Account shell:
-
/usr/lib/doctor/bin/modem
- User Id:
-
Any free value
-
Create a user group (/etc/group entry) with the
following fields:
- Group Name:
-
godoctor
- Group Id:
-
Any free value
-
Create the TCP/IP service entries for agent
or modemd by copying the following services
entries to the /etc/services file.
Copy the text exactly as it appears below:
- agent
-
1643/tcp
- modemd
-
1644/tcp
Installing SCO Doctor products and patches
The SCO Doctor media contains SCO Doctor Lite, SCO Doctor,
SCO Doctor for Networks, SCO Agent for SCO Doctor,
and two patches that you may need to install for use with
the SCO Doctor products.
Table 2-1 identifies
the procedure to use to install
the different SCO Doctor products and patches:
Table 2-1 SCO Doctor installation procedures
----------------------------------------------------------------------------
To install: See:
----------------------------------------------------------------------------
SCO Release 5 versions of: ``Installing on SCO OpenServer Release 5''
SCO Doctor Lite
or
SCO Doctor
or
SCO Doctor for Networks
or
SCO Agent
----------------------------------------------------------------------------
SCO Release 3 versions of: ``Installing on SCO Release 3 platforms''
SCO Doctor Lite
or
SCO Doctor
or
SCO Doctor for Networks
or
SCO Agent
----------------------------------------------------------------------------
SCO Advanced Server ``Installing the SCO Advanced Server
SCOadmin Supplement SCOadmin Supplement patch''
----------------------------------------------------------------------------
SLS NET382E ``Installing the SLS NET382E patch''
----------------------------------------------------------------------------
NOTE:
If you are using NIS, see
``NIS and SCO Doctor products''
before beginning an installation.
See also:
Installing on SCO OpenServer Release 5
To install an SCO Doctor product on SCO OpenServer Release 5:
-
Log in as root.
-
Start the Software Manager in one of the following ways:
-
Double-click on the Software Manager icon
in the System Administration window on the Desktop.
-
Start the SCOadmin launcher by entering scoadmin
on the command line, then select Software Manager.
-
Enter scoadmin software manager on the command line.
-
Select Install New from the Software menu.
-
Select the current host by pressing Continue.
-
Insert the SCO Doctor media.
-
Choose the correct media device and press Continue.
-
Highlight the desired SCO Doctor product
then select either Full for a full installation
or Partial for a partial installation.
-
If prompted, enter the group ID for SCO Doctor
to use.
-
Enter your security password. Re-enter it to confirm and
press Continue.
If you are installing SCO Doctor Lite
or SCO Doctor, skip this step.
-
Enter the License Number, License Code, and License Data
from your Certificate of License and Authenticity (COLA)
and select License.
For information on product licensing and using the SCOadmin
License Manager, see
Chapter 6, ``Licensing and registering SCO products'' in the SCO OpenServer Handbook.
NOTE:
If you select to Defer licensing at this point,
you will only be able to use the agent portions of
SCO Doctor until you run the
License Manager and enter the information on your
COLA.
If you are installing SCO Doctor Lite or SCO Agent, skip
this step.
-
When the installation is complete,
select Exit from the Host menu.
-
Remove the media from the device.
-
To configure SCO Doctor, start the program in one
of the following ways:
-
Double-click on the SCO Doctor icon in the
System Administration window on the Desktop.
(No icon is provided when you install SCO Agent.)
-
Enter scoadmin sco doctor in a scoterm window.
-
Enter doctor on the command line.
An Installation Wizard is invoked when you first run doctor,
to help guide you through the SCO Doctor configuration.
You can press <Esc> or
select cancel at any time if you want to exit the Wizard.
You can return to the Wizard at any time to complete the configuration
process by selecting Installation Wizard from the
Help menu.
See also:
-
``After your installation''
-
Chapter 6, ``Licensing and registering SCO products'' in the SCO OpenServer Handbook
for information on registering your SCO Doctor products.
Installing on SCO Release 3 platforms
To install an SCO Doctor product
on SCO Open Desktop/Open Server Release 3.0 or SCO
UNIX 3.2v4.2 or later:
NOTE:
You may need to create an installation floppy
for the Release 3 version of SCO Agent, using the
media image on the SCO Doctor CD-ROM,
before you can follow these steps.
See
``Creating an SCO Agent Release 3 installation diskette''
for information on how to do this.
-
Log in as root.
-
Enter custom on the command line to display
the custom Main menu.
-
Select Install.
-
Select A New Product.
-
Insert Volume 1 of the desired SCO Doctor media
and select Continue.
-
If prompted to insert SCO Doctor media, select Continue
(the media is already in the appropriate drive).
-
Select the desired SCO Doctor product to install.
-
If prompted, enter the group ID for SCO Doctor to use.
-
Enter your security password. Re-enter it to confirm and
press Continue.
If you are installing SCO Doctor Lite
or SCO Doctor, skip this step.
-
When the custom Main menu is displayed again,
remove the media from the drive and select Quit
then Yes to exit custom.
-
Enter doctor on the command line to complete
the configuration of SCO Doctor.
An Installation Wizard is invoked when you first run doctor
to guide you through the SCO Doctor configuration.
You can press <Esc> or
select cancel at any time if you want to exit the Wizard.
You can return to the Wizard at any time and complete the configuration
process by selecting Installation Wizard from the
Help menu.
-
When prompted by the Installation Wizard, enter
the License Number, License Code, and License Data
from your Certificate of License and Authenticity (COLA).
If you are installing SCO Doctor Lite or SCO Agent, skip
this step.
See also:
Creating an SCO Agent Release 3 installation diskette
To create an installable floppy for the Release 3
SCO Agent for SCO Doctor:
-
On an SCO system,
insert the SCO Doctor CD-ROM disk into the drive.
-
Mount the CD-ROM disk:
mount -r /dev/cd0 /<mnt_pt>
Possible mount point values for <mnt_pt>
include ``cdFS'' or ``cdrom''.
-
Change to the following directory:
cd /<mnt_pt>/docagnts/sco3
-
Insert a blank, formatted diskette into the mounted floppy drive.
-
Enter the following:
dd if=VOL.000.000 of=/dev/install
/dev/install is the default floppy drive on your
system. If you want to use a different floppy drive,
specify that device instead.
-
Repeat Steps 4 and 5 for each VOL file in the
sco3 image directory.
-
To verify that the installation floppies were created correctly:
-
Run the sum -r command on each of
the VOL files on the CD-ROM. For
example:
sum -r /<mnt_pt>/docagnts/sco3/VOL.000.000
-
Then run the sum -r command on each of the
floppies that you created:
The
sum(C)
results from the image files on the CD-ROM should
match the results from each corresponding floppy.
Now you can install the Release 3 version of SCO Agent, using the
procedure described in
``Installing on SCO Release 3 platforms''.
After your installation
-
When SCO Doctor is first installed, your system's
disk drives are benchmarked
to determine their preliminary operational characteristics.
To improve the accuracy of the benchmark results,
the benchmarks are run again when the system is next rebooted.
This allows SCO Doctor to perform the benchmarks in
an idle environment, before users can log into the system.
-
To add client connection licenses for the SCO Agent for
SCO Doctor, see:
-
For a highlight of SCO Doctor features, and a comparison
of the functionality between SCO Doctor Lite and the SCO Doctor
and the SCO Doctor for Networks products, see
Chapter 1, ``SCO Doctor features''.
-
For information on starting SCO Doctor, see
Chapter 3, ``Getting started with SCO Doctor''.
-
The SCO Doctor user interface automatically adapts to
your terminal configuration and runs in the most suitable
mode. If you encounter display difficulties, see
Appendix A, ``System environment options''
for doctor command line switches.
Installing the SCO Advanced Server SCOadmin Supplement patch
To apply
the SCO Advanced Server SCOadmin Supplement
patch on an SCO OpenServer Release 5.0.0 system:
-
Log in as root.
-
Start the Software Manager in one of the following ways:
-
Double-click on the Software Manager icon
in the System Administration window on the Desktop.
-
Start the SCOadmin launcher by entering scoadmin
on the command line, then select Software Manager.
-
Enter scoadmin software manager on the command line.
-
Select Patch Management and then the
Apply Patch option from the Software menu.
-
Select the current host by pressing Continue.
-
Insert the SCO Doctor media.
-
Choose the correct media device and press Continue.
-
Highlight the desired patch then select either
Full for a full installation
or Partial for a partial installation.
-
Follow the directions on the screen.
-
After the patch is installed on your system,
select Exit from the Host menu.
-
Remove the media from the device.
See also:
Installing the SLS NET382E patch
To install SLS NET382E:
-
On an SCO system,
insert the SCO Doctor CD-ROM disk into the drive.
-
Mount the CD-ROM disk:
mount -r /dev/cd0 /<mnt_pt>
Possible mount point values for <mnt_pt>
include ``cdFS'' or ``cdrom''.
-
Change to the following directory:
cd /<mnt_pt>/opt/patches/NET382E
-
Insert a blank, formatted diskette into the mounted floppy drive.
-
Create an installable diskette by entering:
/dev/install is the default floppy device on your
system. If you want to use a different floppy drive,
specify that device instead.
-
Log in to the
the system where you want to install
SLS NET382E as root and
put the system into system maintenance (single-user) mode.
-
Enter custom on the command line to display the
custom Main menu.
-
Select Install.
-
Select A New Product.
-
Select Entire Product.
-
Insert the SLS NET382E diskette into the drive and
select Continue.
Note that if SLS NET382A, SLS NET382B,
SLS NET382C, or NET382D
is already installed on the system, you
will be prompted to verify that you want to install
the newer SLS.
-
You may see information that
custom(ADM)
is saving several files or that it is doing an update from a previous
release of the SLS.
You are prompted again to insert the SLS media --
select Continue.
-
Follow the directions on the screen.
-
After the SLS is installed on your system,
select Exit from the Host menu.
-
Remove the floppy from the drive and
reboot the system so your changes take effect.
See also:
Upgrading from SCO Doctor Lite Release 2.0.0
To upgrade from SCO Doctor Lite Release 2.0.0 to either
the SCO Doctor or SCO Doctor for Networks Release 2.0.0
product, you must first purchase an SCO Certificate of
License and Authenticity (COLA).
After that,
simply install the desired SCO Doctor product, following
the directions in
``Installing SCO Doctor products and patches''.
You do not need to remove the Lite version first; it is
automatically removed for you.
NOTE:
You cannot upgrade from SCO Doctor Release 2.0.0 to
SCO Doctor for Networks Release 2.0.0.
This change requires that you remove the SCO Doctor
product first and then do a new installation of
SCO Doctor for Networks.
Adding client connection licenses
This section describes the procedures for adding
client connection licenses on SCO Release 5 and Release 3 systems:
Adding client connection licenses on SCO OpenServer Release 5
To add licenses for connections
to SCO Doctor for Networks installed on SCO OpenServer Release 5:
-
Log in as root on
the Central Management Station (CMS) -- the
system where SCO Doctor for Networks is installed.
-
Start the License Manager in one of the following ways:
-
Double-click on the License Manager icon
in the System Administration window on the Desktop.
-
Start the SCOadmin launcher by entering scoadmin
on the command line, then select License Manager.
-
Enter scoadmin license manager on the command line.
-
Select License Additional Client Connections
from the License menu.
-
Select SCO Doctor from the pop-up list.
-
Enter the License Number, License Code, and License Data from
your Client Connections for SCO Doctor
Certificate of License and Authenticity (COLA)
and click on License.
-
If SCO Doctor for Networks is currently running, you
need to exit and restart the program for the client
connection licenses to take effect.
For more information on licensing products, see
Chapter 6, ``Licensing and registering SCO products'' in the SCO OpenServer Handbook.
NOTE:
To license client connections on an SCO OpenServer
Release 5.0.0 system, you must first install the
enhanced version of the SCOadmin
License Manager, which is included in
the SCO Advanced Server SCOadmin Supplement patch,
provided with SCO Doctor. See
``Adding client connection licensing functionality''
for more information.
Adding client connection licenses on SCO Release 3 platforms
To add licenses for connections to SCO Doctor for Networks
installed on SCO Open Desktop/Open Server Release 3.0 or SCO
UNIX 3.2v4.2 or later:
-
Log in as root
on the Central Management Station (CMS) -- the
system where SCO Doctor for Networks is installed --
and run doctor.
-
Select Licenses from the Config menu.
-
Select Insert from the Edit menu.
The ``Add License'' dialog is displayed.
-
Enter agent in the ``Product'' field.
-
Enter the License Number, License Code, and License Data from
your Client Connections for SCO Doctor
Certificate of License and Authenticity (COLA).
-
Select OK.
Removing SCO Doctor products and patches
This section describes the procedures for removing
SCO Doctor products and patches:
NOTE:
Before removing SCO Doctor products, ensure that no one is
currently using the product, or bring your system
to single-user (maintenance) mode.
Removing SCO Doctor from SCO OpenServer Release 5
To remove an SCO Doctor product
from SCO OpenServer Release 5:
-
Log in as root.
-
Start the Software Manager in one of the following ways:
-
Double-click on the Software Manager icon
in the System Administration window on the Desktop.
-
Start the SCOadmin launcher by entering scoadmin
on the command line, then select Software Manager.
-
Enter scoadmin software manager on the command line.
-
Highlight the SCO Doctor product that you want to remove.
-
Select Remove Software from the Software menu.
-
Select Remove to confirm the removal.
-
You are asked if you want to remove the historical databases
you have accumulated while running SCO Doctor.
These databases contain a record of your system's
performance that you may want to keep for future
reference. If you are removing SCO Doctor Lite,
skip this step.
-
Select Exit from the Host menu.
NOTE:
After removing SCO Doctor or SCO Doctor for Networks,
be sure to also remove the associated license from the
SCOadmin License Manager.
If you remove the license after removing the product,
you need to know the product's License Number because the
product will be displayed as ``Unknown product''.
If you do not remove the license before re-installing
an SCO Doctor product, the newly-installed product may fail
to function properly until the old license is removed and
then recreated on the system using the License Manager.
Removing SCO Doctor from SCO Release 3 platforms
To remove an SCO Doctor product
from SCO Open Desktop/Open Server Release 3.0 or SCO
UNIX 3.2v4.2 or later:
-
Log in as root.
-
Enter custom on the command line. The custom
Main menu is displayed.
-
Select Remove.
-
Select the SCO Doctor product that you want to remove.
-
Select to remove the entire product.
-
Select Yes at the ``Do you wish to continue?''
prompt.
-
You are asked if you want to remove the historical databases
you have accumulated while running SCO Doctor.
These databases contain a record of your system's
performance that you may want to keep for future
reference. If you are removing SCO Doctor Lite,
skip this step.
-
When prompted, press any key to continue.
-
Select Quit, then select Yes to exit
custom.
Removing patches from SCO Release 5 systems
To roll back any patch from an SCO OpenServer Release 5 system,
including the SCO Advanced Server SCOadmin Supplement:
-
Log in as root.
-
Start the Software Manager in one of the following ways:
-
Double-click on the Software Manager icon
in the System Administration window on the Desktop.
-
Start the SCOadmin launcher by entering scoadmin
on the command line, then select Software Manager.
-
Enter scoadmin software manager on the command line.
-
Select Patch Management and then the
Rollback Patch option from the Software menu.
-
Select the desired software component and then the patch that
you wish to remove. Click on Rollback to confirm
your choice.
You must repeat this step for each software component that
the patch has changed.
-
When the rollback procedure has completed,
exit the Software Manager.
-
If the kernel was relinked during removal of the patch,
shut down and reboot the system.
NOTE:
For information on removing the SLS NET382E patch,
see the SLS NET382E documentation
(called net382e.ltr.z), which is available
from the SCO World Wide Web site (www.sco.com), in the
``Support Level Supplements (SLS)'' area
of the ``Services'' page.
Chapter 3
Getting started with SCO Doctor
This chapter describes:
Starting SCO Doctor
You can start SCO Doctor in one of the following ways:
-
Double-click on the SCO Doctor icon in the
System Administration window on the Desktop.
-
Enter scoadmin sco doctor in a scoterm window.
-
Enter doctor at the command line.
Using SCO Doctor
All SCO Doctor commands are listed in pull-down menus.
The menu names are displayed in the menu bar on the second line
of the screen. One letter within each menu name and each
command is highlighted in red on a color monitor. If
you are using a monochrome monitor, menus and commands
are indicated in bold font.
Menu items not relevant or available to a particular
operation are grayed out on the menu display.
There are menu options that are always grayed out if you are
using SCO Doctor Lite, SCO Agent, and in some cases,
SCO Doctor. Depending on the feature, these options
are strictly available from both SCO Doctor and SCO Doctor
for Networks, or from SCO Doctor for Networks only.
To select a menu
If you are running SCO Doctor on the system console
or on a display running in scanmode, you can
select menus using the <Alt> key. Otherwise,
you can use <F10>, or <Ctrl>D if the
function keys do not work.
NOTE:
If the menu bar is active (i.e., the cursor is located
in the menu bar), or if you have a menu pulled down,
any live monitoring is temporarily suspended.
The information on your screen is not updated and
alerts are not displayed until you toggle off of the
menu bar.
To select a menu item
-
Type the highlighted letter of the item you want to select.
or
-
Use the arrow keys to choose the option you want to use
and press <Enter>.
SCO Doctor function keys
These function keys provide quick access to some of
SCO Doctor's commands and menus:
- <F1>
-
invokes the Help menu
- <F3>
-
displays a pop-up selection list
- <F6>
-
switches to the next window
- <F10> (or <Ctrl>D)
-
moves you to and from the menu bar
- <Ctrl> + <Enter>
-
accepts a dialog box
- <Esc>
-
cancels a dialog box/escapes from a menu
See the
SCO Doctor User Guide
for more information
on using function keys and other aspects of the SCO Doctor
user interface.
Chapter 4
Known limitations and workarounds
This release of SCO Doctor products
contains limitations, and where possible, workarounds
in the following categories:
Installation limitations
After installing an SCO Doctor product, the Installation
Wizard creates the godoctor user, but does not create
a password for the account. You must log in as root
and run the passwd command to create a password
for the godoctor account. A godoctor
password is required for
the Central Management Station (CMS) -- the system
where SCO Doctor for Networks is installed -- to connect to a
remote system over a modem.
SCO Doctor for Networks limitations
The following limitations apply when using SCO Doctor for Networks:
-
SCO Doctor for Networks requires that all systems under
management have unique system names. If you wish to
manage systems in different domains, they
must have unique, unqualified system names.
-
Systems managed remotely over UUCP
can only be managed at the same time by TCP/IP
if they have different system names.
If the system name for UUCP configuration is
the same as for TCP/IP, you will likely get
an error message from SCO Doctor that the license for the
system is already in use.
To resolve this problem, use different names for the UUCP
and TCP/IP configurations.
-
SCO Doctor communication between two systems through a direct serial
line connection (non-ACU) is not supported.
Use TCP/IP or serial communication over a modem
instead. See
Chapter 12, ``Communications Over a Network''
in the
SCO Doctor User Guide
for more information.
-
If you are connected to a remote system from the CMS
(a system running SCO Doctor for Networks), the following
Config menu options only have an effect
on the SCO Doctor for Networks system -- not on
the remote machine:
-
Config --> Systems
-
Config --> Pagers
-
Config --> Licenses
(available on SCO Release 3 systems only)
To use these options for the remote machine, you must
do a remote login to the system (i.e.,
File --> Open --> Login
from SCO Doctor)
and run doctor from the command line.
You can then use these Config options for
the remote system.
-
In the Software Deployment screen, you can enter the
names of the systems to which you want to deploy software
in the ``System Name'' field. Be certain that
the system names are separated by a space or a comma.
You can also enter ``all'' or ``*'' to
specify all managed systems. Or, you can enter:
where <filename> is a file that contains a list
of system names, with each system on its own line.
SCO Agent limitations
SCO Agent cannot run unless /unix is the booted kernel.
If you discover that SCO Agent is not running and have
trouble restarting it, check the
/usr/spool/doctor/log/agent.log file for
the following message:
SCO Agent cannot start as the linked kernel /unix does not appear to be the
booted kernel. As this program extracts data from the running kernel,
you will need to reboot the system before Agent can run.
Agent failed to start.
See the file /usr/spool/doctor/log/agent.log for details.
If you see this message, it is most likely that /unix
is not the booted kernel. However, other possible problems
may be:
-
your system's hertz speed is set incorrectly. (SCO
Doctor performs best if 100 hertz is used.)
-
the kernel's internal time has drifted so it is out of sync
with the system time. This usually only happens on an
SCO Release 3 system that has been running for a while
without being rebooted.
In any case, the solution to this problem is to reboot
your system. Afterwards, you can restart SCO Agent.
SCO Doctor TCL command limitations
When writing an action program using the
daction SCO Doctor TCL command, make sure that
D_DOCTOR is declared as ``global''
before daction is called.
SCO Doctor online Help system limitations
-
SCO Doctor online documentation is not available
unless the SCO OpenServer Online Documentation Framework
and scohelp are first installed.
The Framework and scohelp
packages are installed by default during a Full installation
of SCO OpenServer.
-
SCO Doctor online documentation is only available if you
are running SCO Doctor from an X server session.
If you select Online Manual from the
Help menu when SCO Doctor is running in a character
environment, you see the message:
To access the online documentation, you must run Doctor
during an X server session and the DISPLAY environment
variable must be set.
-
If you want to use an SCO Doctor product in a French or
German environment on SCO OpenServer Release 5.0.2,
you need to modify the localized version of the
SCOhelp Documentation Library before you will be able to access
the English SCO Doctor online documentation.
As root and using an ascii editor such as
vi, open the appropriate file for editing:
-
/usr/lib/scohelp/fr_FR.ISO8859-1/dochome.html
or
-
/usr/lib/scohelp/de_DE.ISO8859-1/dochome.html)
Locate the </UL> html tag towards the end of
the file.
Open a line above this tag and enter the following lines,
exactly as they are displayed here:
<LI>
<A HREF=/drhome.html>SCO Doctor and SCO Doctor for Networks Documentation Set</A>
Save the changes to the file and then restart
scohelp(XC).
You can now access the English version of
the SCO Doctor online documentation
from either the French or German Documentation Library.
Appendix A
System environment options
The following command line switches may be specified when invoking
SCO Doctor, to modify screen display behavior.
Line drawing mode
The SCO Doctor interface has a high graphical content. If
your terminal does not have graphics capability, it is necessary
to replace the graphic line drawing characters with the
following characters: (-), (+), and (|). To do this, type:
Monochrome and color terminals
The SCO Doctor interface runs in color by default if you
have a color monitor, or in mono if you have a monochrome
monitor. If you need to use monochrome mode on a color
console, type:
PC scancode mode
If you have a PC scancode terminal and you want
to select menus through the <Alt> + (red letter) sequence,
in addition to the standard menu access options, type:
Terminal type mapping
The SCO Doctor interface uses enhanced versions of the terminal
terminfo descriptions. Terminfo descriptions control the display
output and include ansi, wyse60, and xterm terminal types.
If you want to disable this option and only use the standard
terminfo descriptions, type:
Copyright Notice
© 1983 - 1996 The Santa Cruz Operation, Inc. All rights reserved.
No part of this publication may be reproduced, transmitted,
stored in a retrieval system, nor translated into any human or
computer language, in any form or by any means, electronic,
mechanical, magnetic, optical, chemical, manual, or otherwise,
without the prior written permission of the copyright owner or The
Santa Cruz Operation, Inc., 400 Encinal Street, Santa Cruz,
California, 95060, USA. Copyright infringement is a serious
matter under the United States and foreign Copyright Laws.
Information in this document is subject to change without notice
and does not represent a commitment on the part of The Santa Cruz
Operation, Inc. or Go Ahead Software Inc.
SCO, the SCO logo, The Santa Cruz Operation,
SCO OpenServer, SCO Open Server, UnixWare,
Open Desktop, ODT,
SCO OK,
SCO Doctor, SCO Doctor for Networks, and SCO Doctor Lite
are trademarks or registered
trademarks of The Santa Cruz Operation, Inc. in
the USA and other countries.
Go Ahead is a registered trademark and Go Ahead Doctor, Doctor
for Networks, and Go Ahead Agent are trademarks of Go Ahead
Software Inc.
UNIX is a registered trademark in the USA and other
countries, licensed exclusively through X/Open Company Limited.
All other brand and product names are or may be trademarks of,
and are used to identify products or services of, their
respective owners.
The SCO software that accompanies this publication
is commercial computer software and, together with any
related documentation, is subject to the restrictions on US
Government use as set forth below.
If this procurement is for a DOD agency, the following
DFAR Restricted Rights Legend applies:
RESTRICTED RIGHTS LEGEND: Use, duplication, or
disclosure by the Government is subject to restrictions as set forth in
subparagraph (c)(1)(ii) of Rights in Technical Data and Computer
Software Clause at DFARS 252.227-7013. Contractor/Manufacturer
is The Santa Cruz Operation, Inc., 400 Encinal Street, Santa
Cruz, CA 95060.
If this procurement is for a civilian government agency, this
FAR Restricted Rights Legend applies:
RESTRICTED RIGHTS LEGEND: This computer
software is submitted with restricted rights under
Government Contract No. _________ (and Subcontract No. ________, if
appropriate). It may not be used, reproduced, or disclosed
by the Government except as provided in
paragraph (g)(3)(i) of FAR Clause 52.227-14 alt III or as otherwise
expressly stated in the contract. Contractor/Manufacturer is The
Santa Cruz Operation, Inc., 400 Encinal Street, Santa Cruz, CA 95060.
The copyrighted software that accompanies this publication is licensed
to the End User only for use in strict accordance with the End
User License Agreement, which should be read carefully before
commencing use of the software.
This SCO software
includes software that is protected by these copyrights and trademarks:
© 1994 - 1996 Go Ahead Software Inc.
All rights reserved.
SCO, the SCO logo, The Santa Cruz Operation,
SCO OpenServer, SCO Open Server, UnixWare,
Open Desktop, ODT,
SCO OK,
SCO Doctor, SCO Doctor for Networks, and SCO Doctor Lite
are trademarks or registered
trademarks of The Santa Cruz Operation, Inc. in
the USA and other countries.
Go Ahead is a registered trademark and Go Ahead Doctor, Doctor
for Networks, and Go Ahead Agent are trademarks of Go Ahead
Software Inc.
UNIX is a registered trademark in the USA and other
countries, licensed exclusively through X/Open Company Limited.
All other brand and product names are or may be trademarks of,
and are used to identify products or services of, their
respective owners.
Document Version: 2.0.0
29 April 1996