Apple Workgroup Server 95 Read Me

This Read Me file describes the changes made to the Apple Workgroup Server 95 since its original release. You can use the Software Upgrade to upgrade your system either from the original release or from the Tune Up release. This software upgrade includes the following software.

A/UX 3.1
AppleShare Pro 1.1 (installed only when an earlier version of
AppleShare Pro is found on the system)
Apple DocViewer 1.1
Retrospect 2.0Ci


Notes On Installing The Software Upgrade

Installation takes approximately 20 minutes. The installation instructions on the back cover of the Apple Workgroup Server 95 Software Upgrade CD, along with the on-screen messages, will guide you through the installation process. The following notes provide important additional information.

Space Requirements
The software upgrade requires 10 MB of free space on the root (/) volume. To complete the software upgrade process, you temporarily need approximately 20 MB of free space on the / volume. To check the amount of free space available, double-click the icon for the / hard disk. Then, if you aren't already viewing the window by icons, choose By Icon from the View menu. The amount of available space on / is shown in the upper-right corner of the window that displays the contents of /.

Before Installing, Check Your Applications Folder
Before installing the upgrade software, make sure that the following applications reside in the Applications folder on the root (/) volume; succesful upgrading of these applications depends on it: AppleShare Pro Admin, AppleShare Pro File Server, Retrospect, TextEditor, Apple HD SC Setup, and Apple DocViewer

Note that the Applications folder name starts with a leading space: "<space>Applications". If you change the name of the folder that contains the these applications, you must include the leading space at the beginning of the name for the upgrade to install completely.

Prompts for Older Versions
You will be prompted to replace newer versions of the LaserWriter and Chooser files on the root (/) volume with older ones; the older version is actually newer -- the creation dates on these files were incorrect in the original AWS 95 software.

Preferences in A/UX Startup
The upgrade software returns the preferences to their default settings. If you had modified the settings in the Preferences menu in the A/UX Startup application, you'll need to reenter your settings. These preferences determine whether A/UX automatically boots upon startup, the command that the system runs to check the root file system at startup time, whether parity checking is enabled, etc.

User Accounts on the Server
If you have created user account(s) on your server, and given them personal system folders, you must manually update the personal system folder for each user account after installing your system software. To update a personal system folder, log in to the user account and start the AWS 95 Upgrade Installer application. Use the Custom Install option to install the package "AWS 95 A/UX System Folder Upgrade" to the personal system folder for that account. This must be done for each personal system folder on your server.

Size of the A/UX Buffer Cache
If you had previously adjusted the size of the A/UX buffer cache on your server, check that your setting has not been changed by the installation procedure. If it has been changed, you'll need to reenter it.


Re-linking On-line Manuals
After completing the software upgrade, you may need to re-link the on-line manuals in the new DocViewer collection document called "AWS 95 Documentation." To re-link the files, open the collection document in the Documentation folder. Then double-click on one of the on-line manuals. When the "can not be found" dialog box appears, click the Locate button. Locate the DocViewer file, then use the Save command from the File menu to save the collection document. Repeat this procedure for each on-line manual in the collection document.

Network Launch Fix File
You'll notice a file called Network Launch Fix on your AppleShare Pro CD. This file fixes a bug that affects AppleShare client machines of the Macintosh Quadra, Centris, and Performa 470 series of computers (which all have the 040 microprocessor). You don't need to add this file to client machines other than the 040 series, or to your server.

GENERAL NOTES

The upgrade software improves performance in several areas, including a 400 percent increase in the speed of AppleShare Pro over AppleShare 3.0 in certain areas. See the new guide, "Tuning Server Performance and Adding Internal Drives" to learn about measuring and tuning the performance of your Apple Workgroup Server 95.

Software Enhancements
The "config_server" script for preparing the system for database or file and print services. UNIX Library for AppleTalk Printer Access Protocol (PAP) servers. Support for UNIX file systems of 4 GB in size (AppleShare Pro is limited to 2 GB) A version of sendmail that offers more security. The capability to disable the autologin feature by pressing CONTROL-X when the system is about to start the Finder environment.

Hardware Enhancements
Support for automatic mounting and unmounting of removable media SCSI drives from the Finder. The Apple Ethernet NB Twisted-Pair Card. Support for up to five internal hard drives, and for the 2 GB Apple internal drive.

