UnixWare 7.1.3 Update Pack 4
New Features and Notes

May 2004

This document provides installation instructions, new feature descriptions, and release notes for Unixware 7.1.3 Update Pack 4.

Update Pack 4 is the final Update Pack for UnixWare 7.1.3 and is a non-removable upgrade to UnixWare 7.1.4. In order to receive Update Packs for UnixWare 7.1.4, you will need a new SCO Update License for this new release. To obtain a new license, please contact your software supplier.

Complete UnixWare documentation is available on the Documentation and Support Web Sites. Your UnixWare system serves the online documentation set, including manual pages, on http://hostname:8458 (where hostname is the network name or IP address of the UnixWare system, or localhost when using a browser on the system running DocView).

Contents

Installation Notes
Installation Procedures
Complete New Feature List
Update Pack 4 New Features
Update Pack 3 New Features
Update Pack 2 New Features
Update Pack 1 New Features
Problems Fixed
Known Problems and Workarounds


Installation Notes

About Maintenance Packs and Update Packs
Update Pack System Requirements
Obtaining Update Packs
Licensing Update Packs
Update Pack Contents

About Maintenance Packs and Update Packs

There are two support "tracks" for UnixWare:

Maintenance Packs

A Maintenance Pack (MP) is a collection of fixes for reported problems distributed as a single installable package. Maintenance Packs are made available periodically when such fixes are available, and can be downloaded and installed free of charge. Maintenance Packs are cumulative, so only the latest one needs to be installed. If installed individually, they must be installed in the order they are issued (i.e., MP1, MP2, etc.). A Maintenance Pack typically is accompanied by a single text file with installation instructions and release notes.

It is important to note that a Maintenance Pack cannot be installed onto a system that already has an Update Pack installed. This restriction ensures the integrity of the software installed on your system.

Update Packs

An Update Pack (UP) is a collection of features, enhancements, and problem fixes distributed as a single package or set, plus additional packages, in a CD ISO image. Update Packs are made available quarterly (for a licensing fee) to registered customers of the SCO Update Service. Update Packs are cumulative; you only need to install the current Update Pack to pick up all the features, enhancements, and fixes issued in all previously issued Update Packs and Maintenance Packs. If installed individually, they must be installed in the order they are issued (i.e., UP1, UP2, etc.).

The current UP can be installed on top of any previously issued Maintenance Pack (MP). Each Update Pack comes with full documentation, including installation and release notes (like the document you are reading now), that explain the target system requirements. No MP can be installed on a system that has one or more UPs already installed.

Switching Tracks

If you already have one or more Maintenance Packs installed, you can switch over to the UP track by installing the Update Pack that includes all the Maintenance Packs you have currently installed. For example, if you have Maintenance Pack 2 installed, you can switch over to the UP track by installing Update Pack 2 or later.

If you are an Update Pack customer and want to switch over to the MP track, you must first remove all Update Packs installed on your system (in the reverse order they were installed), and then install the latest Maintenance Pack. For example, if you loaded UP1 and then UP2 onto your system, and want to switch over to the MP track, remove UP2 and then UP1 from the system. Once all the Update Packs are removed, install the currently available Maintenance Pack.

NOTE: Update Pack 4, because it implements changing the system from a 7.1.3 system to a 7.1.4 system, cannot be removed. It is therefore critical that you back up your system before installing Update Pack 4 should you for any reason want to go restore the previously running configuration. See: Before Beginning: Backup Your System.

UnixWare Maintenance Packs and Update Packs are available from the UnixWare Supplements Web Page.

Update Pack System Requirements

Update Pack 4 can be installed only on a Release 7.1.3 system. The system may have any combination of previously issued Maintenance Packs and Update Packs installed.

If you have any Maintenance Pack later than MP3 installed, you must remove it using pkgrm(1M) before installing Update Pack 4. Use the pkginfo(1) command or the scoadmin application installer to check your current software configuration.

Please Note: If you install an Update Pack on a system with one or more Maintenance Packs already installed, do not attempt to remove any of the Maintenance Packs from the system after installing the Update Pack. This will lead to unexpected system behavior.

Most individual packages distributed with Update Packs require the installation of the Update Pack Set in order for the software to work correctly.

