Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
sheepshaver_mac_os_x_setup_new [2018/09/16 08:12] – [Version 2.5 build, 11 July 2018] ronald_p._regensburg | sheepshaver_mac_os_x_setup_new [2018/09/19 05:23] (current) – removed ronald_p._regensburg | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Setting up SheepShaver for OSX/macOS on Intel Macs ====== | ||
- | (Last updated September 16, 2018) | ||
- | |||
- | (You can also set up SheepShaver versions [[sheepshaver mac os x setup old|for PPC Mac]], [[sheepshaver setup|for Windows]], [[ubuntu|and for Linux]]) | ||
- | ===== Introduction ===== | ||
- | |||
- | === === | ||
- | |||
- | This manual is revised for use with the **July 2018 and later builds of [[SheepShaver]] for Intel Macs**.\\ | ||
- | For older SheepShaver builds that will run on PPC Macs, see this [[sheepshaver mac os x setup old|older setup guide]]. | ||
- | |||
- | **Download both SheepShaver Folder and SheepShaver application from [[http:// | ||
- | Please read the information on that page, newer information may not yet be included in this manual.** | ||
- | |||
- | **Classic setup:** We start with the description of a classic setup with all files together in a folder named " | ||
- | 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. | ||
- | |||
- | **Changing settings:** After making changes in preferences, | ||
- | |||
- | **CD-ROMs: | ||
- | |||
- | As most users will now use disk image files instead of physical CD-ROMs, this guide will describe a setup with installation of the Mac OS using a disk image file created from a system install CD. | ||
- | |||
- | // | ||
- | |||
- | Please post questions and comments on E-Maculation SheepShaver forum: https:// | ||
- | ===== Setting up SheepShaver ===== | ||
- | ==== You need a Mac OS install CD ==== | ||
- | |||
- | === === | ||
- | |||
- | You will need a compatible Mac OS install CD to be able to install a Mac OS in the SheepShaver emulated machine. Depending on the used ROM file (see below for more info on ROM files), SheepShaver can run System 7.5.3 through Mac OS 9.0.4. SheepShaver cannot run 9.1 or later. | ||
- | |||
- | Only general retail Mac OS install CDs are fully compatible with SheepShaver. A system install CD that was originally provided with a new Mac will only install on that specific model. * | ||
- | |||
- | |||
- | == == | ||
- | |||
- | * You may be able to install in SheepShaver from a model-specific install CD using a special hack and you may be able to use a restore CD by copying the system manually. However, with both procedures, the installed system may or may not work and when it works, it may not be fully functional.\\ | ||
- | See discusion in this forum topic: http:// | ||
- | |||
- | === === | ||
- | |||
- | This guide assumes that you own a suitable retail Mac OS install CD and that you can create a disk image from it.\\ | ||
- | Install CD image files can also be downloaded from various places on the internet. Make sure the image is indeed created from a general retail Mac OS install CD. Any usual disk image file format will do as long as it is not a read-only or compressed format. A retail international English Mac OS 9.0.4 install CD image can be downloaded from the Macintosh Garden site. On that site search for "Mac OS 9.0.4" and on the Mac OS 9.0.4 page look for the file " | ||
- | |||
- | You can create disk images from CD-ROMs using Disk Utility:\\ | ||
- | - Mount the CD in OSX/macOS\\ | ||
- | - Start Disk Utility (in the / | ||
- | - Select the CD volume (not the drive) in the list on the left\\ | ||
- | - Click New Image in the tool bar or in newer Disk Utility versions use New Image from the File menu\\ | ||
- | - Choose DVD/CD master for the format\\ | ||
- | - Save the image file. It will have a .cdr extension. | ||
- | |||
- | ==== The files you need in your SheepShaver folder ==== | ||
- | |||
- | === 1. The SheepShaver application === | ||
- | |||
- | The SheepShaver application and the SheepShaver folder are presented as separate downloads. Drag the SheepShaver application into the SheepShaver folder. | ||
- | |||
- | === 2. A compatible ROM file === | ||
- | |||
- | **SheepShaver will not run without a compatible ROM file. If SheepShaver does not find a compatible ROM file, it will immediately quit on launch.** | ||
- | |||
- | It may be difficult to get hold of a compatible ROM file as distributing bare ROM files violates Apple license agreements. Emaculation.com site policy is still to not offer or link directly to bare ROM files, although Apple seems to have stopped taking action against distribution of ROM files. | ||
- | |||
- | The ROM file from a 9.0.4 system CD will not work with any version of SheepShaver. ROM files from a 8.5 or 8.6 system CD may work with SheepShaver for Windows, but do not work with SheepShaver for OSX/macOS (with a few specific exceptions that are beyond the scope of this manual). | ||
- | |||
- | ROM files that will work with SheepShaver for OSX/macOS are either an "old world" rom image grabbed from an actual hardware PowerMacintosh ROM, or the "new world" rom file extracted from the "Mac OS ROM Update 1.0" using TomeViewer. The "Mac OS ROM Update 1.0" can be downloaded from Apple, but you need to have a working Mac OS system (or Classic in Mac OS X) to run TomeViewer. | ||
- | |||
- | [[http:// | ||
- | [[http:// | ||
- | [[http:// | ||
- | |||
- | **However, to make it easier:** | ||
- | |||
- | You can find compatible ROM files when you search the web for " | ||
- | |||
- | With the old world rom file SheepShaver can run System 7.5.3 through Mac OS 9.0.4, with the new world rom file SheepShaver can run Mac OS 8.5 through 9.0.4. | ||
- | |||
- | If you want to install 8.6 through 9.0.4, best use the new world rom. | ||
- | |||
- | When you have acquired a compatible ROM file, **rename it "Mac OS ROM" | ||
- | |||
- | === 3. A keycodes file === | ||
- | |||
- | The keycodes file is needed with other than US-English QWERTY keyboard layouts. It is not needed (but does no harm either) if only a US-English keyboard will be used. The keycodes file is already present in the downloaded SheepShaver folder. | ||
- | |||
- | |||
- | === 4. The install CD image file === | ||
- | |||
- | If you are going to use an install CD image file for installing the Mac OS in SheepShaver, | ||
- | ==== The shared folder ==== | ||
- | |||
- | === === | ||
- | |||
- | From within SheepShaver you will have access to a folder on the OSX/macOS side. That folder will appear on the SheepShaver desktop as a disk named " | ||
- | |||
- | Before you start configuring SheepShaver, | ||
- | |||
- | **Note:** Although serious bugs that plagued the shared folder feature in early versions of SheepShaver have been solved, we still advise to not use folders like your Documents folder or your Home folder as shared folder and not keep the only existing copy of a file in the shared folder. | ||
- | |||
- | **Note:** Applications cannot run properly from the " | ||
- | See further below in this guide how to use the shared folder / " | ||
- | ==== Configuring SheepShaver ==== | ||
- | |||
- | === === | ||
- | |||
- | When the needed files are in the SheepShaver folder and when you have created a shared folder, you can start configuring SheepShaver. | ||
- | |||
- | === 1. Start SheepShaver === | ||
- | |||
- | SheepShaver is not code signed. The first time you launch SheepShaver you may need to right-click or control-click its icon to open it from the contextual menu. | ||
- | |||
- | If SheepShaver does not find a compatible ROM file, it will immediately quit on launch. | ||
- | |||
- | If a compatible ROM file with the name "Mac OS ROM" or " | ||
- | |||
- | {{ http:// | ||
- | |||
- | **Note:** At this stage you can only hard quit SheepShaver by pressing Control-Escape. | ||
- | |||
- | === 2. Open Preferences from SheepShaver application menu === | ||
- | |||
- | 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 ~/ | ||
- | |||
- | === 3. Configure preferences in Setup tab === | ||
- | |||
- | **ROM File**\\ | ||
- | First add the ROM file name using the " | ||
- | |||
- | {{ : | ||
- | |||
- | **Volumes**\\ | ||
- | You can now proceed with creating the disk image file that will be the virtual hard disk on the emulated Mac. Click the " | ||
- | |||
- | {{ : | ||
- | |||
- | Choose an appropriate name for the image file, for instance MacOS9. (An extension .dsk will be suggested, but no extension is needed.) Choose a size in MB for the volume (for instance 500 or 1000 or 2000) and save the file in the SheepShaver folder. (Creating a large disk image may take a while after the " | ||
- | |||
- | Then, if a Mac OS install CD image file is used, use the " | ||
- | |||
- | {{ : | ||
- | |||
- | **Unix Root**\\ | ||
- | Add the path to your shared folder using the second " | ||
- | |||
- | **Do not keep the default value "/", | ||
- | |||
- | **RAM Size (MB)**\\ | ||
- | Enter a value for the amount of RAM that the virtual Mac will have. For instance 128 or 256 or 512. | ||
- | |||
- | Leave **Boot From** set to " | ||
- | |||
- | Leave **Disable CD-ROM** unchecked. | ||
- | |||
- | === 4. Configure preferences in Audio / Video tab === | ||
- | |||
- | {{ : | ||
- | |||
- | **Video Type**\\ | ||
- | Set Video Type to " | ||
- | (Do not use " | ||
- | |||
- | **Refresh Rate**\\ | ||
- | On fast Intel machines always choose " | ||
- | |||
- | **Width and Height**\\ | ||
- | Set Width and Height for the window to lower values than the width and height of your screen. If you have a large screen, you can enter higher values than the presets in the menu, for instance 1280 x 800. | ||
- | |||
- | Check **Enable QuickDraw Acceleration**. | ||
- | |||
- | The **Audio Settings** can be ignored. | ||
- | |||
- | === 5. Configure preferences in Miscellaneous tab === | ||
- | |||
- | {{ : | ||
- | |||
- | **CPU Options**\\ | ||
- | Check " | ||
- | |||
- | **Mouse/ | ||
- | Check "Use Raw Keycodes" | ||
- | |||
- | "Mouse Wheel Function" | ||
- | |||
- | **Serial/ | ||
- | You can ignore "Modem Port Device" | ||
- | |||
- | For " | ||
- | |||
- | === 6. Save your settings === | ||
- | |||
- | Click " | ||
- | |||
- | === 7. Quit SheepShaver === | ||
- | |||
- | The emulated machine cannot be shut down normally while waiting for a boot disk and SheepShaver cannot be quit with the emulated machine still running. So at this point we use Control-Escape to quit SheepShaver, | ||
- | ==== Booting SheepShaver and installing the system ==== | ||
- | |||
- | === === | ||
- | |||
- | //(If you use a real install CD, **first insert the CD** and have it mount in OSX/ | ||
- | |||
- | Do **not** have your install CD image mounted in OSX/macOS. | ||
- | |||
- | **Launch SheepShaver**. The emulated machine will start up from the install CD image //(or from the install CD)//. | ||
- | |||
- | 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 and 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 image or the CD), for the new volume that you will install the system onto, and for the " | ||
- | |||
- | Proceed with the system installation by starting (double-clicking) the installer "Mac OS Install" | ||
- | |||
- | == == | ||
- | |||
- | | In some configurations the system installation may stall at the very beginning while " | ||
- | |||
- | === === | ||
- | |||
- | When the installation is completed, you can quit the installer. | ||
- | |||
- | Open SheepShaver Preferences and **remove the CD disk image file from the volumes list**, select it and click the Remove button. | ||
- | |||
- | Shut down the emulated machine and quit SheepShaver. | ||
- | |||
- | //(If you used a real install CD, you can now remove it in OSX/ | ||
- | ===== Running Mac OS in SheepShaver ===== | ||
- | ==== First run, setup, basic functions ==== | ||
- | |||
- | === === | ||
- | |||
- | **The Configuration Assistant**\\ | ||
- | When you launch SheepShaver, | ||
- | |||
- | **The Startup Disk control panel is not functional in SheepShaver**\\ | ||
- | SheepShaver will startup from the first bootable volume in the Volumes list, or from a bootable CD if no bootable volume is in the list, or always from a bootable CD when "Boot From" is set to CD-ROM in Preferences. Trying to use the Startup Disk control panel may cause SheepShaver to crash. | ||
- | |||
- | **Enable sound in SheepShaver**\\ | ||
- | In " | ||
- | |||
- | **Enable network access**\\ | ||
- | Set the TCP/IP control panel to Ethernet and DHCP. As soon as you start using IP network access, for instance with a web-browser, | ||
- | |||
- | **QuickTime**\\ | ||
- | The latest version of QuickTime that is compatible with SheepShaver is version 4.1.2. Note that it is not possible to downgrade QuickTime by simply installing an earlier version. If you happened to have installed a later version, you will need to remove all QuickTime related files first. | ||
- | |||
- | QuickTime 4.1.2 can be downloaded here: http:// | ||
- | |||
- | **CD-ROM**\\ | ||
- | You can use a CD-ROM in SheepShaver on MacOSX 10.7 and earlier. SheepShaver will only recognize CD-ROMs, no other disk formats like Audio CDs or DVDs. | ||
- | |||
- | OSX 10.8 and later prevents mounting physical CD-ROMs in SheepShaver. Use disk images instead. | ||
- | |||
- | **Additional volumes**\\ | ||
- | In Preferences you can create additional volumes (disk image files) or add existing compatible disk image files as additional volumes. The next time you start SheepShaver, | ||
- | |||
- | Most ' | ||
- | |||
- | Note that after any change in preferences SheepShaver needs to be quit and launched again. | ||
- | ==== The shared folder / " | ||
- | |||
- | === === | ||
- | |||
- | **Transferring files**\\ | ||
- | As explained above, the shared folder that you created in OSX/macOS will appear on the SheepShaver desktop as a disk (a volume) named “Unix”. Files copied or saved in SheepShaver to the “Unix” disk, will appear in the shared folder on the OSX/macOS side and files placed in the shared folder on the OSX/macOS side will appear in the “Unix” disk in SheepShaver. That way you can use the shared folder and the “Unix” disk to transfer or exchange files in both directions. | ||
- | |||
- | Exchanging files via the shared folder used to be crippled by many bugs. The most serious bugs have been solved but you may still encounter occasional unexpected behaviour while copying folders to and from the “Unix” disk. | ||
- | |||
- | **Applications cannot run properly from the “Unix” disk**\\ | ||
- | If you use the shared folder and “Unix” disk to transfer applications for use in SheepShaver, | ||
- | |||
- | Note that moving files directly from the “Unix” disk onto the SheepShaver desktop, does not copy them to the startup system volume. Those files will still be on the “Unix” disk, in fact inside the folder “Desktop Folder” in the shared folder. If you want to copy files from the " | ||
- | |||
- | **Trashing files**\\ | ||
- | Trashing files from the shared folder should be done at the OSX/macOS side. On the Mac OS side, the trash cannot be emptied when it contains files from the " | ||
- | ==== Printing ==== | ||
- | |||
- | === === | ||
- | |||
- | |||
- | See this guide: [[sheepshaver_basilisk_printing|Printing from SheepShaver and BasiliskII]] | ||
- | ==== AppleTalk ==== | ||
- | |||
- | === === | ||
- | |||
- | See this guide: [[appletalk for sheepshaver|Appletalk for SheepShaver/ | ||
- | ==== Running in full-screen mode ==== | ||
- | |||
- | === === | ||
- | |||
- | SheepShaver can run full-screen. **Using Control-Return, | ||
- | |||
- | While SheepShaver is running full-screen, | ||
- | |||
- | In SheepShaver Preferences, | ||
- | |||
- | **Mission Control and Spaces** | ||
- | The 64-bit 2.5 version SheepShaver builds (Mac OS X 10.7 and later only) will behave much like other applications in full-screen mode. It is compatible with Mission Control and you can easily switch between SheepShaver in full-screen mode and other applications in full-screen mode or the desktop using the swipe gesture that moves between spaces. | ||
- | ===== Virtual machines ===== | ||
- | |||
- | ==== Self-contained virtual machines ==== | ||
- | |||
- | === === | ||
- | SheepShaver for OSX/macOS supports self-contained virtual machines. These virtual machines are packages with all needed files inside. They are portable to any compatible OSX/macOS system. Multiple virtual machines can be created, each with its own settings, and they can coexist with a ' | ||
- | |||
- | Apart from the .sheepvm package creation, the setup is identical to the ' | ||
- | |||
- | **1. A SheepShaver application needs to be present on your machine.** | ||
- | |||
- | **2. In the Finder:**\\ | ||
- | - Create a folder with an appropriate name for the virtual machine you want to set up\\ | ||
- | - Add a compatible ROM file named "Mac OS ROM" (no extension!) to the folder\\ | ||
- | - Add a keycodes file if you use other than US-English QWERTY keyboard layouts\\ | ||
- | - Add an empty file named " | ||
- | - Add a .sheepvm extension to the folder name\\ | ||
- | |||
- | As soon as you add the extension, the folder will change into a package with a SheepShaver icon. I will refer to it as the VM. | ||
- | |||
- | **3. Double-click the VM icon.**\\ | ||
- | SheepShaver will start and you can set up the VM in SheepShaver preferences as you would a ' | ||
- | |||
- | VMs are portable and will work on any compatible OSX/macOS system that has SheepShaver installed. If a SheepShaver.app is added to the VM, it is portable as one single package to machines that do not have SheepShaver installed. * * | ||
- | |||
- | You can add or remove files to/from the VM by opening it in the Finder: Select the VM, right-click (or control-click) on the icon and choose "Show Package Contents" | ||
- | |||
- | == == | ||
- | //* The empty " | ||
- | |||
- | //* * Note that the VM will not necessarily use the SheepShaver application inside. The VM behaves as a SheepShaver document that will be opened with the " | ||
- | === === | ||
- | |||
- | ===== Additional features ===== | ||
- | |||
- | === === | ||
- | |||
- | Some available features are not mentioned elsewhere in this manual: | ||
- | |||
- | **Grabbing mouse cursor toggle**\\ | ||
- | Using Control-F5 will contain the mouse cursor within the SheepShaver window. This may be useful with some games. | ||
- | |||
- | **Hard cursor in window mode** (Version 2.5 build only)\\ | ||
- | The version 2.5 build uses a different way to display the cursor in window mode, it uses the soft cursor that is also used in full-screen mode. If you prefer the hard cursor in window mode, you can add this line to the preferences file (~/ | ||
- | hardcursor true | ||
- | However, with the hard cursor the cursor issues in version 2.4, when switching between window mode and full-screen mode, will also return. (See below under Known Issues.) | ||
- | |||
- | **Changing the hotkey** (Version 2.5 build only)\\ | ||
- | By default, the hotkey used with window/ | ||
- | |||
- | 1: control(default)\\ | ||
- | 2: option\\ | ||
- | 3: control+option\\ | ||
- | 4: command\\ | ||
- | 5: control+command\\ | ||
- | 6: option+command\\ | ||
- | 7: control+option+command | ||
- | |||
- | For instance, you can set the hotkey to Control-Command by adding this line to the preferences file: | ||
- | hotkey 5 | ||
- | ===== Uninstalling SheepShaver ===== | ||
- | |||
- | === === | ||
- | |||
- | To uninstall SheepShaver, | ||
- | |||
- | Then remove the two hidden files from your Home folder. Open Terminal (in Applications/ | ||
- | rm .sheepshaver_prefs | ||
- | rm .sheepshaver_nvram | ||
- | | ||
- | Or use the two scripts that are included in the SheepShaver folder download. | ||
- | |||
- | That's it! | ||
- | =====Known issues===== | ||
- | |||
- | ==== Both July 2018 builds ==== | ||
- | |||
- | === === | ||
- | |||
- | **Crash at startup**\\ | ||
- | On some host machines and/or with some configurations in the installed Mac OS system, SheepShaver will crash during Mac OS startup. In the crash log you will then typically find a line that ends with “SIGSEGV”. | ||
- | |||
- | Most of these crashes can be prevented by checking “Ignore Illegal Memory Accesses” in Miscellaneous tab in SheepShaver preferences as advised in the configuration directions above. When it is impossible to start SheepShaver because of the crash, you can move the startup volume temporarily to a different location. Then you can launch SheepShaver to the screen with blinking question mark and access the Preferences. | ||
- | |||
- | **Bug with the mount image as CD-ROM feature**\\ | ||
- | Unintended behavior when you try to remove/ | ||
- | |||
- | This issue can be avoided by only adding and removing disk images as CD-ROM in the Volumes list in SheepShaver Preferences. (As always: After a change in preferences settings quit SheepShaver and launch it again for the change to take effect.) | ||
- | |||
- | ==== Version 2.4 build, 9 July 2018 ==== | ||
- | |||
- | === === | ||
- | |||
- | **Cursor issues when switching between window mode and full-screen mode**\\ | ||
- | When you switch from window to full-screen mode using Control-Return before you used the mouse cursor in the emulator at least once, you may loose the cursor. One click on the desktop or pressing the control key suffices to bring back the cursor. | ||
- | |||
- | When you switch from full-screen to window mode using Control-Return, | ||
- | ==== Version 2.5 build, 11 July 2018 ==== | ||
- | |||
- | === === | ||
- | |||
- | **CapsLock issue**\\ | ||
- | When SheepShaver is launched while CapsLock is active, typed text will not correctly reflect the CapsLock status. | ||
- | |||
- | One press on the CapsLock key will correct the issue. |