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



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:

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:

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''):



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:

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:


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:

  1. 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

  2. Create a user group (/etc/group entry) with the following fields:

    Group Name:
    godoctor

    Group Id:
    Any free value

  3. 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:

  1. Log in as root.

  2. Start the Software Manager in one of the following ways:

  3. Select Install New from the Software menu.

  4. Select the current host by pressing Continue.

  5. Insert the SCO Doctor media.

  6. Choose the correct media device and press Continue.

  7. Highlight the desired SCO Doctor product then select either Full for a full installation or Partial for a partial installation.

  8. If prompted, enter the group ID for SCO Doctor to use.

  9. 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.

  10. 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.

  11. When the installation is complete, select Exit from the Host menu.

  12. Remove the media from the device.

  13. To configure SCO Doctor, start the program in one of the following ways:

    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:



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.

  1. Log in as root.

  2. Enter custom on the command line to display the custom Main menu.

  3. Select Install.

  4. Select A New Product.

  5. Insert Volume 1 of the desired SCO Doctor media and select Continue.

  6. If prompted to insert SCO Doctor media, select Continue (the media is already in the appropriate drive).

  7. Select the desired SCO Doctor product to install.

  8. If prompted, enter the group ID for SCO Doctor to use.

  9. 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.

  10. When the custom Main menu is displayed again, remove the media from the drive and select Quit then Yes to exit custom.

  11. 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.

  12. 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:

  1. On an SCO system, insert the SCO Doctor CD-ROM disk into the drive.

  2. Mount the CD-ROM disk:

    Possible mount point values for <mnt_pt> include ``cdFS'' or ``cdrom''.

  3. Change to the following directory:

  4. Insert a blank, formatted diskette into the mounted floppy drive.

  5. Enter the following:

    /dev/install is the default floppy drive on your system. If you want to use a different floppy drive, specify that device instead.

  6. Repeat Steps 4 and 5 for each VOL file in the sco3 image directory.

  7. To verify that the installation floppies were created correctly: 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




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:

  1. Log in as root.

  2. Start the Software Manager in one of the following ways:

  3. Select Patch Management and then the Apply Patch option from the Software menu.

  4. Select the current host by pressing Continue.

  5. Insert the SCO Doctor media.

  6. Choose the correct media device and press Continue.

  7. Highlight the desired patch then select either Full for a full installation or Partial for a partial installation.

  8. Follow the directions on the screen.

  9. After the patch is installed on your system, select Exit from the Host menu.

  10. Remove the media from the device.

See also:



Installing the SLS NET382E patch

To install SLS NET382E:

  1. On an SCO system, insert the SCO Doctor CD-ROM disk into the drive.

  2. Mount the CD-ROM disk:

    Possible mount point values for <mnt_pt> include ``cdFS'' or ``cdrom''.

  3. Change to the following directory:

  4. Insert a blank, formatted diskette into the mounted floppy drive.

  5. 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.

  6. 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.

  7. Enter custom on the command line to display the custom Main menu.

  8. Select Install.

  9. Select A New Product.

  10. Select Entire Product.

  11. 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.

  12. 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.

  13. Follow the directions on the screen.

  14. After the SLS is installed on your system, select Exit from the Host menu.

  15. 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:

  1. Log in as root on the Central Management Station (CMS) -- the system where SCO Doctor for Networks is installed.

  2. Start the License Manager in one of the following ways:

  3. Select License Additional Client Connections from the License menu.

  4. Select SCO Doctor from the pop-up list.

  5. 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.

  6. 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:

  1. Log in as root on the Central Management Station (CMS) -- the system where SCO Doctor for Networks is installed -- and run doctor.

  2. Select Licenses from the Config menu.

  3. Select Insert from the Edit menu. The ``Add License'' dialog is displayed.

  4. Enter agent in the ``Product'' field.

  5. Enter the License Number, License Code, and License Data from your Client Connections for SCO Doctor Certificate of License and Authenticity (COLA).

  6. 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:

  1. Log in as root.

  2. Start the Software Manager in one of the following ways:

  3. Highlight the SCO Doctor product that you want to remove.

  4. Select Remove Software from the Software menu.

  5. Select Remove to confirm the removal.

  6. 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.

  7. 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:

  1. Log in as root.

  2. Enter custom on the command line. The custom Main menu is displayed.

  3. Select Remove.

  4. Select the SCO Doctor product that you want to remove.

  5. Select to remove the entire product.

  6. Select Yes at the ``Do you wish to continue?'' prompt.

  7. 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.

  8. When prompted, press any key to continue.

  9. 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:

  1. Log in as root.

  2. Start the Software Manager in one of the following ways:

  3. Select Patch Management and then the Rollback Patch option from the Software menu.

  4. 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.

  5. When the rollback procedure has completed, exit the Software Manager.

  6. 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:



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



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 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:

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




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