This page covers a number of questions that I tend to get asked a lot. The first part is of questions that are of a technical nature. These are questions that would come up while using a Rhapsody based OS on a daily basis. I have provided a directory of links to each of those questions and their answers as the answers are more likely to be part of an emergency.

The questions that seem to be asked mostly by those curious about Rhapsody (the only Apple OS released for Intel hardware) are in the second section entitled Miscellaneous FAQs.

Some answers apply only to a limited number of version of Mac OS X Server or Rhapsody. The following is a list of version codes that are going to be posted next to each question/answer.

r5.0 = Rhapsody Developer Release
r5.1 = Rhapsody Developer Release 2
r5.3 = Mac OS X Server 1.0
r5.4 = Mac OS X Server 1.0.1
r5.5 = Mac OS X Server 1.0.2
r5.6 = Mac OS X Server 1.2
I = Intel hardware
P = PowerPC hardware

Q: What is Mac OS X Server 1.x.x? (r5.3, r5.4, r5.5, r.56)
A: Too make a long story short Apple had put together an operating system based on OPENSTEP (the NeXT OS) that could run on Mac hardware and looked like the Mac OS, it even had a Mac OS environment to run Mac apps. This OS (called Rhapsody) wasn't what the developers had thought they were going to get (something they could move their apps to easily). Not wanting to waste a wonderful OS while they developed Carbon (the environment that would make moving to this new OS easy), Apple made Rhapsody (the project had now change to the Mac OS X name) into a server platform and released it as Mac OS X Server. Over the past couple years there have been version updates. The current version of Server based on Mac OS X v. 10.x.x (and is known as Mac OS X Server 10.x.x).

The original version supported web serving, streaming QuickTime, and some Apple File Sharing (though not to the point that Apple had given up on AppleShare IP, version 6.3.3 was finally replaced with Mac OS X Server 10.0.3), and is based on most of the same technologies that Mac OS X has (except the Carbon support).
That is the short version (the long one is more interesting though).

Q: What is Rhapsody? (r.5.0, r5.1, r5.3, r5.4, r5.5, r.5.6)
A: There is a big question. Rhapsody is the name given to the fifth version of the OS originally called NeXTstep (similar to how the name changed for the fourth version to OPENSTEP). Beyond that, this was the first implamentation done completely by Apple Computer after acquiring NeXT Software.

Most people think of Rhapsody as being only the Developer Releases (1 & 2), but those are actually just the first of many that followed. Rhapsody Developer Release was actually Rhapsody 5.0 and Rhapsody Developer Release 2 was Rhapsody 5.1. Apple had planned a public release as a workstation operating system but at the last minute that version, Rhapsody 5.2, was pulled. I don't think that any copies of 5.2 actually made it off of Apple's campus.

Fortunately that is not the end of Rhapsody. Apple started a new project called Mac OS X which would use the technology of Rhapsody to form a new OS (free of the license restrictions that had been following the NEXTSTEP/OPENSTEP/Rhapsody for years). Apple still wanted to use what they already had, so they released Rhapsody with a suite of server apps and renamed it Mac OS X Server 1.0 (which was actually Rhapsody 5.3). Installing this OS without the added server software produces what would have been the workstation version. This was actually done by quite a few web developers who wanted to do WebObjects development on a Mac instead of a Windows NT PC.

Apple released two free updates for Mac OS X Server, 1.0.1 and 1.0.2 (Rhapsody 5.4 and 5.5 respectively), and one major non-free upgrade to 1.2 (Rhapsody 5.6) before ending production of the line.

Q: Where can I find references for Mac OS X Server/Rhapsody? (r.5.0, r5.1, r5.3, r5.4, r5.5, r.5.6)
A: At apple you can do a search in TIL under "Mac OS X Server" and get a ton of good info, and Mac OS X Server comes with a very good online help. Apple used to have the installation and tutorial pdf manuals, but I've heard that they are no longer on the site. Stepwise (www.stepwise.com) has a great archive of articles on Server (do a search under Mac OS X Server and Rhapsody DR2), including their "Mac OS X Server - First Look" article (http://www.stepwise.com/Articles/FirstImpressions/MacOSXServerIntro/index.html). A very good overall book for beginners would be "Mac OS X Server Administrator's Guide" by Russell and Welch. I've lone my copy to many new Mac OS X Server admins.
You also have a very good resource in the Mac OS X Server community. Both this page and the ones at the Omni Group site (www.omnigroup.com) are great places to find the answers to questions.

