UnixWare 7 Release 7.1.3
New Features and Notes

Oct. 30, 2002

This document is provided both on the installation CDs and in the online documentation set; some of the links in this document do not work when this document is viewed from the CD. To see the online doc, which is installed by default, point any browser at http://localhost:8458. This document is available under New Features and Notes.


System Requirements
Installation Notes
Runtime Notes and Limitations
New Features
CD-ROM Contents

System Requirements

Minimum: 1 Intel Pentium or later microprocessor or 100% compatible (e.g., AMD Athlon and Duron processors),
Recommended: A 100MHz processor is recommended for minimum performance. Faster processors (available beyond 2GHz) will improve system performance and responsiveness. If Merge (from the Optional Services CD) is installed, a 200MHz or faster CPU is recommended.
Maximum: no known maximum

Minimum: 32 MB or more of RAM.
Recommended: 128MB for optimal CDE, Optional Services, and Java performance. Performance is further enhanced as more RAM is added.
Maximum: Up to 16GB RAM for General Purpose Memory and up to 64GB as Dedicated Memory (limited for use as either SHM or DSHM)

Disk Space
Minimum: At least 1GB.
Recommended: At least 2.8GB for the Installation and Updates CDs (CD #1 and #2) with LKP selected. To install all runtime CD packages, at least 4.6GB of disk space, as follows:
  • 2.8GB for the Installation and Updates CDs (with LKP selected)
  • 130MB for the Optional Services CD
  • 950MB for the Skunkware CD (available via ftp)
  • 700MB for OpenLinux Supplemental Open Source CD (available via ftp)
Maximum: IDE disk drives up to 128GB are supported; there is no limit on SCSI disk drive capacity.

Host Bus Adapters
Minimum: 1
Recommended: Depends on system's disk configuration.
Maximum: 32 HBAs default, up to 1024 HBAs if the driver supports it.

Network Cards
Minimum: 0 if no networking, 1 if networking
Recommended: 1
Maximum: No system limit; depends on the number of cards supported by the driver.


This section provides brief installation notes you'll need to successfully install UnixWare 7. For a full description of the installation process (including installing from a network Install Server), see the Getting Started Guide on the Base Operating System CD #1 under /info/gsg or in the online documentation under Installation and Licensing.

To begin a fresh install using a bootable CD-ROM: insert CD #1 into the bootable CD-ROM drive and power up (or reboot) the system.

To begin a fresh install on a non-bootable CD-ROM: you first need to create installation diskettes. See the instructions found under /info/images on CD #1. Insert Installation Diskette #1 into the primary floppy drive and power up (or reboot) the system.

To begin an upgrade install from Release 7.1.1 or 8.0.0 only: insert CD #2 into the primary CD-ROM drive and enter the following commands as root:

   pkgadd -d cdrom1 uli
   scoadmin upgrade wizard

Follow the prompts to install the desired packages. Once the Upgrade Wizard is finished, reboot the system:

   cd /
   shutdown -y -i6 -g0

You may now upgrade other software, such as LKP (see below) and Skunkware, that is not automatically updated by the upgrade process.

Upgrade Installation Licensing Information

An upgrade license is not required to upgrade from Release 8.0.0; however, the upgrade wizard may ask you for your original Release 8.0.0 license if it cannot determine it from the information on your system. A separate upgrade license is required to upgrade a UnixWare 7 Release 7.1.1 system, and the upgrade wizard may also ask for your original Release 7.1.1 license.

Installation Notes

Disconnect USB Hard Drives Before Installation
Installation Fails on HP Systems with Dual IDE Ports
Install Fails on non-conforming DMA IDE Drives
Larger Default vxfs Block and Log Sizes
osmp (Multiprocessing Drivers) package now part of base OS
kdb (Kernel Debugger) now part of base OS
Domain Names with Numeric Characters Permitted During Installation
Upgrade: Screen Goes Blank for a Moment
LKP on a Filesystem Other Than root
LKP Installation and Upgrade Uses OpenLinux 3.1.1 CDs
Upgrading LKP: Selecting a Profile
Autodetection of PCI IDE Drives Turned Off During Upgrade
No DHCP During Installation
CD-ROM Installation Order
Upgrading to ReliantHA 1.1.3
3Com 3c556B Laptop NIC Not Supported -- Autodetection Incorrect
Upgrade: Removal of BASEdoc May Fail
ENABLE_4GB_MEM on Systems with <4GB Memory
Upgrade: Use Upgrade Wizard
Upgrade: LKP Space May Be Miscalculated

Runtime Notes and Limitations

LKP: Using OpenLinux 3.1.1 with LKP
LKP: Applying Updated RPMs
Linux Shell Users Cannot Log Into or Run CDE
Installing and Running UnixWare 7 Applications
Emergency Recovery Does Not Work with the udi_dpt Driver and Tape Drives
X Applications Cannot Dynamically Scale Down Some Multibyte-Character Fonts
High Security Profile Prevents non-root DNS Lookups
Slow Printing on Extended Parallel Printing Ports
NVIDIA and AOPEN Video Driver May Cause Reboot when Opening Desktop
USB Keyboards Do Not Work with kdb
df Returns Error or Uses Wrong Path if LKP is Installed
Japanese xterm Has Cut and Paste Problems
Errors in First Mail to root After Install
CD Burning Timeout and Performance Issues
MultiTech Modem Problems After Upgrade
Java Errors When Using Netscape 4.6.1
Viewing Apache Manual Pages
USB Device Fails To Work on Connect

New Features

Advanced File and Print Server 4.0.2
Apache 1.3.26
Booting above 4GB
Buffer Overflow Checking
DocView Documentation Server
Domain Name Service (DNS) Configuration
EMC Symmetrix Disk Restamp Driver
Emergency Recovery Improvements
Filesystems and Disk Partitions
Hardware Development
Host Bus Adapters (HBAs)
Jackson Technology (Hyperthreading) Support
Java Development Kit 1.3.1
Linux Kernel Personality (LKP)
LS-120 and LS-240 Device Support
Merge 5.3.4
Network Interface Cards (NICs)
OpenServer 5 Libraries
Program Temporary Fixes (PTFs)
ReliantHA 1.1.3
Removable Storage Support (CD-R, CD-RW, Zip, DVD)
Samba 2.2.4
SCSI-3 Support
SCO Update Service
Skunkware for Release 7.1.3
Squid Proxy Server
Universal Serial Bus (USB)
UnixWare 7 Development Kit
Video Drivers
Volution Manager Client
Volution Manager Server

Advanced File and Print Server 4.0.2

Advanced File and Print Server (AFPS) provides file sharing capabilities using native Microsoft SMB and CIFS protocols for interoperability with Microsoft operating systems, and is based on Microssoft NT 4.0 networking technology. Version 4.0.2 is included on the Optional Services CD-ROM, and includes a number of bug fixes and enhancements over the previous version (4.0.1) included with UnixWare 7 Release 8.0.0, Most notably, AFPS 4.0.2 includes Windows 2000 interoperability. The documentation for this software is installed under DOS and Windows in the online documentation when you install the software.

Apache 1.3.26

Version 1.3.24 of the Apache Web Server is included on CD #1 and CD #2. The package includes a startup script (/etc/init.d/apache) with options to start/stop and enable/disable Apache web service. Apache 1.3.24 supports the Apache interface to OpenSSL, mod_ssl, as well as the Apache interface to Perl, mod_perl.

PHP 4.2.0 is also available on the Skunkware CD-ROM. To install PHP:

  1. Insert the Skunkware CD in the CD drive, and enter:
        # pkgadd -d cdrom1 php
  2. Stop and restart your Apache server to enable PHP 4 support:
        # /etc/init.d/apache stop
        # /etc/init.d/apache start

Booting above 4GB

Previous releases required that an UnixWare 7 bootable partition must be located within the first 4GB on the disk and below cylinder 1024. With this release, the bootable partition must be located within the first 8GB and below cylinder 1024.

Buffer Overflow Checking

Buffer overflow attacks have become increasingly common, and represent a major security vulnerability. A buffer overflow occurs when an application uses a fixed-length buffer to hold user input, and does not check that the data read into the buffer does not exceed the size of the allocated buffer. Malicious users can exploit this programming error by overwriting the buffer with data that typically gets executed as a program and grants them a shell on the target system. If the application whose buffer is overwritten in this fashion is a system process running as root, the user can gain unrestricted access to the system. Other possible methods of exploiting buffer overflows also exist. The bock command provides a means of monitoring for such attacks. See the bock(1M) manual page in the online documentation.


Version 1.11a21 of the cdrtools CD recording software is provided on the Optional Services CD-ROM. It includes the following tools (manual pages for these can be displayed with the man(1) command after installing cdrtools):
record audio or data Compact Discs from a master
read or write data Compact Discs
a sampling utility that dumps CD audio data into wav sound files
devdump, isoinfo, isovfy, isodump
utility programs for dumping and verifying iso9660 images
create a hybrid ISO9660/JOLIET/HFS filesystem with optional Rock Ridge attributes

Please also see the section CD Burning Timeout and Performance Issues, in this document.

DocView Documentation Server

The DocView Documentation Server (docview) is installed by default from CD #1 during a fresh installation and from CD #2 during an upgrade. DocView provides access to all documentation installed on UnixWare 7, through a customized Apache server on port 8458. With it, updated documentation packages are installed that are designed to work in the DocView framework.

To display DocView, simply point any browser at http://localhost:8458. If you get no response, check the status of DocView and start it if necessary, as shown (logged in as root):

# docview status
/etc/docview status: httpd (no pid file) not running
# docview start
/etc/docview start: httpd started
DocView may also not start because the Apache Web Server package was not installed. To check if Apache is installed, enter:
$ pkginfo apache
UX:pkginfo: ERROR: information for "apache" was not found
The above example shows the response given if Apache is not installed. To install Apache, insert the Optional Services CD into the CD-ROM drive, and enter:
$ pkgadd -d cdrom1 apache

DocView uses htdig as its search engine. The search index is not created automatically when you install DocView. To create the search index, run the following command as root:


Whenever you add documentation to DocView, run the above command to include the new documentation in the search index.

DocView replaces the SCOHelp documentation server and browser supported on Release 8.0.0 and earlier systems. Upgraded systems will have both SCOhelp (serving port 457) and DocView (serving port 8458) installed; the previous release's BASEman and BASEdoc packages are removed, and a pointer to DocView is added at the top level of SCOhelp. Fresh installations will have DocView only.

The table below shows the base system documentation packages now in DocView format, the CD-ROMs on which they are located, and the name of any set that installs the documentation packages automatically.

CD #1, #2docview
CD #2lkpdoclxcompat
OUDK CDudkdocudk

The remainder of the documentation on CD #2 (such as the openslpd package) and the documentation packages on he Optional Services CD remain in SCOhelp format, and will be installed and displayed under DocView on port 8458. Similarly, legacy SCOHelp-format documentation from prior releases will be viewable under DocView after they are installed, under the same topic name as before. For example, the RelHAdoc package is in SCOhelp format on the Optional Services CD. It is installed under the Filesystems topic in both SCOhelp and DocView.

Domain Name Service (DNS) Configuration

The scoadmin dns graphical interface can be used to set up basic Domain Name Service (DNS) configuration files and a BIND9 boot file. A new command, h2n(1M), is provided to manage basic and advanced DNS and BIND9 features. See the manual page for details. Note that once you use h2n, you must continue to use it to maintain the configuration files; the scoadmin dns interface cannot process the files generated by h2n.

EMC Symmetrix Disk Restamp Driver

This driver is included specifically for EMC Symmetrix RAID storage systems, and should be installed only when an EMC Symmetrix RAID storage system is attached to the UnixWare 7 system. This driver is included in its own package (named rstmp) on the Updates CD (CD #2) and is not loaded automatically during ISL. During an update of a previously installed system, this package will be installed if an instance already exists on the system. There are no tunables or external APIs for this driver. To manually load this driver, insert the Updates CD into your primary CD-ROM drive and enter:
   pkgadd -d cdrom1 rstmp

Emergency Recovery Improvements

The emergency_disk(1M) command has been updated to incorporate a number of improvements and bug fixes, to reduce the likelihood of floppy diskette overflow, and to add support for USB keyboards and disks. The emergency_rec(1M) command has been updated to support larger block sizes. See the manual pages for details.

Filesystems and Disk Partitions


Host Bus Adapter Support

The following Host Bus Adapter (HBA) drivers have been updated as indicated:

adsl Corrected various problems that made the system unusable.
adst70 The following problems were corrected:
  • spurious messages at boot time
  • internal error with Adaptec 39169 2-channel card
  • driver failed to recognize last drive on the SCSI bus
  • problems with timeouts
ciss Corrected a problem where ciss-based boot controllers were not configured properly during OS installation. This updated driver adds support for the following Compaq HBA model: the Smart Array 5312 64 bit PCI-X Dual Channel Ultra 160. Note that to use 64-bit DMA with this driver, ensure that Smart Array 530x or Smart Array 532 firmware is at firmware level 2.18 or higher; if not data corruption could occur. Smart Array firmware updates can be found on Compaq's Web Site.
c8xx Minor problems with the text displayed on boot were corrected. The fixed block size limit was increased to 128K.

Jackson Technology (Hyperthreading) Support

UnixWare 7 includes the capability to use Intel Jackson Technology (hyperthreading) available on some Pentium 4 processors, but does not include full ACPI (Advanced Configuration and Power Interface) support. The Intel Multi-Processor Specification (MPS) firmware tables are still required to boot; hence, UnixWare 7 will not work on a system that only supports ACPI.

Note that using Jackson Technology may either increase or decrease system performance depending on the workload applied to the system. By default, Jackson Technology is disabled. To enable it, edit the file /stand/boot and add the following to the file:


You can also enter this string before the OS boots, by pressing the space bar when you see the UnixWare 7 logo during a reboot.

Modifications were made to the MPS (Intel Multi-Processor Spec) PSM (Platform Specific Module) to read the ACPI BIOS tables. The PSM processes the tables as follows:

  1. If the "ENABLE_JT" boot parameter is set to "Y", the MPS PSM will attempt to use the ACPI tables to enumerate the processors on the system.
  2. If reading the ACPI tables fails, the PSM will fail to load.
  3. If the ACPI tables are loaded correctly and Jackson Technology is present, the OS assumes the ACPI tables have presented it with all the logical processors available on the system.
  4. During system initialization on a multi-procesor kernel, if the "ENABLE_JT" boot parameter is set to "Y" and Jackson Technology is present, the bootstrap processor is queried for the number of logical processors present in it. The number of logical processors/physical processor is saved for later use in determining the maximum number of processors to allow online. The default number of logical processors/physical processor is 1.
  5. Except for onlining processors, the OS does not distinguish between logical and physical processors. When requested to bring a processor online, the OS checks whether the CPU license is greater than or equal to the number of physical processors on the system. If this is true, all logical processors present in the system will be allowed to be brought online. If not all of the physical processors have been licensed, the number of logical processors allowed online is kept the same as the number of physical processors licensed.

Use the psrinfo(1M) command to display processor status.

Java 2 Development Kit 1.3.1

Release 7.1.3 includes version 1.3.1 of the Java 2 Development Kit on CD #2 (the Updates CD) and the Development Kit CD. The JDK 1.3.1 is provided in two packages, j2jre131 (the runtime environment) and j2sdk131 (the development kit).

The java2sdk3 package from Release 8.0.0 has been updated and is also on CD2 to allow users to upgrade previous versions of the java2sdk3 package. These packages can be selected during a fresh install or an upgrade from a previous release. They can also be installed manually using pkgadd; the j2sdk131 package depends on the j2jre131 package, which must be installed first. as in this example:

pkgadd -d cdrom1 j2jrel31 j2sdk131

Release notes for the JDK are on the UDK CD under /info/java_dk.

Linux Kernel Personality (LKP)

The Linux Kernel Personality (LKP) is installed from The Updates CD #2 and the Linux RPM CD #4. CD #4 contains a full OpenLinux 3.1.1 distribution. Other RPMs from the Supplemental Open Software CD for OpenLinux are available for download from

LS-120 and LS-240 Device Support

ATAPI and USB (Universal Serial Bus) LS-120 and LS-240 floppy drives (such as the Imation SuperDisk) are supported. During installation, however, only USB LS-120/240 devices can be used and only for diskettes used after the installation begins (that is, you cannot begin the installation by inserting the first Installation diskette into an LS-120/240 drive, but you can use a USB LS-120/240 drive for the HBA diskettes).

The LS-120 technology standard enables LS-120 floppy drives to store 120 MB of data on a single, 3.5-inch LS-120 diskette; an increase of more than 80 times the current capacity of standard 1.44 MB diskettes. The LS-240 standard doubles that capacity when using LS-240 diskettes; LS-240 drives can also typically read/write LS-120 diskettes, as well as reformat standard 1.44MB-capacity diskettes to hold 32MB of data. Both types of drives can read and write standard 1.44MB capacity diskettes.

Merge 5.3.4

The Optional Services CD (CD #3) contains Merge 5.3.4, the latest version from NeTraverse. If you are upgrading, the merge package on CD #3 will automatically remove any already installed instance of the merge package before installing Merge 5.3.4. Note that removing the previous merge package does not remove individual users' Windows configurations.

If your system is a fresh installation of Release 7.1.3, the Merge documentation is served by DocView on http://localhost:8458 and installed under DOS and Windows. If you upgraded your system to Release 7.1.3, then the Merge documentation is served by both DocView and the previous SCOhelp browser (on port 457) under the same topic. Also see the Merge Release Notes under the /info/merge directory on the CD.

Network Interface Cards (NICs)

In earlier releases, the BOARD_IDS parameter in a driver's bcfg(4dsp) file accepted identifiers in the format 0xSubVendorSubDevice, as in:

Though never officially supported, this format did work. With Release 7.1.3, the format above is no longer allowed; BOARD_IDS must be specified in the format 0xVendorDevice.SubVendorSubdevice, as in:


If both formats are specified, then the driver will work on both Release 7.1.3 and older systems:

BOARD_IDS="0xE110085 0x14E41645.0x0E110085"

Discontinued NIC Drivers:

The Intel eeE and e1000g drivers are no longer provided or supported. They are replaced by the eeE8 (Intel Pro/100+) and e1008g (Intel Pro/1000) drivers, respectively. On upgrade, the new drivers do not automatically replace the older drivers; the system continues to use the eeE or e1000g drivers if already installed. To use the new driver instead: run netcfg (or scoadmin network), remove the adapter, then add the adapter again, selecting the new driver (both drivers will be listed).

The stbg driver (IBM PCI Ethernet Adapter) has been discontinued; use the pnt driver (AMD PCnet family mdi driver) instead.

New and Updated NIC Drivers:

The following network interface card (NIC) adapter drivers are new or have been updated for this release:

The new Broadcom Corporation Gigabit Ethernet (1000Mbps) DDI8 driver (version 2.2.13) supports the following NICs:
  3Com 3C996/3C1000/3C94X Gigabit Ethernet
  Broadcom BCM5700 NetXtreme Gigabit Ethernet
  Broadcom BCM5701 NetXtreme Gigabit Ethernet
  Broadcom BCM5702 NetXtreme Gigabit Ethernet
  Broadcom BCM5703 NetXtreme Gigabit Ethernet
  Compaq NC6770 Gigabit Ethernet
  Compaq NC7760 Gigabit Ethernet
  Compaq NC7770 Gigabit Ethernet
  Compaq NC7771 Gigabit Ethernet
  Compaq NC7780 Gigabit Ethernet
  Compaq NC7781 Gigabit Ethernet
The Compaq NetFlex driver has been updated to version 7.4.4 and adds support these new adapters:
Compaq Netelligent 10/100 TX PCI Dual TP (ID CPQAE40)
Compaq Netelligent 10BaseT PCI UTP (Board ID CPQAE34)
The Intel e1008g Gigabit (1000Mbps) Ethernet DDI8 driver has been updated to version 6.2.14. It fixes various problems with previous versions and adds support for the XF and XT models shown in the list of supported adapters below.
  700262-xxx  PRO/1000 Gigabit Server Adapter            PWLA8490
  717037-xxx  PRO/1000 Gigabit Server Adapter            PWLA8490
  713783-xxx  PRO/1000 Gigabit Server Adapter            PWLA8490G1

  A38888-xxx  PRO/1000 F Server Adapter                  PWLA8490SX
  738640-xxx, PRO/1000 F Server Adapter                  PWLA8490-SX
  A06512-xxx  PRO/1000 Gigabit Adapter                   PWLA8490SXG1P20

  A19845-xxx  PRO/1000 T Server Adapter                  PWLA8490T
  A33948-xxx  PRO/1000 T Server Adapter                  PWLA8490TG1P20

  A51580-014  PRO/1000 XT Server Adapter                 PWLA8490XT
  A73668-001  PRO/1000 XT Server Adapter                 PWLA8490XTL
  A68178-xxx  PRO/1000 XT Lo Profile PCI Server Adapter  PWLA8490XTL
  A50484-xxx  PRO/1000 XF Server Adapter                 PWLA8490XF

  739456-xxx  IBM Netfinity Gigabit Ethernet SX Adapter  09N3599
  721352-xxx  IBM Netfinity Gigabit Ethernet SX Adapter  30L7076
  A34085-xxx  IBM Gigabit Ethernet SX Server Adapter     06P3718
  A36407-xxx  IBM Gigabit Ethernet Server Adapter        22P4618

  A78408-xxx  PRO/1000 MT Desktop Adapter                PWLA8390MT
  A81081-xxx  PRO/1000 MT Server Adapter                 PWLA8490MT
  A65396-xxx  PRO/1000 MT Dual Port Server Adapter       PWLA8492MT
  A81983-xxx  PRO/1000 MF Server Adapter                 PWLA8490MF
  A78709-xxx  PRO/1000 MF Dual Port Server Adapter       PWLA8492MF
The new 3Com EtherLink PCI DDI8 driver (version 1.1) provides updated support for the following adapters, formerly supported only by the e3H driver. If you have one of these adapters, you should use the e3bc driver:
3COM 3C980C EtherLink Server
3COM 3C982-TXM Dual Port Fast EtherLink Server
3COM 3C980C-TXM 10/100 PCI Server Network Interface Card
The Intel eeE8 EtherExpress driver was updated to version 2.3.19 and adds support for the following new adapter:
Intel EtherExpress PRO/100B T4 PILA8475B


Support for Network File System version 3 (NFSv3), including NFS over TCP, has been added. Changes are reflected in the appropriate NFS manual pages [e.g., automount(1M), and mount(1Mnfs)].

OpenServer 5 Libraries

The libraries that provide compatibility for compiled OpenServer executables on OpenUnix 8 have been updated to the latest versions from OpenServer 5 Release 5.0.6a.


Version 1.0.6a of the openslp package is included on both the Installation CD and the Updates CD (CD #1 and CD #2). This is a fully supported native port of the Open Source OpenSLP technology to UnixWare 7. The Service Location Protocol (SLP) is an IETF standards track protocol that provides a framework to allow networking applications to discover the existence, location, and configuration of networked services in enterprise networks. For more information on OpenSLP, search the online documentation for ``SLP'' after installing the openslpd package (on CD #2 only), or go to


OpenSSH is a suite of network connectivity tools that encrypts all traffic to effectively eliminate eavesdropping, connection hijacking, and other network-level attacks. OpenSSH provides a variety of secure tunneling capabilities and authentication methods. Version 3.4p1 is included on both the Installation CD and the Updates CD (CD #1 and CD #2). This version fixes a major security vulnerability present in versions 2.3.1 to 3.3, and is built with privilege separation and compression turned on.

The OpenSSH suite includes the ssh program (replacing rlogin and telnet), scp (replacing rcp), and sftp which replaces ftp. Also included is sshd, the server side of the package, and the other basic utilities like ssh-add, ssh-agent, ssh-keygen and sftp-server. OpenSSH supports SSH protocol versions 1.3, 1.5, and 2.0. For more information on the SSH tools, see the documentation on the OpenSSH Web Site


Version 0.9.6 of the openssl package is included on both the Installation CD and the Updates CD (CD #1 and CD #2). This is a fully supported native port of the Open Source OpenSSL technology to UnixWare 7. OpenSSL is an Open Source toolkit implementing the Secure Sockets Layer (SSL v2/v3) and Transport Layer Security (TLS v1) protocols as well as a general purpose cryptography library. A user level command, openssl, is also provided that performs a variety of cryptographic functions. For more information on OpenSSL, type man openssl after installing the openssld package (on CD #2 only), or go to

Program Temporary Fixes (PTFs)

Program Temporary Fixes (PTFs) contain software and documentation issued between major releases. Maintenance Packs are also issued between releases, and these typically combine several PTFs along with additional bug fixes. They are more convenient than applying individual PTFs and are updated as additional PTFs are issued during the lifetime of a release. Release 7.1.3 includes all the fixes issued with Release 8.0.0 Maintenance Pack 4 (ou800pk4). For more information on the content of ou800pk4, go to the SCO FTP Site

ReliantHA 1.1.3

The Optional Services CD (CD #3) contains ReliantHA 1.1.3, the latest version. If you are upgrading from an earlier version of ReliantHA, you must remove the previous version of ReliantHA first (as in pkgrm ReliantHA), and then install ReliantHA 1.1.3 from the Optional Services CD. An upgrade package for releases 1.1.0-1.1.2 will be included in the final product. If you have already installed the new package over the old, remove the package as shown above and then reinstall from the CD.

The documentation for this software is installed under Filesystems in the online documentation. The following enhancements are included in version 1.1.3:

  1. Added a configuration utility to simplify the configuration process. The new script is /usr/opt/reliant/bin/rcu. Documentation for it will be available in the final product.

  2. Added a minimal sanity diagnostic tool for ReliantHA configurations. The new script is /usr/opt/reliant/bin/rdu. Documentation for it will be available in the final product.

  3. Added a sample script utility that copies configuration files from one machine to all other nodes in a Reliant cluster. It new script is /usr/opt/reliant/bin/samples/hvcpconf. Documentation for it will be available in the final product.

  4. When serial or other private links fail, a warning is now logged in the switchlog file.

  5. The example line in the hvipalias files has been updated.

  6. The gab driver has been changed to allow the system administrator to run the gabconfig command to make the system panic when a gab_halt occurs, allowing a dump to be taken. The command and its options are:

         /sbin/gabconfig -P [0|1]

    A '1' enables the panic scenario, and a '0' disables it. It is disabled by default.

  7. Oracle failover scripts capable of handling Oracle9i have been provided as sample scripts in the /usr/opt/reliant/samples directory. They have not yet been fully certified, so use them at your own risk. When certified, they will replace the Oracle scripts with the same names in /usr/opt/reliant, which are currently not Oracle9i-capable.

  8. A bug in the Process_Offline script has been corrected, so that the appropriate script processes get killed, and do not accidentally kill non-ReliantHA processes and shells. It also appropriately kills any children spawned by the ReliantHA process.

  9. The Ip and Mount detector scripts have been improved, and now allow you to set the debug mode for each, as follows:

    Desired Logging Behavior -d flag in the Ip or Mount entry in /usr/opt/reliant/etc/rkind/names .Ipdebug_min or .Mtdebug_min file in rkind directory
    log failure messages and state changes onlyset exists
    log all messagessetremoved
    log minimum detector messages and don't log bm messages unsetexists
    log no messagesunsetremoved

  10. An experimental, improved Nw detector has been added as a sample; it should be used with care on production systems, or it may pose a security risk.

    The vulnerability is that rsh is invoked within the binary, and root permission in the .rhosts file on each node must be enabled for the experimental version to work properly. By doing this, you are allowing the root login on the system running the experimental version to log in to any node with root permissions.

    To use the experimental Nw:

    1. cp /usr/opt/reliant/bin/samples/Nw /usr/opt/reliant/bin/Nw
    2. On each node, create a /.rhosts file that contains the system name (uname -s)

    The experimental Nw detector, upon detection of a Network failure, will remotely check the ability of other nodes to access the network. If they are unable to access the network either, then the applications will stay on the current node. If the node to which the application is to move is successful in accessing the net, then the switchover will proceed as configured.

    When none of the nodes are able to access the public network, execution of hvdisplay will show all applications (as well as the Nw Resource) to be "online". The Nwlog will log messages indicating that the network is inaccessible. The administrator must inspect the log, when the network access is questionable, before executing an hvswitch. To execute hvswitch under this condition will not restore the network and may result in an unecessary switch.

    Setting the debug level is the same as for Ip and Mount, except the resource name is Nw and the file is .Nwdebug_min.

Removable Storage Support (CD-R, CD-RW, DVD, Zip)

The following removable mass storage devices and media are now supported:

The cdrtools application on the Optional Services CD can be used to record CD-R and CD-RW format CDs.

Samba 2.2.4

Samba 2.2.4 is included on the Optional Services CD. Samba provides filesharing capabilities using native Microsoft SMB and CIFS protocols for interoperability with Microsoft operating systems. Samba 2.2.4 includes both a Pan-European version as well as a multibyte version suitable for Asian locales. (The important difference between the two versions is the sorting algorithm used for file ordering which determines whether the file sorting is compatible with wide-character or ascii character code environments.)

Samba is configured with the SWAT (Samba Web Administration Tool) utility using a web browser on http://localhost:901. In both versions, localization settings are accessed from the SWAT Home Page by clicking on the Globals tab, and then selecting Advanced View. Set appropriate values for your locale for the client code page, the character encoding system, and the other options (each option has context-sensitive help). Please refer to the man page for smb.conf for futher details. The Samba documentation is installed with the software. To view it:

SCSI-3 Support

The SCSI (Small Computer System Interface) technology standard, version 3 (commonly called SCSI-3), is supported in Release 7.1.3, so you can take advantage of faster SCSI-3 controllers and devices (such as hard drives, CD-ROMs, DVDs, scanners). This 16-bit peripheral bus provides maximum transfer rates of 80MB/s and allows for cable lengths of up to 39 feet (12 meters). Simply install the SCSI-3 controller into an expansion slot in your system, properly attach one or more SCSI-3 devices to the controller with a SCSI cable, and configure the device using the SCSI configuration tools provided by the controller vendor before rebooting UnixWare 7.

SCO Update Service

The SCO Update Service provides a convenient way for you to keep your system current via access to maintenance and security updates, and optionally to early access to new product features which will be included in the next release. When you register your SCO Update Enabling License, obtain a Registration Key, and enter the information into the License Manager, you will then receive updates over the internet (or, optionally, on CD). Please go to for more information about the SCO Update Service, including SCO Update licensing terms and obtaining a SCO Update license.

SCO Update Service Enabling Licenses are sold either separately or bundled with an Edition License. If bundled with the Edition License, the Enabling License is part of the license information supplied during installation of the system, and will appear in the License Manager after installation. If purchased separately, use the License Manager to enter SCO Update license information.

The SCO Update Service Enabling License must be registered in order to begin receiving product updates via the SCO Update Service.


Registering your system software provides these benefits:

Registering a product is basically a three-part process: first, you use the License Manager to get the information you need to register; second, you visit the Registration Web Site to obtain a Registration Key; then, you use the License Manager again to enter the Registration Key onto your system.

See Using the License Manager for how to use the License Manager and register products.

Skunkware for Release 7.1.3.

Skunkware offers a wide variety of open source software re-compiled for UnixWare 7. Please visit the Skunkware web site at for the latest open source software for UnixWare 7.

telnet Enhanced for Mutlibyte Locales

The telnet command has been enhanced to enable binary mode (i.e., the -8 option) by default in Asian locales. See the telnet(1tcp) manual page for details.

Squid Proxy Server

Version 2.4.STABLE6 of Squid is included on the Optional Services CD-ROM. Squid provides high performance proxy caching for Web clients.

Universal Serial Bus (USB)

USB, the Universal Serial Bus, is an increasingly ubiquitous interconnect that allows large numbers of hot-pluggable devices to share a consistent interface to the host. With USB devices, you simply plug the device into a USB port and the device is available. Release 7.1.3 is compliant with Version 2.0 of the USB Specification and supports the device types listed below; note that the current USB implementation does not support USB printers and modems. The USB interface is implemented via the Uniform Driver Interface (UDI). Both the usb and the udienv packages must be installed to enable USB support.
HCI - The Host Controller Interface
Tape Drives

Any device that conforms to the protocol defined in the USB Specification should work with the UnixWare 7 USB stack. Devices using proprietary protocols will not. If you have, for example, a touch tablet that presents itself as a conforming Human Interface Device, there is an excellent chance that it will work like a mouse even though it has not explicitly been tested. The following hardware has been used with Release 7.1.3:

Keyboards Antec
Imageteam 3800PDF handheld linear Imager
Logitech iTouch
Microsoft Natural Keyboard
Symbol 2014 Barcode reader
Mice Acomdata RF wireless/laser pointing presentation mouse
Apple Hockey Puck
Apple Optical
Kensington Mouseworks
Logitech Mouseman Wheel
Microsoft Intellimouse
Microsoft Intellimouse Optical Explorer
Hubs Antec keyboard integrated hub
Ariston 4 port
Apple keyboard integrated hub
Aten 2 port dongle
Belkin 7 port
Belkin F5U012 docking station (hub only)
Gateway keyboard integrated hub
Logitech itouch keyboard integrated hub
Orange Micro USB 2.0
Xircom 4 port
HCIs Numerous motherboard chipsets
Dlink D500 UHCI
Adaptec EHCI
Orange Micro EHCI
ADS 2-port OHCI
CDs Addonics 1.1 cable
Addonics 2.0 cable
IBM USB Portable CD-ROM Drive 00N8239 (mechanical media lock)
Iomega ZipCD 650
La Cie 8x4x32
Part II Atapi to USB CD-RW enclosure
Plextor PlexWriter 24x10x40 CD-RW Drive PX-W2410A1.03
Tape Drives Onstream USB 2.0 Exernal Tape
Drive with controller
LS120/240 Floppy Drives Addonics Pocket Superdisk 240
Buslink floppy FDD1 (mechanical media lock)
IBM External USB Floppy Disk Drive 05K9282
Imation D353FUE
Que Superdisk 240

For more information on USB, including copies of the USB 2.0 Specification, see the USB Web Site.

UnixWare 7 Development Kit

Various improvements have been made in the native compilers and tools provided on the UnixWare 7 Development Kit CD. Among them:

For more information, see the /info directory on the UDK CD; it contains updated release notes for the Java Development Kit, the Open Source Tool Kit, as well as the UnixWare 7 compilers and tools.

See the Guide to Development Kits for a general introduction to developing software on SCO Products. This and other resources are available from the SCO Developer Network Web Page.

Video Drivers

The default graphics mode for installation has been increased from 800x600 resolution with 256 colors to 1024x768 resolution with 256 colors.

The following updated drivers are provided in Release 7.1.3:


The mtx driver has been updated to include support for the Matrox G450 Graphics Adapter. The highest resolution supported by the driver is 1600x1200 with 16 million colors, even though the card is capable of supporting higher resolutions. Also note that the DualHead and Dual Display features of this adapter are not supported.


Autodetection support for the ATI RAGE 128 PRO II GL Graphics Adapter has been added to the r128 driver.

Volution Manager Client

Both CD #1 and CD #2 contain the Volution Manager 1.1 Client for UnixWare 7 Release 7.1.3. The Volution package (along with the required openssl and openslp packages) are selected by default for both fresh and upgrade installations. They can also be installed manually from either CD as in this example:
pkgadd -d cdrom1 openssl openslp Volution

The Volution Manager Client requires a Volution Manager 1.1 Server running on OpenLinux 3.1.1 or on Release 7.1.3/LKP; in the case of LKP, the server can be installed and run on the same machine as the UnixWare 7 VM Client. Together, they enable you to manage critical services on your UnixWare 7 system from a browser anywhere on your network. Once installed, the Volution Manager Client is started by executing:

/etc/init.d/volutiond start

Note that although a Volution Manager Client is provided for OpenLinux, you should not install and run the Volution manager Client under LKP; only the Unix-side VM Client can manage a Release 7.1.3/LKP system.

All documentation for using Volution Manager 1.1 is installed on the Server system, not on the Client. The Volution Manager Installation Guide and Administration Guide are available on the web at It is recommended that you read Chapter 3 of the Volution Manager Installation Guide, “Installing Volution Manager Clients”, with particular attention to the subsection “Running the Volution Manager Key Tool on UnixWare and UnixWare 7 Clients” before running the VM Client. Also see the product information on the Volution Manager Web Page.

Volution Manager Server

You can manage software on your Release 7.1.3 system with a Volution Manager Server running on the LKP side, and a Volution Manager Client running on the Unix side.

The Volution Manager Server is provided on a separate CD-ROM, and is installed under LKP only. You must choose LKP for installation from CD #2 on fresh install or upgrade (or use the lkpinstall command after installation or upgrade) to install LKP, prior to installing the Volution Manager Server. A Volution Manager Client can be run on the Unix side using the Volution set installed from CD #1 or CD #2 (see Volution Manager Client).

To install the Volution Manager Server from the supplied CD, and then start the Unix Volution Client, follow these steps:

  1. Select the KDE2 and Linux Personality (LKP) session option in the CDE login screen, and log in as root.

  2. Edit the file /unixware/etc/default/linuxrc and remove httpd, ldap, slpd, and tomcat. This lets the needed daemons run under LKP.

  3. Mount the Volution Manager CD on /mnt/cdrom.

  4. Enter the following:

       cd /mnt/cdrom/server

    This begins the Volution Manager Server installation; follow the prompts shown. After displaying a message indicating that installation is complete, a screen titled Postinstall Diagnostics appears and may hang. This will appear after a message indicating that installation is complete, and does not affect operation of the Volution Manager server. If this screen does hang, switch to another terminal before going to the next step.

    Note that after the installation is complete, the Volution Manager Linux client runs under LKP; this misleads Volution Server into treating the system as if it were a Linux system. The Linux client will not be restarted after rebooting, but you do need to remove the computer object in the Volution Manager database that was created for the system before starting the Unix client. This is done in a later step.

  5. Reboot the system:

    shutdown -i6 -g0 -y
  6. Remove the computer object from the database before starting the Unix client:

    1. Connect to the Volution Manager Server console by pointing a browser at https://servername/volution.
    2. After logging in, use the Go to object popup window to find the computer object for your system.
    3. Click on the Delete this object task to remove the computer object.

  7. To access the server from the Unix Volution client:

    1. Log in as root in Unix mode and see if the Volution Client is installed:
      pkginfo Volution

      If no information is found for Volution, install the client as shown in the section Volution Manager Client.

    2. Start the Unix client by entering:
      /etc/init.d/volutiond enable
      /etc/init.d/volutiond start
    3. Once the client is installed and configured, you can connect to the Volution Manager Server console by pointing a browser at https://servername/volution.

CD-ROM Contents

Release 7.1.3 includes the following software on CD-ROM. The package or set name used to manually install the indicated software or documentation using the pkgadd command is shown in parentheses in the table below, as appropriate.

Base Operating System Installation CD #1
  • Bootable CD-ROM image
  • Images for creating boot, network install, and HBA diskettes (see /info/images/readme.txt on the CD)
  • Initial System Load (ISL) image
  • UnixWare 7 Release 7.1.3 UpdateSet for ISL
  • Documentation Set (doc)
       includes: DocView Server (docview)
       Base System Guides (basedoc)
       Base System Manual Pages (baseman)
  • Veritas Volume Manager 3.2 (vxvm)
       includes disk mirroring, striping,
       spanning and similar features
  • Veritas ODM Visual Administator 3.2 (vxva)
       graphical volume administration
  • Apache Web Server 1.3.26 (apache)
  • Volution Manager Client (Volution)
  • OpenSSL 0.9.6 (openssl)
  • OpenSSH 3.4p1 (openssh)
  • OpenSLP 1.0.6a (openslp)
  • Strong Encryption Supplement 1.0 (encrypt)
  • UDI 1.01 Runtime Environment (udienv)
  • X Server and Client software, fonts, etc.
  • Driver packages
  • other packages installed during ISL
  • /info files
This is the first CD-ROM to insert during a fresh install of UnixWare 7 (see Installation). This CD is also used to stage the base operating system for a network install.
Individual packages from this CD can also be installed after a fresh install using pkgadd(1M), but it is recommended that all desired packages be selected during the fresh or upgrade installation process. If you add packages after installation, you'll need to reapply the UpdateSet (from the Updates CD #2).
A copy of the product release notes (the document you are reading now) is included in the file relnotes.html at the top of the CD #1 directory structure. The /info directory on the CD-ROM contains additional notes, copies of software licenses, and other important information. See /info/readme.htm on the CD.
Base Operating System and Updates CD #2
  • UnixWare 7 Release 7.1.3 Update Set (UpdateSet)
  • Linux Kernel Personality (LKP) Set (lxcompat)
    includes: LKP Documentation (lkpdoc)
  • Netscape Communicator 4.6.1 (nscomm)
  • Apache Web Server 1.3.26 (apache)
  • Volution Manager Client (Volution)
  • OpenSSL 0.9.6 (openssl)
    and manual pages (openssld)
  • OpenSSH 3.4p1 (openssh)
  • OpenSLP 1.0.6a (openslp)
    and doc (openslpd)
  • Java Developers Kit 1.3.1
    (j2jre131 & j2sdk131)
  • Documentation Set (doc)
       includes: DocView Server (docview)
       Base System Guides (basedoc)
       Base System Manual Pages (baseman)
  • Desktop Management Interface (dmi) 2.0.1
  • Enhanced Event Logging System (eels) 7.1.1
  • Network User License Monitor (nulmon)
  • UDI 1.01 Development Kit (udidk)
  • UDI 1.01 Runtime Environment (udienv)
  • /info files
This is the second CD inserted during a fresh install, and the CD used for an upgrade install. Upgrade installs should be performed using the Upgrade Wizard (see Installation). Individual packages from this CD can also be installed after a fresh install using pkgadd(1M), but it is recommended that all desired packages be selected during the fresh or upgrade installation process. If you add packages after installation, you'll need to reapply the UpdateSet (from the Updates CD).
If you select LKP, then you will be prompted for the OpenLinux CD as well before installing the Optional Services CD.
The /info directory on the CD-ROM contains product release notes, copies of software licenses, and other important information. See /info/readme.htm on the CD.
Optional Services CD #3
  • AFPS 4.0.2 (afps)
  • Merge 5.3.4 (merge)
  • Reliant HA 1.1.3 (ReliantHA)
  • Samba 2.2.4 (samba-2.2.4)
  • Samba 2.2.4 Multibyte Version (sambamb-2.2.4)
  • Cdrtools - record audio/data CDs (cdrtools)
  • Squid Caching Proxy Server 2.4.STABLE6 (squid)
  • /info files
After loading all required software from the Updates CD (and possibly the Linux Distribution CD), a fresh installation will prompt for installation of desired packages from the Optional Services CD. Individual packages from this CD can also be installed after a fresh or upgrade installation is completed, using pkgadd(1M).
The /info directory on the CD-ROM contains English and other language files that provide product release notes, copies of software licenses, and other important information. See /info/readme.htm on the CD.
Linux RPM CD #4
OpenLinux Server 3.1.1 Distribution for use with LKP Inserted during the installation of LKP from the Upgrade CD. Contains all RPMs for LKP. The Release Notes for OpenLinux 3.1.1 can be found at
UnixWare 7 Development Kit CD
  • Development Kit Set (udk)
  • Java Developers Kit 1.3.1
  • Development Kit Documentation (udkdoc)
  • gcc 2.95.3 + patches
  • gdb 5.0 + patches
  • binutils 2.10.1 + patches
  • gmake 3.79.1
  • bison 1.28
  • flex 2.5.4
  • gawk 3.0.6
  • texinfo 4.0
  • automake 1.4 + patches
  • autoconf 2.13 + patches
All packages installed using pkgadd(1M) after UnixWare 7 installation or upgrade. Installing the udk set leads you through the installation of all packages on the CD.
gcc supports C, C++, Fortran, and Objective C; no java front end is provided.
binutils supports gas, nm, strip, demanglers, ranlib, size, objdump; does not provide ld (to avoid confusion with the UnixWare 7 ld).

If your system does not support a bootable CD-ROM, the following 3.5-inch diskettes images are provided on CD #1; these allow you to start the installation from a 3.5-inch diskette drive. See the /info/images/readme.txt file on the Base OS Installation CD (CD #1) for how to transfer the images to diskettes. These diskettes are not necessary if you start a fresh installation by booting your system from CD #1.

© 2002 Caldera International, Inc. All rights reserved.