Differences

This shows you the differences between two versions of the page.

--- sheepshaver_mac_os_x_setup [2012/05/11 03:59]
ronald [Setting up SheepShaver for Mac OS X]
+++ sheepshaver_mac_os_x_setup [2013/05/19 12:57] (current)
ronald_p._regensburg [11 February 2012 and later builds]
@@ Line 1: / Line 1: @@
 ====== Setting up SheepShaver for Mac OS X ======
-(Last updated May 11, 2012)
+(Last updated August 19, 2012)
 (You can also set up [[sheepshaver setup|SheepShaver for Windows]] and [[ubuntu|SheepShaver for Linux]])
@@ Line 10: / Line 10: @@
 This manual is revised for use with the 25-10-2009 and later builds of [[SheepShaver]].
-The 11-02-2012 build is currently the recommended latest build. For description of this build and download links, see [[http://www.emaculation.com/forum/viewtopic.php?f=20&t=7360|this forum topic]].
+The 15-07-2012 build is currently the recommended latest build. For description of this build and download links, see [[http://www.emaculation.com/forum/viewtopic.php?f=20&t=7360|this forum topic]].
 We start with the description of a classic setup with all files together in a folder named "SheepShaver". That folder can be anywhere you like, for instance in your Applications folder or in your Home folder. In this setup, with the needed files together with SheepShaver in the SheepShaver folder, no full paths are required for configuration, just the file names will work. However, files and folders can be renamed and/or moved to different locations, provided you make sure the file names and/or full paths to the files are entered in SheepShaver preferences.
@@ Line 16: / Line 16: @@
 **Note:** Changed settings in preferences will take effect after SheepShaver is quit and launched again. With only a restart in the emulated machine new settings will not be used.
-When you use a SheepShaver build that can run in 64-bit mode in Mac OS X 10.6 (Snow Leopard) or later, you may still prefer to use it in 32-bit mode. See the section [[sheepshaver_mac_os_x_setup#Known issues|Known issues]] in this guide.
+**Mountain Lion issue:** Mountain Lion prevents mounting of physical CD-ROMs in SheepShaver but images created from CD-ROMs still work fine. You can create an image from a CD with Disk Utility. Make sure you choose either "read/write" (.dmg) or "DVD/CD Master" (.cdr) for the format. Compressed and read-only formats will not work. Follow the instructions in Italics for setup with a system install disk image.
 //(This guide describes a setup with installation of the Mac OS using a general retail system install CD. Alternative instructions for using a disk image file of a system install CD are added throughout this guide in italics and between brackets.)//
@@ Line 106: / Line 106: @@
 === 2. Open Preferences from SheepShaver application menu ===
-The preferences settings will be saved in a invisible file .sheepshaver_prefs in your Home folder. The following description assumes that SheepShaver is set up for the first time and that there is no pre-existing ~/.sheepshaver_prefs file.
+Choose Preferences from the SheepShaver menu to open the preferences (Virtual Machine Settings) window.
+(The preferences settings will be saved in a invisible file .sheepshaver_prefs in your Home folder. The following description assumes that SheepShaver is set up for the first time and that there is no pre-existing ~/.sheepshaver_prefs file.)
 === 3. Configure preferences in Setup tab ===
@@ Line 124: / Line 126: @@
 {{ http://www.emaculation.com/sheepshaverosx/prefs1.png }}
-//(If a install CD disk image file is used instead of a real install CD: Use the "Add..." button to find and "Open" the CD disk image file. The file will appear in the Volumes list below the created volume. See also the information above, under "You need a Mac OS install CD", about using a disk image file.)//
+//(If an install CD disk image file is used instead of a real install CD: Use the "Add..." button to find and "Open" the CD disk image file. That image file will appear in the Volumes list below the volume you created. See also the information above, under "You need a Mac OS install CD", about using a disk image file.)//
 **Unix Root**\\
@@ Line 188: / Line 190: @@
 If you use a real install CD, **first insert the CD** and have it mount in Mac OS X.
-//(If you use a install CD disk image instead of a real install CD, make sure the CD image file is locked in the Finder: Check the "Locked" box in Finder "Get Info" for the file.)//
+//(If you use a install CD disk image instead of a real install CD, make sure the CD image file is locked in the Finder: Check the "Locked" box in Finder "Get Info" for the file. Do not mount the image in Mac OS X.)//
 **Launch SheepShaver**. The emulated machine will startup from the install CD //(or from the CD disk image)//.
@@ Line 194: / Line 196: @@
 During startup, the system will encounter the newly created volume and will offer to initialize it. Give the volume an appropriate name (for instance MacOS9HD) and (for Mac OS 8.1 or later) choose Mac OS Extended for the format. Click to proceed with initializing the volume.
-Finally, you will see the desktop with icons for the startup volume (the CD or the CD disk image), the icon for the new volume that you will install the system onto, and the icon for the "Unix" volume that gives access to the shared folder on the Mac OS X side.
+Finally, you will see the desktop with icons for the startup volume (the CD or the CD disk image), for the new volume that you will install the system onto, and for the "Unix" volume that gives access to the shared folder on the Mac OS X side.
-Proceed with the system installation and when the installation is completed, you can quit the installer.
+Proceed with the system installation.
+== ==
+| In some configurations the system installation may stall at the very beginning while "Updating Apple hard disk drivers". It seems to happen especially with some system install CD disk images.\\ \\ Wait at least several minutes to be sure that installation is indeed not proceeding past this stage, then cancel the operation and quit the installer. You may need to force quit SheepShaver as well.\\ \\ Then start again, but in the screen where the actual installation can be started (usually the first screen after the software license agreement), click the "Options..." button and uncheck the option to "Update Apple Hard Disk Drivers". Installation should now proceed normally. |
+=== ===
+When the installation is completed, you can quit the installer.
 //(If you used a install CD disk image file instead of a real install CD: Open SheepShaver Preferences and remove the CD disk image file from the volumes list, select it and click the Remove button.)//
@@ Line 227: / Line 237: @@
 **CD-ROM**\\
-To use a CD-ROM in SheepShaver, insert and mount the CD before launching SheepShaver. SheepShaver will recognize CD-ROMs, no Audio CDs, no DVDs.
+To use a CD-ROM in SheepShaver, insert and mount the CD before launching SheepShaver. SheepShaver will only recognize CD-ROMs, no other disk formats like Audio CDs or DVDs. (OSX 10.8 Mountain Lion prevents mounting CD-ROMs in SheepShaver. Use disk images instead.)
 **Additional volumes**\\
@@ Line 250: / Line 260: @@
 Trashing files from the shared folder should be done at the Mac OS X side. On the Mac OS side, the trash cannot be emptied when it contains files from the "Unix" disk.
+==== Mounting disk images ====
+=== ===
+Most 'Classic' Mac disk images can be mounted in SheepShaver by adding the image file to the Volumes list in Sheepshaver preferences. The next time you start SheepShaver, the volume will appear on the Mac OS desktop.
+Disk images created with Disk Utility in Mac OS X can be mounted the same way, provided the format chosen while creating the image is either "read/write" (.dmg) or "DVD/CD Master" (.cdr). Compressed or read-only formats will not work.
+A system install CD image file must be locked in Mac OS X Finder Get Info because the installer will refuse to work on writeable media. Locking the file is usually not needed for other CD images, but it can be used as a precaution to make sure the content of the image is not changed.
 ==== Printing ====
@@ Line 306: / Line 325: @@
 **On PPC machines**\\
 SheepShaver is extremely CPU hungry on PPC hosts. Do not set refresh rate in SheepShaver preferences higher than 30Hz.
-**In 64-bit mode (on Intel)**\\
-Clipboard integration between host and guest system for text does not work in 64-bit mode. Use SheepShaver in 32-bit mode if you need the clipboard integration.
 **Crash at startup**\\
@@ Line 317: / Line 333: @@
 http://www.xs4all.nl/~ronaldpr/sheepshaverforum/SheepShaverPrefs.zip
-====11 February 2012 build====
+**Mountain Lion**\\
+Mountain Lion prevents mounting of physical CD-ROMs in SheepShaver. Use CD disk images instead.\\
+To create a disk image: \\
+- Mount the CD in OSX \\
+- Start Disk Utility (in the /Applications/Utilities folder))\\
+- Select the CD in the list on the left\\
+- Click New Image in the tool bar\\
+- Choose DVD/CD master for the format\\
+- Click Save\\
+- Use the SheepShaver preferences editor to add the image to the volumes list. Shut down and restart SheepShaver. The CD will show up on the desktop. \\
+Using the Virtual DVD-ROM/CD Utility:\\
+In some cases, when the CD has a special format or when the software insists that the original CD needs to be present, you need to use the Virtual DVD-ROM/CD Utility to get a CD image to mount in SheepShaver.
+http://www.emaculation.com/basilisk/VirtualCD_Imager_v1.0d0.sit
+- Start SheepShaver.\\
+- Install the Virtual DVD-ROM/CD Utility\\
+- Create a new volume with the preferences editor, large enough to hold the contents of the CD image you will create. For one CD image, 800 Mb should be enough. You can create a larger volume to hold more such CD images.\\
+- Shut down and restart SheepShaver. The new disk image will need to be initialized.\\
+- Use the preferences editor to add the CD image you created earlier in OSX (see above) to the volumes list.\\
+- Shut down SheepShaver, and start it again. The CD image will mount as a volume on the MacOS desktop.\\
+- Launch the Virtual DVD-ROM/CD Utility, click the button "Create CD/DVD Toast image", and select the mounted CD volume.\\
+- Save the new image to the large volume you created for this purpose.\\
+- Unmount the first CD volume from MacOS, remove the CD image from the volumes list, save, and shut down SheepShaver.\\
+- Start again SheepShaver and launch the Virtual DVD-ROM/CD Utility, click the button "Mount Toast .ati file as Virtual DVD-ROM" and open the image you created with this utility. This image will now mount in SheepShaver as a CD.\\
+==== 11 February 2012 and later builds ====
 === ===
+**On PPC machines**\\
+These later builds appear to be very unstable on some PPC configurations. The older 25 October 2009 build is generally more stable on PPC:
+http://www.xs4all.nl/~ronaldpr/sheepshaverforum/SheepShaver_UB_20091025.zip
+(That build will present on PPC an "unexpectedly quit" message at launch that can simply be dismissed and ignored.)
 **On Intel machines**\\
 After minimizing or hiding the SheepShaver window and again bringing it back in view, colors in the window will not be displayed correctly. It can be resolved by forcing the emulator to redraw its screen by changing (and changing back) the color depth setting in Monitors control panel or from the color depth control strip tile.
-If you find this issue very disturbing, you can use the older 25 October 2009 build:
+If you find this issue very disturbing and do not need new features in later builds, you can try the older 25 October 2009 build:
 http://www.xs4all.nl/~ronaldpr/sheepshaverforum/SheepShaver_UB_20091025.zip
@@ Line 330: / Line 381: @@
 **In 64-bit mode in Snow Leopard**\\
 Serious cursor problems with clicking in the menu bar in full-screen mode. Use SheepShaver in 32-bit mode if you want to use it full-screen.
-====25 October 2009 build====
-=== ===
-**In Mac OS X 10.7 (Lion)**\\
-Cannot run in full-screen mode in Lion