Obtaining Update Packs

Update Packs (and Maintenance Packs) are available for download from the UnixWare Supplements Web Page. A registered SCO Update Service license is required to install the Update Pack Set and other licensed packages distributed with the Update Pack CD. Once registered, you can install the Update Pack from the CD ISO image. The ISO image can be written to a CD-ROM using any Windows or Unix CD recording software, such as cdrtools on UnixWare. The ISO image file can also be mounted directly without being written to a CD, as shown in the procedures below. Customers can also receive Update Packs on CD-ROM directly from SCO. For more information, please see your software supplier or go to the SCO Update Ordering Web Page.

Licensing Update Packs

A registered SCO Update Service (SUS) Enabling license is required to install the Update Pack Set and other packages indicated in the section Update Pack Contents. If you attempt to install any of these packages on a system that does not have a registered SUS license, the installation will fail.

To check your current licenses, launch SCOadmin from the graphical desktop and select License Manager, or launch the License Manager from the command line (as root):


scoadmin license

The License Manager's main screen displays the currently installed licenses. One of these should mention the SCO Update Service. If you do have a SCO Update Service license installed, it must also be registered in order to allow you to install the Update Pack Set. If the Registered column for your SCO Update Service license or bundled license does not have a "Yes" or "N/A", you need to register that license before attempting to install the Update Pack Set.

An SUS Enabling license can be purchased as part of your License Edition (e.g., Base, Departmental, Enterprise, etc.), or purchased separately. Contact your software supplier if you do not have an SUS license or go to the SCO Update Ordering Web Page. For registration information, please see the SCO Update Service Registration web site.

The entire process of installing licenses on your system and registering your SCO Update Service license is described in the online documentation under Installation and Licensing>Getting Started Guide>CD Contents, Licensing, Installation Profiles, and Support. The Getting Started Guide is also available in a number of file formats from the UnixWare Doc Web Page.

Update Pack Contents

Update Pack 4 consists of a single Update Pack Set named uw713up4, as well as a number of additional updated packages.

The table below lists the package and set names as they are found on the Update Pack CD ISO image and optional Update Pack CD. Packages on the CD are in datastream format (files ending in .image) and in file system format (a directory with the same name as the package). The Installation Procedures section show you how to install both types of package formats.

The Update Pack Set requires a license; most other packages and sets do not. Those packages and sets that do require a license are indicated in the table below by an asterisk (*) before the package or set name.

Update Pack Contents
Package/SetDescription
*uw713up4.image SetThe Update Pack 4 Set installs these packages:
  • *libc - Updated Runtime C Library
  • *libthread - Updated Runtime Thread Library
  • *update714 - Updates that did not require a package recut