Q: What types of systems can run Rhapsody/Mac OS X Server 1.x.x? (r.5.0-P, r.5.0-I, r.5.1-P, r5.1-I, r5.3, r5.4, r5.5, r.5.6)
A: Originally Apple planned on having Rhapsody run of PPC604 based PCI Macs and the same types of PCs that would run OPENSTEP.

The PC version was pulled at the same time as Rhapsody 5.2 (I think it is safe to say that there was must likely a PC version of 5.2). You can find a copy of the list of supported hardware here.

The Mac version had some additional abilities thanks to the design team. Many team members wanted to be able to run their OS on their PowerBooks, so they added support for PPC603 series processors and PowerBook video drivers.

PowerBook set-ups that I know work...

Rhapsody 5.1- PowerBook 3400, 2400, original PowerBook G3 (requires cache enabler to use the G3 processor correctly)
Rhapsody 5.3, 5.4, 5.5- PowerBook 3400, 2400, original PowerBook G3, PowerBook G3 (Wallstreet, Lombard)
Rhapsody 5.6- PowerBook G3 (Wallstreet, Lombard)

I personally wouldn't want to use Rhapsody on the PowerBook 3400, 2400 or original PowerBook G3 because they only had 800x600 displays. I have Rhapsody 5.1 running on an IBM ThinkPad 760ED because it had a 1024x768 display (at 12.1"), and I ran Rhapsody 5.6 on my PowerBook G3 (Wallstreet) which also displayed 1024x768 (at 14.1").

Q: How do I get a copy? (r.5.0, r5.1, r5.3, r5.4, r5.5, r.5.6)
A: I, personally, don't recommend getting copies of any software without acquiring the actual media with them (that is, I don't approve of pulling copies of commercial software off warez servers for free). Given that, ebay seems to be the best place. Remembering that Rhapsody includes the original versions of Mac OS X Server 1.x.x, I think you'll find copies can be found for as low as $35. And on the odd occasion the Developer Releases turn up (which included the only PC versions released into the wild).

If you are looking for a historical version, the first Developer Release (5.0) is a good choice as it is very different from anything that came before or after it. If you are looking for a functional OS that you can work in, the second Developer Release (5.1) and later would be the best version to stick with. If you want a good working version and only have a PC to work with, 5.1 is pretty much your only choice (but be ready to see a ton of cool software that only runs on the PowerPC version).

Q: What version do I have? (r.5.0, r5.1, r5.3, r5.4, r5.5, r.5.6)
A: If you have Rhapsody or Mac OS X Server installed on a system, you can find out what version of Rhapsody it is by opening the terminal and entering
uname -a. The results should give you the version number (5.x) of your OS.

The versions are:

Rhapsody 5.0: Rhapsody Developer Release
Rhapsody 5.1: Rhapsody Developer Release 2
Rhapsody 5.2: -not released-
Rhapsody 5.3: Mac OS X Server 1.0
Rhapsody 5.4: Mac OS X Server 1.0.1
Rhapsody 5.5: Mac OS X Server 1.0.2
Rhapsody 5.6: Mac OS X Server 1.2


Q: Where can I share ideas with other developers about Rhapsody? (r.5.0, r5.1, r5.3, r5.4, r5.5, r.5.6)
A: Actually the best place was the Omni Group mailing list. They still have archives of the correspondents during that period for those who want to read up on things.

Q: How do I install packages? Where is the Installer.app? (r.5.0, r5.1)
A: Yes, it looks like Apple forgot something when making the early versions of Rhapsody. Actually they were on the road to the much debated transition from tar to pax within their packages. So they held off on making an actual installer app for Rhapsody until the final release to the public.

To install packages in the in the early versions you need to run the terminal script installer.sh. An example of how it should look when installing something (the directory OmniFrameworks.pkg is on the root level of my home directory in this example):

installer.sh ~/OmniFrameworks.pkg

I would like to thank Andrew Stone at Stone Design for helping me with this problem.

Note: this was removed from Mac OS X Server in version 1.2.

Q: How do I install fonts? What fonts do I use? (r.5.0, r5.1, r5.3, r5.4, r5.5, r.5.6)
A: Rhapsody can use most (though not all) NEXTSTEP/OPENSTEP fonts. The installation of them requires them to be in either
/Local/Library/Fonts (for all users to have access) or ~/Library/Fonts (for only a single user). These directories may need to be created.

Gather together the fonts you want and put them in the font directory that reflects the access you wish people to have to them. Then open up a terminal and enter the following:

buildafmdir ~/Library/Fonts