A/UX Buffer Cache Default
The setting of -1 is still the default setting for the server offering file and print services. However, the action triggered by this setting has been changed to prevent the occurrence of paging of virtual memory when AppleShare Pro and Retrospect are run simultaneously.

Don't Install CD-ROM Driver Files
CD-ROM driver files are delivered with Apple CD-ROM drives and with third-party drives. Don't copy these files to your A/UX System Folders; installing these drivers is unnecessary and will prevent your system from starting up the Finder environment.

Apple 2 GB Drive at System Startup
If your server is equipped with an Apple 2 GB hard drive, there is a slight chance that the system software might check for the hard drive before the drive has reached full speed, and as a result, the system might not start up correctly. If this situation arises, no icon for the startup disk will appear. Restart your system; the hard drive will be recognized the second time.

Symbolic Links Changed to Increase Security
To increase system security when AppleShare Pro is running, a change has been made to the behavior of symbolic links when the symbolic link involves files in more than one folder. The change causes the check for access permissions to treat the Macintosh environment as having the level of permissions of "NOBODY". This change affects the Finder and Macintosh applications, only occurs when AppleShare is running, and does not affect the CommandShell application.

Some MacDriver Partitions Incorrectly Recognized
Apple Computer has recently released HD SC Setup Version 7.2.2. This versrion of the disk partitioning application creates a MacDriver partition that is not understood as a valid MacDriver partition by the A/UX version of HD SC Setup. (The A/UX version of HD SC Setup is the version used by the AWS 95.) The partition that creates the problem is called MacDriver and has the partition type "Apple Driver43". The misunderstood partition causes the following behavior when using the HD SC Setup application or using HD SC Setup from within the AWS 95 Installer:

You cannot update the partition; in the main dialog box of HD SC Setup, the Update button is greyed out. You can create a second MacDriver partition; after selecting "Partition...", the dialog boxes allow you to create an additiona MacDriver partition. If you encounter one of these problem MacDriver partitions, remove it and create a new one using the A/UX version of HD SC Setup delivered with the AWS95.

Limit on File System Check Command
When the Apple Workgroup Server 95 starts up, the fsck command is run from the A/UX Startup application. When the fsck command is run from the A/UX Startup application, it cannot check a file system larger than 2 GB. Therefore, limit the size of your root file system to 2,097,151 KB so that the root file system can be checked at system startup. Once A/UX is running, the fsck command can check file systems as large as 4 GB.

Install Driver for the Apple Ethernet NB Twisted-Pair Card

If you are using this new interface card, install the driver on the volume named MacPartition. Installing the file on MacPartition assures that the server will use EtherTalk rather than switching to LocalTalk each time you restart the server.


CORRECTIONS TO MANUAL PAGES
A few commands are incorrect as they appear onscreen in the manual pages. The corrections are as follows.

"newconfig" manual page
If you're adding support to your system for an Ethernet card, these are the modules you need to specify in the "newconfig" command:

ao - Built-in interface for Apple Ethernet.
as - Apple Ethernet NB Card (a half-length card).
ae6 - Apple EtherTalk NB Card ( a full-length card).
ac - Apple Ethernet NB Twisted-Pair Card.

An error appears in the last paragraph of the Descriptions section: "bnet_dr" should be "bnet".

"NETADDRS" manual page
The value of interface_id is as follows:
ao0 - for built-in interface for Apple Ethernet (which is found in the AWS 95)
ae0 through ae5 - for Apple EtherTalk NB Cards
as0 through as5 - for Apple Ethernet NB Cards
ac0 through ac5 - for Apple Ethernet NB Twisted Pair Cards


BUG FIXES

A/UX Kernel
AppleShare Pro servers will now appear correctly in the Chooser on client machines. AWS 95 no longer crashes if NFS clients have more than eight active supplementary groups. The server can recognize the first eight group IDs only. Heavy use of the UNIX file system no longer causes system or process deadlock/panics.