adpu320 packageNew Adaptec Ultra320 Family PCI SCSI HBA d3.0
adst70 packageUpdated Adaptec Ultra160 Family PCI SCSI HBA d3.14
apache packageUpdated Apache Web Server 1.3.29
basex packageUpdated X11R6 Base X Runtime System
*cups/image packageNew Common UNIX Print System (CUPS) Client and Server 1.1.19-01
*cupsdev.image packageNew CUPS Development Libraries 1.1.19
cupsdoc packageNew CUPS Online Guides and Manual Pages 1.1.19
db packageNew Berkeley DB v4.1 library for open source OpenLDAP software suite
foomatic packageNew Foomatic V3.0.0-01 -- Printer Filters and PPDs for CUPS
gimpprint packageNew Printer Drivers and PPD files for CUPS and foomatic 4.2.5
*glib.image packageNew Library of utility functions for Gimp ToolKit 1.2.10
gs packageESP Ghostscript 7.05.6 PostScript/PDF Interpreter with GNU Ghostscript 6.0 fonts
*gtk.image packageNew Gimp ToolKit 1.2.10 - runtime library for graphical user interfaces to X
hpijs packageNew HP Inkjet Printer Driver (hpijs) and PPD Files 1.5
ide packageUpdated Generic IDE/ATAPI Driver
iir packageNew Intel Integrated Raid (IIR) HBA Driver Package 2.33
j2jre131 packageUpdated Java 2 SE 1.3.1_10 Runtime Environment
j2sdk131 packageUpdated Java 2 SE 1.3.1_10 Software Development Kit
j2plg131 packageUpdated Java 2 SE 1.3.1_10 Java Plug-in (Netscape and Mozilla)
j2pls131 packageUpdated Java 2 SE 1.3.1_10 Demos and Debug
*j2jre142.image packageUpdated Java 2 SE 1.4.2_03 Runtime Environment
*j2sdk142.image packageUpdated Java 2 SE 1.4.2_03 Software Development Kit
javaxcomm packageNew Java support for RS-232 serial I/O and IEEE 1284 parallel I/O based on Sun COMM 2.0 and RXTX 1.4-8
jpeg packageNew JPEG Image File Compression Library and Utilities
libIDL.image packageNew Library for creating CORBA Interface Definition Language (IDL) files 0.6.8
libpng packageNew PNG (Portable Network Graphic) File Library 1.2.5
*mozilla.image packageNew Mozilla Internet Browser 1.2.1b
mpt packageNew LSI Logic Fibre Channel HBA Driver 1.3.26
nd packageUpdated Network Drivers
nics packageUpdated Netdriver Infrastructure and Configuration Subsystem
*openldap packageNew Open Source OpenLDAP software suite 2.1.22
openssh packageUpdated Secure Shell remote access utility 3.7.1p2 (OpenSSH)
openssl packageUpdated Secure Sockets Layer / TLS cryptography toolkit 0.9.7c (OpenSSL)
openssld packageUpdated OpenSSL Documentation
*perl.image packageNew Perl Programming Language 5.8.0
pgsql packageNew PostgreSQL Database Management System 7.4.2
ppp.image packageUpdated Point-to-Point Protocol (PPP)
qlc2200 packageUpdated QLogic PCI Fibre Channel HBA Driver 3.12
qlc2300 packageUpdated QLogic PCI Fibre Channel HBA Driver 3.04
samba packageNew Samba 3.0 - A Windows SMB/CIFS fileserver for UNIX
tiff packageNew TIFF Image File Libraries and Utilities 3.5.7
*udienv.image packageUpdated Uniform Driver Interface (UDI) 1.01 Runtime Environment
uli packageUpgrade Wizard for Update Packs
urwfonts packageUpdated (URW)++ Free X11 Fonts 2.0 for Java
*usb.image packageUpdated Universal Serial Bus (USB) 2.0 Drivers
uw7updoc packageUpdated online topics
uw7upman packageUpdated manual pages
xdrivers packageUpdated X11R6 Graphics Drivers, Grafinfo Files and Configuration Scripts
xfonts packageUpdated X11R6 100dpi, 75dpi, Speedo, Type1, and Miscellaneous Fonts
xserver packageUpdated X11R6 X Server, Utilties, Font Server
zlib packageUpdated zlib - General Purpose Data Compression Library 1.2.1


Installation Procedures

Before Beginning: Backup Your System
Installing the Update Pack from CD
Installing Additional Packages after the Update Pack Set
Checking Update Pack Installation
Reinstalling the Update Pack
Recovering Files Overwritten by the Update Pack
Removing the Update Pack

Please see the section Known Problems and Workarounds before beginning installation of the Update Pack.

Before Beginning: Backup Your System

Before you install any software or documentation from the Update Pack, it is important that you back up your system. A current system backup makes it easy to recover any files overwritten during the installation of the Update Pack. While the Update Pack Set does make copies of all the files it updates, not all supplemental packages do so. See Recovering Files Overwritten by the Update Pack (below) and Backup and Restore (in the online documentation) for more information.

NOTE: Update Pack 4, because it implements changing the system from a 7.1.3 system to a 7.1.4 system, cannot be removed. It is therefore critical that you back up your system before installing Update Pack 4 should you for any reason want to go restore the previously running configuration.

Installing Update Packs from CD

The procedure below shows you how to install the Update Pack using the Upgrade Wizard, from either a mounted ISO CD image, or from a CD to which the ISO image has been written.

