|
|
This document provides installation instructions, new feature descriptions, and release notes for Unixware 7.1.3 Update Pack 3. 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).
There are two support "tracks" for UnixWare:
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.
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.
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.
UnixWare Maintenance Packs and Update Packs are available from the UnixWare Supplements Web Page.
Update Pack 3 can be installed only on a Release 7.1.3 system. The system may have any combination of previously issued Maintenance Packs (MP1 and MP2) and Update Packs (UP1 and UP2) installed.
If you have any Maintenance Pack later than MP2 installed, you must remove it using pkgrm(1M) before installing Update Pack 3. 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.
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.
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 3 consists of a single Update Pack Set named uw713up3, 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.
| Package/Set | Description |
|---|---|
| *uw713up3.image Set | The Update Pack 3 Set installs these packages:
|
| adpu320 package | New Adaptec Ultra320 Family PCI SCSI HBA d2.0 |
| adst70 package | Updated Adaptec Ultra160 Family PCI SCSI HBA d3.14 |
| basedoc package | Updated online topics |
| baseman package | Updated manual pages |
| basex package | Updated X11R6 Base X Runtime System |
| *cups package | New Common UNIX Print System (CUPS) Client and Server |
| *cupsdev package | CUPS Development Libraries |
| *cupsdoc package | CUPS Online Guides and Manual Pages |
| foomatic package | Foomatic V3.0.0 -- Printer Filters and PPDs for CUPS |
| glib.image package | New Library of utility functions for Gimp ToolKit 1.2.10 |
| gs package | ESP Ghostscript 7.05.6 PostScript/PDF Interpreter with GNU Ghostscript 6.0 fonts |
| gtk.image package | New Gimp ToolKit 1.2.10 - runtime library for graphical user interfaces to X |
| ide package | Updated Generic IDE/ATAPI Driver |
| iir package | New Intel Integrated Raid (IIR) HBA Driver Package 2.33 |
| j2jre131 package | Updated Java 2 SE 1.3.1_08a Runtime Environment 1.3.1 |
| j2plg131 package | Updated Java 2 SE 1.3.1_08a Java Plug-in (Netscape and Mozilla) |
| j2pls131 package | Updated Java 2 SE 1.3.1_08 Demos and Debug |
| j2sdk131 package | Updated Java 2 SE 1.3.1_08 Software Development Kit |
| jpeg package | New JPEG Image File Compression Library and Utilities |
| libIDL.image package | New Library for creating CORBA Interface Definition Language (IDL) files 0.6.8 |
| libpng package | New PNG (Portable Network Graphic) File Library |
| *mozilla.image package | New Mozilla Internet Browser 1.2.1 |
| mpt package | New LSI Logic Fibre Channel HBA Driver |
| nd package | Updated Network Drivers |
| nics package | Updated Netdriver Infrastructure and Configuration Subsystem |
| openssh package | Updated Secure Shell remote access utility 3.4p1 (OpenSSH) |
| openssl package | Updated Secure Sockets Layer / TLS cryptography toolkit 0.9.7 (OpenSSL) |
| openssld package | Updated OpenSSL Documentation |
| *perl.image package | New Perl Programming Language 5.8.0 |
| qlc2200 package | Updated QLogic PCI Fibre Channel HBA Driver |
| samba package | Updated Samba 2.2.8 - A Windows SMB/CIFS fileserver for UNIX |
| sambamb package | Updated Samba 2.2.8 - A Windows SMB/CIFS fileserver for UNIX (multibyte) |
| tiff package | New TIFF Image File Libraries and Utilities |
| uli package | Upgrade Wizard for Update Packs |
| xdrivers package | Updated Graphics Drivers |
| xserver package | Updated X11R6 X Server |
| zlib package | Updated zlib - General Purpose Data Compression Library 1.1.4 |
Please see the section Known Problems and Workarounds before beginning installation of the Update Pack.
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.
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.
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.
Log into the system as root.
Do one of the following:
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.
# marry -a /var/spool/pkg/uw713up3CDimage.iso /dev/marry/var/spool/pkg/uw713up3CDimage.iso # mount /dev/marry/var/spool/pkg/uw713up3CDimage.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/uw713up3CDimage.iso` # echo $device /dev/marry/var/spool/pkg/uw713up3CDimage.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.
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.
Once the uli package is installed, launch the Upgrade Wizard. Do one of the following:
# uli
# uli -f device
where device is the name of the directory where you mounted the ISO image in Step 2b (/install in the example).
When the Upgrade Wizard starts, a screen displays a message that the Upgrade Wizard will install the Update Pack software. Select Next to continue.
The Upgrade Wizard displays the Software License Agreement. Select Accept to continue.
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.
The Wizard checks the contents of the installation device for the Update Pack. Select Next to continue and begin installing the Update Pack.
The Upgrade Wizard automatically installs the Update Pack Set (see the Update Pack Contents), displaying installation messages in a new window.
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.
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.
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.
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/uw713up3CDimage.iso
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
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.
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:
Log into the system as root.
Do one of the following:
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.
# marry -a /var/spool/pkg/uw713up3CDimage.iso /dev/marry/var/spool/pkg/uw713up3CDimage.iso # mount /dev/marry/var/spool/pkg/uw713up3CDimage.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/uw713up3CDimage.iso` # echo $device /dev/marry/var/spool/pkg/uw713up3CDimage.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.
List the contents of the CD:
# ls -l /install
Install the desired packages using one of these methods:
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/uw713up3.image
Each package image must be installed individually.
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
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
When the system comes back up, you can log in and check the installation as shown in the section 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 uw713up3
PKGINST: uw713up3
NAME: UnixWare 7 Release 7.1.3 Update Pack 3
...
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
You will need to reinstall the Update Pack Set if any of the following situations arise:
You are instructed to do so when installing a package or set. This happens, for example, when one or more files that was updated by the Update Pack is changed in any way by the installation of the new software. Reinstalling the Update Pack is required to ensure the integrity of the software already installed on your system.
One or more files installed by the Update Pack needs to be refreshed for any number of reasons; for example, data corruption caused by faulty hardware or user error.
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/uw713up3.image uw713u3
The example above installs only the uw713u3 package from the Update Pack 3 Set, which resides in this example in the file uw713up3.image under /var/spool/pkg.
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/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/uw713u3/bkup0/update.cpio.Z | cpio -icdumv usr/lib/sendmail
See the file /var/sadm/bkup/uw713up3/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
The Update Pack consists of several packages (see Update Pack Contents), and only the uw713u3 package is removed when you remove the Update Pack Set:
# pkgrm -n uw713up3
If you install the cups package, then the uw713u3 package cannot be removed until you first remove the cups package.
© Copyright 2003 The SCO Group, Inc. All rights reserved.