A/UX Macintosh Environment
The Finder now maintains information properly on file systems containing more than 160,000 items. The File Manager allows you to change the case of a filename containing a slash character ('/'). Text files that contain both CR's and LF's are no longer interpreted as UNIX binary files. They are now interpretted as DOS TEXT files. The Finder no longer terminates after rebuilding the desktop. Aliases to UNIX symbolic links resolve to the target file, not the sym-link. You can subscribe to a publisher that has a slash character ('/') in its name.

Retrospect
The Macintosh environment no longer hangs because of loss of communication with a Retrospect Remote client. Scheduled backups now occur at the correct time.

Compatibility With Other Applications
Think C now runs under A/UX. Adobe Photoshop no longer crashes with a disk error when it creates files bigger than the available free space on the volume.

UNIX Utilities
The "catsearchd" utility is now set to "respawn" instead of "once" in "/etc/inittab." fsck The "fsck" utility no longer ignores the -y option when the -p option is also specified. By default, both the "A/UX Startup" application and the A/UX system startup script "/etc/bcheckrc" invoke "fsck" with both of these options.
For Developers
The Printer Access Protocol (PAP) server library is included in the software. The PAP server library is contained in the file "/usr/lib/libpaps.a". For information on the PAP Server Library, see the Tech Notes for the AWS 95. The "popen(3)" subroutine now supports 128 files, the maximum number of files supported by the standard I/O library routines. In the previous release this support was limited to 20 files. Float and double support were fixed in the RPC library routines (libc). When the current directory is a mount-point and a symbolic link is in the same directory, the "getwd(3)" routine returns the target file instead of the symbolic link as it did before.


FILES CHANGED OR ADDED BY THE UPGRADE

Files Changed or Added on the / Volume
Applications/Apple DocViewer/Apple DocViewer
Applications/Apple DocViewer /Apple DocViewer Guide
Applications/Apple DocViewer /Apple DocViewer Guide.idx

Applications/Apple DocViewer /Read Me - DocViewer 1.1
Applications/Apple HD SC Setup
Applications/AppleShare Pro Admin
Applications/AppleShare Pro File Server
Applications/Retrospect/Retrospect Intl A/UX
Applications/Retrospect/Read Me
Applications/Retrospect/Remote WorkStation/Read Me
Applications/Retrospect/Remote WorkStation/Remote
Applications/Retrospect/Remote WorkStation/Workbook
Applications/Retrospect/Remote WorkStation/For 6.0.x/Read Me - 6.0.x
Applications/Retrospect/Remote WorkStation/For Mac Plus/Read Me - MacPlus
Applications/Retrospect/Retrospect Extras A:UX/Retrospect Help
Applications/Retrospect/Retrospect Extras A:UX/Update from 1.3
Applications/TextEditor
bin/cp
bin/cpio
bin/csh
bin/date
bin/df
bin/ls
bin/make
bin/mt
bin/mv
bin/passwd
bin/pstat
bin/remlogin
bin/rm
bin/rmdir
bin/rsh
bin/sh
bin/su
bin/sync
Documentation/AWS 95 Documentation
Documentation/Tuning Server Performance
Documentation/Tuning Server Performance.idx
Documentation/Upgrade ReadMe
etc/bcheckrc
etc/config.d/newunix
etc/catsearchd

etc/disktab
etc/etheraddr
etc/fidd
etc/fs/svfs/restore
etc/fs/svfs/rrestore
etc/fs/ufs/fsck
etc/fs/ufs/dump.bsd
etc/fs/ufs/mkfs
etc/fs/ufs/newfs
etc/fs/ufs/rdump
etc/fs/ufs/restore
etc/fs/ufs/rrestore
etc/fs/ufs/tunefs
etc/fsck
etc/init
etc/install.d/bnet
etc/install.d/boot.d/ac
etc/install.d/boot.d/adsp
etc/install.d/boot.d/ae6
etc/install.d/boot.d/ao
etc/install.d/boot.d/as
etc/install.d/boot.d/at_atp
etc/install.d/boot.d/bnet
etc/install.d/boot.d/ddp
etc/install.d/boot.d/elap
etc/install.d/boot.d/nfs
etc/install.d/boot.d/svfs
etc/install.d/boot.d/tc
etc/install.d/boot.d/toolbox
etc/install.d/boot.d/ufs
etc/install.d/init.d/devscsi
etc/install.d/master.d/ac
etc/install.d/startup.d/ac
etc/install.d/startup.d/ae6
etc/install.d/startup.d/ao
etc/install.d/startup.d/as
etc/macgetty
etc/mount
etc/powerdown
etc/reboot
etc/settimezone
etc/shutdown
etc/telinit
etc/uninstall.d/bnet
etc/RELEASE_ID
lib/libc.a
lib/libc_s.a
lib/libdb.a
lib/libposix.a
lib/libp/libc.a
mac/bin/launch
mac/bin/setfile
mac/lib/Patches/Patch.0178