The instructions below assume you are using the Upgrade Wizard in graphical mode. If uli is executed on the console without X Window or another process running on vt01, the default back-end package installer is the morepkgs interface, where packages are presented in a single vertical list and selected and de-selected via the spacebar rather than Add and Remove buttons. To disable use of the morepkgs interface, the following environment variable can be set before uli is executed:

# ULI_USE_MOREPKGS=NO

# export ULI_USE_MOREPKGS

NOTE: You must install the Update Set before installing most of the other packages available with the Update Pack. This is done automatically by the Upgrade Wizard.

If you are applying the Update Pack to a newly installed or upgraded UnixWare system, be sure to reboot the system after the installation or upgrade is complete and before you apply the Update Pack.

  1. Log into the system as root.

  2. Do one of the following:

    1. If you have a CD with the Update Pack image on it, insert the CD into the primary CD drive and go to the next step.

    2. If you have the CD ISO image, copy the image into any directory that has enough file system space to hold the CD image; we use /var/spool/pkg in these procedures. Then, use the marry(1M) and mount(1M) commands, as in this example, to mount the CD ISO image as a device:
      
      # marry -a /var/spool/pkg/uw713up4CDimage.iso
      
      /dev/marry/var/spool/pkg/uw713up4CDimage.iso
      
      # mount /dev/marry/var/spool/pkg/uw713up4CDimage.iso /install
      
      

      Note that the return value of the marry command is used as the first argument of the mount command. You can also use the series of commands shown in the example below to reduce the amount of retyping required:

      
      # device=`marry -a /var/spool/pkg/uw713up4CDimage.iso`
      
      # echo $device
      
      /dev/marry/var/spool/pkg/uw713up4CDimage.iso
      
      # mount $device /install
      
      

      The first command assigns the return value of the marry command to the environment variable $device. Note that the marry command is enclosed by backquote characters (`) -- not single quotes. (On many keyboards, the backquote character is found on the upper-left side of the keyboard.) The return value can be checked for errors using the echo command as shown.

  3. Install the uli (Upgrade Wizard) package from the CD. Use either the SCOadmin Application Installer from the graphical desktop, or the following command line:

    
    # pkgadd -d device uli
    
    

    where device is cdrom1 if you followed Step 2a; or, /install if you followed Step 2b.

  4. Once the uli package is installed, launch the Upgrade Wizard. Do one of the following:

    1. If you are using a CD in the CD drive (Step 2a), start the Upgrade Wizard by launching SCOadmin from the graphical desktop and selecting Software Management > Upgrade Wizard; or, enter the following at a shell prompt:
      
      # uli
      
      
    2. If you are using a mounted CD ISO image (Step 2b), start the Upgrade Wizard from the command line by entering the following command:
      
      # uli -f device
      
      

      where device is the name of the directory where you mounted the ISO image in Step 2b (/install in the example).

  5. When the Upgrade Wizard starts, a screen displays a message that the Upgrade Wizard will install the Update Pack software. Select Next to continue.

  6. The Upgrade Wizard displays the Software License Agreement. Select Accept to continue.

  7. If you followed Step 4a and used the uli command with no options, skip to the next step.

    Otherwise, if you followed Step 4b and used uli -f, a screen is displayed that lists the primary CD drive and the directory you specified, with the directory selected as the default installation device. Select Next to continue and install from the directory.

  8. The Wizard checks the contents of the installation device for the Update Pack. Select Next to continue and begin installing the Update Pack.

  9. The Upgrade Wizard automatically installs the Update Pack Set (see the Update Pack Contents), displaying installation messages in a new window.

  10. When the Upgrade Wizard finishes installing the Update Pack Set, it displays the Package Selection List, a list of the additional packages on the CD that are not installed automatically by the Update Pack Set. If the Wizard detects previous versions of any of the Update Pack CD packages on your system, the updated version on the CD appears in the Chosen Packages list on the right. Use the Remove button to move packages that you don't want to install from the Chosen Packages list to the Available Packages list. Any packages that remain in the Available Packages list will not be installed.

    NOTE: Some packages on the CD may not be presented in the Package Selection List. This happens when the Upgrade Wizard does not find a previous version of the package on your system. In order to install such a package using the Upgrade Wizard, you need to first install the package from the original UnixWare media used to install the system (along with any prerequisite packages). Or, use pkgadd(1M) to install the package instead.

    After you are done installing software with the Upgrade Wizard, see the section Installing Additional Packages after the Update Pack Set and use pkgadd(1M) instead of the Upgrade Wizard to install the Update Pack version of any package not listed for selection by the Upgrade Wizard. If a package installation fails because a prerequisite package was not found, you will first need to install the prerequisite package from the Update Pack or the original installation media.

    When you are finished choosing packages, select Next to continue.

  11. A summary of your package selections and the space they require on your hard disk is displayed. Select Next to confirm your selections and continue. Select Previous to go back to the previous step and change the Package Selection List.

  12. After you confirm your package selections, the Upgrade Wizard installs the packages you selected. It displays a progress bar as each package is installed. When the Wizard is done, select Finish to exit.

  13. If you followed Step 1a, go to the next step.

    Otherwise, if you followed Step 1b, unmount the CD image and delete the marry device:

    
    # umount /install
    
    # marry -d /dev/marry/var/spool/pkg/uw713up4CDimage.iso
    
    
  14. Reboot your system to rebuild the kernel. From the Desktop, use the SCOadmin Shutdown Manager. From the command line, enter the following:

    
    # shutdown -i6 -g0 -y
    
    
  15. When the system comes back up, you can log in and check the installation as shown in the section Checking Update Pack Installation.

    If you decide that you want to add additional packages from the Update Pack CD, see the section Installing Additional Packages after the Update Pack Set.

Installing Additional Packages after the Update Pack Set

After you have installed the Update Pack Set and rebooted your system, you can use either the Upgrade Wizard or the pkgadd(1M) command to install any packages that you did not select when you installed the Set.

If any desired package cannot be installed because a prerequisite package was not found, install the prerequisite package (either from the Update Pack or the original UnixWare installation media), and then attempt to install the desired package again.

Using the Upgrade Wizard will re-install the Update Set automatically before installing additional packages. Use the pkgadd command if you want to:

To use the Upgrade Wizard, follow the Installation Procedure, omitting Step 3.

To use the pkgadd command:

  1. Log into the system as root.

  2. Do one of the following:

    1. If you have a CD with the Update Pack image on it, insert the CD into the primary CD drive and enter:

      
      # mount /dev/cdrom/cdrom1 /install
      
      

      Go to the next step.

    2. If you have the CD ISO image, copy the image into any directory that has enough file system space to hold the CD image; we use /var/spool/pkg in these procedures. Then, use the marry(1M) and mount(1M) commands, as in this example, to mount the CD ISO image as a device:
      
      # marry -a /var/spool/pkg/uw713up4CDimage.iso
      
      /dev/marry/var/spool/pkg/uw713up4CDimage.iso
      
      # mount /dev/marry/var/spool/pkg/uw713up4CDimage.iso /install
      
      

      Note that the return value of the marry command is used as the first argument of the mount command. You can also use the series of commands shown in the example below to reduce the amount of retyping required:

      
      # device=`marry -a /var/spool/pkg/uw713up4CDimage.iso`
      
      # echo $device
      
      /dev/marry/var/spool/pkg/uw713up4CDimage.iso
      
      # mount $device /install
      
      

      The first command assigns the return value of the marry command to the environment variable $device. Note that the marry command is enclosed by backquote characters (`) -- not single quotes. (On many keyboards, the backquote character is found on the upper-left side of the keyboard.) The return value can be checked for errors using the echo command as shown.

  3. List the contents of the CD:

    
    # ls -l /install
    
    
  4. Install the desired packages using one of these methods:

    1. If the package is in a single file whose name ends in .image, enter:

      
      pkgadd -d /install/name.image
      
      

      where name.image is the name of the file on the CD. For example, the following command installs the Update Pack Set from the mounted CD image:

      
      pkgadd -d /install/uw713up4.image
      
      

      Each package image must be installed individually.

    2. If the package is contained in a directory on the CD, enter:

      
      # pkgadd -d /install package...
      
      

      Replace package with the names of one or more filesystem format packages on the CD. This example installs the nd and nics packages from a mounted ISO image file:

      
      # pkgadd -d /install nd nics
      
      
  5. Shut down the system to rebuild the kernel. From the Desktop, use the SCOadmin Shutdown Manager. From the command line, enter the following:

    
    # shutdown -i6 -g0 -y
    
    
  6. When the system comes back up, you can log in and check the installation as shown in the section Checking Update Pack Installation.

