|
. . . . . . . Skunkware 7 Release Notes |
Distributions are released on CD periodically and a repository of this and previous distributions as well as updates and corrections can always be found at http://www.sco.com/skunkware.
SCO Skunkware is software for entertainment, education, experimentation, and often real work. It is provided for free and is not formally supported by SCO.
To determine the licensing conditions for a particular component, see the corresponding source in the source directory. With the infrequent exception of SCO proprietary code, all Skunkware components are accompanied by the source used to build them. The source is archived in the src subdirectory by category. The categories are:
| Skunkware 7 Software Categories | ||||||||
|---|---|---|---|---|---|---|---|---|
| audio | emulators | libraries | shellutil | fileutil | sysadmin | db | net | |
| textproc | devtools | interp | news | video | editors | lib | shells | www |
| X11 Graphical Categories | ||||||||
| apps | fonts | games | graphics | misc | savers | utils | viewers | winman |
Remember, Skunkware is freely distributed and unsupported software. No warranty is made on any of the Skunkware components. Support and assistance with this software is not provided by SCO. In many cases, however, an e-mail to skunkware@sco.com describing any problem you might have may result in a reply/fix/solution. And ...
"The Santa Cruz Operation, Inc. and SCO Skunkware are not related to, affiliated with or licensed by the famous Lockheed Martin Skunk Works (R), the creator of the F-117 Stealth Fighter, SR-71, U-2, Venturestar(tm), Darkstar(tm), and other pioneering air and spacecraft."
[Note that it is not necessary to mount the Skunkware 7 CD-ROM in order to install the pkgadd installable packages. See the section below on installing the Skunkware 7 software.]
To mount the Skunkware 7 CD-ROM on an SCO UnixWare system, use the command:
# mount -r -f cdfs /dev/cdrom/c1b0t0l0 /<mount-point>
where <mount-point> refers to the full pathname of the directory on
which you wish to mount the CD-ROM (e.g. /mnt).
Note also that the CD-ROM device name may vary from system to system
(the exact name for the cdrom device is usually the only entry in /dev/cdrom).
On an SCO OpenServer Release 5 system issue the command:
# mount -r /dev/cd0 /<mount-point>
Almost all of the files in the Skunwkare 7 distribution will be installed in /usr/local. Unfortunately, in UnixWare 7 the /usr/local directory is on the root filesystem and contains the Netscape Navigator plugins. Therefore, you may wish to move the existing /usr/local hierarchy to a filesystem with sufficient disk space and create a symbolic link from /usr/local. For instance, assuming you had created a /u filesystem with plenty of space:
# mv /usr/local /u/local
# ln -s /u/local /usr/local
To install most of the software available on the CD, you can invoke one of the following as a system owner:
# /<mount-point>/INSTALL
This is the recommended Skunkware 7 installation procedure.
The INSTALL program will detect which platform you are installing on,
(possibly) ask some questions and install all the available packaged files
for that platform. On UnixWare 7 this installation method also installs several
additional UnixWare 2.x packages in /<mount-point>/uw2/Packages,
consuming around 30 MB of additional disk space. UnixWare 7 installs will also
be given the opportunity to update /etc/magic with the augmented /etc/magic
on Skunkware 7 when using this installation method.
# pkgadd -d /<mount-point> [glib tcl802 tk802 all | package_list]
# pkgadd -d /dev/cdrom/c1b0t010 [glib tcl802 tk802 all | package_list]
where /dev/cdrom/c1b0t0l0 is the device node name of your CD-ROM drive
(this may vary from system to system).
The installation of all the Skunkware 7 components requires about 150 MB of free space on the root partition for OpenServer, about 500 MB of free space on the partition used by /usr/local for UnixWare 7 and around 80 MB on UnixWare 2.x.
Further platform-specific installation instructions are available later in these notes:
After completing the installation of the Skunkware 7 components you desire, you may wish to add /usr/local/bin to your PATH and /usr/local/man to your MANPATH. You may also wish to add /usr/local/java to your CLASSPATH. It should not be necessary to add /usr/local/lib to your LD_LIBRARY_PATH as the Skunkware 7 shared libraries have been built with the appropriate flags.
To query the system about installed Skunkware 7 packages, issue the command:
# pkginfo -c skunkware
For an introductory tour, point a web browser at /<mount-point>/index.html
# /usr/bin/X11/netscape file:/<mount-point>/index.html
If you do not have Netscape Navigator installed, download a trial copy from
http://www2.sco.com
or (for OpenServer) install NCSA Mosaic off of this CD:
# custom -p SKUNK97:default:Mosaic -i -z /<mount-point>/osr5/inst
or use any browser that supports tables and open the URL file:/<mount-point>/index.html
(assuming you mounted the CD on /<mount-point>).
If you do not have or want a graphical browser, you can install Lynx 2.7.1 (a character browser) off of this CD (OpenServer only, if you are running UnixWare 7 then Lynx is included by default).
# custom -p SKUNK97:default:Lynx -i -z /<mount-point>/osr5/inst
Then execute the command:
# lynx file:/<mount-point>/index.html
SCO Skunkware 7 contains both files suitable for installation on SCO UnixWare systems with the pkgadd facility, and media images suitable for installation on SCO OpenServer systems with the custom utility, In addition, there are compressed archives of pre-compiled utilities which can be extraced manually. Finally, there are hundreds of source archives (almost everything on the CD is accompanied by the source used to build it).
If you wish to remove the Skunkware 7 components installed with the pkgadd facility, first mount the Skunkware 7 CD-ROM using a command similar to the example above. Then, as a user with owner privileges, issue the command:
# <mount-point>/REMOVE
This will remove all of the Skunkware 7 packages which were installed with
the pkgadd facility. The REMOVE command will occasionally leave remnants of
some packages. In particular, you may need to manually remove
/usr/local/squid and /usr/local/man. Further, the REMOVE command does not
remove the "news" user and "news" group created by the INN installation nor
does it restore the original /etc/magic.
Some sites may wish to make the Skunkware 7 packages available for download via ftp/http. In that case it is convenient to transfer the packages from the CD-ROM to an ftp download area or an httpd document root. It's also nice to provide the packages as a single file rather than in filesystem layout. To assist in this process, i have written a script called UNLOAD. This shell script acts as a front-end to the pkgtrans program and transforms each of the pkgadd installable filesystem format packages on the CD-ROM into pkgadd installable data-stream format packages on the hard disk. To "unload" the Skunkware 7 software, issue the following command as a system owner:
# <mount-point>/UNLOAD
You will be prompted for a location for the data-stream package files
to be placed.
The pkgadd installable files for UnixWare 7 are located in /<mount-point>/<package-name> (in pkgadd Filesystem Format files) on the CD-ROM (where <package-name> indicates the package name).
They are installed into /usr/local and in total consume about 500 MB.
To install an individual package, execute the command:
# pkgadd -d /<mount-point> package_name
where "package_name" is the name of the desired component.
# pkgadd -d /<mount-point>
and select the name of the package to install
For a list of all the pkg installable components see the file /<mount-point>/uw7/CONTENTS.
An interactive graphical installation can be performed by running /usr/X/bin/PackageMgr (with owner permissions):
Select "CD-ROM_1" from the "Install from" Combo Box.
Wait for the Packages to be scanned then select the Packages you want installed and press the install button. Unfortunately, i have not found an easy way to install all of the packages with PackageMgr. To install all of the packages on the Skunkware 7 CD-ROM, either run the INSTALL script or use the pkgadd command:
# pkgadd -d /<mount-point> glib tcl802 tk802 all
Some of the Skunkware 7 components intended for use on UnixWare 7 are not pkgadd installable. Notably, there is an augmented /etc/magic file in /<mount-point>/sco/magic. This augmented /etc/magic contains support for additional file types including Java class files. To install it, back-up your existing /etc/magic and copy the new one in off of the Skunkware CD-ROM:
# cp /etc/magic /etc/magic.00
# cp /<mount-point>/sco/magic /etc/magic
Note that the INSTALL command on Skunkware 7 prompts for the installation
of the augmented /etc/magic.
The "IP Address Alias Manager" administers network addresses for configured IP interfaces - enabling the virtual domains services in both FTP server and mail delivery.
Currently UnixWare 7 does not have a manager to do this and the administrator has to set up the aliases by hand.
Included in the image is a set of HTML pages that are added to SCOhelp at install time. The doc is under Networking -> Administering TCP/IP and Internet services -> Configuring IP Address Aliases.
The package is fully removable and can be installed with the command:
# pkgadd -d /<mount-point> ipalias
The Skunkware 7 CD-ROM contains several "pre-compiled" source archives. These include:
# cd /x/src/www
(this can be anywhere you have write permission and sufficient disk space)
# cd php-2.0b12
# make install
There are several useful scripts in the sco directory. The uw7/x11/winman directory contains some examples of how to configure your X session to use one of the alternate window managers (e.g. AfterStep) as well as examples of how to configure the UnixWare graphical login and session manager to include these alternate window managers. There are several audio files in the audio directory. A script to maintain hypermail archives is in the uw7/mail directory.
The media images for SCO OpenServer are located in /<mount-point>/osr5/inst on the CD-ROM. The packages will be exported to /usr/local and in total consume about 150 MB.
To install an individual package, execute the command:
# custom -p SKUNK97:default:Package -i -z /<mount-point>/osr5/inst
where "Package" is the name of the desired component. See the file
/<mount-point>/osr5/CONTENTS for the list of available components.
An interactive graphical installation can be performed by running /etc/custom as root and choosing to install from "media images". Enter the pathname of the media images (e.g. /<mount-point>/osr5/inst) and choose to do a full install.
If, as root, you are running the X.Desktop, then you can configure your system to mount the SCO Skunkware 7 CD-ROM by double-clicking the System Administration folder -> Filesystems -> Filesystem Manager. Alternatively, at a root shell prompt, type "scoadmin f" to bring up the Filesystem Manager. Next select Mount -> Add Mount Configuration -> Local and enter /dev/cd0 for the device and a mount point. Change the "Can Users Mount" to Yes and uncheck the "At System Startup" mount. After completing this operation, you should be able to mount and unmount the SCO Skunkware 7 CD-ROM by typing "mnt <mount-point> and "umnt <mount-point> as any user.
The Skunkware 7 CD-ROM contains several additional distributions intended for use on SCO OpenServer systems but not yet packaged for installation via the SCO custom facility. To install one of these distributions, it is necessary to extract the archive from / as root as follows:
# cd /
# gzcat /<mount-point>/osr5/path/to/foo-rel-dist.tar.gz | tar xf -
These additional binary distributions include:
The pkgadd installable files for UnixWare 2.x systems are located in /<mount-point>/uw2/Packages/<package-name>.pkg (in pkgadd Data Stream Format files) on the CD-ROM (where <package-name> indicates the package name).
They are installed into /usr/local and in total consume about 80 MB.
To install an individual package, execute the command:
# pkgadd -d /<mount-point>/uw2/Packages/package_name.pkg
where "package_name" is the name of the desired component.
For a list of all the pkg installable components see the file /<mount-point>/uw2/CONTENTS.
The Skunkware 7 CD-ROM contains several "pre-compiled" source archives intended for installation on UnixWare 2.x systems. These include:
On any other system, after mounting or otherwise making the High-Sierra Rockridge CD-ROM filesystem accessible, point your WWW browser to <mount-point>/index.html where <mount-point> indicates the UNIX directory or Windows drive representing the CD-ROM.
In almost all cases, source code is also provided, so you can rebuild for earlier SCO releases or other platforms. Source code is provided in the src directory. In some cases, source code is provided but no compiled binaries. The source distributions are in gzip-compressed tar or cpio format. In order to extract these, use the command:
$ gzcat /<mount-point>/src/<directory>/<package>.tar.gz | tar xf -
or, in the case of a compressed cpio archive:
$ gzcat /<mount-point>/src/<directory>/<package>.cpio.gz | cpio -icdu
Where <directory> refers to the top-level source directory
and <package> is the package name (e.g. gzip-1.2.4).
If you do not have gzcat installed (part of the gzip package), you can install it off of the SCO Skunkware 7 CD via the command:
(UnixWare 7 systems)
# pkgadd -d /<mount-point> gzip
(UnixWare 2.x systems)
# pkgadd -d /<mount-point>/uw2/Packages/gzip.pkg
(OpenServer systems)
# custom -p SKUNK97:default:GZIP -i -z /<mount-point>/osr5/inst
You may also find the SCO Technical Library Supplements to be of interest. These are drawn from the SCO Support Online System, and are accessible via anonymous ftp on the Internet from ftp.sco.com or via web facilities at http://www.sco.com
Default Package Configurations
Many of the Skunkware packages contain configuration files. In order to avoid excessive user interaction during installation and to provide a consistent and well integrated set of configurations, the Skunkware 7 packages have been pre-configured (with the exception of xmcd which will prompt you for your CD-ROM make and model; and inn which may prompt for a "news" user password).
Generally, you will not need to alter the default configurations but you may choose to do so. Some of the package pre-configurations are as follows:
$ xgal -nosound
Known Limitations and Problems
# pkgadd -d /<mount-point> glib
# TMPDIR=/u/tmp
# export TMPDIR
(where /u/tmp represents a location with sufficient disk space).
# cd /usr
# mv local /u/local
# ln -s /u/local local
Where /u/local resides on an additional disk with sufficient space.
# cd /opt/K
# ln -s /u/local local
Where /u/local resides on an additional disk with sufficient space.
# ps -ef | grep X
# kill <pid>
$ xset -fp /usr/local/share/fonts/freefont
$ xset +fp /usr/local/share/fonts/freefont
$ xset fp rehash
The gimp command has been wrappered with a shell script which does this for you.
We are interested in your general comments about this distribution and about development tools in general. Please feel free to e-mail skunkware@sco.com with comments, criticisms and suggestions.
| Ronald Joe Record | SCO | rr@sco.com | |
| Senior Engineer for Free Stuff, Skunkware, technical tools, etc. | |||
| 400 Encinal St. | Santa Cruz, CA 95061 | FAX: 408-427-5417 | Voice: 408-427-7604 |
| Dion L. Johnson II | SCO | dionj@sco.com | |
| Product Manager for Free Stuff, Skunkware, technical tools, etc. | |||
| 400 Encinal St. | Santa Cruz, CA 95061 | FAX: 408-427-5417 | Voice: 408-427-7565 |
Last Updated: Friday Mar 19, 1999 at 13:28:44 PST
© Copyright 1997 The Santa Cruz Operation, Inc. All rights reserved.