mac/lib/Patches/Patch.067C
mac/lib/SystemFiles/private/System
mac/lib/SystemFiles/private/Extensions/LaserWriter
mac/lib/SystemFiles/private/Extensions/StyleWriter II
mac/lib/SystemFiles/shared/Apple Menu Items/Chooser
mac/lib/SystemFiles/shared/Control Panels/Memory
mac/lib/SystemFiles/shared/Extensions/AppleIco
mac/lib/SystemFiles/shared/Extensions/AppleIcoTwo
mac/lib/SystemFiles/shared/Extensions/AppleShare
mac/lib/SystemFiles/shared/Extensions/System 7 Tuner
mac/sys/Login System Folder/%Login
mac/sys/Startup System Folder/System
newunix
shlib/libc1_s
usr/bin/rcp
usr/catman/a_man/man1/sendmail.1m.Z
usr/catman/u_man/man3/btree.3.Z
usr/catman/u_man/man3/dbopen.3.Z
usr/catman/u_man/man3/hash.3.Z
usr/catman/u_man/man3/mpool.3.Z
usr/catman/u_man/man3/recno.3.Z
usr/catman/u_man/man4/Autologin.4.Z
usr/etc/rpc.rstatd
usr/etc/config_server
usr/include/compat.h
usr/include/db.h
usr/include/limits.h
usr/include/mpool.h
usr/include/ndbm-db.h
usr/include/string.h
usr/include/at/at_atp.h
usr/include/sys/buf.h
usr/include/sys/cdefs.h

usr/include/sys/gdkernel.h
usr/include/sys/mtio.h
usr/include/sys/nvram.h
usr/include/sys/param.h
usr/include/sys/proc.h
usr/include/sys/scsireq.h
usr/include/sys/ss_scan.h
usr/include/sys/time.h
usr/include/sys/uinter.h
usr/include/sys/user.h
usr/include/sys/vfs.h
usr/lib/libat.a
usr/lib/libpaps.a
usr/lib/sendmail
usr/lib/sendmail.cf
usr/lib/sendmail.st
usr/lib/sendmail.hf
usr/lib/sendmail.conf
usr/lib/sendmail.conf/README
usr/lib/sendmail.conf/cf
usr/lib/sendmail.conf/cf/Makefile
usr/lib/sendmail.conf/cf/aux.mc
usr/lib/sendmail.conf/cf/alpha.mc
usr/lib/sendmail.conf/cf/auspex.mc
usr/lib/sendmail.conf/cf/chez.mc
usr/lib/sendmail.conf/cf/clientproto.mc
usr/lib/sendmail.conf/cf/cogsci.mc
usr/lib/sendmail.conf/cf/cs-exposed.mc
usr/lib/sendmail.conf/cf/cs-hidden.mc
usr/lib/sendmail.conf/cf/hpux-cs-exposed.mc
usr/lib/sendmail.conf/cf/hpux-cs-hidden.mc
usr/lib/sendmail.conf/cf/knecht.mc
usr/lib/sendmail.conf/cf/mail.cs.mc
usr/lib/sendmail.conf/cf/mail.eecs.mc
usr/lib/sendmail.conf/cf/osf1-cs-exposed.mc
usr/lib/sendmail.conf/cf/osf1-cs-hidden.mc

