home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1999 mARCH / PCWK3A99.iso / Unixware / INFO / UW7 / RTRNOTES.TXT < prev   
Text File  |  1998-08-19  |  207KB  |  5,343 lines
  1.  Copyright 1998 The Santa Cruz Operation, Inc.         All rights reserved.
  2.  
  3.  
  4.  About this book
  5.  
  6.     This book contains critical information that supplements the UnixWare
  7.     7.0.1 Installation Guide, UnixWare 7 System Handbook and online
  8.     documentation.  It also includes information on runtime features and
  9.     limitations that are not covered in New features and Differences for SCO
  10.     OpenServer and SCO UnixWare 1 and 2 users in the online documentation.
  11.  
  12.     This book is available in French, German, Spanish and Japanese.
  13.  
  14.  
  15.  Further information
  16.  
  17.     See the UnixWare online documentation for information about using
  18.     UnixWare.
  19.  
  20.  
  21.  Support services
  22.  
  23.     SCO offers a World Wide Web site which contains information about SCO
  24.     products and services.
  25.  
  26.     If you are connected to the Internet, use Netscape(TM) (provided with
  27.     UnixWare) or another World Wide Web browser to access the following URL
  28.     (Uniform Resource Locator) to get to the SCO World Wide Web home page
  29.     (http://www.sco.com/).
  30.  
  31.  
  32.  Typographical conventions
  33.  
  34.     This publication presents commands, filenames, keystrokes, and other
  35.     special elements as shown here:
  36.  
  37.  
  38.     Example:     Used for:
  39.  
  40.     lp or lp(1)  commands, device drivers, programs, and utilities (names,
  41.                  icons, or windows);  the letter in parentheses indicates the
  42.                  reference manual section in which the command, driver,
  43.                  program, or utility is documented
  44.  
  45.     /new/client.list
  46.                  files, directories, and desktops (names, icons, or windows)
  47.  
  48.     root         system, network, or user names
  49.  
  50.     filename     placeholders  (replace with appropriate name or value)
  51.  
  52.     <Esc>        keyboard keys
  53.  
  54.     Exit program?
  55.                  system output  (prompts, messages)
  56.  
  57.     yes or yes   user input
  58.  
  59.     ``Description''
  60.                  field names or column headings  (on screen or in database)
  61.  
  62.     Cancel       button names
  63.  
  64.     Edit         menu names
  65.  
  66.     Copy         menu items
  67.  
  68.     File != Find != Text
  69.                  sequences of menus and menu items
  70.  
  71.     open or open(2)
  72.                  library routines, system calls, kernel functions, C
  73.                  keywords;  the letter in parentheses indicates the reference
  74.                  manual section in which the file is documented
  75.  
  76.     $HOME        environment or shell variables
  77.  
  78.     SIGHUP       named constants or signals
  79.  
  80.     ``adm3a''    data values
  81.  
  82.     employees    database names
  83.  
  84.     orders       database tables
  85.  
  86.     buf          C program structures
  87.  
  88.     b.b_errno    structure members
  89.  
  90.  
  91.  How can we improve this book?
  92.  
  93.     What did you find particularly helpful in this book?  Are there mistakes
  94.     in this book? Could it be organized more usefully? Did we leave out
  95.     information you need or include unnecessary material?  If so, please tell
  96.     us.
  97.  
  98.     To help us implement your suggestions, include relevant details, such as
  99.     book title, section name, page number, and system component.  We would
  100.     appreciate information on how to contact you in case we need additional
  101.     explanation.
  102.  
  103.     _________________________________________________________________________
  104.        NOTE  For answers to technical questions, please contact your
  105.        software vendor or your support representative.  Technical
  106.        Publications is not qualified to give technical support.
  107.     _________________________________________________________________________
  108.  
  109.  
  110.     To contact us, write to us at:
  111.  
  112.  
  113.        Technical Publications
  114.        Attn:  Customer Feedback Team
  115.        The Santa Cruz Operation, Inc.
  116.        PO Box 1900
  117.        Santa Cruz, California  95061-9969
  118.        USA
  119.  
  120.  
  121.     or email us at:
  122.  
  123.  
  124.        techpubs@sco.com  or   ...  uunet!sco!techpubs
  125.  
  126.  
  127.     Thank you.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  Chapter 1
  134.  Read this before installation
  135.  
  136.     UnixWare 7.0.1 is an update to the UnixWare 7 Operating System that
  137.     provides significant new features and enhancements. UnixWare 7.0.1 can be
  138.     installed in either of these ways:
  139.  
  140.     +  By performing a full installation of UnixWare from the UnixWare 7.0.1
  141.        installation media. Refer to the notes in this chapter and the
  142.        instructions in Chapter 3, ``Installing a UnixWare 7 system'', in the
  143.        Installation Guide.
  144.  
  145.     +  By performing a layered installation of the UnixWare 7.0.1 update
  146.        packages on top of a previously installed UnixWare 7 system. Refer to
  147.        the installation instructions in Chapter  3, ``Updating your system''.
  148.  
  149.     This chapter covers the following areas:
  150.  
  151.     +  ``Installation hardware requirements''
  152.  
  153.     +  ``Network installations''
  154.  
  155.     +  ``Installable components''
  156.  
  157.     +  ``Upgrading SCO UnixWare 2.1 VxVM to UnixWare''
  158.  
  159.     +  ``Installation limitations and workarounds''
  160.  
  161.     +  ``Installation troubleshooting''
  162.  
  163.  
  164.  Installation hardware requirements
  165.  
  166.     Before installing UnixWare, make sure your system has at least the
  167.     minimum required system memory and hard disk space.  See the Installation
  168.     Guide for information.
  169.  
  170.     _________________________________________________________________________
  171.        NOTE  A primary hard disk of 1GB or larger is recommended.
  172.  
  173.        The minimum supported hard disk size is 500MB, but a full
  174.        installation is not possible on this size disk.
  175.     _________________________________________________________________________
  176.  
  177.  
  178.  Network installations
  179.  
  180.     The UnixWare 7.0.1 Installation CD-ROM contains images of all diskettes
  181.     used to install and troubleshoot UnixWare. These are found in the
  182.     /info/images directory.
  183.  
  184.     Your distribution does not contain media for the Magic diskette or the
  185.     Network Installation Utilities diskettes. If you want to create diskettes
  186.     from the images on the CD-ROM:
  187.  
  188.     1.  Log onto your UnixWare system as root.
  189.  
  190.     2.  Mount the CD-ROM. Enter:
  191.  
  192.            mount -F cdfs -r /dev/cdrom/cCbBtTlL /mnt
  193.  
  194.         where C, B, T, L are the controller, bus, target (SCSI ID), and
  195.         logical unit number (LUN) of your CD-ROM device.
  196.  
  197.         _______________________________________________________________________
  198.            NOTE  In many cases, you can substitute the wildcard * in place
  199.            of the full device name; for example /dev/cdrom/*.
  200.         _______________________________________________________________________
  201.  
  202.  
  203.         Once the update has been installed, the CD-ROM drives can be accessed
  204.         as cdrom1, cdrom2, cdrom3 and so on.
  205.  
  206.     3.  Enter:
  207.  
  208.            cd /mnt/info/images/
  209.  
  210.  
  211.     4.  Format a blank diskette by inserting it into the primary diskette
  212.         drive and entering:
  213.  
  214.            format -V /dev/rdsk/f03ht
  215.  
  216.         You can skip this step if the diskette is already formatted.
  217.  
  218.     5.  With a formatted diskette in the primary drive, enter:
  219.  
  220.            dd if=image of=/dev/rdsk/f0t bs=32b
  221.  
  222.         where image is the name of the source file for the diskette you are
  223.         creating (for example, netinstall.image.1).
  224.  
  225.     6.  Verify the checksum, by comparing the value listed in
  226.         /mnt/info/images/sums with the result of this command:
  227.  
  228.            sum -r /dev/rdsk/f03ht
  229.  
  230.         The checksums should match.
  231.  
  232.     From an SCO OpenServer(TM) machine, the syntax in steps 2, 4, 5, and 6
  233.     is:
  234.  
  235.        mount -f HS,r /dev/cd0 /mnt
  236.        format /dev/rfd0135ds18
  237.        dd if=image.name of=/dev/rfd0 bs=32b
  238.        sum -r /dev/rfd0
  239.  
  240.  
  241.     Network installation onto systems of 16MB or less is not supported in
  242.     this release.
  243.  
  244.     _________________________________________________________________________
  245.        NOTE  This version of UnixWare 7 does not provide any drivers for
  246.        PC CARD (PCMCIA) network interface adapters.  This means that while
  247.        UnixWare 7 can be installed from CDROM onto a laptop computer,
  248.        network installations onto a laptop computer are not currently
  249.        supported.
  250.  
  251.        PCMCIA drivers from SCO(r) UnixWare(r) 2.1 will work on UnixWare 7,
  252.        but these must be added after installation and cannot be used for
  253.        network installations. In addition, SCO is continually updating the
  254.        available drivers for UnixWare 7. See the SCO Compatible Hardware
  255.        Web Pages (http://www.sco.com/chwp) for the latest information on
  256.        PCMCIA network adapter drivers for UnixWare 7.
  257.     _________________________________________________________________________
  258.  
  259.  
  260.  
  261.  Installable components
  262.  
  263.     See Appendix A, ``System profiles, services, and packages'' for a list of
  264.     installable components.
  265.  
  266.  
  267.  Upgrading SCO UnixWare 2.1 VxVM to UnixWare
  268.  
  269.     You can preserve a VxVM filesystem that is not your root or /usr
  270.     filesystem from SCO UnixWare 2.1. To do so, follow this procedure:
  271.  
  272.     1.  Ensure that the VxVM ODM packages are installed and the filesystem is
  273.         configured as you require it on SCO UnixWare 2.1.
  274.  
  275.     2.  Mount the filesystem.
  276.  
  277.     3.  Create an s5 filesystem on a floppy diskette as follows:
  278.  
  279.            # format /dev/rdsk/f03ht
  280.            # mkfs -F s5 /dev/dsk/f03ht 2880
  281.  
  282.  
  283.     4.  Mount the diskette and copy the necessary files and directories as
  284.         follows:
  285.  
  286.            # mount -Fs5 /dev/dsk/f0t /mnt
  287.            # find  /etc/vx/reconfig.d \
  288.            /etc/vx/tempdb  \
  289.            /etc/vx/volboot \
  290.            /etc/vfstab | cpio -pd /mnt
  291.  
  292.  
  293.     5.  Unmount the diskette and install UnixWare 7:
  294.  
  295.            # umount /mnt
  296.  
  297.         ________________________________________________________________________
  298.            NOTE  After the installation of UnixWare 7 do not perform a
  299.            vxinstall.
  300.         ________________________________________________________________________
  301.  
  302.  
  303.     6.  Copy the files from the diskette back to the UnixWare system:
  304.  
  305.            # mount -Fs5 /dev/dsk/f0t /mnt
  306.            # cd /mnt
  307.            # find  /etc/vx/reconfig.d \
  308.            /etc/vx/tempdb  \
  309.            /etc/vx/volboot | cpio -pd /
  310.  
  311.         Merge /mnt/vfstab and /etc/vfstab by hand.
  312.  
  313.     7.  If the mountpoint used in SCO UnixWare 2.1 (in step 2) does not
  314.         exist, create it:  # mkdir mount_point
  315.  
  316.     8.  Remove the file /etc/vx/reconfig.d/state.d/install-db:
  317.  
  318.            # rm /etc/vx/reconfig.d/state.d/install-db
  319.  
  320.  
  321.     9.  Reboot the system.
  322.  
  323.     10. Mount the VxVM filesystem or volume:
  324.  
  325.            # mount /mount-point
  326.  
  327.  
  328.  
  329.  Installation limitations and workarounds
  330.  
  331.     SCO has tested the installation of UnixWare 7 on a wide range of
  332.     hardware. Note the following possible problems that have been identified
  333.     during testing.  These notes supplement or correct the installation
  334.     instructions in the Installation Guide.
  335.  
  336.     _________________________________________________________________________
  337.        NOTE  Before you install any new system software, you should always
  338.        back up your current system and verify that the backup was
  339.        successful.
  340.     _________________________________________________________________________
  341.  
  342.     _________________________________________________________________________
  343.        NOTE  In some cases, you may need to switch to the character
  344.        console (vt0) to resolve installation problems. To do this, press
  345.        <Alt><SysReq>H.  To return to the graphical installation screen,
  346.        press <Alt><SysReq><F1>.
  347.     _________________________________________________________________________
  348.  
  349.  
  350.     +  Please note that the fix incorporated into SCO UnixWare 2.1.3 to allow
  351.        disks greater than 2GB in size to be backed-up with the -e option to
  352.        emergency_rec has not been included in UnixWare 7.0.1.  A PTF may be
  353.        created to fix this -- please check the SCO BBS.
  354.  
  355.     +  If you configure a non-existent network adapter then try to remove it
  356.        and configure the correct one, the system may hang. If this happens,
  357.        you must restart the system.
  358.     +  If you do not know or are unsure of the network parameters for your
  359.        network adapter, TCP/IP, IPX/SPX, or NIS, you should defer
  360.        configuration until after installation rather than misconfigure these
  361.        components. In most cases, the <F8> option is displayed at the bottom
  362.        of the screen when you are able to defer configuration.
  363.  
  364.     +  Debugging is set switched off by default during installation.  To
  365.        switch debugging on, set the boot parameter IVAR_DEBUG_ALL=1. See
  366.        boot(1M) for information on setting boot parameters.
  367.  
  368.        When debugging is switched on, the installation process stores logs
  369.        for each of the ui_modules in separate files in either /tmp/log or
  370.        /isl/log directories.  (Logs are no longer written to stderr, which
  371.        used to reside in the /tmp directory.)
  372.  
  373.        The logs are in two different locations depending on where you are
  374.        during the installation:
  375.  
  376.        -  If you have not mounted the hard disk the logs are stored in
  377.           /tmp/log.
  378.  
  379.        -  If the hard disk has been mounted the logs are stored in /isl/log,
  380.           or /mnt/isl/log in the chroot environment, during packaging
  381.           installation.
  382.  
  383.        The hard disk is mounted at the point when the installation process
  384.        displays the message Making Filesystems.  This occurs shortly after
  385.        you have reached the final confirmation screen of the installation
  386.        questions.
  387.  
  388.        Once you have passed the final confirmation screen, all the
  389.        information in the logs is transferred onto the hard disk.
  390.  
  391.        To extract files from the machine, switch to the character console on
  392.        vt0. At the prompt in the appropriate directory (/tmp, /isl or
  393.        /mnt/isl) enter the following command:
  394.  
  395.           ls log/* | cpio -ocuvO /dev/rdsk/f03ht
  396.  
  397.        To extract the files from the floppy diskette, enter the following
  398.        command:
  399.  
  400.           cpio -icuvI /dev/rdsk/f03ht
  401.  
  402.  
  403.     +  The default size for the swap slice, as calculated during the
  404.        installation, is based on the total amount of memory in the system.
  405.        If you intend to allocate a sizeable amount of system memory for use
  406.        as dedicated memory, more swap will be allocated than is necessary.
  407.        By entering the ``Customize filesystems and slices'' screen, you can
  408.        resize the swap to a more reasonable value and allocate the space you
  409.        free up to other slices or filesystems.  As a rough guide, start with
  410.        twice the amount of non-dedicated memory as swap.
  411.  
  412.     +  UnixWare cannot install on a device that is not detected. If you do
  413.        not pay attention to the device information presented on the
  414.        installation screens, you may wind up installing UnixWare on a
  415.        secondary disk (if one is present) because the primary disk was not
  416.        found. If a secondary disk is not present, an error message is given
  417.        that indicates the installation cannot proceed.
  418.  
  419.        UnixWare is installed on the primary hard disk found for the primary
  420.        Host Bus Adapter (HBA). Typically, rules for determining which HBA, or
  421.        which disk, is primary are as follows:
  422.  
  423.        +  IDE HBAs always take precedence over SCSI HBAs.
  424.  
  425.        +  IDE HBAs are designated primary and secondary usually in their
  426.           physical setup (jumpers, for example).
  427.  
  428.        +  With IDE devices, disks are designated as master and slave usually
  429.           by jumper settings on the disk drive.
  430.  
  431.        +  When multiple SCSI HBAs are present, usually the HBA in the lowest
  432.           numbered bus slot is primary.
  433.  
  434.        +  With SCSI disks, the lowest numbered target id on the primary HBA
  435.           is the primary disk.
  436.  
  437.        +  The secondary SCSI disk is the next lowest assigned target id
  438.           starting with the primary HBA, until all HBAs are scanned and no
  439.           further disks are found.
  440.  
  441.        You must be familiar with your system's physical configuration before
  442.        you begin the installation. When the hardware diagnostics are run as
  443.        the system first powers up, check the console messages for recognition
  444.        of your devices. If you do not see what you expect, check the system
  445.        BIOS setting to make sure there are no conflicts. Check power and bus
  446.        cables to make sure they are well attached.
  447.  
  448.        Once the UnixWare HBA autodetection is complete during the
  449.        installation interview process, you can switch to the system console
  450.        screen to see diagnostic messages for devices that successfully load.
  451.        HBA and disk information may be present on the screen.
  452.  
  453.        When configuring disk setup, verify the disk sizes being reported on
  454.        the screen as well as the device names being presented. Device names
  455.        contain the information about the controller and target id for the
  456.        disk it refers to. See disk(7) for details.
  457.  
  458.        In Compaq servers, the system BIOS will boot from the HBA assigned the
  459.        ``Controller order'' of ``first'', using the System Configuration
  460.        Utility. Any controller may be selected as the first controller
  461.        regardless of slot. The UnixWare HBA drivers for Compaq controllers
  462.        will request HBA number 0 for this first controller.  It is important
  463.        that HBA 0 be assigned to the ``primary'' or ``boot'' controller.
  464.        Problems with /stand can result when the boot controller is not HBA 0.
  465.  
  466.     +  If you need to install an HBA, you should install it when the ISL
  467.        procedure first asks you to. If you forget to install it at this time,
  468.        and then try to retrieve the situation by going back to the screen,
  469.        using <F9>, the ISL will appear to accept the HBA, but will actually
  470.        fail to copy the HBA to the link kit.
  471.  
  472.        If the HBA is then used for the boot device, the system will panic on
  473.        the first post install boot of the OS with a message indicating that
  474.        the root file system cannot be mounted. At that point the only option
  475.        is to restart the installation.
  476.  
  477.     +  If you choose to install the NetWare Services package during
  478.        installation, you are asked for an IPX network number and frame type.
  479.        If this is the first IPX/SPX installation on your subnet, it is
  480.        recommended that you specify the network number and IEEE 802.2
  481.        framing. If another system is already configured to use IPX/SPX on
  482.        your subnet, you can make your system use autodiscovery to configure
  483.        its IPX parameters by setting the network number to 0 and the frame
  484.        type to AUTO_DISCOVER.
  485.  
  486.        _________________________________________________________________________
  487.           NOTE  Do not use autodiscovery if the same cable segment is
  488.           hosting more than one IPX subnet number or frame type.
  489.           Autodiscovery is also not recommended if it is possible that
  490.           there may be misconfigured systems on the same cable segment as
  491.           the system that you are configuring.
  492.        _________________________________________________________________________
  493.  
  494.  
  495.     +  Installation fails on a system that has multiple paths to a CLARiiON
  496.        system when some of the paths are inactive.
  497.  
  498.        To resolve this, turn the CLARiiON system off and proceed with
  499.        installation.  When the system is up turn the  CLARiiON system back
  500.        on, then hot add it or reboot.
  501.  
  502.     +  It is not possible to do network installations over non-Ethernet
  503.        media, for example, Token-Ring or FDDI networks.
  504.  
  505.     +  The maximum functional year for installation is Year 2037 (2^31-1) .
  506.        It is not Year 2070, as stated in the help for the Installation Year
  507.        screen.
  508.  
  509.     +  During installation, the initial system load fails to configure token
  510.        ring.  After the first reboot, you will first need to use the Network
  511.        Configuration Manager to remove token ring; then you must use the
  512.        Network Configuration Manager to add token ring.
  513.  
  514.     +  On a DECpc XL566 Pentium with the Symbios Logic NCR53c810, while the
  515.        system is rebooting, after the message
  516.  
  517.           The system is coming is coming up. Please wait.
  518.  
  519.        the following message is displayed:
  520.  
  521.           WARNING: C8XX: Attempting to Send_ABORT to ha=0 id=0 lun=0 tag=FC
  522.  
  523.        This message can be ignored.
  524.  
  525.     +  ISL remains limited to 2 disks and 1 swap slice, sized to the entire
  526.        main memory size present below 4GB. If you want to dedicate memory
  527.        (that is, tune up DEDICATED_MEMORY), stripe your swap space across
  528.        multiple slices, or both, then you must create a swap slice of the
  529.        appropriate size at installation time. An appropriate way of
  530.        calculating this is:
  531.  
  532.           swap_slice_size = (general_memory * 2) / stripe_width.
  533.  
  534.        where swap_slice_size gives the size of the swap slice to be reserved
  535.        on the root disk. It is assumed here that the administrator will
  536.        configure in the additional disks, and their associated swap slices,
  537.        following the first reboot.
  538.     +  Although the ISL seems to allow you to create a /stand that is greater
  539.        than 128MB, it will not actually do it. If you do set the size of
  540.        /stand to be greater than 128MB, the installation will fail when it
  541.        tries to create /stand.  The error message does not give any
  542.        indication why it failed.
  543.  
  544.     +  The ISL will only allow dump slices that are less than 2GB.
  545.  
  546.     +  The largest file system supported by UnixWare is 131104MB (128GB+).
  547.  
  548.     +  If you want to create a set of emergency floppies and you have not
  549.        mounted /var, you will be unable to create the floppies. To
  550.        successfully create the emergency floppies, you must first mount /var.
  551.  
  552.     +  When you try to create a set of emergency floppies, you may fail and
  553.        encounter messages stating that modules such as /dev/dsk/c0b0t0d0s?
  554.        and /home2 could not be found. If this occurs, you should comment out
  555.        the /home2 line in /etc/vfstab.
  556.  
  557.     The following may occur during reboot:
  558.  
  559.     +  The system may appear to hang during reboot because of the time that
  560.        the documentation indexing process takes. If this occurs, switch the
  561.        power off on your system, then switch it on again and let it reboot.
  562.  
  563.     +  The system may panic or reboot in some circumstances while the boot
  564.        process is running from the first diskette. This may be due to an
  565.        incorrect detection of memory.  If this occurs, you should use the
  566.        MEMADJUST command via the boot menu to specify the memory
  567.        configuration manually. See ``Boot problems, hangs, and panics'' for
  568.        details.
  569.  
  570.     +  Your Intel Extended Express system may panic during reboot.
  571.  
  572.        To prevent this, after you install the osmp package, ensure that the
  573.        Advanced Programmable Interrupt Controllers (APICs) in the machine are
  574.        enabled from the BIOS.
  575.  
  576.  
  577.  Installation troubleshooting
  578.  
  579.     This section describes some problems that you may encounter during
  580.     installation, and their solutions, under the following headings:
  581.  
  582.     +  ``Boot problems, hangs, and panics''
  583.  
  584.     +  ``Internal errors''
  585.  
  586.     +  ``Driver problems''
  587.  
  588.     +  ``Kernel build''
  589.  
  590.     +  ``Media errors''
  591.  
  592.     +  ``Memory problems''
  593.  
  594.     +  ``Network installation problems''
  595.  
  596.  Boot problems, hangs, and panics
  597.  
  598.     The following items explain how to solve some of the problems you may
  599.     encounter during system boot or reboot. These are:
  600.  
  601.     +  ``Starting UnixWare message is not displayed''
  602.  
  603.     +  ``Panics or resets while booting from install diskette''
  604.  
  605.     +  ``System hangs during installation''
  606.  
  607.     +  ``System hangs during reboot''
  608.  
  609.     +  ``System has incompatible boot code''
  610.  
  611.     +  ``System hangs or panics during reboots''
  612.  
  613.     +  ``Problems with DPT controller with old firmware''
  614.  
  615.     +  ``Power saver option enabled''
  616.  
  617.     Starting UnixWare message is not displayed
  618.  
  619.  
  620.     Problem
  621.        When booting your system the Starting UnixWare... message is not
  622.        displayed.
  623.  
  624.     Solution
  625.        Check whether the boot disk drive contains a diskette. If so, remove
  626.        the diskette and reboot your system. Otherwise, you may have a system
  627.        hardware problem. See the documentation provided with your hardware.
  628.  
  629.        Many add-on devices and cards come with configuration utilities. Check
  630.        all the connections and run the configuration utilities.
  631.  
  632.     Panics or resets while booting from install diskette
  633.  
  634.  
  635.     Problem
  636.        After booting your system with the Install Diskette, the UnixWare logo
  637.        screen is displayed and then the system either displays a panic
  638.        message or resets (system firmware messages are displayed again).
  639.  
  640.     Solution
  641.        This problem is typically the result of not running a hardware
  642.        configuration program, such as the ECU or the CMOS setup program,
  643.        before installing UnixWare. To fix the problem, run all machine and
  644.        peripheral hardware setup programs provided by your hardware vendor
  645.        and verify that your hardware is correctly configured. In particular,
  646.        check your memory size/control, cache control, bus speed, and video
  647.        specifications. See your hardware documentation for details.
  648.  
  649.        For example, this problem may occur if the correct amount of memory is
  650.        not configured.
  651.  
  652.        If running hardware setup programs does not solve the problem, then
  653.        there may be a memory problem. You can try to set the amount of memory
  654.        on your system manually as follows:
  655.  
  656.        1.  Press the reset button (or power the computer off, then on again
  657.            if you do not have a reset button).
  658.  
  659.        2.  When the Starting UnixWare... prompt or the SCO logo is displayed,
  660.            press <Space>.
  661.  
  662.            The interactive boot session prompt, [boot]#, is displayed.
  663.  
  664.        3.  Use the command show memory to display the memory ranges found by
  665.            the boot loader, and identify the range of memory that is causing
  666.            the problem.
  667.  
  668.        4.  Remove incorrect ranges of memory from use. Use MEMADJUST as
  669.            follows:
  670.  
  671.               MEMADJUST=-range
  672.  
  673.            where range is:
  674.  
  675.               low_address-high_address
  676.  
  677.            Addresses are in decimal, and may be specified in bytes, or
  678.            suffixed with ``K'' to indicate kilobytes (1024 bytes), ``M'' for
  679.            megabytes, or ``G'' for gigabytes.  Addresses may not exceed 4G.
  680.  
  681.            For example, use this command to remove memory between 15MB and
  682.            16MB:
  683.  
  684.               MEMADJUST=-15M-16M
  685.               boot
  686.  
  687.            Alternatively, you can use MEMADJUST to add more memory.  For
  688.            example, if the boot does not detect memory between 16MB and 64MB,
  689.            set MEMADJUST as follows:
  690.  
  691.               MEMADJUST=+16M-64M
  692.               boot
  693.  
  694.            _____________________________________________________________________
  695.               NOTE  Only the last setting of MEMADJUST takes effect.
  696.  
  697.               You cannot use MEMADJUST to configure memory above 4GB.
  698.            _____________________________________________________________________
  699.  
  700.            _____________________________________________________________________
  701.               NOTE  Using MEMADJUST during the installation process will
  702.               cause the MEMADJUST setting to be added to /stand/boot.  If
  703.               it remains there, the memory will be configured every time
  704.               the system is booted.  Delete the line that contains
  705.               MEMADJUST line from /stand/boot after installation if it is
  706.               no longer needed.
  707.            ____________________________________________________________________
  708.  
  709.  
  710.        5.  Continue the installation.
  711.  
  712.        In other reset conditions, you may need to set DISABLE_CACHE=yes to
  713.        fix the problem.
  714.  
  715.  
  716.     Problem
  717.        After booting your system with the Install Diskette, the UnixWare logo
  718.        screen is displayed, followed by a machine exception error.
  719.  
  720.     Solution
  721.        You may need to perform the interactive boot process as in the
  722.        previous problem, but instead of using MEMADJUST to adjust memory, set
  723.        IGNORE_MACHINE_CHECK=yes.
  724.  
  725.  
  726.     Problem
  727.        When installing UnixWare, and using a HBA diskette that is not
  728.        actually needed by the installation, the following message is
  729.        repeatedly displayed after the software loads:
  730.  
  731.           Drivers on HBA diskette are not needed
  732.  
  733.  
  734.     Solution
  735.        You must reboot the system to clear this error. Do not insert the HBA
  736.        diskette when you re-install the system.
  737.  
  738.  
  739.     System hangs during installation
  740.  
  741.  
  742.     Problem
  743.        Your system hangs during installation. The gauge showing the
  744.        percentage of files installed does not appear.
  745.  
  746.     Solution
  747.        This occurs under the following circumstances:
  748.  
  749.        +  If your computer is not accessing your diskette drive, check in
  750.           CMOS that your diskette drive type is properly configured. For
  751.           example, if a 1.44MB diskette drive is configured as a 1.2MB drive,
  752.           the diskette drive will not be accessed. Also check that your
  753.           system memory is installed properly.
  754.  
  755.        +  If you suspect a hardware problem (SCSI or non-SCSI CD-ROM) or
  756.           loose cable, check your system hardware.
  757.  
  758.        If you are sure that your system has none of these problems, contact
  759.        your SCO software reseller and exchange your installation media for
  760.        new media.
  761.  
  762.     System hangs during reboot
  763.  
  764.  
  765.     Problem
  766.        After the system self-test completes, the Starting UnixWare... message
  767.        does not appear. The system may be hung.
  768.  
  769.     Solution
  770.        To correct this, try one of the following solutions:
  771.  
  772.        +  If there is a diskette in diskette drive 1, remove it. Press any
  773.           key on the keyboard and the system should come up properly. If it
  774.           does not, use <Ctrl><Alt><Del> or press reset to reboot the system.
  775.  
  776.        +  If you recently installed an add-on card, and if your computer
  777.           worked properly before installing the card, remove the new card and
  778.           see if you can reboot the system. If this solves the problem, there
  779.           is probably an IRQ or address conflict. Reconfigure the card with a
  780.           non-conflicting IRQ or address and then reinstall the card.
  781.  
  782.        +  If your computer uses system shadow RAM or video shadow RAM, access
  783.           your CMOS configuration and turn off the shadow function(s). While
  784.           use of shadow memory improves performance for DOS systems, it has
  785.           no useful effect on the performance of UnixWare.
  786.  
  787.        +  If your computer is not accessing your diskette drive, check in
  788.           CMOS that your diskette drive type is properly configured. For
  789.           example, if a 1.44MB diskette drive is configured as a 1.2MB drive,
  790.           the diskette drive will not be accessed. Also check that your
  791.           system memory is installed properly.
  792.  
  793.        +  If your computer has BIOS caching enabled, disable BIOS caching.
  794.  
  795.        +  If your system has an IDE disk drive that is larger than 512MB, and
  796.           your disk head parameters are defined as greater than 16, verify
  797.           that your system BIOS supports disk drive parameters with more than
  798.           16 heads. If your system BIOS does not support large disk drives,
  799.           redefine your disk drive parameters using 16 or fewer heads. See
  800.           your hardware documentation for details.
  801.  
  802.        +  If your computer has a hard disk drive greater than one gigabyte
  803.           and you have an Adaptec 1542 SCSI controller with extended
  804.           translation enabled, disable the extended translation.
  805.  
  806.        +  If your computer had another operating system installed before
  807.           installing UnixWare, especially an earlier version of SCO UnixWare,
  808.           it may have placed master boot code on the hard disk that is
  809.           incompatible with UnixWare. If this is the case, UnixWare will not
  810.           boot. In most cases, there will be no error message; the system
  811.           will just hang. To resolve this problem, see the following section.
  812.  
  813.     System has incompatible boot code
  814.  
  815.  
  816.     Problem
  817.        You did not choose to overwrite the boot code in response to the
  818.        ``Configure special disk operations?'' when installing UnixWare and
  819.        the boot code from your previous system will not boot UnixWare.
  820.  
  821.     Solution
  822.        Install UnixWare again. This time, do not change the default setting
  823.        for the ``Overwrite system master boot code:'' choice on the ``Disk
  824.        Operations'' screen; it should be set to ``Yes''.
  825.  
  826.     System hangs or panics during reboots
  827.  
  828.  
  829.     Problem
  830.        The kernel builds successfully but the system does not boot or the
  831.        system panics.
  832.  
  833.        A system panic may occur when there is a fatal error that the system
  834.        cannot correct. This is most often caused by an improperly configured
  835.        device or device driver. In a panic situation, the system prints a
  836.        panic message. If the Kernel Debugger (kdb) package is installed,
  837.        control transfers to the kernel debugger program.
  838.  
  839.     Solution
  840.        If you have just installed new hardware, there may be an address or
  841.        interrupt conflict with other hardware on the system. Power down the
  842.        computer and verify that all controllers are properly seated and
  843.        jumpered. Use vendor-supplied software to diagnose hardware conflicts
  844.        and change address or interrupt values as needed.
  845.  
  846.     Problems with DPT controller with old firmware
  847.  
  848.  
  849.     Problem
  850.        On UnixWare systems with old DPT controllers, the installation ends
  851.        just after the HBA drivers are loaded (when it says Checking Hardware
  852.        Configuration...), with the message:
  853.  
  854.           Error: could not determine the size of the main disk
  855.           press any key
  856.  
  857.        Then pressing any key displays the screen:
  858.  
  859.           Internal sequencer error: sequencer failed (first call, UI mapfile)
  860.  
  861.  
  862.     Solution
  863.        If you have one of the old DPT controllers, you can not use it with
  864.        the IDE. If you want to use IDE, take this DPT controller out of the
  865.        machine (otherwise this DPT controller will respond to the IDE driver
  866.        as it tries to emulate IDE).
  867.  
  868.        If you want to use one of these old DPT controllers with UnixWare 7,
  869.        you must disable the IDE driver even if you do not have an IDE
  870.        controller in the system (otherwise this DPT controller will respond
  871.        to the IDE driver as it tries to emulate IDE).
  872.  
  873.        The IDE emulation mode of DPT does not work under UNIX (it is supposed
  874.        to work under DOS).
  875.  
  876.     Problem
  877.        Some old DPT controllers support only LUN 0-5. However, when the SDI
  878.        subsystem probes the controller at LUN 6 and beyond, the controller
  879.        responds as if there is a unit attached at LUN 6. Later when SDI reads
  880.        the capacity of the UNIT at LUN 6, the controller returns 0. This
  881.        value gets used in a computation somewhere in UnixWare 7 and causes a
  882.        ``Divide by Zero'' panic.
  883.  
  884.     Solution
  885.        If IDE devices are present, edit the LUNSEARCH boot parameter to
  886.        prevent the controller from returning 0.
  887.  
  888.     Problem
  889.        The system panics at boot up after install on systems with a DPT
  890.        controller. It gives the VT0> prompt and the ``divide by zero trap''
  891.        message.
  892.  
  893.     Solution
  894.  
  895.        The LUNSEARCH boot parameter limits device searching beyond a
  896.        specified logical unit number.  Most devices do not have logical unit
  897.        numbers greater than 0. If you have any device which has logical unit
  898.        numbers whose values are greater than 0, the LUNSEARCH parameter can
  899.        be modified to specify that.
  900.  
  901.        The format for the LUNSEARCH parameter is:
  902.  
  903.           LUNSEARCH=(c:b,t,l)[,...]
  904.  
  905.        For example,
  906.  
  907.           LUNSEARCH=(0:1,3,5),(1)
  908.  
  909.        means that on controller 0 bus 1 device 3 (SCSI ID 3), logical units
  910.        should not be searched beyond LUN 5 and no devices on controller 1
  911.        should be searched beyond logical unit 0.
  912.  
  913.        For more information on the use of LUNSEARCH and other boot
  914.        parameters, refer to boot(4).
  915.  
  916.     Power saver option enabled
  917.  
  918.  
  919.     Problem
  920.        Installation fails at random points after the hard disk is set up (or
  921.        the message
  922.  
  923.           WARNING: Disk Driver Request Timed Out,
  924.           Resetting Controller
  925.  
  926.        is displayed after a successful installation) on systems with the
  927.        ``Power Saver'' option (also referred to as ``Power Management'' or
  928.        ``Green PC'') enabled.
  929.  
  930.     Solution
  931.        Turn off the ``green/energy star'' power-saving time outs in the
  932.        system BIOS. (Refer to your hardware manual for details.)
  933.  
  934.  Internal errors
  935.  
  936.     The following item explains what to do if you encounter a system error.
  937.  
  938.     Internal error in system installation. Cannot continue.
  939.  
  940.  
  941.     Problem
  942.        This message indicates a fatal and probably unrecoverable error.
  943.  
  944.     Solution
  945.        Perform an installation from the beginning to clear the problem.
  946.  
  947.  Driver problems
  948.  
  949.     The following item explains what to do if you encounter a driver problem.
  950.  
  951.     HBA driver problems
  952.  
  953.     On some platforms, attempting to load a driver for a board that is not
  954.     installed on your system can cause installation failure. If this happens,
  955.     disable loading of the offending driver during installation by entering
  956.     the Device Configuration Utility (DCU) during the installation process.
  957.     From within the DCU:
  958.  
  959.     1.  Select Software Device Drivers.
  960.  
  961.     2.  Select Host Bus Adapters.
  962.  
  963.     3.  Highlight the driver that is causing the problem.
  964.  
  965.         If you are not sure which driver is causing the problem, try
  966.         switching virtual terminals using <Alt><SysReq>H and look for the
  967.         driver name in the error message. Use <Alt><SysReq>F1 to return to
  968.         the virtual terminal you were in.
  969.  
  970.     4.  Deselect the driver by pressing <Space>.
  971.  
  972.     5.  Press <Enter> to exit the menu.
  973.  
  974.     6.  Select Return to DCU Main Menu.
  975.  
  976.     7.  Select Apply Changes & Exit DCU.
  977.  
  978.     8.  Proceed with the installation.
  979.  
  980.  Kernel build
  981.  
  982.     The following item explains how to solve a problem you may encounter when
  983.     the UnixWare kernel is built.
  984.  
  985.     Kernel build fails
  986.  
  987.  
  988.     Problem
  989.        Kernel build fails during installation.
  990.  
  991.     Solution
  992.        If a kernel build fails during installation, review the error messages
  993.        in the /tmp/kernel.build error file for details.
  994.  
  995.        If a failure occurs while rebuilding the UnixWare kernel, this may be
  996.        the result of a corrupted kernel file or idbuild tool caused by bad
  997.        media or a malfunctioning device. The installation halts at this
  998.        point.
  999.  
  1000.        Determine if your hardware (CD-ROM, diskette, or network) is working
  1001.        properly. To do so, run any hardware and vendor diagnostic utilities
  1002.        or contact your network administrator. If necessary, replace the
  1003.        installation media and restart the installation.
  1004.  
  1005.     Problem
  1006.        The kernel build gives a warning message about a circular dependency
  1007.        in module ``event''.
  1008.  
  1009.     Solution
  1010.        This is a harmless message and can be safely ignored.
  1011.  
  1012.  Media errors
  1013.  
  1014.     The following items explain what to do if a media error is displayed or
  1015.     if the media you want to install UnixWare from is not listed.
  1016.  
  1017.     Error reading media
  1018.  
  1019.  
  1020.     Problem
  1021.        A fatal error message indicates that there was a problem reading your
  1022.        installation or HBA diskette media.
  1023.  
  1024.     Solution
  1025.        Such error messages can be a hardware problem, or a problem with your
  1026.        network (if you are performing a network installation), or a problem
  1027.        with your media. Do the following:
  1028.  
  1029.        1.  If you are performing a network installation, contact your network
  1030.            administrator to verify that there is not a problem with the
  1031.            Install Server or network. If there is a problem with either the
  1032.            Install Server or your network, you may have to perform the
  1033.            installation again.
  1034.  
  1035.        2.  If the problem was not resolved in Step 1, shut down your system
  1036.            and check for hardware problems. Check all connections and run the
  1037.            diagnostic utilities provided with your system hardware.
  1038.  
  1039.        3.  If the problem is still not resolved, contact your SCO reseller to
  1040.            obtain replacement media. (If you used an HBA diskette from a
  1041.            third-party vendor, contact that vendor for a replacement
  1042.            diskette.)
  1043.  
  1044.     Installation devices not listed
  1045.  
  1046.  
  1047.     Problem
  1048.        You are installing from CD-ROM and CD-ROM is not listed as an
  1049.        installation device.
  1050.  
  1051.     Solution
  1052.        If UnixWare does not list your install device, check the following:
  1053.  
  1054.        +  Make sure the hardware in your system is supported. See ``Supported
  1055.           hardware'' and the SCO Compatible Hardware Web Pages
  1056.           (http://www.sco.com/chwp) for information.
  1057.  
  1058.        +  Make sure the device is powered on at boot time.
  1059.  
  1060.        +  Check the cabling to the device.
  1061.  
  1062.        +  Make sure your controller and devices are set up properly.
  1063.  
  1064.        +  If you are using a SCSI device, ensure that SCSI termination rules
  1065.           are followed.
  1066.  
  1067.        +  Restart the installation and enter the DCU. Check whether the
  1068.           device driver for this device has been configured.
  1069.  
  1070.        +  Run diagnostic software on that device to make sure it is not
  1071.           faulty.
  1072.  
  1073.        +  If necessary, swap that install device with another make or model.
  1074.  
  1075.  Memory problems
  1076.  
  1077.     The following items explain how to solve some of the system memory
  1078.     problems you may encounter.
  1079.  
  1080.     Insufficient memory during installation
  1081.  
  1082.  
  1083.     Problem
  1084.        During installation on EISA systems, an error message indicates that
  1085.        there is insufficient memory to load UnixWare.
  1086.  
  1087.     Solution
  1088.        Run the ECU provided by your hardware vendor and set the correct
  1089.        amount of memory.
  1090.  
  1091.     Incorrect amount of RAM memory detected
  1092.  
  1093.  
  1094.     Problem
  1095.        On EISA systems with exactly 16MB or less of RAM, the incorrect amount
  1096.        of RAM may be detected if ECU is incorrectly configured. This can lead
  1097.        to panics when non-existent memory is used.
  1098.  
  1099.     Solution
  1100.        You can determine the amount of memory detected by pressing any key
  1101.        while UnixWare is booting and the logo screen is showing, then typing
  1102.        ``show memory'' at the [boot] prompt; the last value shown will be the
  1103.        highest detected memory address.  If this value is greater than 16MB
  1104.        on a system with only 16MB of RAM, run the ECU provided by your
  1105.        hardware vendor and make sure the memory size is correctly set to
  1106.        16MB, then reboot. If this does not fix your problem, see ``Boot
  1107.        problems, hangs, and panics'' for details of how to use MEMADJUST to
  1108.        change the amount of memory used by UnixWare.
  1109.  
  1110.     Memory above 4GB not recognized
  1111.  
  1112.  
  1113.     Problem
  1114.        Memory above 4GB is not recognized.
  1115.  
  1116.     Solution
  1117.        Add ENABLE_4GB_MEM=Y to /stand/boot and reboot the system. See ``Large
  1118.        physical memory'' in Understanding system administration for
  1119.        information.
  1120.  
  1121.  Network installation problems
  1122.  
  1123.     The following items explain how to solve some problems you may encounter
  1124.     while performing a network installation.
  1125.  
  1126.     Network Utility Diskette not recognized
  1127.  
  1128.  
  1129.     Problem
  1130.        The Network Utility Diskette is not recognized. The installation
  1131.        process asks you to insert the first Network Utility Diskette even
  1132.        when it is already in the drive.
  1133.  
  1134.     Solution
  1135.        This problem occurs when your computer has a GSI model 21 Enhanced
  1136.        IDE/floppy diskette/tape controller. When this is installed according
  1137.        to the instructions, the diskette devices in the CMOS are set to ``Not
  1138.        installed''.
  1139.  
  1140.        To install UnixWare, define the floppy diskette drive in the system
  1141.        CMOS as well as with the controller's BIOS. Some machines may report
  1142.        floppy-diskette drive errors on boot as a result, but the boot should
  1143.        continue successfully.
  1144.  
  1145.     Cannot configure network interface card
  1146.  
  1147.  
  1148.     Problem
  1149.        When prompted to provide your network interface adapter configuration
  1150.        data, the value for one or more of your adapter's hardware parameter
  1151.        settings is not listed (for example, the IRQ, I/O address range,
  1152.        memory address range, and/or DMA channel).
  1153.  
  1154.     Solution
  1155.        Only hardware parameter values not already in use are listed. If the
  1156.        value for a hardware parameter is not listed, then another hardware
  1157.        controller is configured to use the same hardware setting. There are
  1158.        several ways to fix this problem:
  1159.  
  1160.        +  Repeat the installation from CD-ROM or diskette.
  1161.  
  1162.        +  Repeat the installation and use the DCU to disable hardware
  1163.           controllers that are not needed during installation (for example, a
  1164.           cartridge tape drive).
  1165.  
  1166.        +  Record the choices that are listed and then shut down your system.
  1167.           Reconfigure your networking card to use one of the values you
  1168.           recorded and then repeat the installation.
  1169.  
  1170.  
  1171.     Problem
  1172.        When running the networking configuration manager a smart-bus board
  1173.        (PCI, EISA, MCA) is not autodetected.
  1174.  
  1175.     Solution
  1176.        Run dcu(1M) and ensure that an ISA device is not using the same IRQ.
  1177.        If it is, you must disable the ISA device using dcu and also in BIOS
  1178.        if necessary. After doing this the card will appear as a selectable
  1179.        option.
  1180.  
  1181.     Error when configuring network
  1182.  
  1183.  
  1184.     Problem
  1185.        When performing a network installation, an error message is displayed
  1186.        following the Configuring Network message.
  1187.  
  1188.     Solution
  1189.        The last line of the error message explains the cause of the problem:
  1190.  
  1191.        +  If the message indicates a problem with your networking card
  1192.           selection, then either the wrong networking card or the wrong
  1193.           networking parameters were selected. Press <Enter> to restart
  1194.           installation from the beginning.
  1195.  
  1196.        +  If the message indicates a problem contacting an Install Server,
  1197.           first check that your networking cable is securely attached to your
  1198.           system.
  1199.  
  1200.           If the cable is securely attached to your system, ask your network
  1201.           administrator to check whether your network is up and whether an
  1202.           Install Server is enabled for network installation. Then select
  1203.           whether to return to the previous menu or to cancel the
  1204.           installation.
  1205.  
  1206.        +  If the cable is not securely attached to your system, attach the
  1207.           cable. Then select whether to return to the previous menu or to
  1208.           cancel the installation.
  1209.  
  1210.     Installing osmp from NFS filesystems
  1211.  
  1212.  
  1213.     Problem
  1214.        Network installation of the osmp package from an NFS filesystem fails
  1215.        because some files are accessible only with root privileges, which are
  1216.        not available via NFS.
  1217.  
  1218.     Solution
  1219.        Copy the osmp package to the local machine and install it from there.
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  Chapter 2
  1227.  Read this after installation
  1228.  
  1229.     After you have installed UnixWare, you should follow the instructions for
  1230.     configuring your system in the Installation Guide in conjunction with the
  1231.     special information contained in this chapter.
  1232.  
  1233.     This chapter covers the following:
  1234.  
  1235.     +  Large physical memory support
  1236.  
  1237.     +  Reconfiguring IPX/SPX after installation
  1238.  
  1239.     +  Setting up SPX or TCP installation servers
  1240.  
  1241.     +  Switching auditing on
  1242.  
  1243.     +  Enabling SCOhelp searching
  1244.  
  1245.  
  1246.  Large physical memory support
  1247.  
  1248.     Any machine which contains memory at or above address 4G (2^32) requires
  1249.     large physical memory (LPM) support. Examples of machines that required
  1250.     LPM are a Corollary architecture system with more than 4GB of memory, or
  1251.     a Unisys Aquanta system with more than 3GB.
  1252.  
  1253.     See ``Large physical memory'' in the online documentation under System
  1254.     management -> Understanding system administration -> Performing basic
  1255.     system tuning and monitoring for details of how to configure LPM support.
  1256.  
  1257.     Note that the following corrections and clarifications apply to the
  1258.     information in ``Large physical memory'' in the online documentation:
  1259.  
  1260.     +  The references to tuning the PAGEOUTRATE parameter no longer apply.
  1261.        This parameter is autotuned.
  1262.  
  1263.     +  The DEDICATED_MEMORY parameter needs to be set only if you wish to
  1264.        dedicate memory below 4GB. If ENABLE_4GB_MEM is set, memory above 4GB
  1265.        is dedicated automatically. If you set DEDICATED_MEMORY in this case,
  1266.        you must set it to the amount of dedicated memory that you require,
  1267.        plus the total amount of memory over 4GB.
  1268.  
  1269.        Alternatively, set DEDICATED_MEMORY to ``unlimited'', then set
  1270.        GENERAL_MEMORY to the amount of general purpose memory that you
  1271.        require.  For example, to use 128MB as general purpose memory, and the
  1272.        remainder for dedicated memory, set the following tunables.
  1273.  
  1274.           DEDICATED_MEMORY        16777216
  1275.           GENERAL_MEMORY  32768
  1276.  
  1277.  
  1278.     +  In addition to setting ARG_MAX as suggested, you may also need to set
  1279.        the MAXRSS parameter as follows:
  1280.  
  1281.        ___________________________________________________________________
  1282.        Suggested value            For...
  1283.        ___________________________________________________________________
  1284.        0x2000                     typical systems
  1285.        0x20000                    netscape server or departmental server
  1286.        0x40000000                 data base server
  1287.  
  1288.  
  1289.     +  The commands required to set tunables for a Netscape server are
  1290.        similar to the following:
  1291.  
  1292.           /etc/conf/bin/idtune SDATLIM 0x7fffffff
  1293.           /etc/conf/bin/idtune HDATLIM 0x7fffffff
  1294.           /etc/conf/bin/idtune SVMMLIM 0x7fffffff
  1295.           /etc/conf/bin/idtune HVMMLIM 0x7fffffff
  1296.  
  1297.  
  1298.  
  1299.  Reconfiguring IPX/SPX after installation
  1300.  
  1301.     It is strongly recommended that you use the Network Configuration Manager
  1302.     (netcfg) rather than nwcm(1Mipx) if you need to modify your system's
  1303.     IPX/SPX configuration. Similarly, you should not modify IPX/SPX
  1304.     configuration files using a text editor.
  1305.  
  1306.  
  1307.  Setting up SPX or TCP installation servers
  1308.  
  1309.     Note that setting up TCP or SPX servers can be problematic if the server
  1310.     is also an NIS client as it will pick up the services map rather than the
  1311.     local /etc/services file. This can cause TCP/IP and IPX/SPX both to be
  1312.     misconfigured.  You need to ensure that the services map contains
  1313.     inetinst 6969/tcp and 1006/spx entries for network installs to work.
  1314.  
  1315.     Setting up an SPX server requires that a sapd is running. This means that
  1316.     the system must be configured with an internal network number via IPX/SPX
  1317.     configuration in netcfg. The router type must also be set to FULL so that
  1318.     the service will be advertised using RIP.
  1319.  
  1320.  
  1321.  Switching auditing on
  1322.  
  1323.     Even if you select the auditing package and therefore install it during
  1324.     the installation procedure, auditing is not turned on by default when the
  1325.     system boots.
  1326.  
  1327.     To turn auditing on manually, run auditon(1M) as root. You should run
  1328.     auditoff(1M), also as root, to turn auditing off before you shut down the
  1329.     system. Rebooting the system with auditing switched on is very slow and
  1330.     should be avoided.
  1331.  
  1332.     You should preferably switch auditing on automatically after the system
  1333.     boots and switch it off again before shutdown. To do this, edit
  1334.     /etc/rc2.d/S02audit to remove the comments from the lines that execute
  1335.     the commands auditon and auditoff.
  1336.  
  1337.  
  1338.  Enabling SCOhelp searching
  1339.  
  1340.     The SCOhelp search capability may not be enabled on your server. To
  1341.     enable it, you must run the Verity indexing command:
  1342.  
  1343.        /usr/man/bin/config_search -f
  1344.  
  1345.     _________________________________________________________________________
  1346.        NOTE  The configuration requires at last 32KB of RAM to be
  1347.        available on the system. Attempting it with less may result in a
  1348.        core dump.
  1349.     _________________________________________________________________________
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  Chapter 3
  1357.  Updating your system
  1358.  
  1359.     You can install UnixWare 7.0.1 in one of two ways: as a full
  1360.     (destructive) installation, or as updates to your previously installed
  1361.     UnixWare 7 system.
  1362.  
  1363.     _________________________________________________________________________
  1364.        NOTE  For information on performing a full installation, see the
  1365.        Chapter 1 of these Release Notes and the Installation Guide.
  1366.     _________________________________________________________________________
  1367.  
  1368.     All UnixWare 7.0.1 update packages are located on the UnixWare 7.0.1
  1369.     Operating System Updates CD-ROM (Disk 2 of 3).
  1370.  
  1371.     To update your previously installed UnixWare system with UnixWare 7.0.1
  1372.     update packages:
  1373.  
  1374.     1.  Verify that your system's hardware and software is suitable for the
  1375.         update.
  1376.  
  1377.     2.  Install the update701 package if it has not already been installed,
  1378.         then reboot the system.
  1379.  
  1380.     3.  Install other desired update packages in this order:
  1381.  
  1382.         +  One or more host bus adapter drivers.
  1383.  
  1384.         +  Audio drivers.
  1385.  
  1386.         +  Graphics drivers.
  1387.  
  1388.         +  Network drivers.
  1389.  
  1390.         +  English-language SCOhelp documentation and manual pages.
  1391.  
  1392.         +  Localized SCOhelp documentation.
  1393.  
  1394.     4.  Install any desired software from the UnixWare 7.0.1 Optional
  1395.         Services CD-ROM (Disk 3 of 3).
  1396.  
  1397.  
  1398.  Update 7.0.1 installation requirements
  1399.  
  1400.     To install the update packages from the UnixWare 7.0.1 Operating System
  1401.     Updates CD-ROM, your system must have one of the following operating
  1402.     systems installed:
  1403.  
  1404.     +  UnixWare 7.0.0s
  1405.  
  1406.     +  UnixWare 7.0.0t
  1407.  
  1408.     +  UnixWare 7.0.0u
  1409.  
  1410.     These updates do not change the base hardware requirements described in
  1411.     the Installation Guide, but each update package does have a disk space
  1412.     requirement that must be satisfied for its installation to succeed:
  1413.  
  1414.     ___________________________________________
  1415.     Package                Space required (MB)
  1416.     ___________________________________________
  1417.     BASEdoc                27
  1418.     BASEman                17
  1419.     audio                  1
  1420.     basex                  2.5
  1421.     cpqhpcd                .05
  1422.     deBASEdoc              4
  1423.     esBASEdoc              4
  1424.     frBASEdoc              4
  1425.     hba drivers            0.1
  1426.     nics                   5
  1427.     update701              45
  1428.     xclients               1.5
  1429.     xdrivers               5
  1430.     xserver                7
  1431.  
  1432.     _________________________________________________________________________
  1433.        NOTE  The space required by the installation is usually larger than
  1434.        the space needed by the software after installation.
  1435.  
  1436.        If space is at a premium, install your packages one at a time
  1437.        rather than simultaneously.
  1438.     _________________________________________________________________________
  1439.  
  1440.  
  1441.  
  1442.  Installing the update701 package
  1443.  
  1444.     The update701 package contains many enhancements to the base operating
  1445.     system as detailed in Appendix B, ``New features and enhancements''.
  1446.  
  1447.     _________________________________________________________________________
  1448.        NOTE  When you install update701, only those components already
  1449.        installed on your system are updated. If you later install
  1450.        additional components from the UnixWare 7.0.1 Installation CD-ROM,
  1451.        you should re-install the update701 package to ensure that all
  1452.        fixes and enhancements are correctly applied.
  1453.     _________________________________________________________________________
  1454.  
  1455.     To install the update701 package:
  1456.  
  1457.     1.  Log in to the system as root.
  1458.  
  1459.     2.  Bring the system down to single user mode by entering:
  1460.  
  1461.            shutdown -y -g300 -i1
  1462.  
  1463.         This gives your users 5 minutes to log off the system.
  1464.  
  1465.     3.  After the system comes down, log in to the system as root at the
  1466.         console login prompt.
  1467.  
  1468.     4.  Insert the UnixWare 7.0.1 Operating System Updates CD-ROM into the
  1469.         CD-ROM drive.
  1470.  
  1471.     5.  Enter:
  1472.  
  1473.            pkgadd -d cdrom1 update701
  1474.  
  1475.  
  1476.         Messages appear as the software loads.
  1477.  
  1478.     6.  After the software loads, reboot the system to reflect changes to the
  1479.         kernel. Enter:
  1480.  
  1481.            init 6
  1482.  
  1483.  
  1484.     After you install the update701 package, you should install any other
  1485.     desired updates from this CD-ROM before installing any products from the
  1486.     Optional Services or other CD-ROMs.  For more details, see the following
  1487.     section.
  1488.  
  1489.     _________________________________________________________________________
  1490.        NOTE  Installing the update701 package temporarily disables
  1491.        domestic encryption capabilities. For more information and a
  1492.        workaround to this problem, see ``Domestic encryption''.
  1493.     _________________________________________________________________________
  1494.  
  1495.  
  1496.  
  1497.  Installing other updates
  1498.  
  1499.     Installation of other updates on the Operating System Updates CD-ROM
  1500.     requires that you first install update701.
  1501.  
  1502.     To install other updates:
  1503.  
  1504.     1.  Log in to the system as root.
  1505.  
  1506.     2.  Insert the UnixWare 7.0.1 Operating System Updates CD-ROM into the
  1507.         CD-ROM drive.
  1508.  
  1509.     3.  From either the CDE console or a graphical xterm window, enter:
  1510.  
  1511.            scoadmin application installer
  1512.  
  1513.  
  1514.         The Application Installer main window appears.
  1515.  
  1516.     4.  Select CD-ROM_1 from the Install From menu.
  1517.  
  1518.         The list of sets and packages found on this CD-ROM appear.
  1519.  
  1520.     5.  Click on the icon of the package or set you want to install, then
  1521.         press Install.
  1522.  
  1523.         Messages appear as the software loads.
  1524.  
  1525.         Repeat this step for each package or set you want to install.
  1526.  
  1527.     6.  When finished installing software, select Actions -> Exit to exit the
  1528.         Application Installer.
  1529.  
  1530.     7.  If you installed one or more drivers from the HBA set, reboot the
  1531.         system to reflect changes to the kernel. Enter:
  1532.  
  1533.            shutdown -y -g300 -i6
  1534.  
  1535.         This gives your users 5 minutes to log off of the system before it
  1536.         reboots.
  1537.  
  1538.     The following update packages are available:
  1539.  
  1540.     BASEdoc and BASEman
  1541.             The BASEdoc and BASEman packages update the SCOhelp topics and
  1542.             manual pages, respectively, to reflect UnixWare 7.0.1 software.
  1543.             These packages also contain enhanced documentation in many areas
  1544.             of the product, specifically in the areas of network and system
  1545.             administration.
  1546.  
  1547.     audio   The audio package contains drivers for all supported audio
  1548.             adapters, including new support for the following:
  1549.  
  1550.                Creative Labs SB AWE64 PnP (Type 2-CTL00C1)
  1551.                Creative Labs SB AWE64 Pnp (Type 3-CTL00C3)
  1552.                Creative Labs SB AWE64 PnP (Type 5-CTL00E4)
  1553.                Creative Labs SB 32/AWE Pnp (Type 3-CTL0048)
  1554.                Creative Labs SB 32/AWE Pnp (Type 4-CTL0042)
  1555.                Creative Labs SB 32/AWE Pnp (Type 5-CTL0043)
  1556.                Creative Labs SB 32/AWE PnP (Type 6-CTL0047)
  1557.                Creative Labs SB ViBRA16CL PnP (CTL0080)
  1558.                ESS ES1868 Plug and Play AudioDriver(ESS1868)
  1559.                ESS ES1869 Plug and Play AudioDrive (Type 1-ESS1869)
  1560.                ESS ES1869 Plug and Play AudioDrive (Type 2-ESS0003)
  1561.                ESS ES1878 Plug and Play AudioDrive (ESS1878)
  1562.                Maxi sound 64 / Home Studio 64 (audio only) (MAXI64)
  1563.  
  1564.  
  1565.     basex, xclients, xdrivers, xserver
  1566.             The basex, xclients, and xserver packages contain optimizations
  1567.             and enhancements to the X server, graphical libraries (libX11.so
  1568.             and libICE.so), Video Configuration Manager, xdm, and other
  1569.             aspects of the Graphical Environment.
  1570.  
  1571.             The xdrivers package contains drivers for all supported graphics
  1572.             adapters, including new or updated support for the following:
  1573.  
  1574.                r3p driver
  1575.  
  1576.                ATI RAGE PRO PCI and AGP chipset based adapters
  1577.                ATI Xpert@Play (RAGE PRO)
  1578.                ATI Xpert@Work (RAGE PRO)
  1579.                ATI All-In-Wonder PRO (RAGE PRO)
  1580.  
  1581.                m64 driver
  1582.  
  1583.                ATI Mach64 PCI (VT/GT) RAGE/II/II+/IIC chipset based adapters
  1584.                ATI 3D Charger
  1585.  
  1586.                mil driver
  1587.  
  1588.                Matrox Millennium I PCI and II PCI and AGP
  1589.  
  1590.  
  1591.     cpqhpcd The cpqhpcd package contains the hpcd driver, which supports PCI
  1592.             Hot Plug slots on Compaq Proliant 6500, Proliant 7000, & Proliant
  1593.             7000 Xeon series machines. Once installed, you can use the
  1594.             SCOadmin Hot Plug Manager, installed as part of the update701
  1595.             package, to manage PCI devices whose drivers support PCI Hot Plug
  1596.             capabilities (for example, DDI8 based drivers).
  1597.  
  1598.     deBASEdoc, esBASEdoc, frBASEdoc
  1599.             The updated localized documentation packages include updated
  1600.             SCOhelp topics in French (frBASEdoc), German (deBASEdoc), and
  1601.             Spanish (esBASEdoc).
  1602.  
  1603.     hba (set)
  1604.             A complete set of supported Host Bus Adapter drivers is found in
  1605.             the hba set. This set includes all previously-supported HBA
  1606.             drivers and the following new or updated drivers:
  1607.  
  1608.                adsb -- Adaptec PCI Ultra2 SCSI
  1609.                adsl -- Adaptec PCI SCSI
  1610.                c8xx -- Symbios PCI to SCSI
  1611.                dak -- Mylex DAC960 Array
  1612.                dpt -- DPT SCSI
  1613.                i2oOSM -- SCO I2O Mass Storage OSM                          
  1614.                qlc1020 -- QLogic PCI IQ
  1615.                qlc2100 -- QLogic PCI FC
  1616.  
  1617.  
  1618.     nics    The nics package contains drivers for all supported network
  1619.             adapters, including new support for the following:
  1620.  
  1621.                e3H driver
  1622.  
  1623.                3Com Fast EtherLink XL PCI (3C905B)
  1624.  
  1625.                dcfx driver
  1626.  
  1627.                DEC Fast EtherWORKS PCI 10/100 DE500-BA
  1628.  
  1629.                d21x driver
  1630.  
  1631.                Digital Semiconductor 21040 10 Ethernet
  1632.                Digital Semiconductor 21041 10 Ethernet
  1633.                Digital Semiconductor 21140 10/100 Ethernet
  1634.                Digital Semiconductor 21143/2 10/100 Ethernet
  1635.  
  1636.                skfp driver
  1637.  
  1638.                SysKonnect FDDI PCI adapter SK-5521 (SK-NET FDDI-UP)
  1639.                SysKonnect FDDI PCI adapter SK-5522 (SK-NET FDDI-UP DAS)
  1640.                SysKonnect FDDI PCI adapter SK-5541 (SK-NET FDDI-FP)
  1641.                SysKonnect FDDI PCI adapter SK-5543 (SK-NET FDDI-LP)
  1642.                SysKonnect FDDI PCI adapter SK-5544 (SK-NET FDDI-LP DAS)
  1643.                SysKonnect FDDI PCI adapter SK-5821 (SK-NET FDDI-UP64)
  1644.                SysKonnect FDDI PCI adapter SK-5822 (SK-NET FDDI-UP64 DAS)
  1645.                SysKonnect FDDI PCI adapter SK-5841 (SK-NET FDDI-FP64)
  1646.                SysKonnect FDDI PCI adapter SK-5843 (SK-NET FDDI-LP64)
  1647.                SysKonnect FDDI PCI adapter SK-5844 (SK-NET FDDI-LP64 DAS)
  1648.  
  1649.             This package also contains a variety of enhancements to
  1650.             previously-supported drivers.
  1651.  
  1652.     _________________________________________________________________________
  1653.        NOTE  Additional information about many of these packages appears
  1654.        in the online /info hierarchy on the UnixWare 7 Operating System
  1655.        Updates CD-ROM:
  1656.  
  1657.        audio     /info/audio/readme.txt
  1658.  
  1659.        basex     /info/basex/readme.txt
  1660.  
  1661.        cpqhpcd   /info/cpqhpcd/readme.txt
  1662.  
  1663.        hba       /info/hba/readme.txt
  1664.  
  1665.        nics      /info/nics/readme.txt
  1666.  
  1667.        xclients  /info/xclients/readme.txt
  1668.  
  1669.        xdrivers  /info/xdrivers/readme.txt
  1670.  
  1671.        xserver   /info/xserver/readme.txt
  1672.  
  1673.     _________________________________________________________________________
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  Chapter 4
  1681.  Hardware notes
  1682.  
  1683.     This chapter supplements the information in the UnixWare 7 System
  1684.     Handbook and on the SCO web site, to which you should also refer for
  1685.     information about hardware supported for UnixWare.
  1686.  
  1687.     This chapter covers the following areas:
  1688.  
  1689.     +  Supported hardware
  1690.  
  1691.     +  Hardware compatibility issues
  1692.  
  1693.     +  Upgrading video adapters
  1694.  
  1695.     +  Hardware configuration notes
  1696.  
  1697.     +  Hardware limitations and workarounds
  1698.  
  1699.  
  1700.  Supported hardware
  1701.  
  1702.     To determine if your hardware is supported, please see the following
  1703.     README files on the UnixWare 7.0.1 Operating System Supplements CD-ROM:
  1704.  
  1705.     /info/hardware/audio.txt
  1706.                             sound cards and other audio devices
  1707.  
  1708.     /info/hardware/hba.txt  host bus adapters (HBAs)
  1709.  
  1710.     /info/hardware/isdn.txt ISDN adapters
  1711.  
  1712.     /info/hardware/mp.txt   multiprocessor support modules
  1713.  
  1714.     /info/hardware/nics.txt network adapters
  1715.  
  1716.     /info/hardware/xdrivers.txt
  1717.                             graphics adapters
  1718.  
  1719.     For information on hardware that is newly supported in UnixWare 7.0.1,
  1720.     see the lists in Chapter  3, ``Updating your system''.
  1721.  
  1722.     SCO is constantly adding support for additional hardware devices.  Check
  1723.     the SCO Compatible Hardware Web Pages (http://www.sco.com/chwp) regularly
  1724.     to see if hardware not listed in these Release Notes or in the online
  1725.     READMEs is now supported.
  1726.  
  1727.  
  1728.  Hardware compatibility issues
  1729.  
  1730.     Except where noted, the hardware described in SCO documentation has been
  1731.     tested with UnixWare 7 systems. However, because the manufacturers of
  1732.     compatible machines or add-on peripherals may change configuration,
  1733.     functionality, or firmware at any time, no guarantee is implied.
  1734.  
  1735.     To determine whether hardware components are compatible with your
  1736.     machine, you must know the processor (for example, 486 or Pentium) and
  1737.     the bus architecture (ISA, EISA, MCA and PCI) that it uses.  You should
  1738.     also be aware of the type of disk controller in your system.
  1739.  
  1740.     If you have added any adapters, make sure that all switches or software-
  1741.     controlled settings are set as recommended in the manufacturer's hardware
  1742.     manual for that board. Some computers require specific switches or
  1743.     software-controlled settings to run UnixWare systems. If your computer
  1744.     does not run the UnixWare system with the settings as shipped, contact
  1745.     your computer hardware representative for the proper settings.
  1746.  
  1747.     UnixWare supports ``versioning schemes'' to allow the operating system to
  1748.     support a range of devices of a given type without mixing older and newer
  1749.     fixtures within the driver. This makes for more robust drivers and
  1750.     simplifies driver development and support. Versions are implemented for
  1751.     various driver configuration files documented in Section 4dsp manual
  1752.     pages to specify different formats for the file.
  1753.  
  1754.     The principal versioning scheme is ``driver interface versioning'', which
  1755.     defines the set of interfaces used to code the driver. A driver's
  1756.     interface versions are set in the ``$interface'' field of the driver's
  1757.     Master(4dsp) file.  This file should be supplied with the driver; current
  1758.     driver versioning has been implemented for all devices listed in
  1759.     ``Supported hardware''.  If your device is not listed, consult your
  1760.     hardware vendor for the most current driver interface version.
  1761.  
  1762.     For example, DDI (Device Driver Interface) is the primary interface
  1763.     versioning scheme that is used for all kernel drivers. DDI8 is the newest
  1764.     interface version that is supported for UnixWare, but drivers written for
  1765.     DDI5 and later versions will run without modification on UnixWare.
  1766.     However, drivers written for DDI versions prior to version 8 do not
  1767.     support DDI8 features such as hotplug.  Other interface versions include
  1768.     SDI for mass storage devices and MDI for network adapter cards.
  1769.  
  1770.     _________________________________________________________________________
  1771.        NOTE  Drivers written for DDI1 through 4 that ran on SCO UnixWare
  1772.        2.0 do not run on UnixWare 7 unless they are modified to support a
  1773.        later DDI interface version. SCO UnixWare 2.0 network adapter card
  1774.        driver interfaces were not supported by a versioned interface; most
  1775.        of these drivers will run on UnixWare but they cannot be rebuilt
  1776.        and are unlikely to run on future versions of the operating system.
  1777.        SCO OpenServer drivers do not support DDI interface version and
  1778.        will not run on UnixWare.
  1779.     _________________________________________________________________________
  1780.  
  1781.     For more information on interface versioning, see Intro(7).
  1782.  
  1783.  
  1784.  Upgrading video adapters
  1785.  
  1786.     UnixWare 7 supports a large number of video adapters including those
  1787.     supported under SCO UnixWare 2.X and SCO OpenServer Release 5. In
  1788.     addition, UnixWare 7 provides the vesa X server driver. This generic
  1789.     driver can operate any new video card that honors the VESA BIOS
  1790.     interface, and is useful in supplying high resolution support to video
  1791.     cards that do not have a specific accelerated driver.  For more
  1792.     information on this feature, including performance implications, see the
  1793.     online documentation on your installed UnixWare 7 system.
  1794.  
  1795.     Most video adapters are automatically configured when you install your
  1796.     UnixWare 7 system. However, you should record your video configuration
  1797.     from your previous operating system in case any of the following occurs:
  1798.  
  1799.     +  UnixWare 7 cannot automatically configure the adapter
  1800.  
  1801.     +  UnixWare 7 incorrectly configures the adapter
  1802.  
  1803.     +  you incorrectly configure the adapter manually and need to restore the
  1804.        default configuration
  1805.  
  1806.     To manually configure a video adapter in UnixWare 7, use the SCOadmin
  1807.     Video Configuration Manager.
  1808.  
  1809.  Upgrading SCO UnixWare 2.X video adapters
  1810.  
  1811.     On your SCO UnixWare 2.X system, view or print the file
  1812.     /usr/X/defaults/Xwinconfig. This file contains keyboard, video adapter,
  1813.     and monitor definitions. The important lines are shown here:
  1814.  
  1815.          chipset = GD54xx                # video chipset
  1816.            model = "GD54xx"              # the core drawing lib for this class
  1817.       vendor_lib = gd54xx_256.so.2       # chip specific drawing lib
  1818.     virtual_size = 1024x768              # actual Frame Buffer size
  1819.           vendor = "Cirrus Logic - Generic"              # vendor name
  1820.  
  1821.     From this information, you can determine that the configured video
  1822.     adapter is a Cirrus Logic GD54xx series model configured for 1024x768
  1823.     mode.
  1824.  
  1825.     Record this information, then (if auto-detection or auto-configuration
  1826.     fails) use it to configure your adapter on UnixWare 7 using the SCOadmin
  1827.     Video Configuration Manager.
  1828.  
  1829.  Upgrading SCO OpenServer Release 5 video adapters
  1830.  
  1831.     To obtain information about the currently configured adapter, run the
  1832.     Video Configuration Manager.
  1833.  
  1834.     The display at the top of the screen lists the name of the adapter, any
  1835.     configured monitor, and the resolution.
  1836.  
  1837.     Record this information, then (if auto-detection or auto-configuration
  1838.     fails) use it to configure your adapter on UnixWare 7 using the SCOadmin
  1839.     Video Configuration Manager.
  1840.  
  1841.  Troubleshooting video configuration
  1842.  
  1843.     If you install your UnixWare 7 system and find that your video adapter is
  1844.     incorrectly configured, or you want to modify configuration, try the
  1845.     following.
  1846.  
  1847.     To run your system in a safe video mode
  1848.  
  1849.     Enter /usr/bin/X11/setvideomode -stdvga. This sets IBM VGA 640x480-16
  1850.     mode, which is almost always safe for any adapter.
  1851.  
  1852.     To restore the adapter's default configuration
  1853.  
  1854.     Enter /usr/bin/X11/setvideomode -default.
  1855.  
  1856.     Do this if initial auto-configuration worked well enough to get the video
  1857.     working, but you manually configured the adapter to a different setting
  1858.     and lost the use of the video adapter.
  1859.  
  1860.     This -default option restores the settings to initial auto-configuration
  1861.     defaults.
  1862.  
  1863.     To determine the video adapter in the system
  1864.  
  1865.     Enter /usr/bin/X11/VideoHelp.
  1866.  
  1867.     This command lets you know what video adapter is present on your system.
  1868.  
  1869.     If the video Configuration Manager is run in the graphical environment,
  1870.     the configuration could be lost after a reboot. Change video modes only
  1871.     on virtual terminals in text mode.
  1872.  
  1873.  
  1874.  Hardware configuration notes
  1875.  
  1876.     The UnixWare 7 System Handbook contains details of hardware
  1877.     configuration.
  1878.  
  1879.  
  1880.  Hardware limitations and workarounds
  1881.  
  1882.     The following limitations and workarounds apply to hardware and device
  1883.     drivers in UnixWare:
  1884.  
  1885.     Hot Plug PCI and replacement network adapters
  1886.          If your system supports Hot Plug PCI, then a network adapter can be
  1887.          hot replaced, but the replacement adapter must be of an identical
  1888.          make and model to the original.
  1889.  
  1890.     Device drivers not supported
  1891.          The following device drivers are no longer supported:
  1892.  
  1893.          +  c7xx for Symbios Logic 53c7xx chipsets
  1894.  
  1895.          +  efp2 for the Olivetti SCSI host adapter
  1896.  
  1897.          +  fdeb for the Future Domain HBA
  1898.  
  1899.          +  ida for older discontinued Compaq host adapter models IDA, IDA-E
  1900.             and IDA-2
  1901.  
  1902.          +  mcis for SCSI host bus adapters
  1903.  
  1904.          +  wd7000 for MicroChannel Integral SCSI host bus adapters
  1905.  
  1906.          +  zl5380 for Trantor T160 host adapter and the SCSI interface
  1907.             provided by the Media Vision Pro Audio Spectrum 16 host adapter
  1908.  
  1909.     DDI8 device files not deleted
  1910.          DDI8 device files in /dev are not deleted when a device is removed.
  1911.  
  1912.     STREAMS module and driver in same code do not load
  1913.          All drivers must have unique names, even in the case of a STREAMS
  1914.          module and a STREAMS device driver built together in one Driver.o.
  1915.          If such a combination STREAMS module/driver is also using a DDI
  1916.          version older than version 8, this failure will panic the system.
  1917.  
  1918.     ds_qlen not set for CLARiiON arrays
  1919.          The CLARiiON arrays on the Unisys XR6 do not report the
  1920.          instantaneous qlength (ds_qlen in met_disk_stats).
  1921.  
  1922.     Error from sdipath
  1923.          On a system with two qlc1020 adapters and two disks attached, when
  1924.          sdipath(1M) is used to fail or repair a path an error similar to the
  1925.          following may occur:
  1926.  
  1927.          UX:sdipath: ERROR: Could not find path for disk2.
  1928.          :4:Path path85 has been failed.
  1929.  
  1930.          The command is completed successfully.
  1931.  
  1932.     Hot swap on MPIO-based SCSI bus
  1933.          It is not possible to hot-swap disks on an MPIO-based SCSI bus.
  1934.  
  1935.     adsl driver may generate errors
  1936.          The adsl driver may generate errors similar to the following on
  1937.          systems with multiple Adaptec adapters:
  1938.  
  1939.          date system_name unx: WARNING: adsl: device queue full [810070311]
  1940.          (ha/targetID/ lun 0/0/ 0)
  1941.          date system_name unx: WARNING: DiskDriver: HA 0 TC 0 LU 0 -I/O Error
  1942.          0x4DD13002
  1943.          date system_name unx: WARNING: adsl: device queue full [810070311]
  1944.          (ha/targetID/ lun 0/0/ 0)
  1945.          date system_name unx: WARNING: DiskDriver: HA 0 TC 0 LU 0 -I/O Error
  1946.          0x4DD13002
  1947.  
  1948.          These may be ignored.
  1949.  
  1950.     Dependencies of DDI8 drivers
  1951.          DDI8 drivers may not have circular dependencies.  idbuild(1M) will
  1952.          report non-DDI8 drivers which have circular dependencies, but these
  1953.          are acceptable.
  1954.  
  1955.     System with MPIO cannot initialize multiple disks
  1956.          On a system with an MPIO driver, you cannot initialize disks using
  1957.          the Volume Manager. (See ``Initializing the Volume Manager'' in
  1958.          Online Data Manager overview and installation for full details of
  1959.          initializing disks.)
  1960.  
  1961.          To initialize multiple disks, turn the MPIO driver off, initialize
  1962.          the disks, then turn the MPIO driver back on.
  1963.  
  1964.     c8xx controllers
  1965.          adding the c8xx package to a system with no c8xx controller will
  1966.          panic the system on reboot.  This occurs because the driver attempts
  1967.          to be loaded on reboot even though a controller does not exist.  To
  1968.          prevent this occurrence, please make certain that a c8xx controller
  1969.          is present in the system when the package is installed.
  1970.  
  1971.     Zyxel modem definition
  1972.          When using the Zyxel modem, you should use the Hayes deinition
  1973.          rather than the autodetect mechanism.
  1974.  
  1975.     Tricom modem profile
  1976.          Before you use the Tricom Tempest 34 Modem, edit the file
  1977.          /etc/uucp/default/Tricom_Tempest_34 to change the entry
  1978.          ``MDM_SETUP=&K3\N3'' to ``MDM_SETUP=AT&K3\N3''.
  1979.     Connection server fails to return protocol information
  1980.          The Connection server fails to return protocol information to an
  1981.          application when it is determined by class from the ISDN dialer.
  1982.  
  1983.     Downloading firmware to qlogic adapter is slow
  1984.          At bootup time, the qlc1020 driver may take several minutes to
  1985.          download firmware to the adapter.
  1986.  
  1987.     Duplicate controller numbers
  1988.          On Compaq systems with an IDE controller and with more than one
  1989.          Compaq HBA installed (either SCSI-2 using the cpqsc driver, or SMART
  1990.          arrays using the ida driver), it is possible to get duplicate
  1991.          controller numbers in the resource manager database. This will
  1992.          result in a message at boot time requesting that you press <Esc> to
  1993.          continue or <Enter> to rebuild the kernel. The rebuild will occur
  1994.          automatically if no key is pressed for 30 seconds. The system will
  1995.          reboot and as the duplicate controller numbers remain in the
  1996.          database the process will loop.
  1997.  
  1998.          To recover from this reboot loop, press <Esc> to stop the kernel
  1999.          rebuild. After the system boots, run /sbin/dcu to change the UNIT
  2000.          number of the IDE controller to something unused by any other HBA
  2001.          controller on the system.  See dcu(1M) for instructions on how to
  2002.          run the DCU. You are likely to find that unit number 1 is not used
  2003.          by any other HBA controller. Be sure to save your changes when
  2004.          exiting the DCU. One additional reboot will be required so that the
  2005.          IDE driver will begin using the new UNIT number that you assigned
  2006.          using the DCU.
  2007.  
  2008.     IEEE 1284 compliant printers
  2009.          Some IEEE 1284 compliant printers do not operate correctly if the
  2010.          SELECTIN signal from the parallel port is asserted when printing.
  2011.  
  2012.          There are four tunable parameters that control the behavior of
  2013.          SELECTIN. They are LP0SELECT through to LP3SELECT.
  2014.  
  2015.          LP0SELECT indicates whether the SELECTIN signal on parallel printer
  2016.          port 0 should be asserted to select a printer.  LP1SELECT through to
  2017.          LP3SELECT have the same purpose for ports 1 through 3.
  2018.  
  2019.          If SELECTIN is to be asserted on port 0 while printing, set
  2020.          LP0SELECT to 1. Similarly for ports 1 through 3.
  2021.  
  2022.          If SELECTIN is not to be asserted on port 0 while printing, set
  2023.          LP0SELECT to 0. Similarly for ports 1 through 3.
  2024.  
  2025.          Note that many printers which are not IEEE 1284 compliant ignore the
  2026.          SELECTIN signal altogether, and so will be unaffected by the values
  2027.          to which these tunables are set.
  2028.  
  2029.     Selecting incorrect support modules
  2030.          During installation, UnixWare 7 automatically detects the
  2031.          multiprocessor configuration of your system and recommends a
  2032.          selection if you choose to install the Multiprocessor support
  2033.          package. Most of today's systems comply with the Intel
  2034.          multiprocessor specification.  In some cases, however, you need to
  2035.          select the vendor-specific multiprocessor support modules, which are
  2036.          listed on the multiprocessor selection page. Only if UnixWare cannot
  2037.          determine the appropriate multiprocessor support modules should you
  2038.          choose the selection by hand.
  2039.  
  2040.          Choosing the wrong multiprocessor support modules, for example,
  2041.          choosing the Compaq modules for a Compaq Proliant 2500 system, is a
  2042.          common error, because the option Compaq Proliant 2000 indicates the
  2043.          specific model, not a family of systems. This will often result in a
  2044.          kernel that will not boot properly.
  2045.  
  2046.          If you choose the incorrect support modules, interrupt the boot
  2047.          sequence, set PSM=atup, then, once the system has booted, use
  2048.          pkgrm(1M) to remove the osmp package and pkgadd(1M) to add the
  2049.          correct multiprocessor support modules.
  2050.  
  2051.     Corrupt display on Intel M440LX DP system
  2052.          On an Intel M440LX DP server board (such as the Micron NetFrame
  2053.          MVE5000) system with a Cirrus Logic 54M40 video chip on the
  2054.          motherboard using the native Cirrus Logic 54M40/30 driver, and the
  2055.          standard 0.5MB of video RAM, the SCOlogin screen is corrupt.
  2056.  
  2057.          This is because the graphics driver requires at least 1MB of video
  2058.          RAM to operate. The graphics device can be operated in high
  2059.          resolution mode by selecting the VESA driver within the Video
  2060.          Configuration Manager. To do this, start the Video Configuration
  2061.          Manager and press Modify.  If it then displays a short list of
  2062.          auto-detected adapters, press Configure adapter not listed above...
  2063.          to obtain a full list of all adapters. From the full list of
  2064.          adapters, near the bottom of the list, there will be an entry for
  2065.          ``VESA (...adapter name...)''. Choose this VESA entry.
  2066.  
  2067.     Remapping bad blocks from SCO OpenServer
  2068.          Remapping SCO OpenServer bad blocks may cause a panic with HBAs
  2069.          written to DDI 7.2.
  2070.  
  2071.          See ``Bad sector/track mapping'' in the online documentation for
  2072.          information about remapping disks.
  2073.  
  2074.     Stamps on converted SCO OpenServer disks
  2075.          When sdimkosr5(1M) converts disks from SCO OpenServer Server systems
  2076.          to be used on UnixWare 7 systems, it does not assign valid disk
  2077.          stamps on the converted disks.  As a result, the uninitialized disk
  2078.          stamps left on the converted disks may collide with stamps on other
  2079.          disks in MPIO configurations and cause data corruption.
  2080.  
  2081.     Compaq LTE5280
  2082.          On some newer laptop systems, the video drivers provided with
  2083.          UnixWare will fail to work properly. Contact your system vendor to
  2084.          ensure that you have the latest BIOS revision for your laptop.
  2085.  
  2086.     MPIO with two adsl drivers
  2087.          You cannot boot a system with MPIO installed that has two adsl 2944
  2088.          drivers configured on the same SCSI bus. A panic may occur if you
  2089.          try to do this.
  2090.  
  2091.     Storage Works RAID box
  2092.          At runtime, the Storage Works RAID box is not visible to the qlogic
  2093.          driver.
  2094.  
  2095.     Network adapters not suitable for network installation
  2096.          Systems that have the following network adapters cannot be used to
  2097.          perform a network installation:
  2098.  
  2099.             3Com 3C507 EtherLink 16 Series
  2100.             3Com 3C523 EtherLink MC Series
  2101.             Compaq NetFlex-1 ENET/TR (Board ID CPQ6100)
  2102.             Compaq NetFlex-2 ENET/TR (Board ID CPQ6101)
  2103.             Compaq NetFlex-2 TR (Board ID CPQ6002)
  2104.             Compaq NetFlex-2 DualPort ENET (Board ID CPQ6200)
  2105.             Compaq NetFlex-2 DualPort TR (Board ID CPQ6300)
  2106.             Intel 2104x/2114x based 10/100 Mbps Ethernet Controllers
  2107.               (Exceptions: SMC EtherPower 8432/8434 10 mbps PCI Ethernet
  2108.               Adapter, SMC EtherPower 9332DST/BDT/BVT 10/100 mbps PCI
  2109.               Adapter)
  2110.  
  2111.          In addition, adapters newly supported in UnixWare 7.0.1 (as listed
  2112.          in Chapter 3 of this book) are not suitable for performing a network
  2113.          installation. This limitation will be removed at a later date.
  2114.  
  2115.     Corrupted cursor
  2116.          The cursor is corrupted on systems with the following graphics
  2117.          adapters that have more than 64MB of memory:
  2118.  
  2119.          +  Diamond Stealth 64 (Trio64)
  2120.  
  2121.          +  S3 86c764
  2122.  
  2123.          +  S3 86c732
  2124.  
  2125.          To remedy this problem, for machines with more than 64MB but less
  2126.          than 2.5GB of memory, edit the grafinfo file as follows:
  2127.  
  2128.          +  Change each occurence of the following:
  2129.  
  2130.             MEMORY(0x4000000, 0x200000)
  2131.  
  2132.             to read:
  2133.  
  2134.             MEMORY(0xA0000000, 0x200000);   /* 2MB at 2.5GB */
  2135.  
  2136.             This moves memory to the 2.5GB limit.
  2137.  
  2138.          +  Change each occurence of the following:
  2139.  
  2140.             /* Set upper word of starting address: 0x4000000 (64 Mb) */
  2141.             out(0x3d4, 0x59);
  2142.             out(0x3d5, 0x04);       /* Upper byte 31:24 */
  2143.             out(0x3d4, 0x5a);
  2144.             out(0x3d5, 0x00);       /* lower byte 23:16 */
  2145.  
  2146.             to read:
  2147.  
  2148.             /* Set upper word of starting address: 0xA0000000 (2.5 Gb) */
  2149.             out(0x3d4, 0x59);
  2150.             out(0x3d5, 0xa0);       /* Upper byte 31:24 */
  2151.             out(0x3d4, 0x5a);
  2152.             out(0x3d5, 0x00);       /* lower byte 23:16 */
  2153.  
  2154.             The following two lines are changed:
  2155.  
  2156.             /* Set upper word of starting address: 0xA0000000 (2.5 Gb) */
  2157.             out(0x3d5, 0xa0);       /* Upper byte 31:24 */
  2158.  
  2159.          For machines with more than 4GB of memory, edit the grafinfo file as
  2160.          above, but instead of the fixed address of 0xA0000000, substitute
  2161.          the address assigned to the hardware by the PCI bus, which you can
  2162.          identify from the Resource Manager.
  2163.  
  2164.     Display corruption
  2165.          The Video Configuration Manager attempts to autodetect installed
  2166.          adapters whenever you use it to add or modify video configuration.
  2167.          When the manager is run in graphical mode, auto-detection might
  2168.          sometimes cause temporary corruption of your display. This condition
  2169.          is transient and benign, and it does not indicate problems with your
  2170.          video hardware or configuration.
  2171.  
  2172.     Serial OSA
  2173.          The serial OSA may take approximately five minutes to return
  2174.          information to managers and dialin services. Managers affected
  2175.          include:
  2176.  
  2177.          +  Serial Manager
  2178.  
  2179.          +  Network Configuration Manager
  2180.  
  2181.          +  Modem Manager
  2182.  
  2183.          The following message may be displayed:
  2184.  
  2185.             Determining configured serial ports
  2186.  
  2187.  
  2188.     SMC9332DST adapter
  2189.          The SMC9332DST adapter does not work on 10BaseT (10 Mbps) networks.
  2190.          The driver does not correctly detect media type for this model,
  2191.          though it does operate the SMC9332BDT correctly at 10Mbps.  The
  2192.          SMC9332DST adapter functions correctly on 100BaseTX networks.
  2193.  
  2194.     Matrox Mystique video driver
  2195.          You cannot use the CDE desktop on a system that uses a Matrox
  2196.          Mystique video driver.
  2197.  
  2198.     Removing modems using Network Configuration Manager
  2199.          After adding a modem device using the Network Configuration Manager,
  2200.          the option to remove the configured device will not be selectable
  2201.          from within the Network Configuration Manager. The configured modem
  2202.          can be removed by using the Modem Manager.
  2203.  
  2204.     Network Configuration Manager user
  2205.          You must be root to run the Network Configuration Manager.  It is
  2206.          not possible to run this manager as system owner.
  2207.  
  2208.     Toshiba Laptop Computers
  2209.          On many Toshiba laptop computers, the BIOS setup screen contains a
  2210.          configurable parameter for the Video Display Segment Address which
  2211.          defaults to ``E400''.  UnixWare 7 graphics modes will not function
  2212.          properly unless this parameter is set to ``C000''.
  2213.  
  2214.          If possible, set the parameter correctly before installation.  If
  2215.          you do not do so, the auto-detection of the video display chipset
  2216.          may fail and you will need to reconfigure it by hand later.
  2217.  
  2218.          If you have already installed UnixWare 7 on your laptop you will
  2219.          need to set the segment address correctly, then run the SCOadmin
  2220.          Video Manager to reset your display type.
  2221.  
  2222.  
  2223.  Console multiscreens
  2224.  
  2225.     In UnixWare 7, the default configuration of the console gives a similar
  2226.     look and feel to that of SCO OpenServer console multiscreens.
  2227.  
  2228.     When the system enters multiuser mode, seven multiscreen text login
  2229.     prompts and one graphical login prompt are presented. The traditional SCO
  2230.     OpenServer screen switch sequences can be used to navigate among the
  2231.     multiscreens, with the following exceptions:
  2232.  
  2233.     +  The first multiscreen is reached be pressing <Ctrl><Alt><Esc>, or
  2234.        alternatively <Ctrl><Alt>h, instead of <Ctrl><Alt><F1>.
  2235.  
  2236.     +  The graphical login prompt is reached by pressing <Ctrl><Alt><F1>.
  2237.  
  2238.     All the traditional SCO UnixWare 1 and 2 screen switch sequences have
  2239.     also been preserved and can be used in conjunction with the newer
  2240.     UnixWare switch sequences.  See the keyboard(7) manual page for further
  2241.     details of these. Users who prefer to use vtlmgr(1) and newvt(1) instead
  2242.     of multiscreens can still continue to do so. The default configuration
  2243.     described above uses virtual terminals 00 through 08. The first free
  2244.     virtual terminal available is therefore 09. To return the console to the
  2245.     traditional SCO UnixWare configuration without text login prompts, run
  2246.     the following command:
  2247.  
  2248.        sacadm -d -p contty
  2249.  
  2250.     The login prompts can be subsequently re-enabled by running the following
  2251.     command:
  2252.  
  2253.        sacadm -e -p contty
  2254.  
  2255.     If you prefer to have eleven text login prompts as in SCO OpenServer,
  2256.     instead of the default seven, you can run the following script to enable
  2257.     the extra login prompts:
  2258.  
  2259.        for i in 09 10 11 12
  2260.        do
  2261.        pmadm -a -p contty -s $i -S login -fu -v `ttyadm -V` \
  2262.        -m "`ttyadm -d /dev/vt$i -l console -s /usr/bin/shserv \
  2263.        -p \"Login (vt$i): \"`"
  2264.        done
  2265.  
  2266.  
  2267.     Note there must be no trailing spaces after the backslash (``\'')
  2268.     characters at the ends of the third and fourth lines.
  2269.  
  2270.     _________________________________________________________________________
  2271.        NOTE  This script was incorrect in the previous version of these
  2272.        release notes.  It is now correct.
  2273.     _________________________________________________________________________
  2274.  
  2275.     For more information on using multiscreens see ``Running programs
  2276.     simultaneously with multiscreen displays'' in the online documentation.
  2277.     Note that the diagram in this section indicates that the first
  2278.     multiscreen is on <Ctrl><Alt><F1>, when it is now on <Ctrl><Alt><Esc> as
  2279.     described above.
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  Chapter 5
  2286.  Software notes
  2287.  
  2288.     This section describes software limitations under the following headings:
  2289.  
  2290.     +  ``Localization and internationalization''
  2291.  
  2292.     +  ``System management''
  2293.  
  2294.     +  ``Command line and shell''
  2295.  
  2296.     +  ``Users and groups''
  2297.  
  2298.     +  ``Filesystems''
  2299.  
  2300.     +  ``Backup and restore''
  2301.  
  2302.     +  ``SCO ARCserve/Open''
  2303.  
  2304.     +  ``Printing''
  2305.  
  2306.     +  ``Networking''
  2307.  
  2308.     +  ``Mail and messaging''
  2309.  
  2310.     +  ``Desktop, SCOhelp and Netscape''
  2311.  
  2312.     +  ``X server and graphical environment''
  2313.  
  2314.     +  ``man pages''
  2315.  
  2316.     +  ``Security''
  2317.  
  2318.     +  ``Tcl''
  2319.  
  2320.     +  ``Emergency recovery with an encapsulated or mirrored root disk''
  2321.  
  2322.     +  ``XENIX''
  2323.  
  2324.     +  ``Domestic encryption''
  2325.  
  2326.     +  ``Documentation''
  2327.  
  2328.     See also Differences for SCO OpenServer and SCO UnixWare 1 and 2 users
  2329.     for areas in which UnixWare software differs from SCO UnixWare 2.0 and
  2330.     SCO OpenServer.
  2331.  
  2332.  
  2333.  Localization and internationalization
  2334.  
  2335.  
  2336.     +  The Latin1 locales which were provided in SCO UnixWare 2.1 in the IBM
  2337.        codepages 437, 850, 865, 646 and 863 are preserved for backward
  2338.        compatibility. They will be retired in the next release of UnixWare
  2339.        and are not supported in this release.
  2340.  
  2341.     +  The International Settings Manager should not be used to administer
  2342.        the settings on a remote system and should only be run as a foreground
  2343.        task.
  2344.  
  2345.     +  In single-user mode, the console is only configured correctly for
  2346.        displaying text. It is not configured correctly for entering of text.
  2347.        The root password can therefore only contain 7 bit characters if the
  2348.        root user wishes to be able to log in in single-user mode.
  2349.  
  2350.        Once logged in, the root user needs to do the following:
  2351.  
  2352.        1.  Run mapkey(1M)
  2353.  
  2354.        2.  Run mapchan(1M)
  2355.  
  2356.        3.  Run stty(1) with the istrip option to stop the high bit being
  2357.            stripped.
  2358.  
  2359.        4.  Set TERM=AT386-ie and export it.
  2360.  
  2361.        This is necessary before running any kind of command which is screen-
  2362.        orientated, for example, vi or scoadmin.
  2363.  
  2364.        In multiuser mode, on any virtual terminal other than vt00, the
  2365.        console is not configured correctly.  If a user's password contains
  2366.        8-bit characters they will not be able to log in on these virtual
  2367.        terminals.  If the console is in multibyte mode, any multibyte
  2368.        character will not be displayed correctly.
  2369.  
  2370.        Once logged in, an ordinary user in an 8-bit locale needs to run the
  2371.        following:
  2372.  
  2373.           /etc/mapchan
  2374.  
  2375.        An ordinary user in a multibyte locale needs to run the following:
  2376.  
  2377.           /sbin/loadfont
  2378.  
  2379.  
  2380.  Not internationalized or localized
  2381.  
  2382.     The following scoadmin managers, applications and commands are not
  2383.     internationalized, or are only partially internationalized, and therefore
  2384.     will only appear in English:
  2385.  
  2386.     scoadmin managers
  2387.  
  2388.  
  2389.     +  parts of the Netconfig (TCP, WAN) Manager
  2390.  
  2391.     +  ISA Plug and Play Configuration Manager
  2392.  
  2393.     +  Netscape Server Admin Manager
  2394.  
  2395.     +  the titles in the NetWare Service Manager
  2396.  
  2397.     +  Process Manager
  2398.  
  2399.     +  SLIP Manager
  2400.  
  2401.     +  Veritas Volume Manager
  2402.  
  2403.     +  The list of timezones in the Time Zone Manager is not translated.
  2404.  
  2405.  
  2406.     Applications
  2407.  
  2408.  
  2409.     +  VisionFS is not internationalized. The interface appears in English
  2410.        only.
  2411.  
  2412.     +  SCO ARCserve/Open is not internationalized and therefore displays its
  2413.        menus and other interface components in English only. It will backup
  2414.        and restore filenames which include non-ASCII characters.
  2415.  
  2416.     +  Lynx is only partially internationalized.  English messages appear on
  2417.        some menus and prompts.
  2418.  
  2419.     +  pine(1) is not internationalized and therefore displays all its
  2420.        messages in English.  In addition, pine does not support Japanese mail
  2421.        standard ISO2022-JP.
  2422.  
  2423.  
  2424.     Commands
  2425.  
  2426.  
  2427.     +  The messages for the following commands always appear in English:
  2428.  
  2429.        -  sdipath(1M)
  2430.  
  2431.        -  sdimkosr5(1M)
  2432.  
  2433.        -  rlpconf(1M)
  2434.  
  2435.        -  hpnpcfg(1M)
  2436.  
  2437.     +  The list of timezones is not translated.
  2438.  
  2439.     +  The responses to questions from fsck(1M) are not localized. Press
  2440.        ``y'' for ``yes'' and ``n'' for ``no'' in all locales.
  2441.  
  2442.  
  2443.  Documentation
  2444.  
  2445.  
  2446.     +  When the locale is set to one whose codeset is not Latin 1 (for
  2447.        example, C, Japanese, Polish, Russian), the following characters may
  2448.        be displayed incorrectly or cause the terminal layout to be disrupted
  2449.        when viewing the English documentation:
  2450.  
  2451.        -  Copyright
  2452.  
  2453.        -  Registered Trademark
  2454.  
  2455.        -  Plus or minus
  2456.  
  2457.        -  Acute accent
  2458.  
  2459.        -  ``Half'' character
  2460.  
  2461.        -  ``Multiply'' character
  2462.  
  2463.        The copyright character occurs only at the foot of man pages and on
  2464.        copyright pages. The other characters may occur intermittently
  2465.        throughout the documentation set.
  2466.  
  2467.     +  Searching is currently supported in English, French, German and
  2468.        Spanish.  Searching is not supported for Asian languages.
  2469.  
  2470.     +  The Verity search engine uses only English-language rules to find
  2471.        ``stemmed'' (plural and other inflected) forms of words.  This may
  2472.        result in spurious results in languages other than English.  If this
  2473.        is a problem, enclose all search strings inside double quote (``"'')
  2474.        characters.
  2475.  
  2476.  CDE and X11
  2477.  
  2478.  
  2479.     +  dtlogin(X1) does not support dead keys or compose keys.  In general,
  2480.        users should not select passwords that contain non-alphanumeric (8-
  2481.        bit) characters.
  2482.  
  2483.        On the German keyboard, the following ASCII characters are unavailable
  2484.        to dtlogin:
  2485.  
  2486.           ~ [ ] { } |  @
  2487.  
  2488.        On the Spanish keyboard, the following ASCII characters are
  2489.        unavailable to dtlogin:
  2490.  
  2491.            | @ # [ ] { }
  2492.  
  2493.        On the French keyboard, the following ASCII characters are unavailable
  2494.        to dtlogin:
  2495.  
  2496.           ~ # { } [ ] | `  ^ @
  2497.  
  2498.        Please refer to your own keyboard for details on other characters.
  2499.  
  2500.     +  The following Xkeyboards cannot be installed:
  2501.  
  2502.        -  Russian
  2503.  
  2504.        -  Polish
  2505.  
  2506.        -  Czech
  2507.  
  2508.        -  Hungarian
  2509.  
  2510.     +  Non-Latin1 locales, other than Japanese, are supported only on the
  2511.        console and not under X.  The primary reason for this is that no X
  2512.        fonts are provided for these locales.  Users may download their own
  2513.        fonts from a variety of sources.  They may also need to modify several
  2514.        X font resources.
  2515.  
  2516.        The non-Latin1 locales are:
  2517.  
  2518.        -  Chinese
  2519.        -  Croat
  2520.  
  2521.        -  Czech
  2522.  
  2523.        -  Greek
  2524.  
  2525.        -  Hungarian
  2526.  
  2527.        -  Polish
  2528.  
  2529.        -  Romanian
  2530.  
  2531.        -  Russian
  2532.  
  2533.        -  Slovak
  2534.  
  2535.        -  Slovenian
  2536.  
  2537.        -  Turkish
  2538.  
  2539.        -  Ukrainian
  2540.  
  2541.     Japanese
  2542.  
  2543.  
  2544.     +  Neither dtterm nor xterm(X1) correctly handles multibyte characters.
  2545.        Do not use them if you are in a multibyte locale such as Japanese.
  2546.  
  2547.     +  Japanese buttons do not display completely in a dtterm or xterm.
  2548.  
  2549.     +  The input method for Japanese using SJXM is not fully functional in a
  2550.        dtterm or xterm.
  2551.  
  2552.     +  dtmail does not support the Japanese mail standard ISO-2022-JP.
  2553.  
  2554.  
  2555.  System management
  2556.  
  2557.     See also ``Emergency recovery with an encapsulated or mirrored root
  2558.     disk''.
  2559.  
  2560.     +  In order to install the Data Management services (SCO(r)
  2561.        ARCserve(r)/Open), it is first necessary to install SCO NetWare (nuc
  2562.        and nwnet). This dependency exists even if your server is not
  2563.        connected to a NetWare LAN because SCO ARCserve/Open tests for the
  2564.        presence of NetWare at runtime.
  2565.  
  2566.     +  To use the command emergency_disk(1M) while you are logged in to the
  2567.        CDE desktop, you must specify the full pathname of the command:
  2568.  
  2569.           #sh /sbin/emergency_disk -d / diskette1
  2570.  
  2571.        This example assumes that you are logged in as root and that /sbin is
  2572.        in your PATH environment.
  2573.  
  2574.     +  fstyp(1M) does not recognize the format of the emergency boot
  2575.        floppies.
  2576.  
  2577.     +  This release of UnixWare 7 is 7.0.1.
  2578.  
  2579.     +  If the Online Data Manager (ODM) is installed on the system, messages
  2580.        stating that a panic dump is available in /swap are not displayed. The
  2581.        panic dump information is, however, always available in /swap.
  2582.  
  2583.     +  When you add an ODM license, the following message is displayed:
  2584.  
  2585.           unknown product with id 157
  2586.  
  2587.        This message indicates a correctly installed VxVM mirroring or ODM.
  2588.  
  2589.     +  The LDAP, Network Config and Virtual Domain SCOadmin managers cannot
  2590.        be run as system owner; they must be run as root.
  2591.  
  2592.     +  devnm(1M) works only on filesystems mounted on devices that have
  2593.        backing storage. It fails on memfs and under ODM, and on other
  2594.        pseudo-filesystems.
  2595.  
  2596.     +  To reboot from the kdb(1M) prompt, enter the following:
  2597.  
  2598.           kdb>> 1 0 mdboot 2 call
  2599.  
  2600.  
  2601.     +  Loading kdb(1M) dynamically does not enable the Debug Extension bit of
  2602.        cr4 on Pentium processors and higher. Use statically linked kdb on
  2603.        these processors.
  2604.  
  2605.     +  On some multi-processor systems, the keyboard may become irrecoverably
  2606.        corrupted while kdb(1M) is running. The only solution to this is to
  2607.        press the restart button on the computer.
  2608.  
  2609.     +  When installing an application such as a commercial database package
  2610.        which makes use of raw asynchronous I/O (AIO_RAW), you will need to
  2611.        change the mode, group and owner (as appropriate) of the device node
  2612.        /dev/async.  See Node(4dsp).
  2613.  
  2614.     +  The system variable SYSDUMP_SELECTIVE is not configurable via the
  2615.        System Tuner. See crash(1M) for details.
  2616.  
  2617.     +  You cannot run pkgtrans(1) from csh.
  2618.  
  2619.     +  The Installation Manager leaves the CD-ROM mounted when installation
  2620.        is complete. Use umount(1M) to unmount the CD-ROM before removing it.
  2621.        Enter the following:
  2622.  
  2623.           umount /dev/cdrom/cCbBtTlL
  2624.  
  2625.        from the shell. C,B,T, and L are controller, bus, target (SCSI ID),
  2626.        and logical unit number (LUN) respectively.
  2627.  
  2628.        Once the update is installed, use the command:
  2629.  
  2630.           umount /dev/cdrom/cdromN
  2631.  
  2632.        where N is the CD-ROM driver number.
  2633.  
  2634.     +  The license scheme used by UnixWare 7 is different from that used by
  2635.        UnixWare 2. Applications originally designed to install on UnixWare 2,
  2636.        such as Oracle(r) 7.3.3, use the file /etc/.snum to verify that the
  2637.        operating system is UnixWare. This file is not part of the UnixWare 7
  2638.        licensing system, and therefore the installation of these applications
  2639.        may fail.
  2640.  
  2641.        To work around this problem, log on to the system as root or the
  2642.        system owner and enter:
  2643.  
  2644.           touch /etc/.snum
  2645.  
  2646.  
  2647.     +  When limited space is available on the hard disk, it may not be
  2648.        possible to remove unwanted packages to free up more space. Try to
  2649.        install only packages that are actually required.
  2650.  
  2651.     +  Do not use cp(1) or any other method to replace an executable file
  2652.        with an updated version while the existing file is being executed.
  2653.        This will result in a core dump.
  2654.  
  2655.     +  The real time performance monitor, rtpm(1M), may lose track of the
  2656.        current tty if the same session runs for a number of days.
  2657.  
  2658.     +  The Process Manager exits if it is running in background when you view
  2659.        processes using tty(1).
  2660.  
  2661.     +  The first time the details of a cron(1M) job are displayed, there is
  2662.        an extra zero in front of the hour field.
  2663.  
  2664.     +  To use SCOadmin managers in single-user mode, you must first set the
  2665.        terminal type manually. To identify and set the correct terminal type,
  2666.        see /etc/default/coterm or run the following command:
  2667.  
  2668.           eval `defadm coterm TERM`; export TERM
  2669.  
  2670.  
  2671.     +  The ``h'' accelerator key selects only the Help menu in the System
  2672.        Defaults Manager. Use the mouse or <Tab> and <Space> keys to select
  2673.        the Hosts menu.
  2674.  
  2675.     +  You can select only years up to 2037 in the Set Time Manager.
  2676.  
  2677.     +  The desktop menu option Copy to Folder is useful only on the CDE
  2678.        desktop. Do not attempt to use it on other desktops.
  2679.  
  2680.     +  In addition to the /etc/magic file shipped with UnixWare, there is a
  2681.        Java class aware version of the file available on the Skunkware CD-
  2682.        ROM.
  2683.  
  2684.     +  You can only select one processor at a time in the Processor Manager.
  2685.  
  2686.     +  SCOadmin managers may take a long time to start if the machine goes
  2687.        off the network.
  2688.  
  2689.     +  You cannot set the values of a table of MIB items using the SCOadmin
  2690.        Intranet Manager. This must be done from the command line using
  2691.        setany(1Msnmp).
  2692.  
  2693.     +  pkgadd(1M) may display the following message before exiting:
  2694.  
  2695.           UX:mailx: WARNING: No message
  2696.  
  2697.        This is harmless and may be ignored.
  2698.  
  2699.     +  In the SCOadmin License Manager, when you select a license from the
  2700.        list in character mode, be sure to deselect any license you do not
  2701.        want to act on by using the arrow keys to highlight the item, then
  2702.        pressing the space bar.
  2703.  
  2704.     +  When a package fails to install for any reason, the installation GUI
  2705.        may still report that the set of packages that contains it was
  2706.        installed successfully. The message reporting the failure is generated
  2707.        by pkgadd(1M).
  2708.  
  2709.        Similarly, if the removal of a package fails, the GUI does not report
  2710.        the failure. The icon for the set of packages goes away and is not
  2711.        replaced by the package icon for the package that is still on the
  2712.        system.
  2713.  
  2714.        The log created by pkgadd, which contains details of the failed
  2715.        processes, is in /var/sadm/install/logs/pkg.log where pkg is the name
  2716.        of the package.
  2717.  
  2718.     +  You cannot run the network installation server as owner. Use a root
  2719.        login.
  2720.  
  2721.     +  If the -c option to pkgmk is specified, you must also specify the -r
  2722.        option.
  2723.  
  2724.     +  pkgmk does not work with a tape device.
  2725.  
  2726.     +  The information provided in the documentation about starting the Hot-
  2727.        Plug Manager is incorrect.  The correct procedures are as follows:
  2728.  
  2729.        You can start the Hot-Plug Manager in any of these ways:
  2730.  
  2731.        +  Choose SCOadmin from the SCO menu (above the SCO logo) on the CDE
  2732.           desktop, then select Hardware, then select Hot-Plug Manager.
  2733.  
  2734.        +  Start the SCOadmin launcher by entering scoadmin on the command-
  2735.           line, then select Hardware, then select Hot-Plug Manager.
  2736.  
  2737.        +  Enter scoadmin Hotplug Manager on the command-line (or abbreviate
  2738.           to scoadmin hot).
  2739.  
  2740.  
  2741.  Command line and shell
  2742.  
  2743.  
  2744.     echo ignores -n argument
  2745.        The built-in echo command in ksh(1) ignores the -n argument if
  2746.        provided. This may cause problems with legacy shell scripts.
  2747.  
  2748.     ksh fails when incorrect script run
  2749.        ksh(1) fails when an incorrect script similar to the following is run:
  2750.  
  2751.           foo()
  2752.           {
  2753.           echo ${$1}
  2754.  
  2755.        The following error is displayed:
  2756.  
  2757.           The error: ksh: syntax error: `1' unexpected
  2758.           Memory fault(coredump)
  2759.  
  2760.        In some circumstances, the failure may occur when the next shell
  2761.        command is run.
  2762.  
  2763.     TIMEOUT for sh
  2764.        The manual page for sh(1) incorrectly implies that TIMEOUT can be set
  2765.        in the user's .profile. TIMEOUT can be set only on a system-wide
  2766.        basis.
  2767.  
  2768.     tr (1)
  2769.        tr(1) now requires the dash (-) character to be escaped with a
  2770.        backslash (\).
  2771.  
  2772.     vi editor
  2773.        When you edit a multiline command from the history file using vi(1),
  2774.        the cursor does not correctly step over a newline character (displayed
  2775.        as ^J).  Therefore, the cursor position in the edit buffer is
  2776.        incorrect.  The multiline command can be edited correctly by entering
  2777.        control mode, fetching the multiline command and typing v. This will
  2778.        invoke the /bin/vi command.
  2779.  
  2780.     SCO OpenServer scoterm
  2781.        If you run the SCO OpenServer scoterm command, it will corrupt the
  2782.        entries in /var/adm/utmpx.  As a result, all further login attempts
  2783.        will be blocked (as well as causing invalid data for any other
  2784.        administration commands which use it) until the utmpx entry is
  2785.        removed, and a UnixWare command rebuilds it.  Since this corruption
  2786.        can not be prevented, it is recommended that the SCO OpenServer
  2787.        scoterm binary is not run on UnixWare.
  2788.  
  2789.     Passwords reported as locked
  2790.        The command passwd -s -a always shows the user's password as locked
  2791.        (``LK''), even when the password is present or missing.
  2792.  
  2793.     terminfo settings
  2794.        The commands vi(1), pg(1) and possibly others that use the terminfo(4)
  2795.        settings, may fail unexpectedly if the settings for stty(1) are
  2796.        changed from the default. Use the command
  2797.  
  2798.           stty sane
  2799.  
  2800.        to restore the default stty settings.
  2801.  
  2802.     Using cu as root
  2803.        If your system is configured with a modem that accepts incoming calls,
  2804.        you cannot use cu(1bnu) to log into a remote sh shell as root.
  2805.  
  2806.  
  2807.  Users and groups
  2808.  
  2809.  
  2810.     +  When you log into an FTP server, the home directory is always ``/''.
  2811.  
  2812.     +  The root user is not permitted to perform a number of system
  2813.        administration tasks from the desktop. Only the root user, however,
  2814.        can install software using pkgadd(1M) from the command line.
  2815.  
  2816.     +  Only numbers and lower case letters are permitted in login names.
  2817.        Accented characters are not permitted.
  2818.  
  2819.     +  You cannot run the SCOadmin Account Manager in an xterm on an NCD-19
  2820.        system.
  2821.  
  2822.     +  If you create a user in the Account Manager and specify that the user
  2823.        must change the password at the first login, you must still enter a
  2824.        password in the password field. The user cannot log in without a
  2825.        password on the first login.
  2826.  
  2827.     +  The SCOadmin Account Manager does not set up a proper .login file for
  2828.        new csh users.  csh users wishing to use SCOadmin tools should add the
  2829.        following line to their .login:
  2830.  
  2831.           eval `/usr/lib/scoadmin/account/setenv -c $HOME`
  2832.  
  2833.        See csh(1) for full information.
  2834.  
  2835.     +  The SCOadmin Account Manager may create new user accounts with home
  2836.        directory permissions that differ from those specified in
  2837.        /etc/default/useradd. Use Options -> User Defaults in the Account
  2838.        Manager to set the desired permissions.
  2839.  
  2840.  
  2841.  Filesystems
  2842.  
  2843.     For VisionFS known problems and workarounds, see ``Late-breaking
  2844.     information'' in the online documentation.
  2845.  
  2846.     Panic when two processes close a FIFO
  2847.          A race condition may occur when two processes attempt to close the
  2848.          same FIFO. One process will find fn_open to be greater than 0 and
  2849.          will free the kernel memory for the stream. If that happens before
  2850.          the other process has woken up all the associated sleeping
  2851.          processes, the system will panic.
  2852.  
  2853.     NFS server man page
  2854.          The nfsd(1Mnfs) manual page for the NFS server front end refers to
  2855.          two options, -c and -q, which are not supported in UnixWare 7.
  2856.  
  2857.          These options relate to connection-based transports which are not
  2858.          supported by UnixWare 7 NFS, and should be ignored in the
  2859.          documentation.
  2860.  
  2861.     Listing of symbolic links over NWS
  2862.          The command ls -l (see ls(1)), when run over NWS, returns the size
  2863.          of the destination file, not that of the symbolic link in the
  2864.          directory in which it is run. This may cause problems when the
  2865.          output of the command is used as input to cpio(1).
  2866.  
  2867.     devnm
  2868.          The command devnm(1M) does not run on the root filesystem.
  2869.  
  2870.     Filesystem Manager permissions
  2871.          The owner may appear to not have permission to run the SCOadmin
  2872.          Filesystem Manager, even though permission has been granted.  This
  2873.          occurs when fsUtils.tlib has a newer date than fsUtils.tndx but the
  2874.          mode on fsUtils.tndx does not permit the owner to rebuild the .tndx
  2875.          file.
  2876.  
  2877.          Run the Filesystem Manager as root once, then it will work for
  2878.          owner.
  2879.     Bad block for VTOC causes panic
  2880.          The virtual table of contents (VTOC) resides on block 29 in the
  2881.          active UNIX Partition.  The system will panic if the physical block
  2882.          is bad. If this occurs, modify the UNIX partition by moving it up
  2883.          one cylinder so that the 29th block in the active partition no
  2884.          longer touches the bad block and is not used at all.
  2885.  
  2886.     Advanced Option option in Filesystem Manager
  2887.          In the Filesystem Manager, the text in the option ``Advanced Options
  2888.          for Mounting CD-ROM'' does not display correctly in character mode.
  2889.          Use the desktop version of the SCOadmin Filesystem Manager to use
  2890.          this option.
  2891.  
  2892.     Enabling DMAPI access to VXFS
  2893.          Data Management API (DMAPI) access to the kernel is not enabled by
  2894.          default.  Do the following to enable DMAPI kernel access.
  2895.  
  2896.          _______________________________________________________________________
  2897.             NOTE  Besides enabling DMAPI,  you must also license it before
  2898.             you can use it.
  2899.  
  2900.             VXFS must be configured into the system otherwise the system
  2901.             will not build with DMAPI.
  2902.          ______________________________________________________________________
  2903.  
  2904.  
  2905.          1.  Edit /etc/conf/sdevice.d/vxportal to change the second column of
  2906.              the last line from a N to a Y. That is, change this line:
  2907.  
  2908.                 vxportal    N   0   0   0   0   0   0   0   0   -1
  2909.  
  2910.              to this:
  2911.  
  2912.                 vxportal    Y   0   0   0   0   0   0   0   0   -1
  2913.  
  2914.  
  2915.          2.  Rebuild and reboot the system:
  2916.  
  2917.                 /etc/conf/bin/idbuild -B
  2918.  
  2919.  
  2920.     Veritas Volume Manager (VxVM)
  2921.          The Veritas Volume Manager (VxVM) product will not install if the
  2922.          system is configured to have a separate /var file system.  If you
  2923.          wish to use VxVM to manage the root disk do not configure your
  2924.          system to have a separate /var file system.
  2925.  
  2926.     Shared directories error VxFS
  2927.          The Filesystem Manager may incorrectly display the following error
  2928.          when specifying shared directories on high-specification systems:
  2929.  
  2930.             Error while sharing directory
  2931.  
  2932.          This error is caused because the copy of the filesystem database
  2933.          that the graphical manager uses is updated only once per second. The
  2934.          process of sharing a filesystem updates the filesystem record more
  2935.          quickly than this on a fast system, and the modification date on the
  2936.          filesystem may therefore not match that of its record.
  2937.  
  2938.     You should install osmp during system installation if possible, in order
  2939.     to avoid possible corruption of large drivers that may occur when ODM is
  2940.     installed without osmp being present. This corruption may cause the
  2941.     Volume Manager and other managers to crash.
  2942.  
  2943.     In the SCOadmin Filesystem Manager, in a character environment, the
  2944.     Select button for the Remote Directory field on the Add Remote Filesystem
  2945.     screen is not reachable. Either enter the remote directory name by hand
  2946.     or use the X/Motif version of the Filesystem Manager.
  2947.  
  2948.     The SCOadmin Filesystem Manager may not show any mount status information
  2949.     after the Volume Manager has been installed. Refresh the view in the
  2950.     Filesystem Manager by selecting View -> Disk Usage then selecting View -
  2951.     > Mount Status again.
  2952.  
  2953.  Netscape and NFS
  2954.  
  2955.     Files may be truncated when saved from the Netscape browser and other
  2956.     clients to remote NFS filesystems.  This problem can only occur if the
  2957.     NFS filesystem is explicitly mounted with the intr or soft mount(1Mnfs)
  2958.     options. If you do save files from clients onto a remote file system
  2959.     mounted with the intr or soft options, you should check the file contents
  2960.     immediately afterwards.
  2961.  
  2962.  Large file support
  2963.  
  2964.     Filesystems up to 2^40 bytes (1TB) are supported. A single file can thus
  2965.     consume up to 1TB of disk store. A sparse file can exhibit length up to
  2966.     2^63 bytes. New system interfaces, lseek64(2) and mmap64(2), permit
  2967.     operations of this entire length. Compiler extensions allow for a C
  2968.     application to conveniently manipulate files of such size via 64 bit
  2969.     integers (called ``long long'').
  2970.  
  2971.     The pax(1) utility supports the archival of files larger than 2 Gigabytes
  2972.     (2GB) in size when using the default ``ustar'' format.  Files up to
  2973.     2^63-1 bytes in size are supported. The pax utility also supports
  2974.     filenames and symbolic link filenames up to 1024 characters long when
  2975.     using the default ``ustar'' format. Older versions of pax will not be
  2976.     able to extract files larger than 2GB in size, or files whose filenames
  2977.     or symbolic link names are larger than 255 characters long.
  2978.  
  2979.     The cpio(1) utility supports the archival of files larger than 2
  2980.     gigabytes (2GB) in size when using the ASCII (-c) or CRC (-H crc)
  2981.     formats. Files up to 2^63-1 bytes in size are supported. Previous
  2982.     versions of cpio will not be able to extract files larger than 2GB in
  2983.     size.
  2984.  
  2985.     A limited set of system utilities have been made large-file aware, and
  2986.     are noted as such on their respective manual pages.
  2987.  
  2988.     _________________________________________________________________________
  2989.        NOTE  Large file support is intended for specialized applications
  2990.        which need to deal with more than 2GB of data in a single file, and
  2991.        not for general purpose text files and similar.
  2992.     _________________________________________________________________________
  2993.  
  2994.  
  2995.  
  2996.  Backup and restore
  2997.  
  2998.     The SCO OpenServer version of cpio(1) is available so that you can
  2999.     restore archives made using the Backup Manager under SCO OpenServer. You
  3000.     should not use the SCO OpenServer command to make backups under UnixWare.
  3001.  
  3002.     Set the environment variable OSRCMDS=on to use the SCO OpenServer version
  3003.     of cpio or any command. Remember to unset the variable when you have
  3004.     finished restoring the backup.  Alternatively, use the full pathname
  3005.     /OpenServer/bin/cpio.
  3006.  
  3007.     Restore operations can be performed using the cpio utility on the command
  3008.     line. The examples included here assume you are using the standard tape
  3009.     device, /dev/ctape1.
  3010.  
  3011.     To restore a backup:
  3012.  
  3013.        cpio -iAmudB -I /dev/ctape1
  3014.  
  3015.     Restore individual files or directories by adding them to the end of the
  3016.     command line.  Use the full pathname and omit the leading ``/'', as in
  3017.     this example:
  3018.  
  3019.        tmp/hold/time
  3020.  
  3021.     Use the ``*'' Bourne shell wildcard character to restore a directory, as
  3022.     in this example:
  3023.  
  3024.        tmp/hold/other/*
  3025.  
  3026.     To verify a backup:
  3027.  
  3028.        cpio -itvn -I /dev/ctape1
  3029.  
  3030.     To list the files on a backup:
  3031.  
  3032.        cpio -iABmudq -I /dev/ctape1 \*
  3033.  
  3034.     This command reads the first file off the media.  Backups created by the
  3035.     SCO OpenServer Backup Manager include a file list called
  3036.     _BACKUP_CONTENTS_ at the beginning of each backup.  If the backup was
  3037.     created by another means, use this command to list the files:
  3038.  
  3039.        cpio -itv -I /dev/ctape1
  3040.  
  3041.     _________________________________________________________________________
  3042.        NOTE  When a disk is recovered, the size of the slices is rounded
  3043.        up. This means that the recovered filesystem may not fit on the
  3044.        same size disk if the backed up disk was nearly full.
  3045.     _________________________________________________________________________
  3046.  
  3047.  
  3048.  
  3049.  SCO ARCserve/Open
  3050.  
  3051.  
  3052.     SCO ARCserve/Open locks SCSI tape devices
  3053.             By default, SCO ARCserve/Open locks all of the SCSI tape devices
  3054.             attached to your system.  Because of this, your tape devices are
  3055.             unavailable for use by backup commands such as tar(1) or cpio(1),
  3056.             even if the devices are not currently in the process of
  3057.             performing a backup or restore operation by SCO ARCserve/Open.
  3058.  
  3059.             ___________________________________________________________________
  3060.                NOTE  SCO ARCserve/Open Lite, the version of ARCserve/Open
  3061.                provided by default with UnixWare 7 is limited to the use
  3062.                of a single SCSI tape drive.
  3063.             ___________________________________________________________________
  3064.  
  3065.             Depending on the number of tape devices available on your system,
  3066.             there are two possible workarounds to this situation.
  3067.  
  3068.             +  If your system contains a single SCSI tape drive, you can
  3069.                temporarily unlock the device by running astop as root user to
  3070.                shut down the SCO ARCserve/Open backend. When you are finished
  3071.                using the tape drive, restart SCO ARCserve/Open by running
  3072.                astart as root user.
  3073.  
  3074.             +  If your system contains multiple tape drives, you can unlock
  3075.                one or more individual devices by editing the
  3076.                /usr/lib/ARCserve/tapesvr.cfg file and commenting out the
  3077.                desired devices in the Device Table section.  Specific
  3078.                instructions on how to make these changes are documented
  3079.                within the tapesvr.cfg file.
  3080.  
  3081.                _________________________________________________________________
  3082.                   NOTE  Any tape devices that are commented out of the
  3083.                   tapesvr.cfg file are unavailable to SCO ARCserve/Open.
  3084.                   You should only use this approach if you do not mind
  3085.                   dedicating a tape device to non-SCO ARCserve/Open uses.
  3086.                _________________________________________________________________
  3087.  
  3088.  
  3089.     ARCserve/Open and high security systems
  3090.             If you run ARCserve on a system that has been configured with
  3091.             high security, and you create a backup using the Compare Tape to
  3092.             Disk verification option, file privileges for any file backed up
  3093.             are lost. This harms the system because commands that depend on
  3094.             fixed or inherited privileges, such as ftp, rlogin, ping, passwd,
  3095.             and share fail for users other than root.
  3096.  
  3097.             There are two workarounds:
  3098.  
  3099.             +  If you have not already created a backup using the Compare
  3100.                Tape to Disk option, turn the option off, by selecting one of
  3101.                the other Backup Options (None or Scan Tape Contents) when
  3102.                scheduling your backup.
  3103.  
  3104.             +  If you already have removed permissions by running a backup
  3105.                with the Compare Tape to Disk option turned on, you can
  3106.                restore your privileges by logging in as root and executing
  3107.                the following command:
  3108.  
  3109.                /etc/security/tools/setpriv -x
  3110.  
  3111.  
  3112.  
  3113.  Printing
  3114.  
  3115.     The following notes apply to printing:
  3116.  
  3117.     +  You cannot add a printer using the Printer Setup Manager if the
  3118.        printer output is sent to a file instead of to a printer.
  3119.  
  3120.        To add a printer of this type, use the command line as follows:
  3121.  
  3122.           /usr/lib/scoadmin/printer/pradmin printer_name filename\
  3123.           lpadmin  -T hplaserjet -D "HP LaserJet 5L/5ML (PCL)" -I pcl\
  3124.           -m standard -v filename -A mail -o nobanner\
  3125.           -o "stty='clocal -onlcr'" -p filename
  3126.  
  3127.  
  3128.        lp must have permissions to write to the filename
  3129.  
  3130.     +  The Printer Setup Manager displays the following error message if you
  3131.        use it to add a NetWare printer:
  3132.  
  3133.           Unexpected error: Vtcl Server VtSet - Widget not found
  3134.  
  3135.        This may be ignored.
  3136.  
  3137.     +  In the Printer Setup Manager, if you attempt to specify a nonexistent
  3138.        port as the connection port when you add a printer, the process will
  3139.        fail.
  3140.  
  3141.     +  When you use the Printer Setup Manager to add, copy or view the
  3142.        details of a TCP/IP printer connected via a remote server, using the
  3143.        <Tab> key to move the cursor across the screen again to the field ``On
  3144.        Remote Server'' erroneously toggles the values given for Remote Server
  3145.        and Remote Printer.
  3146.  
  3147.     +  <Del> has no effect on the Printer Setup Manager.  <Ctrl>C puts the
  3148.        terminal into raw mode, and should be avoided.
  3149.  
  3150.     +  The SCOadmin Printer Setup Manager does not permit printer names to
  3151.        contain the ``_'' character. To add a printer whose name includes a
  3152.        ``_'', add it from the command-line.  Once the printer name is
  3153.        created, the Printer Setup Manager will be able to manage it.
  3154.  
  3155.     +  If you install the highest level of security during installation, the
  3156.        Printer Setup Manager will not execute.
  3157.  
  3158.     +  To print to Hewlett-Packard printers, you must have installed the
  3159.        netmgt package.
  3160.  
  3161.  
  3162.  Networking
  3163.  
  3164.     The following notes apply to networking:
  3165.  
  3166.     +  If you defer network configuration during installation, then use
  3167.        netcfg(1M) to configure network drivers, you must reboot the system
  3168.        for the network configuration to take effect.
  3169.  
  3170.     +  The associated ttymon entry is not deleted when a modem is deleted in
  3171.        the Modem Manager. Delete it by hand if necessary, using pmadm(1M)
  3172.        with the -r option.
  3173.  
  3174.     +  Version 4.9.7 of BIND, which is shipped with UnixWare, does not allow
  3175.        underscore characters in hostnames. This is in compliance with RFC952.
  3176.  
  3177.     +  The SCOadmin SNMP Agent Manager may fail to run with an error of the
  3178.        form:
  3179.  
  3180.           Fatal error: building package index for
  3181.           `/usr/lib/scoadmin/snmpmgr/generic.tlib' failed: couldn't open
  3182.           "/usr/lib/scoadmin/snmpmgr/generic.tndx": permission denied
  3183.  
  3184.        To resolve this problem, run the SNMP Agent Manager as root. After it
  3185.        has been run once by root, the SNMP Agent Manager can then be run by
  3186.        any user with owner privileges.
  3187.  
  3188.     +  If a socket performs a listen(3sock), a semaphore is allocated for the
  3189.        socket. By default, there are 150 semaphores available on the system.
  3190.        If more than 150 semaphores are required the kernel tunable SEMMNI
  3191.        must be increased.
  3192.  
  3193.        listen(3sock) will fail with ENOSPC if no semaphores are available.
  3194.  
  3195.     +  The routine hstrerror is not available.  The manual page
  3196.        gethostent(3N) is incorrect.
  3197.  
  3198.     +  When TCP/IP is stopped, a message is displayed from talkd(1Mtcp).
  3199.        This should be ignored.
  3200.  
  3201.     +  DHCP only supports a single subnet on each network interface
  3202.  
  3203.     +  If an NIS user who has a long password enters more than eight
  3204.        characters of the password, ftpd(1Mtcp) refuses the login. The user
  3205.        should only type the first 8 characters.
  3206.  
  3207.     +  A problem in IP puts the wrong value, 8 instead of 4, in the
  3208.        ``dl_dest_addr_length'' field of the DL_UNITDATA_REQ message sent
  3209.        downstream when ARP is disabled.
  3210.  
  3211.     +  RFC 1323 is not fully implemented in UnixWare 7. Specifically:
  3212.  
  3213.        -  ifconfig(1Mtcp) options relating to rfc1323 are not present.
  3214.  
  3215.        -  inconfig(1Mtcp) options relating to rfc1323 are not present.
  3216.  
  3217.        -  TCP/IP support for scalable windows and timestamps is not present.
  3218.  
  3219.     +  To remove a network adapter configured with TCP using the Network
  3220.        Configuration Manager in a graphical session, launch the manager from
  3221.        the Panorama desktop only.  Doing this task while the CDE desktop is
  3222.        running will cause CDE to hang.  To recover from a hung CDE desktop,
  3223.        switch to a character screen, and reboot the system.
  3224.  
  3225.     +  You may encounter an error message, similar to the following, when
  3226.        trying to configure IPX/SPX over token ring:
  3227.  
  3228.           NetWare IPX setup at Fri May 15 11:46:23 EDT 1998
  3229.           NWCM-2.1-147: Folder 7 is NOT valid.
  3230.           NWNET-2.1-232: Invalid frame_type for configured adapter_type
  3231.           Novell Protocol Suite Streams Architecture Daemon
  3232.           Reading configuration from "/etc/netware/nwconfig"
  3233.           IPX Internal Network configured, setting Router Type to FULL
  3234.           Problem starting up npsd
  3235.  
  3236.        If you see this message, you should enter:
  3237.  
  3238.           nwcm -s "lan_1_adapter_type=TOKEN-RING_DLPI
  3239.  
  3240.        and reboot the system.
  3241.  
  3242.     +  The connection server can dump core if the Systems file does not have
  3243.        a phone number in the phone number field.
  3244.  
  3245.        The work around is to place a '-' in the phone number field when you
  3246.        do not have any phone numbers (for Direct connections for example).
  3247.  
  3248.     +  When UnixWare attempts to communicate with older RPC mechanism, it may
  3249.        fail.  This is likely to happen if you try to NFS mount a disk on a
  3250.        system that uses older versions of the RPC mechanism.
  3251.  
  3252.     +  The Network Configuration Manager incorrectly deletes the domain name
  3253.        associated with the primary interface to a gateway in /etc/resolv.conf
  3254.        if the domain name for a second interface is added. You must update
  3255.        /etc/resolv.conf by hand to include both domain names. See
  3256.        resolv.conf(4tcp) for details.
  3257.  
  3258.     +  The  command finger(1tcp) may report the idle time of the session from
  3259.        which it is called incorrectly.
  3260.  
  3261.     +  If you have installed DNS, make sure you have a valid Ethernet
  3262.        connection.  If your Ethernet connection is faulty or disconnected,
  3263.        and you try to remove packages, the system tries to send email to
  3264.        acknowledge the package removal. The system uses the resolve.conf file
  3265.        in /etc that was created during the DNS installation to acknowledge
  3266.        the package removal.
  3267.  
  3268.        If the Ethernet is faulty, the system cannot reconcile any email
  3269.        addresses on the network. Thus the system will appear to hang. If this
  3270.        occurs, ensure the Ethernet connection is valid and retry the package
  3271.        removal, or kill the email processes to free up the removal process.
  3272.  
  3273.     +  Do not specify a fully qualified domain name (FQDN) when adding a
  3274.        hostname to a primary zone using the DNS Manager. The domain name for
  3275.        the zone is appended automatically. For example, specify the hostname
  3276.        ``myhost'' rather than ``myhost.test.net.'' in the Records -> Add -
  3277.        > Host -> Hostname dialog.
  3278.  
  3279.     Anonymous FTP configured as NIS user
  3280.        When you use the FTP Server Manager to create the anonymous FTP user,
  3281.        if the host under configuration is a client in an NIS domain, the
  3282.        creation of the anonymous FTP user will fail if the user is already
  3283.        present in the NIS domain.
  3284.  
  3285.        To create a local anonymous FTP user, temporarily suspend NIS; create
  3286.        the user using the FTP Server Manager; then resume NIS.
  3287.  
  3288.     +  To use netcfg(1M) in single-user mode, you must set the terminal type.
  3289.        To identify the terminal type, run the following command:
  3290.  
  3291.           eval `defadm coterm TERM`; export TERM.
  3292.  
  3293.  
  3294.     +  Incoming and outgoing ISDN V.120 calls are not supported.  Devices
  3295.        configured as type ISDN_ASYNC are not supported. Service types of
  3296.        isdn_async in Callfilter and Callservices are not supported.
  3297.  
  3298.  Networking: PPP
  3299.  
  3300.     The following notes and limitations apply to the PPP Manager and PPP
  3301.     Internet Connection Manager:
  3302.  
  3303.     +  By default an ISDN adapter is configured with the Line Direction of
  3304.        Outgoing and Incoming enabled.  If the Outgoing Line Direction is
  3305.        disabled in the Network Configuration Manager, the ISDN adapter will
  3306.        not be available to the PPP Manager for configuration with PPP.  Do
  3307.        not disable the Outgoing Line direction for an ISDN adapter if you
  3308.        intend to configure the adapter with PPP, even for an incoming only
  3309.        PPP bundle.
  3310.  
  3311.     +  If the host under configuration is a client in an NIS domain the
  3312.        creation of PPP user will fail if the user is already present in the
  3313.        NIS domain.
  3314.  
  3315.        To create a local PPP user, temporarily suspend NIS; create the user
  3316.        using the PPP Server Manager; then resume NIS.
  3317.  
  3318.     +  Ensure that all WAN devices are configured for communication in the
  3319.        direction required before including them in any PPP configuration. Use
  3320.        the WAN view of the Network Configuration Manager, netcfg(1M), to set
  3321.        the communication direction for each device.
  3322.  
  3323.     +  When creating outgoing connections, ensure that the remote host name
  3324.        for the destination system is configured correctly in the Dialup
  3325.        Systems Manager.
  3326.  
  3327.     +  When creating incoming connections ensure that the devices used for
  3328.        the links are configured in the Dialer Services Manager.
  3329.  
  3330.  Configuring router discovery on multiple routers
  3331.  
  3332.     The routing daemon, routed(1Mtcp), in UnixWare 7 implements router
  3333.     discovery by default.
  3334.  
  3335.     On a router (a system with more than one network interface configured,
  3336.     and with ipforwarding and ipsendredirects set to 1), routed advertises
  3337.     and responds to router discovery solicitation messages. Note that systems
  3338.     that are configured with both a LAN connection and a WAN connection (PPP
  3339.     or SLIP) may also be acting as routers to external networks such as the
  3340.     Internet.
  3341.  
  3342.     On non-routing hosts, routed keeps track of received router
  3343.     advertizements, adding a default route for the highest preference route.
  3344.     For this reason, multiple routers running router discovery on the same
  3345.     subnet should use different preference values. A preference value is an
  3346.     integer greater than 0. The most preferred route should have the highest
  3347.     value. You should not configure a router to advertize a route on an
  3348.     interface if this might lead to inefficient routing of packets through
  3349.     the local subnets.
  3350.  
  3351.     The following example entries from the /etc/inet/gateways configuration
  3352.     file on a router cause routed to advertize a route with a preference of
  3353.     10 on the subnet connected to the net1 interface, but not to advertize on
  3354.     the subnet connected to the net0 interface:
  3355.  
  3356.        if=net0 no_rdisc_adv
  3357.        if=net1 rdisc_pref=10
  3358.  
  3359.     If some routers on a subnet implement router discovery while others do
  3360.     not, or if identical or incorrect preference values are configured on the
  3361.     routers, non-routing hosts may install an incorrect default route.
  3362.  
  3363.     To disable router discovery on routers and non-routing hosts running
  3364.     routed:
  3365.  
  3366.     1.  Add the following line to /etc/inet/gateways (create this file if it
  3367.         does not already exist):
  3368.  
  3369.            no_rdisc
  3370.  
  3371.  
  3372.     2.  Find out the process ID (PID) of in.routed by entering the following
  3373.         command:
  3374.  
  3375.            ps -ef | grep in.routed
  3376.  
  3377.         The process ID is the number in the second column. For example, the
  3378.         PID in the following output is 1991:
  3379.  
  3380.            root  1991  1   TS  80  0 11:28:32 ?   0:02 /usr/sbin/in.routed
  3381.  
  3382.  
  3383.     3.  Kill and restart routed by entering the following commands:
  3384.  
  3385.            kill PID
  3386.            in.routed
  3387.  
  3388.         Alternatively, shut down and reboot the router.
  3389.  
  3390.  NetWare Services
  3391.  
  3392.     The following notes apply to the NetWare Services software and
  3393.     documentation:
  3394.  
  3395.     NetWare licensing
  3396.  
  3397.     UnixWare 7 is shipped with a zero-user NetWare Services license. This
  3398.     allows an installed UnixWare system to participate in a NetWare network
  3399.     as documented without further action on your part. It is visible to other
  3400.     nodes, and users can see the NDS directory. For the system to use NWS
  3401.     services, you must obtain an Additive License Pack. Contact your SCO
  3402.     supplier for details.
  3403.  
  3404.     Directory Services Repair
  3405.  
  3406.     Running Directory Service Repair in an xterm can corrupt the display. To
  3407.     avoid this, run it on the console. See ``Directory Services Repair'' in
  3408.     the online documentation under Networking -> Administering NetWare
  3409.     Services (NWS) for information.
  3410.  
  3411.     The ``nwsup'' package
  3412.  
  3413.     The NetWare Services (NWS) ``nwsup'' package (NetWare Integration Kit) is
  3414.     not distributed with UnixWare 7, although references to it appear in the
  3415.     UnixWare 7 documentation.
  3416.  
  3417.     This package was distributed with SCO UnixWare 2.1 and contained floppy
  3418.     images of additional NetWare Loadable Modules (NLMs) which could be
  3419.     installed on top of existing Native NetWare servers.  These NLMs added
  3420.     support for additional UnixWare semantics when accessing files on the
  3421.     server (mode and ownership in particular).  They were known collectively
  3422.     as the ``NUC NLM'' or sometimes the ``UnixWare NLM''.
  3423.  
  3424.     A standard Native NetWare server supports file access semantics in what
  3425.     is called ``DOS Mode''. The NUC NLM added two more additional modes
  3426.     called ``NetWare Mode'' and ``UnixWare Mode'' which provided increasing
  3427.     levels of SCO UnixWare file access semantics.
  3428.  
  3429.     While the NUC NLM is no longer supported, references to ``NetWare Mode''
  3430.     and ``UnixWare Mode'' appear in the context of modes supported by the
  3431.     UnixWare NetWare server. These are still valid.  They are only obsolete
  3432.     when referring to the Native NetWare server with NUC NLMs added.
  3433.  
  3434.     This issue affects the Networking -> Administering NetWare Services
  3435.     (NWS) -> Administering NetWare Connectivity online documentation topic,
  3436.     particularly the following:
  3437.  
  3438.     +  Overview of NUC Connectivity
  3439.  
  3440.     +  NetWare Loadable Modules
  3441.  
  3442.     +  Accessing NetWare volumes from UnixWare
  3443.  
  3444.     +  NetWare backup and restore
  3445.  
  3446.     nwcm (1Mipx)
  3447.  
  3448.     The nwcm(1Mipx) manual page refers to the lan_x_adapter and lan_x_network
  3449.     parameters. These can no longer be accessed via nwcm: instead,
  3450.     configuration of these values is now handled with the netcfg(1M) utility.
  3451.  
  3452.     Directory Services installation in an xterm
  3453.  
  3454.     The Directory Services installation program may display empty dialog
  3455.     boxes when used in an xterm.  To avoid this, run it on the console.
  3456.  
  3457.     NetWare Setup
  3458.  
  3459.     The owner user cannot use NetWare Setup. The root user must use this
  3460.     manager.
  3461.  
  3462.     NetWare installation from command line
  3463.  
  3464.     The online topic Networking -> Administering NetWare Services (NWS) -
  3465.     > Installing NetWare Services -> Installing using the command line the
  3466.     command
  3467.  
  3468.        pkgadd -d cdrom nws
  3469.  
  3470.     should be as follows:
  3471.  
  3472.        pkgadd -d cdrom1 nws
  3473.  
  3474.     This assumes that there is only one CD-ROM on the machine.  If you have
  3475.     more than one CD-ROM drive, enter
  3476.  
  3477.        pkgadd -d cdromn nws
  3478.  
  3479.     In this case, n is the number of the CD-ROM drive in which you have
  3480.     inserted the CD-ROM.
  3481.  
  3482.  
  3483.  Mail and messaging
  3484.  
  3485.     The following notes apply to mail and messaging:
  3486.  
  3487.     +  biff(1) and comsat(1M) are not supported in UnixWare.
  3488.  
  3489.     +  xbiff(X1) is not fully supported in UnixWare.  It does not
  3490.        automatically determine the location of users' mailboxes configured in
  3491.        the message store.  By default it will monitor mailbox location
  3492.        /usr/spool/mail/username, where username is your login name.  If
  3493.        users' mailboxes are configured to be in a location other than the
  3494.        system spool directory (/usr/spool/mail, which is a symbolic link to
  3495.        /var/mail), then you must specify the filename location to xbiff by
  3496.        using its -file filename command line option.
  3497.  
  3498.        Also, xbiff does not use the ``flagup'' and ``flagdown'' bitmaps by
  3499.        default to show incoming mail status (as reported in the man page
  3500.        text), but rather uses the image of a two-tiered ``inbox'' which
  3501.        becomes filled with messages.
  3502.  
  3503.     +  The Netscape MUA does not recognize the inbox folder location
  3504.        specified for the message store configuration in /etc/default/mail.
  3505.  
  3506.     +  The message New mail has arrived is displayed after mailx(1) even when
  3507.        messages have been read or deleted.
  3508.  
  3509.     +  mailx(1) cannot make an IMAP connection to a remote host when the user
  3510.        is root, because IMAP will not allow root login for security reasons.
  3511.        If this is attempted, the message No new mail may be displayed when
  3512.        there is mail on the remote host.
  3513.  
  3514.     +  When mailx(1) is run as an IMAP client, the ``From '' line of a
  3515.        displayed message shows the date instead of the correct sender.
  3516.  
  3517.     +  Mail folders may not be configured as hard or symbolic links. The
  3518.        message store system will reject them for security reasons.
  3519.  
  3520.     +  For a non-networked system, the sendmail(1M) startup script
  3521.        /etc/mail/sendmailrc (which is linked to /etc/rc2.d/S81sendmail,
  3522.        /etc/rc1.d/K68sendmail, and /etc/rc0.d/K68sendmail) automatically
  3523.        creates the file /etc/service.switch with an entry which directs
  3524.        sendmail to only look up host names in /etc/hosts, effectively
  3525.        disabling DNS lookups.  The sendmailrc script overwrites any existing
  3526.        /etc/service.switch file. You must therefore edit /etc/mail/sendmailrc
  3527.        if you wish to include your own customizations for service.switch.
  3528.  
  3529.        See ``The service switch'' in the online documentation under Mail and
  3530.        Messaging -> Administering Mail and Messaging -> sendmail operations
  3531.  
  3532.     +  If you have added or removed a networking card from your hardware
  3533.        configuration using the Network Configuration Manager, you must stop
  3534.        and re-start sendmail(1M) in the case where the manager does not ask
  3535.        you to reboot the system.  You may do so by executing the following
  3536.        commands:
  3537.  
  3538.           /etc/mail/sendmailrc stop
  3539.           /etc/mail/sendmailrc start
  3540.  
  3541.  
  3542.  
  3543.  Desktop, SCOhelp and Netscape
  3544.  
  3545.  
  3546.     +  You cannot use the desktop File Manager to change the properties of
  3547.        files larger than 2GB.
  3548.  
  3549.     +  A rare race condition may occur on reboot that causes the following
  3550.         dtlogin error message to be displayed on the console:
  3551.  
  3552.           The X Server cannot be started on display machine_name:0
  3553.  
  3554.        The message incorrectly tells you to log in to the console and log out
  3555.        again to start dtlogin.  You must in fact log in to the console, use
  3556.        ps(1) to identify the dtlogin-daemon process, then send a kill -9
  3557.        signal to it.  You can now run scologin start command from the
  3558.        console.
  3559.  
  3560.     +  The <Del> key is not set up as the delete character for dtterm, which
  3561.        instead uses ^C as the delete character by default.  To use <Del> as
  3562.        the delete key, execute the following command in the dtterm window:
  3563.  
  3564.           stty intr ^?
  3565.  
  3566.        ``^?'' consists of the two characters ``^'' and ``?''.
  3567.  
  3568.     +  Using the Back button in the SCOhelp frame to return to the first page
  3569.        of search results causes an error. This is harmless, and may be
  3570.        ignored.  You may wish to redo the search.
  3571.  
  3572.     +  When you invoke SCOhelp from the SCO ARCserve/Open window, and click
  3573.        on any of the hotlinks displayed, a Javascript error similar to the
  3574.        following is displayed:
  3575.  
  3576.           Window.node has no property named 'location'
  3577.  
  3578.        This error may be ignored. Click OK in the error window to close it.
  3579.  
  3580.     +  If you resize the SCOhelp window, a JavaScript error message is
  3581.        displayed.  This is harmless. Click OK to close the error message
  3582.        window.
  3583.  
  3584.     +  You cannot assemble a topic in SCOhelp for printing until the search
  3585.        capability has been enabled.
  3586.  
  3587.     +  When Netscape and SCOhelp browsers are open at the same time, exiting
  3588.        from either closes both browsers. To exit from just one browser, use
  3589.        the File -> Close menu option.
  3590.  
  3591.     +  The Back and Forward buttons in each frame in the SCOhelp browser
  3592.        behave differently from the buttons with the same names in the browser
  3593.        tool bar and in the Netscape browser. The frame buttons work within
  3594.        frames, but only with the UnixWare online documentation set.
  3595.        Navigating to pages outside the documentation set causes the frame
  3596.        buttons to behave in unpredictable ways.
  3597.  
  3598.     +  A PostScript version of the Netscape Navigator Gold Authoring Guide is
  3599.        available
  3600.  
  3601.        on the web at:
  3602.  
  3603.           http://www.sco.com/documentation/postscript/navau/goldauth/
  3604.  
  3605.  
  3606.     +  The Directory buttons (and Directory menu options) have changed for
  3607.        the UnixWare version of Netscape.  To return to standard Netscape
  3608.        Directory behavior, move aside the following file:  /usr/X/lib/app-
  3609.        defaults/Netscape.cfg.
  3610.  
  3611.     +  In some circumstances, you may not be able to return to SCOhelp via
  3612.        the Netscape back buttons. If this happens, select File -> Open
  3613.        Location and enter the address localhost:457.
  3614.  
  3615.     +  SCOhelp may not be able to access the documentation set if the help
  3616.        browser was installed while a network was configured, and the network
  3617.        is disconnected.
  3618.  
  3619.     +  The Netscape Mail/News Preferences window is too big for an 800x600
  3620.        display. This means that the OK, Cancel and Defaults buttons are not
  3621.        visible.
  3622.  
  3623.        You can access these buttons using the <Tab> key. Move the cursor to
  3624.        the last item on the tab, then press <Tab> once more to move the
  3625.        cursor to just off the screen for OK. Press <Tab> once again for
  3626.        Cancel, and a third time for Defaults. The next <Tab> should bring the
  3627.        cursor back to the top of the tab.
  3628.  
  3629.     +  If you kill all the processes owned by the current desktop user while
  3630.        you are root in a console on the Panorama desktop, the desktop becomes
  3631.        unusable.
  3632.  
  3633.     +  During installation, the config_help(1M), config_man(1M), and
  3634.        config_views(1M) tools are run and the output captured to log files.
  3635.        After installation, you need to run the config_search(1M) tool (with
  3636.        the -f option) to complete SCOhelp configuration.
  3637.  
  3638.        These tools can return errors that might indicate a problem with the
  3639.        SCOhelp system;  more typically, they return warnings that do not
  3640.        affect the integrity of SCOhelp.
  3641.  
  3642.        The following paragraphs explain some of the messages you may see when
  3643.        running these tools.
  3644.  
  3645.                   config_search: lang: No search collection at
  3646.                   /usr/lib/scohelp/lang/_SearchIndex.
  3647.                   First run config_help or config_man
  3648.  
  3649.        This message (where lang: is a language specifier such as es, fr, de,
  3650.        ja), indicates that config_search was run with either no options or a
  3651.        -L option that pointed to a particular language, and no input to the
  3652.        search index was found for that language.  The result is that no
  3653.        search index processing is done for the indicated language, but
  3654.        otherwise SCOhelp is unaffected by this error.  However, if there is
  3655.        documentation for lang: present on the system, then run config_help
  3656.        and config_man, and run config_search again, this time with the -L
  3657.        lang:  option.
  3658.  
  3659.           mktitles: lang: 1: Warning: manpage claims to be in
  3660.                     section n: path
  3661.  
  3662.        This error indicates a problem in the source file at /usr/man/path.
  3663.        Specifically, the file named by path is in section n, but the text in
  3664.        the file says that the page is in another section.  The source file
  3665.        itself needs to be corrected or moved to the proper section under
  3666.        /usr/man.  This is typically a problem caused by the application
  3667.        package that installed the manual pages.
  3668.  
  3669.           mktitles: lang: path: No documentation found.
  3670.  
  3671.        The mktitles tool looks for documentation files in every directory it
  3672.        finds under /usr/lib/scohelp.  If prints a message like the above for
  3673.        every directory in which it expected to find documentation files but
  3674.        found none.  This usually occurs when a doc package has been removed,
  3675.        but the directories it used were not deleted during package removal.
  3676.        Directories are typically left behind in case users have added their
  3677.        own source files.
  3678.  
  3679.           config_views: lang: path parent view <view-name> does not exist
  3680.  
  3681.           config_views: lang: <view-name> view has non-existant
  3682.                         OverviewURL: path
  3683.  
  3684.           config_views: lang: path view refers to non-existant
  3685.                         URL: path
  3686.  
  3687.        These messages usually indicate a reference to a topic view (a left
  3688.        frame table of contents) that does not exist.  This is usually due to
  3689.        a reference in one package that depends on doc in another package that
  3690.        is not currently installed.  For example, if you install the BASEdoc
  3691.        package but not the ARCdoc package (for ARCserve documentation), then
  3692.        you will get messages like this since the top-level BASEdoc view
  3693.        Backup and Restore will not have any ARCserve documentation to which
  3694.        it can point.
  3695.  
  3696.  
  3697.  X server and graphical environment
  3698.  
  3699.  
  3700.     +  The option -crt to X(X1M) does direct the X server to a virtual
  3701.        terminal (/dev/vt10, for example).
  3702.  
  3703.     +  DISPLAY settings for applications for SCO OpenServer (including those
  3704.        on the Skunkware 96 disk) may not be valid for UnixWare 7.  An error
  3705.        similar to the following may result:
  3706.  
  3707.           Connection broken
  3708.  
  3709.        You may wish to try the following workaround:
  3710.  
  3711.           DISPLAY=localhost;export DISPLAY
  3712.           xhost +localhost
  3713.  
  3714.  
  3715.     +  When startx(X1M) is used to start a pmwm(X1) session, the X session
  3716.        continues to run in an xterm after the pmwm session is closed.
  3717.  
  3718.     +  If you have a two button mouse, then a middle button mouse click may
  3719.        be generated by holding down and releasing the left and right buttons
  3720.        of the mouse simultaneously.  However the middle button simulation can
  3721.        be unreliable with dtterm on the CDE desktop.
  3722.  
  3723.        If after installation you decide to use a three button mouse then
  3724.        change the value of MOUSEBUTTONS in /etc/default/mouse from 2 to 3 and
  3725.        reboot your system.
  3726.  
  3727.  
  3728.  man pages
  3729.  
  3730.     If you install any raw man pages, that is, man pages that are coded with
  3731.     the man troff macros, then you must have the BSDcompat package installed
  3732.     first.  That is because such pages require nroff, which is in BSDcompat.
  3733.  
  3734.     After installing the BSDcompat package, include /usr/ucb in the PATH
  3735.     variable if you want to run catman to process unformatted man pages from
  3736.     the root.
  3737.  
  3738.  
  3739.  Security
  3740.  
  3741.  
  3742.     +  In character mode, the Security Profile Manager fails with a hung
  3743.        remote session if you try to use the OpenHost option to access a host
  3744.        where you do not have permission to use rsh(1) (for example, where you
  3745.        have no .rhost entry).
  3746.  
  3747.     +  A Strong Encryption Supplement is included on the UnixWare 7 CD-ROM.
  3748.        This turns on the Netscape 128-bit encryption.
  3749.  
  3750.        Both weak encryption (40-bit) and strong encryption binaries for the
  3751.        Netscape products (FastTrack, NavGold) are packaged as part of
  3752.        UnixWare. By default, the 40-bit binaries are in place. Installing and
  3753.        licensing the Strong Encryption Supplement causes the 128-bit binaries
  3754.        to be moved into place. Any Netscape products subsequently loaded onto
  3755.        the system will also get the strong encryption binaries.
  3756.  
  3757.        The Strong Encryption Supplement is separate from the encryption
  3758.        included in the base UnixWare 7, in that it currently applies to the
  3759.        Netscape products only (and the Internet Security package on SCO
  3760.        OpenServer).
  3761.  
  3762.     +  Two problems have been reported that concern administering groups via
  3763.        the SCOadmin Account Manager.
  3764.  
  3765.        If a user account has a group configured in its ``multiple group''
  3766.        set, the SCOadmin Account Manager cannot remove that group.
  3767.  
  3768.        The Change Group Membership feature in the SCOadmin Account Manager
  3769.        does not remove groups in the ``Member of'' column from the
  3770.        /etc/groups file if all the groups are selected. A partial selection
  3771.        works correctly.
  3772.  
  3773.        It is recommended that the usermod(1M) command be used for these
  3774.        operations.
  3775.  
  3776.  
  3777.  Tcl
  3778.  
  3779.     The command select(1tcl) exits when a selected socket file descriptor
  3780.     closes, and then blocks the socket.
  3781.  
  3782.  
  3783.  Emergency recovery with an encapsulated or mirrored root disk
  3784.  
  3785.     There are three phases to performing an emergency recovery with an
  3786.     encapsulated or mirrored root disk:
  3787.  
  3788.     1.  ``Creating the Emergency Recovery diskettes and tapes''
  3789.  
  3790.     2.  ``Bringing the system back after emergency media is created''
  3791.  
  3792.     3.  ``Performing recovery when the primary and mirrored root disks fail''
  3793.  
  3794.     _________________________________________________________________________
  3795.        WARNING  If the following procedures are not adhered to exactly, it
  3796.        may result in your system entering an unrecoverable state.
  3797.     _________________________________________________________________________
  3798.  
  3799.     During the following process, use the vxprint(1M) command to obtain
  3800.     information about the encapsulated root disk and the disk to which it is
  3801.     mirrored.  In this example, an initial install was done with all
  3802.     additional filesystems created, and mirrored onto another disk.  Your
  3803.     installation may differ, so you may have a different number of partitions
  3804.     on the root disk.  This procedure is valid for recovering from a disaster
  3805.     where the primary and mirror disks both fail, and ODM was used only to
  3806.     encapsulate the root disk and mirror it.  Information on any other ODM
  3807.     disks should be saved so that they may later be restored.
  3808.  
  3809.  Creating the Emergency Recovery diskettes and tapes
  3810.  
  3811.  
  3812.     1.  Bring the machine down to init state 1 and log in as root
  3813.  
  3814.     2.  Run vxconfigd(1M) to start up the ODM configuration daemon
  3815.  
  3816.     3.  Use vxplex(1M) to disconnect the mirrored root plexes. Examples are
  3817.         given below:
  3818.  
  3819.            vxplex dis home-02
  3820.            vxplex dis home2-02
  3821.            vxplex dis rootvol-02
  3822.            vxplex dis standvol-02
  3823.            vxplex dis swapvol-02
  3824.            vxplex dis tmp-02
  3825.            vxplex dis var-02
  3826.  
  3827.  
  3828.     4.  Set up the kernel to ignore the ODM configuration:
  3829.  
  3830.         +  Make a backup copy of /etc/conf/pack.d/vol/space.c using the
  3831.            following command:
  3832.  
  3833.               cp /etc/conf/pack.d/vol/space.c /etc/conf/pack.d/vol/space.c.old
  3834.  
  3835.            then edit /etc/conf/pack.d/vol/space.c, and change the two lines:
  3836.  
  3837.               #define VOL_ROOTDEV_IS_VOLUME
  3838.               #define VOL_SWAPDEV_IS_VOLUME
  3839.  
  3840.            to:
  3841.  
  3842.               #undef VOL_ROOTDEV_IS_VOLUME
  3843.               #undef VOL_SWAPDEV_IS_VOLUME
  3844.  
  3845.  
  3846.         +  Make a backup copy of /etc/conf/init.d/kernel using the following
  3847.            command:
  3848.  
  3849.               cp /etc/conf/init.d/kernel /etc/conf/init.d_kernel.old
  3850.  
  3851.            then edit /etc/conf/init.d/kernel to move the ``swp1'' entry
  3852.            located just after the ``vol2'' entry to just below the ``vol1''
  3853.            entry, and change the line from:
  3854.  
  3855.               swp1::sysinit:/sbin/swap -a /dev/vx/dsk/swapvol > /dev/sysmsg 2>&1
  3856.  
  3857.            to:
  3858.  
  3859.               swp1::sysinit:/sbin/swap -a /dev/swap > /dev/sysmsg 2>&1
  3860.  
  3861.  
  3862.         +  Make a backup copy of /etc/conf/inittab using the following
  3863.            command:
  3864.  
  3865.               cp /etc/conf/inittab /etc/conf/inittab.old
  3866.  
  3867.            then edit /etc/conf/inittab in the same manner as you edited
  3868.            /etc/conf/init.d/kernel.
  3869.  
  3870.         +  Make a backup copy of /etc/vfstab using the following command:
  3871.  
  3872.               cp /etc/vfstab /etc/vfstab.old
  3873.  
  3874.            then edit /etc/vfstab, and make the following type of
  3875.            substitutions on the non-commented lines:
  3876.  
  3877.               Replace ``/dev/vx/[r]dsk/home'' with ``/dev/[r]dsk/c0b0t0d0s4''
  3878.               Replace ``/dev/vx/[r]dsk/var'' with ``/dev/[r]dsk/c0b0t0d0sb''
  3879.               Replace ``/dev/vx/[r]dsk/home2'' with ``/dev/[r]dsk/c0b0t0d0sc''
  3880.               Replace ``/dev/vx/[r]dsk/tmp'' with ``/dev/[r]dsk/c0b0t0d0sd''
  3881.  
  3882.            You should also comment out any other ODM-defined slices.
  3883.  
  3884.         +  Make a backup copy of /etc/swaptab using the following command:
  3885.  
  3886.               cp /etc/swaptab /etc/swaptab.old
  3887.  
  3888.            then edit /etc/swaptab, replacing ``/dev/vx/dsk/swapvol'' with
  3889.            ``/dev/swap''
  3890.  
  3891.         +  Run the following command:
  3892.  
  3893.               touch /etc/vx/reconfig.d/state.d/install-db
  3894.  
  3895.  
  3896.         +  Run the following command to obtain the major/minor numbers of the
  3897.            root slice:
  3898.  
  3899.               ls -l /dev/dsk/c0b0t0d0s1
  3900.  
  3901.  
  3902.         +  Replace the major/minor numbers for /.io/bootdisk/[r]root:
  3903.  
  3904.               rm /.io/bootdisk/*root
  3905.               mknod root b MAJOR MINOR
  3906.               mknod rroot c MAJOR MINOR
  3907.  
  3908.            where MAJOR and MINOR are the major and minor numbers displayed by
  3909.            the ls in the previous step.
  3910.  
  3911.     5.  Rebuild the kernel:
  3912.  
  3913.            /etc/conf/bin/idbuild -B
  3914.  
  3915.  
  3916.     6.  Reboot using the init 6 command. When you see the UnixWare logo
  3917.         appear, immediately press <Space> to enter the Bootstrap Command
  3918.         Processor. Enter the command initstate=1, followed by ``'boot'''.
  3919.         This will cause the machine to boot into single-user mode.
  3920.  
  3921.     7.  Run the emergency_disk(1M) and emergency_rec(1M) commands.
  3922.  
  3923.  Bringing the system back after emergency media is created
  3924.  
  3925.  
  3926.     1.  Undo the steps in step 4 of the previous procedure to restore the ODM
  3927.         configuration.  When you use mknod(1M) to create the
  3928.         /.io/bootdisk/*root nodes, use the major and minor numbers listed by
  3929.         the following command:
  3930.  
  3931.            ls -l /dev/vx/dsk/rootvol
  3932.  
  3933.  
  3934.     2.  Rebuild the kernel again:
  3935.  
  3936.            /etc/conf/bin/idbuild -B
  3937.  
  3938.  
  3939.     3.  Reboot using the init 6 command. When you see the UnixWare logo
  3940.         appear, immediately press <Space> to enter the Bootstrap Command
  3941.         Processor. Enter the command initstate=1, followed by ``'boot'''.
  3942.         This will cause the machine to boot into single-user mode.
  3943.  
  3944.     4.  When the system comes back up, log in as root, and run vxconfigd(1M)
  3945.         to start the ODM configuration daemon
  3946.  
  3947.     5.  Re-attach the plexes disconnected earlier, for the mirrored disk.
  3948.  
  3949.         For example:
  3950.  
  3951.            vxplex att home home-02
  3952.            vxplex att home2 home2-02
  3953.            vxplex att rootvol rootvol-02
  3954.            vxplex att standvol standvol-02
  3955.            vxplex att swapvol swapvol-02
  3956.            vxplex att tmp tmp-02
  3957.            vxplex att var var-02
  3958.  
  3959.         You should also remove the comments from other ODM-defined slices you
  3960.         previously commented out.
  3961.  
  3962.     6.  Reboot using init 6 and let the machine boot all the way into
  3963.         multiuser mode.
  3964.  
  3965.  Performing recovery when the primary and mirrored root disks fail
  3966.  
  3967.  
  3968.     1.  Boot from the Emergency Recovery diskettes.
  3969.  
  3970.         A message should be displayed indicating that the system is not sane.
  3971.  
  3972.         Continue to the Emergency Recovery menu and perform the Restore
  3973.         Disk(s) process.
  3974.  
  3975.     2.  After the recovery has completed, select the option to Reboot.  When
  3976.         you see the UnixWare logo appear, immediately press <Space> to enter
  3977.         the Bootstrap Command Processor. Enter the command initstate=1,
  3978.         followed by ``boot''.  This will cause the machine to boot into
  3979.         single-user mode.
  3980.  
  3981.     3.  Enter the following command:
  3982.  
  3983.            rm /etc/vx/reconfig.d/state.d/install-db
  3984.  
  3985.  
  3986.     4.  Run vxconfigd to remove all information about the mirrored disk:
  3987.  
  3988.            vxplex -o rm dis home-02
  3989.            vxplex -o rm dis home2-02
  3990.            vxplex -o rm dis rootvol-02
  3991.            vxplex -o rm dis standvol-02
  3992.            vxplex -o rm dis swapvol-02
  3993.            vxplex -o rm dis tmp-02
  3994.            vxplex -o rm dis var-02
  3995.            vxedit rm disk01
  3996.  
  3997.  
  3998.     5.  Run /etc/vx/bin/vxunroot.
  3999.  
  4000.     6.  Remove the VOLPUBLIC partition from BOTH the root disk and the
  4001.         mirrored disk, if they exist:
  4002.  
  4003.            prtvtoc -f /tmp/vtoc /dev/rdsk/c0b0t0d0s0
  4004.  
  4005.         Edit the /tmp/vtoc file and change the line that is similar to this:
  4006.  
  4007.            14  0xe 0x201   2048    2064384
  4008.  
  4009.         to:
  4010.  
  4011.            14  0x0 0x0     0   0
  4012.  
  4013.         Then rewrite the VTOC:
  4014.  
  4015.            edvtoc -f /tmp/vtoc /dev/rdsk/c0b0t0d0s0
  4016.  
  4017.         Reboot using the init 6 command.  When you see the UnixWare logo
  4018.         appear, immediately press <Space> to enter the Bootstrap Command
  4019.         Processor. Enter the command initstate=1, followed by ``boot''.  This
  4020.         will cause the machine to boot into single-user mode.  Ignore the
  4021.         vxconfigd errors.
  4022.  
  4023.     7.  Run vxinstall to re-install ODM and re-encapsulate root.  After the
  4024.         three reboots take place, you can re-mirror the root disk, add any
  4025.         other ODM disks, and restore the data to them.  The machine will be
  4026.         running in multiuser mode.
  4027.  
  4028.  
  4029.  
  4030.  XENIX
  4031.  
  4032.     XENIX compatibility has been removed.  Various  modules and commands have
  4033.     been removed from the system.  These include the DOS commands doscat,
  4034.     doscp, dosdir, dosls, dosmkdir, dosrmdir, and dosrm.  Equivalent
  4035.     functionality can be obtained from the ``mtools'' package found on the
  4036.     Skunkware CD. The following exec modules and commands i286x, x286emul,
  4037.     i286emul, and xout were removed.  These modules and commands provided
  4038.     compatibility for 286 and 386 XENIX binaries.  The XENIX filesystem and
  4039.     all supporting commands for it have been removed.  The module xnamfs has
  4040.     been removed which supports XENIX semaphores and shared data.
  4041.  
  4042.     The XENIX libraries libx, libxcurses, and libxtermlib have been removed.
  4043.     Support for the system call nap is now in libc.  The system calls
  4044.     creatsem, execseg, chsize, locking, nbwaitsem, opensem, proctl, sdenter,
  4045.     sdfree, sdgetv, sdleave, sdwaitv, sigsem, unexecseg, and waitsem that
  4046.     were in libx were not moved to another library.  The corresponding man
  4047.     pages for these system calls no longer exist.
  4048.  
  4049.     If you execute a XENIX binary you can expect exec to return ENOEXEC, and
  4050.     an error message similar to:
  4051.  
  4052.        file: cannot execute [Exec format error]
  4053.  
  4054.     depending on your shell.  You can identify whether a binary is a XENIX
  4055.     binary by using the file command.
  4056.  
  4057.  
  4058.  Domestic encryption
  4059.  
  4060.     Domestic encryption is broken when update701 is installed. If the
  4061.     crypt(1) version of libnsl or the ``crypt'' package are already
  4062.     installed, the following warning is given:
  4063.  
  4064.        Overriding the installed domestic libnsl
  4065.  
  4066.     You should update your system with a new version of the ``crypt''
  4067.     package, obtained by ordering the UnixWare DES encryption utilities.
  4068.     This package is for North American customers only.
  4069.  
  4070.     The ``crypt'' package contains a domestic libnsl that is UNIX95
  4071.     conformant.
  4072.  
  4073.     If you do not update the ``crypt'' package, the secure rpc functionality
  4074.     in libnsl is broken.
  4075.  
  4076.  
  4077.  Documentation
  4078.  
  4079.     The UnixWare 7 documentation states that multiple instances of an
  4080.     application may be installed, and that on installing a second (or nth)
  4081.     package instance, the instance component of the package identifier is
  4082.     automatically incremented. It goes on to state that, subsequently, using
  4083.     this identifier, each instance can be removed from the system
  4084.     independently of any other instances.  This is incorrect. To increment
  4085.     package instances, you begin by installing the package (using the
  4086.     pkgadd(1M) utility), called for example ``package''. Then, you create a
  4087.     second image of the package called ``package.1'', and install that
  4088.     version. This provides a variant of the package instance handling
  4089.     functionality described in the UnixWare 7 documentation, because the
  4090.     identifiers are different.
  4091.  
  4092.     However, it is not then possible to remove one instance without also
  4093.     removing all of the others, as pkgrm(1M) does not correctly use the
  4094.     VERSION parameter (in the package characteristics file) to distinguish
  4095.     one instance from another.
  4096.  
  4097.     Accordingly, the following modifications should be made to the online
  4098.     documentation topic Software Development -> Software Development Tools -
  4099.     > Packaging your Software Applications :
  4100.  
  4101.     +  In the section entitled ``Installation Parameters'', the description
  4102.        of PKGINST should be removed.
  4103.  
  4104.     +  ``Step 2. Defining a Package Instance'' in the section entitled
  4105.        ``Basic Steps of Packaging'' should also be removed.
  4106.  
  4107.     +  The pointer to this documentation given in the second item of the list
  4108.        in ``Basic Steps of Packaging'' should also be removed.
  4109.  
  4110.     The following manual pages should also be modified. In all cases,
  4111.     references to the inst component of the pkginst command line argument
  4112.     should be ignored.
  4113.  
  4114.     +  installf(1M)
  4115.  
  4116.     +  pkgadd(1M)
  4117.  
  4118.     +  pkgask(1M)
  4119.  
  4120.     +  pkgchk(1M)
  4121.  
  4122.     +  pkginfo(1)
  4123.  
  4124.     +  pkgmk(1)
  4125.  
  4126.     +  pkgparam(1)
  4127.  
  4128.     +  pkgrm(1M)
  4129.  
  4130.     +  pkgtrans(1)
  4131.  
  4132.     +  removef(1M)
  4133.  
  4134.     Similarly, the following manual pages should be amended as described:
  4135.  
  4136.     +  admin(4)
  4137.  
  4138.        References to the instance parameter should be ignored.
  4139.     +  depend(4)
  4140.  
  4141.        References to the (arch)version field should be ignored.
  4142.  
  4143.     +  pkginfo(4)
  4144.  
  4145.        References to the MAXINST parameter should be ignored.
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  Chapter 6
  4153.  Netscape products features and limitations
  4154.  
  4155.     This chapter contains information about the UnixWare 7 Netscape Server
  4156.     and other Netscape products under the following headings:
  4157.  
  4158.     +  Netscape server configuration
  4159.  
  4160.     +  Netscape FastTrack Server notes
  4161.  
  4162.     +  Encryption Supplement
  4163.  
  4164.     +  Generic Netscape Server information
  4165.  
  4166.  
  4167.  Netscape server configuration
  4168.  
  4169.     This section contains information about configuring the Netscape server
  4170.     under the following headings:
  4171.  
  4172.     +  ``Configuring the Netscape Administration Server for remote access''
  4173.  
  4174.     +  ``Deferring or reconfiguring network configuration''
  4175.  
  4176.  Configuring the Netscape Administration Server for remote access
  4177.  
  4178.     To configure the Netscape Administration Server to allow remote access:
  4179.  
  4180.     1.  Open this URL:
  4181.  
  4182.            http://localhost:620
  4183.  
  4184.  
  4185.     2.  Select Configure Administration, then select the ``Access Control''
  4186.         link.
  4187.  
  4188.     3.  In the ``IP addresses to allow'' field, enter a list of all the IP
  4189.         addresses which are allowed access to the Administration Server,
  4190.         using the format
  4191.  
  4192.            (IP1|IP2|...)
  4193.  
  4194.         including the IP address of the system's primary network interface,
  4195.         the IP address associated with the system's name (if different to
  4196.         that of the primary network interface), and any other IP addresses by
  4197.         which the system might be referenced.
  4198.  
  4199.     4.  Restart the Administration Server to implement these access
  4200.         configuration changes:
  4201.  
  4202.            /etc/nsadmin restart
  4203.  
  4204.  
  4205.  Deferring or reconfiguring network configuration
  4206.  
  4207.     During installation, the Netscape servers are configured with default
  4208.     settings for the ``ServerName'', ``Hosts'', and ``Addresses'' fields.  If
  4209.     you reconfigure TCP/IP, your Netscape FastTrack Server might no longer be
  4210.     properly configured.  To configure a Netscape FastTrack Server after
  4211.     deferring or reconfiguring networking configuration, edit the appropriate
  4212.     configuration files.
  4213.  
  4214.     In /usr/ns-home/admserv/ns-admin.conf, set ``ServerName'' to the string
  4215.     returned by hostname.  Set ``Hosts'' and ``Addresses'' to the hostnames
  4216.     and IP addresses allowed to administer this server.  After setting these
  4217.     variables, use the Netscape Administration Server to further configure
  4218.     the server.
  4219.  
  4220.     In the /usr/ns-home/httpd-ServerName/config/magnus.conf file, set
  4221.     ``ServerName'' to the string returned by hostname.  When you next enter
  4222.     the Administration server, you will get a message indicating that the
  4223.     configuration has been manually edited.
  4224.  
  4225.  
  4226.  Netscape FastTrack Server notes
  4227.  
  4228.     This section contains information about setting up and using your
  4229.     Netscape FastTrack Server(TM).
  4230.  
  4231.  IP address configuration
  4232.  
  4233.     If networking configuration is deferred or incorrect, the Netscape
  4234.     Administration Server may be inaccessible. In this case, after
  4235.     configuring networking correctly, edit the /usr/ns-home/admserv/ns-
  4236.     admin.conf file.  Change the line beginning with ``Addresses'' to contain
  4237.     the correct IP address and restart the Administration Server.
  4238.  
  4239.  Default configuration
  4240.  
  4241.     The Netscape FastTrack Server installs with the following pre-configured
  4242.     defaults.
  4243.  
  4244.     _________________________________________________________________________
  4245.        NOTE  You can change these values after completing the
  4246.        installation.
  4247.     _________________________________________________________________________
  4248.  
  4249.  
  4250.     +  public server uses port 80
  4251.  
  4252.     +  server IP address is the first non-loopback address returned by
  4253.        netstat -in, or 127.0.0.1 if TCP/IP is not configured
  4254.  
  4255.     +  CGI directory /usr/ns-home/cgi-bin and .cgi filetype disabled
  4256.  
  4257.     +  user document directory $HOME/public_html enabled
  4258.  
  4259.     +  server-parsed HTML for .shtml filetype enabled
  4260.  
  4261.     +  runs as nobody
  4262.  
  4263.     +  administered on port:620
  4264.  
  4265.     +  server home  /usr/ns-home/httpd-80
  4266.  
  4267.     +  document root  /usr/ns-home/docs
  4268.  
  4269.     +  default system home page provided at /usr/ns-home/docs/index.shtml,
  4270.        with a number of useful links pre-configured
  4271.  
  4272.     +  server processes:
  4273.  
  4274.        -  Processes 1
  4275.  
  4276.        -  Minimum threads 4
  4277.  
  4278.        -  Maximum threads 32
  4279.  
  4280.     +  index files index.html or home.html
  4281.  
  4282.     +  never attempts to resolve IP addresses into host names
  4283.  
  4284.     +  all accesses logged
  4285.  
  4286.     +  administration access is limited to the local host
  4287.  
  4288.  CGI scripts
  4289.  
  4290.     The following CGI programs have been included in this release:
  4291.  
  4292.     randstyle
  4293.          select a random digit style from the directory of digits
  4294.  
  4295.     userinfo
  4296.          script to produce an HTML document containing information about any
  4297.          links to personal accounts on the machine on which the web server is
  4298.          running.
  4299.  
  4300.     Count.cgi
  4301.          an excellent counter contributed by Muhammad A. Muquit and included
  4302.          with his permission. For further information, see :
  4303.  
  4304.             http://www.fccc.edu/users/muquit/Count.html
  4305.  
  4306.  
  4307.  Administration scripts
  4308.  
  4309.     The Bourne shell scripts /etc/nsfast  and /etc/nsadmin are included in
  4310.     this release. These scripts can only be run by root and are used to start
  4311.     and stop the server, enable and disable automatic startup, and query the
  4312.     Administration server, and the port 80 and and other FastTrack server
  4313.     instances.
  4314.  
  4315.     To enable or disable automatic startup of the port 80 public HTTP server,
  4316.     issue these commands as root:
  4317.  
  4318.        /usr/sbin/nsfast enable [80]
  4319.        /usr/sbin/nsfast disable [80]
  4320.  
  4321.     To enable or disable automatic startup of the Netscape Administration
  4322.     server, issue the commands:
  4323.  
  4324.        /usr/sbin/nsadmin enable
  4325.        /usr/sbin/nsadmin disable
  4326.  
  4327.     To start, stop or query the port 80 or other public servers, run:
  4328.  
  4329.        /usr/sbin/nsfast stop [80]
  4330.        /usr/sbin/nsfast start [80]
  4331.        /usr/sbin/nsfast query [80]
  4332.  
  4333.     To start, stop or query the Administration Server, run:
  4334.  
  4335.        /usr/sbin/nsadmin stop
  4336.        /usr/sbin/nsadmin start
  4337.        /usr/sbin/nsadmin query
  4338.  
  4339.     See nsadmin(1M) and nsfast(1M) for full details.
  4340.  
  4341.  HTML snippets
  4342.  
  4343.     ``Snippets'' allow you to display system-specific configuration
  4344.     information collected automatically by the /etc/rc2.d/S90sysinfo2html
  4345.     script, which is run during system initialization.  This script gathers
  4346.     information about the system and formats it as HTML for later inclusion
  4347.     by an HTML document.
  4348.  
  4349.     To include this information in an HTML document, use the #include
  4350.     directive; for example:
  4351.  
  4352.        <!--#include file="include/filename.inc" -->
  4353.  
  4354.     The following HTML snippets reside in the /usr/ns-home/docs/include
  4355.     directory:
  4356.  
  4357.     boottime.inc
  4358.          contains the time of the last system boot
  4359.  
  4360.     hostname.inc
  4361.          contains the fully qualified domain name of the system (as returned
  4362.          by the hostname command)
  4363.  
  4364.     nodename.inc
  4365.          contains the node name of the system (as returned by the uname -n
  4366.          command)
  4367.  
  4368.     prtconf.inc
  4369.          contains system information as returned by the prtconf command
  4370.  
  4371.     scohelp.inc
  4372.          contains the hypertext reference for SCOhelp
  4373.  
  4374.     ttalogin.inc
  4375.          contains the URL to use for the Login button; it can be telnet, SCO
  4376.          Tarantella authentication, or a custom authentication mechanism. For
  4377.          more information about SCO Tarantella, see the SCO web site:
  4378.  
  4379.             http://www.tarantella.sco.com
  4380.  
  4381.  
  4382.  User publishing
  4383.  
  4384.     User document directories in $HOME/public_html are enabled, provided a
  4385.     $HOME/.html file is present. In addition, if a $HOME/public_html file is
  4386.     present, a personal web page is offered, with a URL as given there. If a
  4387.     $HOME/.ftp file is present, personal ftp is offered, with a URL as given
  4388.     there.  If a $HOME/.plan file is present, a link to the user's plan is
  4389.     offered, using the UNIX finger utility.
  4390.  
  4391.     To disable this feature, use the Netscape Administration Server.  In
  4392.     addition, the default port 80 server home page includes a link to a user
  4393.     information page generated automatically by a CGI script.  This script
  4394.     will publish information about users whose home directories contain any
  4395.     of these files:
  4396.  
  4397.     .html   indicates the user wishes their $HOME/public_html document
  4398.             directory published through this user information page and
  4399.             accessible at:
  4400.  
  4401.                http://ServerName/~UserName/
  4402.  
  4403.  
  4404.     .ftp    causes a link to the user's personal ftp directory to be
  4405.             published and accessible at:
  4406.  
  4407.                ftp://ServerName/pub/users/UserName/
  4408.  
  4409.  
  4410.     .plan   causes a link to the user's personal plan to be published using
  4411.             the UNIX finger utility
  4412.  
  4413.  Turning on DNS breaks Netscape server Java execution
  4414.  
  4415.     Netscape Java execution in the Netscape web server, enabled on the
  4416.     Programs -> Java frame, works without problems when DNS is not enabled on
  4417.     the System Settings -> Performance Tuning frame. The typical test is to
  4418.     enable Java execution on the web server, then test it by running one of
  4419.     the sample Java applets contained in the
  4420.     <ServerRoot>/plugins/java/applets/ directory.
  4421.  
  4422.     However, when DNS is enabled so that IP addresses are resolved to their
  4423.     full names in the log files and in the ACL directives, Java in the
  4424.     Netscape server fails. Attempting to access one of the applets results in
  4425.     the following page returned by the browser:
  4426.  
  4427.        Server Error
  4428.  
  4429.        This server has encountered an internal error which prevents it from
  4430.        fulfilling your request. The most likely cause is a misconfiguration.
  4431.        Please ask the administrator to look for messages in the server's error
  4432.        log.
  4433.  
  4434.     The error log contains the following entry:
  4435.  
  4436.        [22/Oct/1997:15:55:28] failure: for host h-205-217-236-19.netscape.com
  4437.        trying to GET /server-java/BrowserDataApplet, java-run reports:
  4438.        construction of new ServerApplet failed
  4439.  
  4440.     Turning off DNS in Netscape resolves the problem again and lets the
  4441.     applets run normally.
  4442.  
  4443.  
  4444.  Encryption Supplement
  4445.  
  4446.     This section contains information about the Encryption Supplement.
  4447.  
  4448.  System requirements
  4449.  
  4450.  
  4451.     SCO Strong Encryption Supplement 1.0
  4452.  
  4453.             Software:    UnixWare 7
  4454.  
  4455.             Disk space:  1MB free disk space
  4456.  
  4457.  
  4458.     Enabling SCO Strong Encryption Supplement
  4459.             Customers in the United States and Canada are allowed to use
  4460.             strong encryption with the Netscape products.  All the Netscape
  4461.             client and server products use 40-bit encryption by default when
  4462.             using the Secure Socket Layer (SSL) protocol to communicate
  4463.             secured information.  Strong encryption allows the use of 128-bit
  4464.             encryption between clients and servers.
  4465.  
  4466.             The SCO Strong Encryption Supplement (encrypt) must be installed
  4467.             to enable strong encryption for all Netscape products on this
  4468.             CD-ROM.  The installation of this product prompts for a license.
  4469.             You can purchase a license for the SCO Strong Encryption
  4470.             Supplement by calling 1-800-SCO-UNIX or your SCO Reseller.
  4471.  
  4472.             _________________________________________________________________
  4473.                NOTE  The license can be used on all systems at your site.
  4474.             _________________________________________________________________
  4475.  
  4476.             See encrypt_config(1M) for more information.
  4477.  
  4478.  
  4479.  Generic Netscape Server information
  4480.  
  4481.  
  4482.     Getting support for Netscape products
  4483.             Support for the Netscape products is provided by SCO.  Ignore any
  4484.             links or references that point to Netscape for support
  4485.             information.
  4486.  
  4487.     Starting the Netscape Server Admin manager
  4488.             To start the Netscape Server Admin manager, on the CDE desktop,
  4489.             select SCO Admin from the SCO menu (above the SCO logo), then
  4490.             click on Netscape Server Admin.
  4491.  
  4492.             If a Netscape browser is already running, a new window from the
  4493.             existing browser opens with the Netscape Server Admin URL.
  4494.  
  4495.             To run the Netscape Server Admin manager from an existing
  4496.             Netscape browser, open the following URL:
  4497.  
  4498.                http://ServerName:620
  4499.  
  4500.  
  4501.     Netscape Server Admin user ID and password
  4502.             When you start the Netscape Server Admin manager, you are
  4503.             prompted for the user ID and password.  At installation, the
  4504.             Netscape Server Admin user ID is set to admin and the admin
  4505.             password is set to the same as the root password.
  4506.  
  4507.     TCP/IP reconfiguration
  4508.             If you reconfigure TCP/IP, any Netscape servers installed on your
  4509.             system might be improperly configured.  To correct this, you must
  4510.             edit configuration files as described in ``Deferring or
  4511.             reconfiguring network configuration''.
  4512.  
  4513.     Changing the hostname
  4514.             To change the hostname of your UnixWare 7 system, follow the
  4515.             instructions in setuname(1M).
  4516.  
  4517.             Before rebooting, edit these Netscape server files to replace all
  4518.             occurrences of the old name with the new name:
  4519.  
  4520.                /usr/ns-home/admserv/ns-admin.conf
  4521.                /usr/ns-home/http[d | s]-<ServerName>/config/magnus.conf
  4522.                /usr/ns-home/httpdServerName/config/magnus.conf
  4523.                /usr/ns-home/httpsServerName/config/magnus.conf
  4524.  
  4525.  
  4526.     Warnings in Netscape Server log
  4527.             When the FastTrack server is run with Tarantella, it may hang and
  4528.             produce a number of warnings about failed calls to accept in the
  4529.             log.  These are harmless, and may be ignored. You should restart
  4530.             the server as usual.
  4531.  
  4532.  Accessing Netscape documentation
  4533.  
  4534.     To access online documentation, use SCOhelp (or your existing Netscape
  4535.     browser).  To use SCOhelp:
  4536.  
  4537.     +  Enter scohelp& at the command line in an xterm window on your desktop.
  4538.  
  4539.     +  On the CDE desktop, select the Help menu (above the help icon in the
  4540.        Control Panel), then select SCO Help.
  4541.  
  4542.     +  On the Panorama desktop, pull down the Root menu and select Help.
  4543.  
  4544.     To use your existing Netscape browser, open:
  4545.  
  4546.        http://localhost:457
  4547.  
  4548.     Select Internet and Intranet, then Netscape.
  4549.  
  4550.     Online documentation is also available at the SCO Internet Family
  4551.     Documentation page, http://www2.sco.com:1996/inethome.html.
  4552.  
  4553.     To access printable PostScript(r) images of books for the software on the
  4554.     UnixWare 7 Optional Services CD-ROM:
  4555.  
  4556.     1.  Download and install the gzip utility.
  4557.  
  4558.     2.  Download the files from the SCO web page:
  4559.  
  4560.            http://www.sco.com/documentation/postscript/
  4561.  
  4562.  
  4563.         Sub-directories for each product and book title contain the gzipped
  4564.         PostScript files.
  4565.  
  4566.     3.  Change to the download directory.  For example,
  4567.  
  4568.            cd /tmp
  4569.  
  4570.  
  4571.     4.  Uncompress and print the files:
  4572.  
  4573.            /usr/bin/gunzip * | lp -opost -dprintername *
  4574.  
  4575.         Substitute the name of a PostScript printer for printername and, if
  4576.         necessary, change the -opost option depending on your printer model
  4577.         script.
  4578.  
  4579.     To order printed Netscape documentation:
  4580.  
  4581.     1.  Visit the Netscape home page at http://home.netscape.com.
  4582.  
  4583.     2.  Click on Netscape Store, then Bookstore & Courses.
  4584.  
  4585.  Downloading gzip
  4586.  
  4587.     The PostScript books on the WWW are distributed in gzip (.gz) compressed
  4588.     format.  You must use gunzip to uncompress these files.  To download and
  4589.     install the gunzip utility:
  4590.  
  4591.     1.  Point your browser at:
  4592.  
  4593.            http://www.sco.com/documentation/postscript/bin/gunzip_uw7.tar
  4594.  
  4595.         Download gunzip_uw7.tar to a temporary directory.
  4596.  
  4597.     2.  Enter:
  4598.  
  4599.            tar xvf gunzip_uw7.tar
  4600.  
  4601.         This extracts the gunzip binary into the /usr/bin directory.
  4602.  
  4603.     To download the entire gzip package from Skunkware:
  4604.  
  4605.     1.  Point your browser at:
  4606.  
  4607.            http://www.sco.com/skunkware/uw7/shellutil/gzip/
  4608.  
  4609.  
  4610.     2.  Download gzip.pkg to a temporary directory, such as /tmp.
  4611.  
  4612.     3.  Use pkgadd(1M) to install the package:
  4613.  
  4614.            pkgadd -d /tmp/gzip.pkg
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  Appendix A
  4622.  System profiles, services, and packages
  4623.  
  4624.     System profiles are collections of software that simplify the
  4625.     installation process. When you select a system profile, you ensure that
  4626.     the correct software (services and packages) is installed to enable the
  4627.     type of server you want.
  4628.  
  4629.     _________________________________________________________________________
  4630.        NOTE  The Basic Networking Utilities (BNU) documentation includes a
  4631.        small number of references to the ``bnu'' package, as if this were
  4632.        a separately-installable feature. This is not the case: the BNU
  4633.        commands, utilities, configuration files and so on, are an integral
  4634.        part of the UnixWare 7 base system. Accordingly, instructions that
  4635.        require the user to test for the presence of the ``bnu'' package,
  4636.        for example with pkginfo(1), should be disregarded.
  4637.     _________________________________________________________________________
  4638.  
  4639.     These system profiles are available:
  4640.  
  4641.     +  ``License based defaults''
  4642.  
  4643.     +  ``Small Footprint server''
  4644.  
  4645.     +  ``Full (All Packages) profile''
  4646.  
  4647.     +  ``Customize Installation of Packages''
  4648.  
  4649.  
  4650.  License based defaults
  4651.  
  4652.     The license based defaults system profile presents you with a default
  4653.     list of the packages available for the license that you have selected
  4654.     during installation.  The following licensing based defaults are
  4655.     available:
  4656.  
  4657.     _________________________________________________________________________
  4658.     License               Description
  4659.     _________________________________________________________________________
  4660.     Base                  Base Edition
  4661.     Business              Business Edition
  4662.     Departmental          Departmental Edition
  4663.     Development           Development System
  4664.     Enterprise            Enterprise Edition
  4665.     Free                  Free UnixWare 7
  4666.     Intranet              Intranet Edition
  4667.     Messaging             Messaging Edition
  4668.  
  4669.  
  4670.  
  4671.  Small Footprint server
  4672.  
  4673.     The Small Footprint server consists of the base operating system and
  4674.     networking utilities; it does not contain graphics support or
  4675.     documentation. It is intended for use in replicated sites, or on systems
  4676.     with small memory (less than 32MB) or limited disk capacity (less than
  4677.     500MB).
  4678.  
  4679.  Full (All Packages) profile
  4680.  
  4681.     The Full (All Packages) profile is designed to select a wide spectrum of
  4682.     technologies from the entire list of packages in the UnixWare 7
  4683.     distribution. Only packages that have hardware-sensitive application
  4684.     (osmp and mpio), language-specific context (language extensions), or
  4685.     debugging functionality (kdb) are left unselected in this profile.
  4686.  
  4687.     _________________________________________________________________________
  4688.        NOTE  Selecting this profile does not grant additional unlimited
  4689.        software licenses. If you install packages not covered by the
  4690.        license that you entered earlier in the installation, a 60-day
  4691.        evaluation license may be granted so that you may evaluate our
  4692.        software. It is up to you to obtain the necessary license to cover
  4693.        the software you wish to install on your system.
  4694.  
  4695.        See the cover letter in your product distribution for information
  4696.        on how to obtain further licenses.
  4697.     _________________________________________________________________________
  4698.  
  4699.  
  4700.  
  4701.  Customize Installation of Packages
  4702.  
  4703.     The Customize Installation of Packages option allows you to select and
  4704.     deselect individual packages for installation. By default, the list of
  4705.     packages is selected by the license you entered earlier in the
  4706.     installation. You can also select the Small Footprint server or Full (All
  4707.     Packages) profile then select this profile to change the list of packages
  4708.     selected for installation. You can reset to license-based defaults by
  4709.     reselecting the License-Based defaults profile.
  4710.  
  4711.     You can further customize the list of selected packages by choosing this
  4712.     option and toggling on or off individual packages.
  4713.  
  4714.  
  4715.  Package organization
  4716.  
  4717.     The installation process organizes software into groups called sets,
  4718.     services, and packages. Sets are groupings of one or more packages.
  4719.     Services are logical groupings of packages within a set. Packages are
  4720.     groupings of files and binaries that make up a particular technology.
  4721.  
  4722.  
  4723.  Installation sets
  4724.  
  4725.     The software available in the UnixWare 7 distribution is divided into the
  4726.     following sets:
  4727.  
  4728.     _________________________________________________________________________
  4729.     Set                   Description
  4730.     _________________________________________________________________________
  4731.     UnixWare              Core System Services
  4732.     BaseWeb               Internet Services
  4733.     arcserve              Data Management Services
  4734.     doc                   Documentation Services
  4735.     loc_doc               Localized Documentation Services
  4736.     winsrvcs              Windows Integration Services
  4737.  
  4738.  
  4739.  Core System Services set
  4740.  
  4741.     The UnixWare set contains provides the core system services.  The
  4742.     following services are defined here:
  4743.  
  4744.     +  ``Extended OS utilities (utilities)''
  4745.  
  4746.     +  ``SCO NetWare (netware)''
  4747.  
  4748.     +  ``Networking services (network)''
  4749.  
  4750.     +  ``Graphics services (graphics)''
  4751.  
  4752.     +  ``Database services (database)''
  4753.  
  4754.     +  ``Desktop services (desktop)''
  4755.  
  4756.     +  ``Language supplements (language)''
  4757.  
  4758.     The Core System Set includes the required packages. These packages are
  4759.     necessary to the operation of other packages and cannot be deselected via
  4760.     the installation process. The required packages are:
  4761.  
  4762.     _________________________________________________________________________
  4763.     Package               Description
  4764.     _________________________________________________________________________
  4765.     acp                   Enhanced Application Compatibility
  4766.     base                  Base System
  4767.     expect                expect
  4768.     ls                    Language Supplement
  4769.     nsu                   Network Support Utilities
  4770.     scoadmin              SCO System Administration (SCOadmin)
  4771.     tclrun                Tcl Runtime package
  4772.     terminf               Terminfo Utilities
  4773.     vtclrun               Vtcl Runtime package
  4774.  
  4775.  
  4776.     Extended OS utilities (utilities)
  4777.  
  4778.     This service includes application compatibility commands and libraries,
  4779.     auditing, compilers, advanced commands, the kernel debugger, system
  4780.     administration utilities, multiprocessor support, and printer support.
  4781.  
  4782.     The following packages are included:
  4783.  
  4784.     _________________________________________________________________________
  4785.     Package       Description                            Selected from
  4786.     _________________________________________________________________________
  4787.     acl           Access Control List Utilities          All Licenses
  4788.                                                          Full Profile
  4789.     audio         Audio Subsystem                        All Licenses
  4790.                                                          Full Profile
  4791.     audit         Auditing Subsystem                     All Licenses
  4792.                                                          Full Profile
  4793.     bsdcompat     BSD Compatibility                      All Licenses
  4794.                                                          Full Profile
  4795.     cmds          Advanced Commands                      All Licenses
  4796.                                                          Full Profile
  4797.     kdb           Kernel Debugger                        not selected
  4798.     lp            Printer Support                        All Licenses
  4799.                                                          Full Profile
  4800.     mpio          Multipath I/O Driver                   not selected
  4801.     osmp          OS Multiprocessor Support (OSMP)       not selected
  4802.     perl5         Perl 5.004                             All Licenses
  4803.                                                          Full Profile
  4804.     uccs          UDK Optimizing C Compilation System    All Licenses
  4805.                                                          Full Profile
  4806.     uedebug       UDK Enhanced Debugger                  All Licenses
  4807.                                                          Full Profile
  4808.  
  4809.  
  4810.     SCO NetWare (netware)
  4811.  
  4812.     This service includes the NetWare UNIX client and integration kit.
  4813.  
  4814.     The following packages are included:
  4815.  
  4816.     _________________________________________________________________________
  4817.     Package        Description                           Selected from
  4818.     _________________________________________________________________________
  4819.     nuc            NetWare UNIX Client                   All Licenses
  4820.                                                          Full Profile
  4821.     nwnet          NetWare Networking                    All Licenses
  4822.                                                          Full Profile
  4823.  
  4824.  
  4825.     Networking services (network)
  4826.  
  4827.     This service includes TCP/IP and related Internet technologies.
  4828.  
  4829.     The following packages are included:
  4830.  
  4831.     _________________________________________________________________________
  4832.     Package       Description                            Selected from
  4833.     _________________________________________________________________________
  4834.     dfs           Distributed File Systems utilities     All Licenses
  4835.                                                          Full Profile
  4836.     inet          Internet utilities                     All Licenses
  4837.                                                          Full Profile
  4838.     ldap          Lightweight Directory Access           All Licenses
  4839.                   Protocol utilities                     Full Profile
  4840.     netbios       TPI NetBIOS                            All Licenses
  4841.                                                          Full Profile
  4842.     netmgt        Network management utilities           All Licenses
  4843.                                                          Full Profile
  4844.     nfs           Network File System utilities          All Licenses
  4845.                                                          Full Profile
  4846.     nics          Network Drivers                        All Licenses
  4847.                                                          Full Profile
  4848.     nis           Network Information Services           All Licenses
  4849.                                                          Full Profile
  4850.     ppp           Point-to-Point Protocol utilities      All Licenses
  4851.                                                          Full Profile
  4852.     rpc           Remote Procedure Call utilities        All Licenses
  4853.                                                          Full Profile
  4854.     server        server utilities                       All Licenses
  4855.                                                          Full Profile
  4856.  
  4857.  
  4858.     Graphics services (graphics)
  4859.  
  4860.     This service includes the X11R6.1 Server, OSF/Motif, SCO Visual Tcl(TM),
  4861.     and video drivers.
  4862.  
  4863.     The following packages are included:
  4864.  
  4865.     _________________________________________________________________________
  4866.     Package        Description                           Selected from
  4867.     _________________________________________________________________________
  4868.     TEDlogin       CDE Login Manager                     All Licenses
  4869.                                                          Full Profile
  4870.     basex          X11R6 Base X Runtime System           All Licenses
  4871.                                                          Full Profile
  4872.     mtfrun         OSF Motif Runtime Environment         All Licenses
  4873.                                                          Full Profile
  4874.     xclients       X11R6 X Clients                       All Licenses
  4875.                                                          Full Profile
  4876.     xcontrib       X11R6 Contributed X Clients           All Licenses
  4877.                                                          Full Profile
  4878.     xdrivers       X11R6 Graphics Drivers                All Licenses
  4879.                                                          Full Profile
  4880.     xfonts         X11R6 Fonts                           All Licenses
  4881.                                                          Full Profile
  4882.     xserver        X11R6 X Server                        All Licenses
  4883.                                                          Full Profile
  4884.  
  4885.  
  4886.     Database services (database)
  4887.  
  4888.     This service contains online Virtual Disk Volume administration and
  4889.     management.
  4890.  
  4891.     The following packages are included:
  4892.  
  4893.     _________________________________________________________________________
  4894.     Package        Description                           Selected from
  4895.     _________________________________________________________________________
  4896.     vxva           VERITAS ODM Visual Administrator      Enterprise Edition
  4897.                                                          Full Profile
  4898.     vxvm           VERITAS Volume Manager                Enterprise Edition
  4899.                                                          Full Profile
  4900.  
  4901.  
  4902.     Desktop services (desktop)
  4903.  
  4904.     This service includes the CDE lightweight and full desktops, as well as
  4905.     the graphical login and CDE help system.
  4906.  
  4907.     The following packages are included:
  4908.  
  4909.     _________________________________________________________________________
  4910.     Package       Description                            Selected from
  4911.     _________________________________________________________________________
  4912.     TEDdesk       TriTeal Enterprise Desktop (CDE        All Licenses
  4913.                   Desktop)                               Full Profile
  4914.     TEDdocs       CDE Desktop PostScript Manuals         All Licenses
  4915.                                                          Full Profile
  4916.     TEDhde        CDE German help                        locale selected
  4917.     TEDhelp       CDE Online Help                        All Licenses
  4918.                                                          Full Profile
  4919.     TEDhfr        CDE French help                        locale selected
  4920.     TEDhjpe       CDE Japanese EUC help                  locale selected
  4921.     TEDlde        CDE German catalogs and miscellany     locale selected
  4922.     TEDles        CDE Spanish catalogs and miscellany    locale selected
  4923.     TEDlfr        CDE French catalogs and miscellany     locale selected
  4924.     TEDljpe       CDE Japanese EUC catalogs and          locale selected
  4925.                   miscellany
  4926.     TEDman        CDE Manual Pages                       All Licenses
  4927.                                                          Full Profile
  4928.  
  4929.  
  4930.     Language supplements (language)
  4931.  
  4932.     This service includes support for language extensions.
  4933.  
  4934.     The following packages are included:
  4935.  
  4936.     _________________________________________________________________________
  4937.     Package        Description                           Selected from
  4938.     _________________________________________________________________________
  4939.     dele           German language extension             locale selected
  4940.     esle           Spanish language extension            locale selected
  4941.     frle           French language extension             locale selected
  4942.     jale           Japanese language extension           locale selected
  4943.  
  4944.     One of the above packages is selected automatically, according to the
  4945.     locale that you choose during the installation. If you require other
  4946.     language supplements, you must use the Customize Installation of Packages
  4947.     option and switch them on.
  4948.  
  4949.  Internet Services set
  4950.  
  4951.     The Internet Services set (BaseWeb) provides web browsers and servers.
  4952.     It contains the Internet service (internet).
  4953.  
  4954.     The following packages are included:
  4955.  
  4956.     _________________________________________________________________________
  4957.     Package       Description                            Selected from
  4958.     _________________________________________________________________________
  4959.     FTRKdoc       Netscape FastTrack Server              All Licenses
  4960.                   Documentation                          Full Profile
  4961.     NAVIdoc       Netscape Navigator Documentation       All Licenses
  4962.                                                          Full Profile
  4963.     jdk113        JDK 1.1.3 for SCO                      All Licenses
  4964.                                                          Full Profile
  4965.     nsadmin       Netscape Administration Server 2.13    All Licenses
  4966.                                                          Full Profile
  4967.     nsfast        Netscape FastTrack Server 2.01a        All Licenses
  4968.                                                          Full Profile
  4969.     nsnavAu       Netscape Navigator Gold 3.04           All Licenses
  4970.                                                          Full Profile
  4971.  
  4972.  
  4973.  Data Management Services set
  4974.  
  4975.     The Data Management Services set (arcserve) provides SCO ARCserve/Open
  4976.     backup and restore. It contains the Data Management service (datamgt).
  4977.  
  4978.     The following packages are included:
  4979.  
  4980.     _________________________________________________________________________
  4981.     Package       Description                            Selected from
  4982.     _________________________________________________________________________
  4983.     ARCdoc        SCO(r) ARCserve(r) documentation       All Licenses
  4984.                                                          Full Profile
  4985.     ARCserve      SCO ARCserve commands and utilities    All Licenses
  4986.                                                          Full Profile
  4987.  
  4988.  
  4989.  Documentation Services set
  4990.  
  4991.     The Documentation Services set (doc) provides the documentation services
  4992.     and manual pages for use with the SCOhelp browser. It contains the
  4993.     Documentation service (documentation).
  4994.  
  4995.     The following packages are included:
  4996.  
  4997.     _________________________________________________________________________
  4998.     Package        Description                           Selected from
  4999.     _________________________________________________________________________
  5000.     BASEdoc        UnixWare Documentation                All Licenses
  5001.                                                          Full Profile
  5002.     BASEman        UnixWare Manual Pages                 All Licenses
  5003.                                                          Full Profile
  5004.     scohelp        SCOhelp online help system            All Licenses
  5005.                                                          Full Profile
  5006.  
  5007.  
  5008.  Localized Documentation Services set
  5009.  
  5010.     The Localized Documentation Services set (loc_doc) provides documentation
  5011.     and manual pages for use with the SCOhelp browser.
  5012.  
  5013.     The following packages are included:
  5014.  
  5015.     _________________________________________________________________________
  5016.     Package       Description                            Selected from
  5017.     _________________________________________________________________________
  5018.     frBASEdoc     UnixWare Documentation in French       All Licenses
  5019.                                                          Full Profile
  5020.     deBASEdoc     UnixWare Documentation in German       All Licenses
  5021.                                                          Full Profile
  5022.     esBASEdoc     UnixWare Documentation in Spanish      All Licenses
  5023.                                                          Full Profile
  5024.     jaBASEdoc     UnixWare Documentation in Japanese     All Licenses
  5025.                                                          Full Profile
  5026.     jaBASEman     UnixWare Manual Pages in Japanese      All Licenses
  5027.                                                          Full Profile
  5028.  
  5029.  
  5030.  Windows Integration Services set
  5031.  
  5032.     The Windows Integration Services set (winsrvcs) provides the file and
  5033.     print services and terminal emulation support for Windows. It contains
  5034.     the Windows Integration Service (windowsconn).
  5035.  
  5036.     The following packages are included:
  5037.  
  5038.  
  5039.     _________________________________________________________________________
  5040.     Package        Description                           Selected from
  5041.     _________________________________________________________________________
  5042.     visionfs       SCO VisionFS(TM)                      Not in Development
  5043.                                                          Edition
  5044.                                                          Full Profile
  5045.     termlite       SCO TermLite(TM)                      Not in Development
  5046.                                                          Edition
  5047.                                                          Full Profile
  5048.  
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.  Appendix B
  5055.  New features and enhancements
  5056.  
  5057.     This appendix provides information about new features and Program
  5058.     Temporary Fixes (PTFs) which have been incorporated into the UnixWare
  5059.     7.0.1 release.  All new features and enhancements are contained in the
  5060.     update701 package unless specifically noted, and are installed
  5061.     automatically during initial system load or when the update701 package is
  5062.     layered onto an existing UnixWare 7 system.
  5063.  
  5064.  
  5065.  New features
  5066.  
  5067.     UnixWare 7.0.1 includes the following new features:
  5068.  
  5069.     Unix95 conformance
  5070.             This release of UnixWare 7 fully conforms to the X/Open UNIX
  5071.             brand (Single UNIX specification).  By default UnixWare 7 is not
  5072.             strictly UNIX95 compliant, but you can fully enable strict
  5073.             compliancy by using the suscfg(1M) command which is located in
  5074.             /u95/bin.
  5075.  
  5076.     Core OS Performance Pack
  5077.             Includes performance improvements and bug fixes required to
  5078.             support the TPC/C benchmarking efforts.
  5079.  
  5080.     MMX support
  5081.             Permits applications which use MMX technology to execute.  This
  5082.             feature does not add support for building applications which use
  5083.             MMX.
  5084.  
  5085.     Merge performance
  5086.             Provides new kernel interfaces to Merge to accelerate context
  5087.             switching of Merge tasks.
  5088.  
  5089.     LFS tar/cpio
  5090.             Enables backups of files larger than 2GB and smaller than 1TB
  5091.             using tar, cpio or pax.
  5092.  
  5093.     PCI Hot-Plug
  5094.             Adds the capability to physically add, remove or replace a
  5095.             controller on a ``hot'' (running) system.
  5096.  
  5097.     HDK     Provides documentation for DDI and SDI.
  5098.  
  5099.     POSIX threads support
  5100.             Adds new POSIX threads (pthreads) interfaces based on P1003.1 -
  5101.             1996, and thread extensions from the Eastwood standard.
  5102.  
  5103.     NSC header file changes
  5104.             Provides changes to header files for NSC (NonStop Clusters); to
  5105.             provide user binary compatibility.
  5106.  
  5107.     Veritas File System Changes
  5108.             Allows VjFS/VxFS (statvfs), mount_vxfs and fsck_vxfs to provide
  5109.             support for UnixWare NonStop Clusters.
  5110.  
  5111.     2 Network card failover GUI support
  5112.             Enables a NIC to be configured as a failover device and be
  5113.             associated with a primary interface. The GUI also supports manual
  5114.             failover from the primary to failover device and a failback
  5115.             mechanism from the failover device to the primary NIC.
  5116.  
  5117.     Simplified Chinese locale
  5118.             A simplified Chinese locale (zh_CN.eucCN) is now provided. The
  5119.             user must provide their own fonts to make use of this locale. The
  5120.             font name must match the entry in /sbin/loadfont. See pcfont(1)
  5121.             for more details.
  5122.  
  5123.     Plug and Play Manager
  5124.             The new SCOadmin ISA PnP Configuration Manager allows you to
  5125.             detect and configure ISA Plug and Play devices, including sound
  5126.             cards, network cards, and other devices.
  5127.  
  5128.     Installation enhancements
  5129.             The Initial System Load of UnixWare now allows you to install
  5130.             software from multiple CD-ROMs in a single session.  See the
  5131.             Installation Guide for details.
  5132.  
  5133.     Enhanced hardware support
  5134.             UnixWare now supports additional popular audio, graphics, and
  5135.             networks adapters as described in Chapter  3, ``Updating your
  5136.             system''.  If you layer update701 on top of an existing UnixWare
  5137.             7 system, you must use pkgadd(1) to add the updated audio, nics,
  5138.             and xdrivers packages from the UnixWare 7.0.1 Operating System
  5139.             Updates CD-ROM.
  5140.  
  5141.     Updated documentation set
  5142.             The documentation set contains information on all new features
  5143.             and fuller coverage of other areas, particularly network and
  5144.             system administration.Updated localized documentation sets are
  5145.             also available. These packages are found on the UnixWare 7.0.1
  5146.             Operating System Updates CD-ROM.
  5147.  
  5148.     mailx now supports Japanese environment
  5149.             The mailx(1) command now supports Japanese.
  5150.  
  5151.  
  5152.  Enhancements in UnixWare 7.0.1
  5153.  
  5154.     UnixWare 7.0.1 includes fixes and enhancements previously released as the
  5155.     Release Supplement, localized UnixWare 7, and Program Temporary Fixes
  5156.     PTFs.
  5157.  
  5158.     The PTFs included in update701 are:
  5159.  
  5160.     ptf7002
  5161.          MPIO update supplement
  5162.  
  5163.     ptf7002b
  5164.          ICL fixes for MPIO/Clariion supplement
  5165.  
  5166.     ptf7003
  5167.          UnixWare supplement for Oracle 7
  5168.  
  5169.     ptf7004
  5170.          UnixWare language extension supplement
  5171.  
  5172.     ptf7005
  5173.          Filesystem update supplement
  5174.  
  5175.     ptf7010
  5176.          Accept protocol error supplement
  5177.  
  5178.     ptf7012
  5179.          UnixWare SNMP supplement
  5180.  
  5181.     ptf7011
  5182.          DLPI update supplement
  5183.  
  5184.     ptf7013
  5185.          UnixWare libsocket supplement
  5186.  
  5187.     ptf7014
  5188.          DDI8 CD-ROM supplement
  5189.  
  5190.     ptf7016
  5191.          UnixWare mem driver supplement
  5192.  
  5193.     ptf7017
  5194.          proc driver improvement supplement
  5195.  
  5196.     ptf7018
  5197.          UnixWare memsize supplement
  5198.  
  5199.     ptf7020
  5200.          UnixWare sysdump supplement
  5201.  
  5202.     ptf7021
  5203.          NFS update supplement
  5204.  
  5205.     ptf7022
  5206.          UnixWare support for Compaq Prosigna 800 and Compaq Wellness Driver
  5207.  
  5208.     ptf7024
  5209.          BIND 4.9.7 for UnixWare
  5210.  
  5211.     ptf7026
  5212.          UnixWare support supplement for Oracle 8
  5213.  
  5214.     ptf7027
  5215.          UnixWare seg_dev driver supplement
  5216.  
  5217.     ptf7028
  5218.          UnixWare postwait driver supplement
  5219.     ptf7102
  5220.          scohelp/netscape supplement
  5221.  
  5222.  
  5223.  
  5224.  
  5225.  
  5226.  Appendix C
  5227.  Supported locales and keyboards
  5228.  
  5229.     The current release supports the following locales:
  5230.  
  5231.     _________________________________________________________________________
  5232.     Locale                Description
  5233.     _________________________________________________________________________
  5234.     C                     C
  5235.     POSIX                 POSIX
  5236.     zh_CN                 Chinese for China
  5237.     hr_HR                 Croatian
  5238.     cs_CZ                 Czech
  5239.     da_DK                 Danish
  5240.     nl_BE                 Dutch/Flemish for Belgium
  5241.     nl_NL                 Dutch/Flemish for Netherlands
  5242.     en_AU                 English for Australia
  5243.     en_CA                 English for Canada
  5244.     en_GB                 English for Great Britain
  5245.     en_HK                 English for Hong Kong
  5246.     en_IN                 English for India
  5247.     en_IR                 English for Ireland
  5248.     en_SG                 English for Singapore
  5249.     en_US                 English for USA
  5250.     fr_BE                 French for Belgium
  5251.     fr_CA                 French for Canada
  5252.     fr_FR                 French for France
  5253.     fr_CH                 French for Switzerland
  5254.     fi_FI                 Finnish
  5255.     de_AT                 German for Austria
  5256.     de_DE                 German for Germany
  5257.     de_CH                 German for Switzerland
  5258.     el_GR                 Greek
  5259.     hu_HU                 Hungarian
  5260.     is_IS                 Icelandic
  5261.     it_IT                 Italian for Italy
  5262.     it_CH                 Italian for Switzerland
  5263.     ja_JP                 Japanese
  5264.     no_NO                 Norwegian
  5265.     pl_PL                 Polish
  5266.     pt_BR                 Portuguese for Brazil
  5267.     pt_PT                 Portuguese for Portugal
  5268.     ro_RO                 Romanian
  5269.     ru_RU                 Russian
  5270.     sk_SK                 Slovak
  5271.     sl_SI                 Slovenian
  5272.     es_AR                 Spanish for Argentina
  5273.     es_CL                 Spanish for Chile
  5274.     es_MX                 Spanish for Mexico
  5275.     es_ES                 Spanish for Spain
  5276.     es_VE                 Spanish for Venezuela
  5277.     sv_FI                 Swedish for Finland
  5278.     sv_SE                 Swedish for Sweden
  5279.     tr_TR                 Turkish
  5280.     uk_UA                 Ukrainian
  5281.  
  5282.     The following keyboards are supported:
  5283.  
  5284.     +  American
  5285.  
  5286.     +  American International
  5287.  
  5288.     +  Belgian
  5289.  
  5290.     +  British
  5291.  
  5292.     +  Canadian International
  5293.  
  5294.     +  Canadian French
  5295.  
  5296.     +  Czech
  5297.  
  5298.     +  Danish
  5299.  
  5300.     +  Dutch
  5301.  
  5302.     +  French
  5303.  
  5304.     +  German
  5305.  
  5306.     +  Greek
  5307.  
  5308.     +  Hungarian
  5309.  
  5310.     +  Icelandic
  5311.  
  5312.     +  Irish
  5313.  
  5314.     +  Italian
  5315.  
  5316.     +  Japanese A01
  5317.  
  5318.     +  Japanese AX
  5319.  
  5320.     +  Latin American
  5321.  
  5322.     +  Norwegian
  5323.  
  5324.     +  Polish
  5325.  
  5326.     +  Portuguese
  5327.  
  5328.     +  Romanian
  5329.  
  5330.     +  Russian
  5331.  
  5332.     +  Slovak
  5333.  
  5334.     +  Spanish
  5335.  
  5336.     +  Swiss German
  5337.  
  5338.     +  Swiss French
  5339.  
  5340.     +  Turkish F-Type
  5341.  
  5342.     +  Turkish Q-Type
  5343.