Checking Update Pack Installation

Once installed, use the pkginfo(1) command to confirm that the Update Set has completely installed. The system should respond with output similar to that shown in the example below:


# pkginfo -lc set uw713up4

   PKGINST:  uw713up4

      NAME:  UnixWare 7 Release 7.1.3 Update Pack 4

       ...

    STATUS:  completely installed

If the STATUS field indicates anything other than completely installed, there was some problem during installation of the set. Re-install the set and record any error messages displayed. Then, check the Late News and Support web sites to check for additional installation notes.

To check the installation of other packages, use a command like the following:


pkginfo -l xdrivers j2re142

In addition, if you installed one or more of the Java packages, you can check which version is the default version of Java by entering this command:


java -version

The command will return with the appropriate release, depending on whether /usr/java is linked to /opt/java2-1.3.1 or /opt/java2-1.4.2. For example, to change the default Java from release 1.3.1 to release 1.4.2, enter the following commands, logged in as root:


# rm /usr/java

# ln -s /opt/java2-1.4.2 /usr/java

# rm /usr/java2

# ln -s /opt/java2-1.4.2 /usr/java2

If you update the links as in the example above to switch the active Java release, you should also remove and re-install the javaxcomm package, if it is on your system, so that it runs on the default Java version:


# pkgrm -n javaxcomm