usr/lib/sendmail.conf/cf/python.mc
usr/lib/sendmail.conf/cf/s2k.mc
usr/lib/sendmail.conf/cf/sunos3.5-cs-exposed.mc
usr/lib/sendmail.conf/cf/sunos3.5-cs-hidden.mc
usr/lib/sendmail.conf/cf/tcpproto.mc
usr/lib/sendmail.conf/cf/sunos4.1-cs-exposed.mc
usr/lib/sendmail.conf/cf/sunos4.1-cs-hidden.mc
usr/lib/sendmail.conf/cf/ucbarpa.mc
usr/lib/sendmail.conf/cf/ucbvax.mc
usr/lib/sendmail.conf/cf/udb.mc
usr/lib/sendmail.conf/cf/ultrix4.1-cs-exposed.mc
usr/lib/sendmail.conf/cf/ultrix4.1-cs-hidden.mc
usr/lib/sendmail.conf/cf/uucpproto.mc
usr/lib/sendmail.conf/cf/vangogh.mc
usr/lib/sendmail.conf/cf/obj
usr/lib/sendmail.conf/cf/obj/alpha.cf
usr/lib/sendmail.conf/cf/obj/auspex.cf
usr/lib/sendmail.conf/cf/obj/chez.cf
usr/lib/sendmail.conf/cf/obj/cogsci.cf
usr/lib/sendmail.conf/cf/obj/cs-exposed.cf
usr/lib/sendmail.conf/cf/obj/cs-hidden.cf
usr/lib/sendmail.conf/cf/obj/knecht.cf
usr/lib/sendmail.conf/cf/obj/mail.cs.cf
usr/lib/sendmail.conf/cf/obj/mail.eecs.cf
usr/lib/sendmail.conf/cf/obj/python.cf
usr/lib/sendmail.conf/cf/obj/s2k.cf

usr/lib/sendmail.conf/cf/obj/sunos3.5-cs-exposed.cf
usr/lib/sendmail.conf/cf/obj/sunos3.5-cs-hidden.cf
usr/lib/sendmail.conf/cf/obj/sunos4.1-cs-exposed.cf
usr/lib/sendmail.conf/cf/obj/sunos4.1-cs-hidden.cf
usr/lib/sendmail.conf/cf/obj/tcpproto.cf
usr/lib/sendmail.conf/cf/obj/ucbvax.cf
usr/lib/sendmail.conf/cf/obj/ultrix4.1-cs-exposed.cf
usr/lib/sendmail.conf/cf/obj/ultrix4.1-cs-hidden.cf
usr/lib/sendmail.conf/cf/obj/uucpproto.cf
usr/lib/sendmail.conf/cf/obj/vangogh.cf
usr/lib/sendmail.conf/cf/aux_uucp.mc
usr/lib/sendmail.conf/cf/aux.cf
usr/lib/sendmail.conf/cf/aux_uucp.cf
usr/lib/sendmail.conf/cf/cs-hidden.cf
usr/lib/sendmail.conf/cf/cs-exposed.cf
usr/lib/sendmail.conf/cf/hpux-cs-exposed.cf
usr/lib/sendmail.conf/cf/hpux-cs-hidden.cf
usr/lib/sendmail.conf/cf/sunos3.5-cs-exposed.cf
usr/lib/sendmail.conf/cf/sunos3.5-cs-hidden.cf
usr/lib/sendmail.conf/cf/sunos4.1-cs-exposed.cf
usr/lib/sendmail.conf/cf/chez.cf
usr/lib/sendmail.conf/cf/sunos4.1-cs-hidden.cf
usr/lib/sendmail.conf/cf/ultrix4.1-cs-exposed.cf
usr/lib/sendmail.conf/cf/ultrix4.1-cs-hidden.cf

usr/lib/sendmail.conf/cf/mail.cs.cf
usr/lib/sendmail.conf/cf/mail.eecs.cf
usr/lib/sendmail.conf/cf/ucbvax.cf
usr/lib/sendmail.conf/cf/vangogh.cf
usr/lib/sendmail.conf/cf/knecht.cf
usr/lib/sendmail.conf/cf/cogsci.cf
usr/lib/sendmail.conf/cf/alpha.cf
usr/lib/sendmail.conf/cf/s2k.cf
usr/lib/sendmail.conf/cf/auspex.cf
usr/lib/sendmail.conf/cf/python.cf
usr/lib/sendmail.conf/cf/clientproto.cf
usr/lib/sendmail.conf/cf/tcpproto.cf
usr/lib/sendmail.conf/cf/uucpproto.cf
usr/lib/sendmail.conf/domain
usr/lib/sendmail.conf/domain/Berkeley.m4
usr/lib/sendmail.conf/domain/cs.exposed.m4
usr/lib/sendmail.conf/domain/cs.hidden.m4
usr/lib/sendmail.conf/domain/eecs.hidden.m4
usr/lib/sendmail.conf/domain/s2k.m4
usr/lib/sendmail.conf/domain/apple-aux.m4
usr/lib/sendmail.conf/domain/Apple.m4
usr/lib/sendmail.conf/feature
usr/lib/sendmail.conf/feature/allmasquerade.m4
usr/lib/sendmail.conf/feature/always_add_domain.m4
usr/lib/sendmail.conf/feature/bitdomain.m4
usr/lib/sendmail.conf/feature/domaintable.m4
usr/lib/sendmail.conf/feature/mailertable.m4