or

buildafmdir /Local/Library/Fonts

Then log out and log back in again. You should be able to access the fonts now (if they worked, not all are compatible with Rhapsody).

Q: I've down loaded programs off the internet with ".tar" and ".tar.gz" on the end, how do you work with these? (r.5.0, r5.1, r5.3, r5.4, r5.5, r.5.6)
A: You can decompress the gzipped items (the ones with .gz at the end) by using the terminal.app and entering "
gzip -d", space, and the location of the file. For the TAR files (the ones with .tar on the end) you can one them with the terminal.app by entering "tar xvf", space, and the location of the file (it should put the openned file in your home directory). If you only want to do that once, get OpenUp from StepWise (www.stepwise.com), it can open most types of file compression.

Q: I made some printer ques, both lpd and appletalk but non of them shows up in the chooser/laserwriter. Whats wrong? And the testpage wont print out, seems not to find the printer at all. (r5.3, r5.4, r5.5, r.5.6)
A: The first thing to double check would be that remomte printing is turned on (I don't think it is by default). Go to the Apple Menu, computer settings and then network, and then select services tab. If that checks out, you may want to make sure that your using the correct ppd for your printer. Under Apple Menu, printmanager (I believe that is where it is on the default Apple menu, I moved mine) select edit, then select type/ppd (you can change the size of the window if it is to small).

You can find the spool directory in /var/spool/output/ (you'll need to change to expert mode to see this directory) and should have the name you gave the printer.

Q: Can a Mac OSX Server mirror hard drives like Windows NT? (r5.3, r5.4, r5.5, r.5.6)
A: It sounds like you are asking about software RAID (Redundant Array of Inexpensive Disks) support. No, as of the currently shipping version, Mac OS X Server does not include RAID software. It should be noted that in 1997 it was high on the list of things Apple wanted in their software (right behind symmetric multi-processing), so it should be on it's way soon. According to Apple, Mac OS X Server is compatible with a number of Ultra2 SCSI-based RAID devices, including those from MicroNet.

Q: The default Blue Box image is way, way to small to be useful. How do you fix this? (r5.3, r5.4, r5.5, r.5.6)
A: After Blue Box has been run the first time for any given user, a unique copy of the disk image that Blue Box uses is installed at

/Local/Library/MacOS/Users/dshaw/StartupDisk.img

(where the user in this case is dshaw). You need to copy this over to a Mac running at least Mac OS 8.5 (though 8.1 may work) and use Disk Copy to Convert image... to what ever size you want (up to 2 GB, which was the size I made mine). Copy the new image back to where the original was (making sure that it is named StartupDisk.img) and then fire up Blue Box with your new and improved disk image.

Note: this should really all be done as the user whose disk image is be modified as the permissions are an important factor in this.

Q: Why can't Blue Box see the HFS volumes/partitions on my system? (r5.3, r5.4, r5.5, r.5.6)
A: In order to make sure that both Yellow Box and Blue Box can see all HFS volumes at the same time, you need to run Blue Volume Mount Options.

First start up Blue Box. In the Blue Box disk image under Apple Extras you'll see an app called Blue Volume Mount Options, open it up. You should have a list of the volumes/partitions on your system, click the radio button under Shared next to the volumes/partitions you want to have shared between Yellow Box and Blue Box and then quit out of the app. Shutdown Blue Box and then start it up again, and all the shared HFS volumes should appear on your desktop.

Q: The Infamous Desktop DB problem. Is there a fix? (r5.3, r5.4, r5.5, r.5.6)
A: Yes, all is not well in paradise. Rhapsody does have it's share of problems and because Apple wasn't planning on using it that long (it lasted longer than they planned by almost two years) they didn't think this one needed a fix.

The problem: Blue Box losses the ability to be shared over a network (via Appleshare/Appleshare IP). Cause: the Desktop DB of any of the HFS volumes on the system have become corrupted. Solution: complete removal of the Desktop DB file from all HFS volumes (including the disk image where Mac OS 8.5/8.5.1/8.6 is installed).

The real HFS volumes aren't really a problem, you just go in and remove them with Blue Box turned off and when Blue Box is started again it'll make new ones.

No, you can not rebuild the desktop in Blue Box to fix this problem, the file itself must be remade from scratch. The best method that I know of (that is the one I used) was to use ResEdit while in Blue Box to make the Desktop DB file visible and moved it to the trash. Restarting Blue Box lets the system create a totally new Desktop DB file.

Q: Can I upgrade/update the Mac OS in Blue Box? (r5.1, r5.3, r5.4, r5.5, r.5.6)
A: Yes, to a point. If you are using Rhapsody 5.1 (Rhapsody Developer Release 2), Blue Box must stay at Mac OS 8.1 (as far as I know). If you are running Rhapsody 5.3 - 5.6, you can update 8.5 to either 8.5.1 (recommended if you are currently using 8.5) or 8.6 (recommended for Mac apps that require Carbon libraries). You can not go beyond 8.6 in Blue Box.

Q: Why is my display having problems going from Yellow Box to Blue Box and back again? (r5.1, r5.3, r5.4, r5.5, r.5.6)
A: Blue Box takes over the system when in use, including the display settings. The best way to make sure that Yellow Box and Blue Box play nicely together is to make sure that the display settings are the same in both environments. On my PowerBook I made sure that both Yellow Box and Blue Box were displaying in thousands of colors so the display wouldn't need to change when I was switching between apps in the two environments.

Q: Networking Blue Box. (r5.1, r5.3, r5.4, r5.5, r.5.6)
A: I always made sure that Blue Box looked like it's own computer on the network (pretty much because that was what it was). My PowerBook is named Milnor, Blue Box on my PowerBook was called Milnor-Blue Box. The IP address for my PowerBook would usually be x.x.x.53, the IP address for Blue Box would be x.x.x.54. This was actually helpful as I could reach things on my UFS volume via Fetch (an FTP client) while working in Blue Box (other wise I would have to move items to and from an HFS volume that they could both see, which also worked and was how I usually worked with files in both Yellow Box and Blue Box apps).

Q: Blue Box is frozen, what are the proper commands to get out of this? (r5.3, r5.4, r5.5, r.5.6)
A: You could try Command(Apple)-Shift-q, that should kill the MacOS.app. Or you could also try Command(Apple)-enter, this gets you out of the MacOS.app, and then you could kill it from process manager. Additionally you could also install MacsBug in the MacOS.app and use it to get out of the offending app without losing you work in other apps run in that environment.

Q: Where is the make program in Mac OS X Server. Is there a place to get it from? (r5.3, r5.4, r5.5, r.56)
A: Make is part of the developers tools that you'll find on the Web Objects CD (You'll have to install those tools from that CD).You should be able to run make from the Terminal.app (you may need to su root). Info on make can be found in
/System/Documentation/ManPages/man1/make.1 (at least that is where it is on my system).

Q: What are the memory requirements for a computer running Rhapsody? (r.5.0, r5.1, r5.3, r5.4, r5.5, r.5.6)
A: The suggested minimum of 32 MB of RAM, 48 MB for development or other high-demand applications in 5.0 and 5.1 are actually workable. 5.0 systems seem to be able to take 512 MB while 5.1 systems are limited to no more than 192 MB of RAM (with reports of 224 MB). Systems running 5.3 to 5.5 max out until 1 GB while 5.6 system top out at 1.5 GB (I was running with 512 MB in my PowerBook G3 while using Rhapsody 5.6). Those systems really should be run with a minimum of 64 MB of RAM, 128 MB of RAM if you plan on using Blue Box extensively.

Miscellaneous FAQs

This section is for questions that fall into the trivia about Rhapsody and don't play a major role in the operational usage of Mac OS X Server/Rhapsody.

Q: So how stable is it?
A: I personally haven't had any problems with any of the versions that I have used. To give you an idea, the only time my current desktop installation ever gets restarted is after a power failure...

When was my last power outage? Lets see:

Riemann> uname -a
Rhapsody Riemann 5.1 Rhapsody Operating System Release 5.1: Fri Apr 17 13:07:52 PDT 1998; root(rcbuilder): Objects/kernel-105.6.obj~2/RELEASE_I386 Copyright (c) 1988-1995,1997 Apple Computer, Inc. All Rights Reserved.  i386
Riemann> uptime
9:47AM  up 111 days, 17:14, 2 users, load averages: 2.58, 2.70, 2.62
Riemann>


To say that it is stable doesn't actually reflect just how stable it is. It is the most stable daily use OS that I have ever worked with (which includes the Mac OS, Mac OS X, SGI Irix, Windows 9x and NT, OPENSTEP and NEXTSTEP).

Q: Will any Mac OS technologies be ported to the Yellow Box for Rhapsody? If so, will these be made available on other platforms that OPENSTEP runs on?
A: To my knowledge the one thing that Apple ported over to Yellow Box from the Mac OS was Quicktime. The display engine in Rhapsody is the same as in OPENSTEP and NEXTSTEP (Adobe's very expensive Display Postscript).
 
Q: Are the current built-in services in NextStep/OpenStep (spelling checker, graphics conversion library, etc.) going to remain in Rhapsody?
A: Services are fully functional in Rhapsody.
 
Q: Will Rhapsody applications run on existing versions of OPENSTEP?
A:
Rhapsody 5.0 for Intel can run some unaltered OPENSTEP for Mach apps, but beyond that the code needs to be modified to reflect the changes in Yellow Box from the original OpenStep APIs.

I have heard that Yellow Box for Windows also has had some luck with OpenStep for Windows apps.
 
Q: Will existing 68K and PowerPC applications run on Rhapsody?
A:
In Rhapsody 5.0, no. This version didn't come with Blue Box. Rhapsody 5.1 and later versions for PowerPC had Blue Box, but the Intel versions did not.
 
Q: When will Rhapsody first deliver SMP?
A:
No version of Rhapsody was written to use multiprocessing.
 
Q: What will be Rhapsody's primary volume format?
A:
Rhapsody (5.3 on) does support a wide variety of volume formats, including HFS, HFS+, UFS, and popular network and CD-ROM formats. But Rhapsody's primary format (the only type it can be installed on) is a proprietary form of UFS.

Q: How does Rhapsody handle case sensitivity in file names?
A:
Rhapsody is as case sensitive as OPENSTEP.
 
Q: Will resource forks be supported?
A:
Resource forks are not supported (seen) by the OS in Rhapsody. Even though later version of Rhapsody could see HFS volumes, it ignored the resource information.
 
Q: Will hard drive partitioning be supported?
A:
Not for 5.0 and 5.1, yes for later versions.
 
Q: Will Mac OS applications in the Blue Box be able to recognize that VM is turned on?
A
: Memory management is completely controlled by the Core OS. In Blue Box the system believes that it has as much physical memory as the Core OS has access to. This was a very nice setup for Blue Box apps and made running them seem (in my opinion) far better than running in the standard Mac OS.

Q: Does the Blue Box use the Macintosh ROM?
A:
Actually the ROM file sits next to the Blue Box disk image in the directory
/Local/Library/MacOS/Users/username/. It is loaded before the image is mounted from what I can tell.

Q: What will be the performance of existing applications in the Blue Box?
A:
They seem as fast as if they were running in the Mac OS on the same system (only with better memory management).
 
Q: What imaging model will Rhapsody use?
A
: Adobe's Display Postscript. Apple would later make Quartz for Mac OS X that would replace Display Postscript with their own Display PDF so they would no longer have to pay Adobe a license fee with every copy of the OS.

Q: Is the OpenStep Dock going to be available in Rhapsody?
A:
It is actually still there in 5.0 as I recall. In 5.1 and later it has been replace with the Applications Menu (but you can get it back using Fiend). Also you have the option to use the minimize to tile for windows like in NEXTSTEP/OPENSTEP instead of window shade.
 
Q: Are my windows and dialogs going to look and act the same under Rhapsody?
A:
The theme in both Rhapsody and Mac OS 8 (and later) came from the design that Apple had been working on for Copland.

Q: File types and creators are an important part of the Mac OS experience. Will these work in Rhapsody, or will we be forced to use filename extensions?
A:
All files require extensions to be recognized by the system.
 
Q: What will the installer be like in Rhapsody?
A:
Installer? What installer? (re: Rhapsody 5.0/5.1)

Later versions work like the OPENSTEP installer only using pax instead of tar for the items inside the packages.
 
Q: What will Java applets look like when they run on Rhapsody?
A:
Java is one of the primary languages in Rhapsody/Yellow Box. The version of TextEdit that comes with very version from 5.1 on is actually written in Java. On the down side, it is actually a little slow. Most people who use TextEdit for their work actually use a Objective C version that some people over at StepWise put together (much faster).
 
Q: Will there be an Apple menu in Rhapsody?
A:
Yes, and in later versions you get the AppleMenuOptions.app to help configure the menu yourself. Apple did release a version that works on both the PowerPC and Intel versions of Rhapsody 5.1
 
Q: Will Rhapsody have Setup Assistants?
A:
Yes, and it looks like the Mac OS version.
 
Q: What about fonts? Are they going to be shared between the Yellow Box and the Mac OS compatibility environment?
A:
No, to each their own.
 
Q: Can we copy and paste between Rhapsody and the Mac OS compatibility environment?
A:
 Yes... limited though.