# pkgadd -q -d pathname javaxcomm

Where pathname is the full path to the javaxcomm package.

Reinstalling the Update Pack

You will need to reinstall the Update Pack Set if any of the following situations arise:

Reinstalling the entire Update Pack Set may be necessary, and can be done using the Upgrade Wizard (if you have the Update Pack CD or CD ISO image) or pkgadd (using either the CD ISO image or the Update Pack Set image). To reinstall the entire Update Pack Set, see the section Installing Additional Packages after the Update Pack Set, using the Update Pack CD ISO.

If you want or need to install only a subset of the packages in the Update Pack Set, you can use a pkgadd command line like the following to reduce required installation time:


pkgadd -d /var/spool/pkg/uw713up4.image update714

The example above installs only the update714 package from the Update Pack 4 Set, which resides in this example in the file uw713up4.image under /var/spool/pkg.

Recovering Files Overwritten by the Update Pack

After installation, you may want to recover files that have been overwritten by the Update Pack Set or one of the supplemental packages. For example, if you have a custom version of sendmail(1M) on your system, this will be overwritten by the Update Set. To recover any file overwritten by the Update Set, enter the following command, as root:


# cd /

# zcat /var/sadm/bkup/update714/bkup0/update.cpio.Z | cpio -icdumv pathname

where pathname is the full pathname of the file you want to recover, without the leading slash (/). For example, to recover the /usr/lib/sendmail binary, enter:


# cd /

# zcat /var/sadm/bkup/update714/bkup0/update.cpio.Z | cpio -icdumv usr/lib/sendmail

See the file /var/sadm/bkup/uw713up4/filelist for the contents of the Update Pack Set backup archive (update.cpio.Z).

The supplemental packages provided with the Update Pack generally do not back up the file they install. Check for backup files under /var/sadm/bkup/packagename and /var/sadm/pkg/packagename/save, where packagename is the name of the package. If a package has overwritten a file and not made a backup copy, recover the file from your regular system backup media.

To find out what packages have installed or updated a particular file, enter the following:


# pkgchk -lp pathname

where pathname is the full pathname of the file, as in:


# pkgchk -lp /usr/lib/sendmail

Removing the Update Pack

NOTE: Update Pack 4, because it implements changing the system from a 7.1.3 system to a 7.1.4 system, cannot be removed. It is therefore critical that you back up your system before installing Update Pack 4 should you for any reason want to restore the previously running configuration. See: Before Beginning: Backup Your System.

© Copyright 2004 The SCO Group, Inc. All rights reserved.