This document pertains to the NeXTSTEP operating system (versions 3.2 and previous). Apple Computer no longer provides support for these products. This information is provided only as a convenience to our customers who have not yet upgraded their systems, and may not apply to OPENSTEP, WebObjects, or any other product of Apple Enterprise Software.
Q: When I try to upgrade from Release 3.1 to 3.2, the Upgrade.app indicates the post-processing script failed. When I checked the upgrade log, I saw the following lines:
There isn't enough space to install all the languages.
ROOT: Undefined variable.
What's going on? How do I get the upgrade to complete? Is the computer now unusable?
Q: The Upgrade.app indicates the post-processing script failed, but then said the upgrade completed successfully. When I restart the computer, it panics with a "Can't mount root" error. What can I do?
A: This happens when there isn't enough free space on the hard disk being upgraded to install the languages packages. The post-processing script fails due to a bug: the environment variable ROOT isn't assigned before it's referenced. If you are using an Intel based computer, it is unusable if it's restarted; the device driver upgrade isn't complete at this point. If you are using a NeXT computer, English help didn't get installed. However, you can complete the upgrade, and thus make the computer usable.
+Intel users who haven't rebooted,
+NeXT computer users before or after rebooting
To complete the upgrade, type the following as the root user in a Terminal window (this assumes you're using the C-Shell as your login shell; if this isn't the case, adapt the following procedure, or start the C-Shell, /bin/csh).
Note: This procedure assumes that the 3.2 upgrade CD-ROM is mounted on the directory /NEXTSTEP_3.2. If this is not the case, substitute the actual mount point of the 3.2 upgrade CD-ROM for /NEXTSTEP_3.2 throughout the following procedure.
If you have already rebooted, your computer panics with the "Can't mount root" error.
To complete the upgrade at this point, do the following:
1. Insert the 3.1 floppy disk into the floppy disk drive.
2. Start up the computer.
3. At the boot: prompt, type: if you have a SCSI hard drive
fd()mach_kernel -s rootdev=sd0a if you have an IDE hard drive fd()mach_kernel -s rootdev=hd0a
4. At the # prompt, type the following, pressing the Enter key at the end of each line: mount -o remount / if you have a SCSI hard drive mount -o ro /dev/sd1a /NEXTSTEP_3.2 if you have an IDE hard drive mount -o ro /dev/sd0a /NEXTSTEP_3.2
sh /etc/rc.net -h
setenv ROOT /NEXTSTEP_3.2
/NEXTSTEP_3.2/Upgrader.app/Default.upgrade/PostProcess / /NEXTSTEP_3.2
halt 5. Remove the floppy disk.
6. Restart the computer.
Q: When I try to install NEXTSTEP Release 3.2 for Intel Processors onto my computer, the keyboard locks up, and I am unable to complete the installation.
What's going on? How do I get the installation to complete? Is the computer now unusable?
A: There is a known bug which may lock up your keyboard during installation onto systems which do not have integrated PS/2 mouse support. The problem is in the PS/2 mouse driver, and removing the PS/2 mouse driver from your default configuration will work around the problem.
The following entry will prevent the PS/2 mouse driver from being automatically loaded. By default, NEXTSTEP loads the following drivers during installation and when booting config=Default: PS2Keyboard, PS2Mouse, Adaptec1542B, DPT2012, IDE, and Floppy. To remove the PS2Mouse driver from this list, type the following at the boot: prompt:
"Boot Drivers"="PS2Keyboard Adaptec1542B DPT2012 IDE Floppy"
While configuring during the installation process, be certain to remove the instance of the PS2Mouse driver which is automatically added by Configure.
Q:I have a two gigabyte or larger SCSI disk drive on which I'm trying to install NEXTSTEP Release 3.2. Everything seems to go fine until the installation program looks for disks to install on; then it can't find my hard disk drive. What's going on?
A:There is a known bug in the NEXTSTEP Release 3.2 installation process such that it will not recognize a hard disk drive larger than two gigabytes. This bug has been fixed in NEXTSTEP Release 3.3. Under 3.3, hard disks larger than two gigabytes will be automatically partitioned into as many two-gigabyte-or-smaller partitions as necessary. For example, a nine-gigabyte hard disk devoted solely to NEXTSTEP would be partitioned into five partitions, each with a size of approximately 9/5 = 1.8 gigabytes.
Q: Are there any peripherals known to be incompatible with NeXTSTEP versions 3.1 or 3.2?
A:There is a known incompatibility with the firmware found in Seagate IDE drives model numbers ST3550a and ST3588A when used with NEXTSTEP 3.1 and 3.2. This error manifests during installation when a sequence of IDE error messages occur and installation stops. The error "Disk initialization failed" is then reported. A firmware upgrade to fix this problem is available through Seagate. Model ST3550a requires firmware update 9581, and model ST3385a requires firmware update 9588.