usr/lib/sendmail.conf/feature/nocanonify.m4
usr/lib/sendmail.conf/feature/nodns.m4
usr/lib/sendmail.conf/feature/notsticky.m4
usr/lib/sendmail.conf/feature/nouucp.m4
usr/lib/sendmail.conf/feature/nullclient.m4
usr/lib/sendmail.conf/feature/redirect.m4
usr/lib/sendmail.conf/feature/use_cw_file.m4
usr/lib/sendmail.conf/feature/uucpdomain.m4
usr/lib/sendmail.conf/hack
usr/lib/sendmail.conf/hack/cssubdomain.m4
usr/lib/sendmail.conf/m4
usr/lib/sendmail.conf/m4/cf.m4
usr/lib/sendmail.conf/m4/nullrelay.m4
usr/lib/sendmail.conf/m4/proto.m4
usr/lib/sendmail.conf/m4/version.m4
usr/lib/sendmail.conf/mailer
usr/lib/sendmail.conf/mailer/fax.m4
usr/lib/sendmail.conf/mailer/local.m4
usr/lib/sendmail.conf/mailer/smtp.m4
usr/lib/sendmail.conf/mailer/usenet.m4
usr/lib/sendmail.conf/mailer/uucp.m4
usr/lib/sendmail.conf/ostype
usr/lib/sendmail.conf/ostype/aix3.m4
usr/lib/sendmail.conf/ostype/aux.m4
usr/lib/sendmail.conf/ostype/bsd4.3.m4
usr/lib/sendmail.conf/ostype/bsd4.4.m4
usr/lib/sendmail.conf/ostype/hpux.m4
usr/lib/sendmail.conf/ostype/irix.m4

usr/lib/sendmail.conf/ostype/linux.m4
usr/lib/sendmail.conf/ostype/nextstep.m4
usr/lib/sendmail.conf/ostype/osf1.m4
usr/lib/sendmail.conf/ostype/riscos4.5.m4
usr/lib/sendmail.conf/ostype/solaris2.m4
usr/lib/sendmail.conf/ostype/sunos3.5.m4
usr/lib/sendmail.conf/ostype/sunos4.1.m4
usr/lib/sendmail.conf/ostype/svr4.m4
usr/lib/sendmail.conf/ostype/ultrix4.1.m4
usr/lib/sendmail.conf/sh
usr/lib/sendmail.conf/sh/makeinfo.sh
usr/lib/sendmail.conf/siteconfig
usr/lib/sendmail.conf/siteconfig/uucp.cogsci.m4
usr/lib/sendmail.conf/siteconfig/uucp.old.arpa.m4
usr/lib/sendmail.conf/siteconfig/uucp.ucbarpa.m4
usr/lib/sendmail.conf/siteconfig/uucp.ucbvax.m4
usr/spool/ftp/shlib/libc1_s
usr/ucb/mailstats
usr/ucb/mailq
usr/ucb/newaliases
usr/ucb/rdist
usr/ucb/tip

Files Changed or Added in the Active A/UX System Folder
Extensions:LaserWriter
Extensions:StyleWriter II
Apple Menu Items:Chooser
Extensions:File Server Extension
System

Files Changed or Added in MacPartition

A/UX Startup
bin:fsck
bin:ufs:fsck
System Folder:Control Panels:Date & Time
System Folder:Extensions:Hardware System Update
System Folder:System Enabler 040