Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
sheepshaver_setup [2015/12/21 06:07] – [64-bit Windows compatibility] clockwise | sheepshaver_setup [2023/04/30 08:41] (current) – [Setting up SheepShaver for Windows] ronald_p._regensburg | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Setting up SheepShaver for Windows ====== | ====== Setting up SheepShaver for Windows ====== | ||
- | (Last updated | + | (Last updated |
- | (you can also [[sheepshaver_mac_os_x_setup|set up SheepShaver | + | SheepShaver |
- | ===== Introduction ===== | + | (you can also [[sheepshaver_mac_os_x_setup|set |
- | SheepShaver emulates a PPC Macintosh computer capable of running | + | |
- | Setting up the emulator is fun and easy! But before getting started, there are a few things that you will need to assemble: | + | ==== Upgrading |
- | * [[http:// | + | |
- | * SheepShaver | + | |
- | * You will need a valid ROM file. You can get one from an actual Macintosh computer or you can skulk around the Internet and download one illegally. If you own a physical Macintosh, you can legally acquire a ROM image following the directions in [[sheepshaver roms|this guide]]. | + | |
- | **Tip**: Emaculation.com site policy is to not offer or link to ROM files, although Apple seems to have stopped taking action against distribution | + | If you are upgrading from an old version of SheepShaver, |
- | * You need a Mac OS install disk. A retail Mac OS CD works best, although | + | If you kept your ROM file and hard disk image(s) in the old SheepShaver folder, copy them into the new folder. If they are outside your old SheepShaver |
+ | |||
+ | Next, run the GUI, point to the ROM and disks images and adjust the other GUI settings to match your old settings. Run SheepShaver.\\ | ||
+ | |||
+ | If everything is okay, you can remove the old folder and its content. If you had the GTK development kit installed (and no other programs are using it) you can remove it.\\ | ||
- | | ||
===== Getting Started ===== | ===== Getting Started ===== | ||
- | Download the files listed above. There is no installer to run - just extract the SheepShaver archive. Remember to put SDL.dll in the SheepShaver directory and to install the GTK +2 Runtime. | ||
- | First you need to deal with your Mac OS install media. As noted above, SheepShaver is best used with Mac OS 8.6 - 9.0.4. | + | You need: |
+ | * [[https:// | ||
+ | * A **valid ROM file**. Rom files come in two flavours: the Old World ROM and the New World ROM. With an **Old World ROM**, you can run Mac OS 7.5.3 up to Mac OS 9.0.4. With a **New World ROM** you can run Mac OS 8.5 up to Mac OS 9.0.4 | ||
+ | * An **installation CD or a disk image of an installation CD**. Universal installation CDs work best. Installation CDs for specific Mac models often do work. Appropriate image files can be downloaded from various places on the internet. Check the Macintosh Garden for “MacOS904CD_Intl.ZIP” on its "Mac OS 9.0.4” page. | ||
- | ==== For those with a physical Mac OS installation | + | **Note**: If you are using a CD image, you may need to right-click the image (in Windows), and set it to "read only" in the " |
- | The easiest way to get started is to use an actual Mac OS install CD. To boot from a CD, you must first install SheepShaver' | + | **Tip**: We do not offer or link to ROM files. However, you can find compatible files when you search |
- | **Note**: | + | |
- | Run " | + | **Note**: While the redundant robot site also provides a hard disk image with a pre-installed Mac OS 9, it is **not** advisable to use that image. It does **not contain** a complete Mac OS 9 installation, |
- | ==== For those without a physical Mac OS installation CD ==== | ||
- | You can easily mount either a .TOAST or a .ISO image of a Mac OS installation disk, sparing you the need of burning a copy. First, however, you **must** right click on the file in Windows, select the " | ||
- | ==== For those who don't have a CD or an image of a CD ==== | + | ===== Dealing with your Mac OS Installation Media ===== |
- | If you don't have a Mac OS CD or an image of a CD, you can follow | + | This guide will walk you through the settings on each of the tabs of the SheepShaver GUI. |
+ | === Using a physical Mac OS installation CD === | ||
+ | Insert your CD-ROM. Run " | ||
- | ===== Configuration ===== | + | === Using an image of Mac OS installation CD === |
+ | Run " | ||
- | In the " | + | === For those who don't have a CD or a CD image === |
+ | If you don't have a Mac OS CD or an image of a CD, you can only install | ||
- | {{http:// | + | ===== Setting up SheepShaver |
- | **Figure one: Creating a blank hard file for SheepShaver** | + | |
- | When the hard file is created, | + | Note that the SheepShaver GUI saves all your preferences to a file called " |
+ | ==== Volumes Tab === | ||
- | {{http:// | + | On the " |
- | **Figure two: The " | + | |
- | Switch over to the " | + | Set a size for the hard file (Mac OS requires at least 220 MB for a typical install) and give it a name. Click "OK" to create the file (see figure 2). Be patient... it can take a few minutes to create the file. \\ |
- | {{http:// | + | **Note**: The maximum size of hard disk images is 2 GB\\ |
- | **Figure three: The " | + | |
- | Switch to the " | + | After the hard file has been created, |
- | {{http:// | + | **Note:** If you are are listing an installation CD image here, it should be **the first entry** so that SheepShaver can boot from it. You can drag the entries to a different position, if needed.\\ |
- | **Figure four: The Memory/Misc tab of the SheepShaver GUI** | + | |
- | ===== Booting ===== | + | Other settings on the volumes tab: \\ |
- | Click " | + | |
- | {{http:// | + | **Disable CD-ROM Driver**: disables CD access.\\ |
- | **Figure five: Give your hard disk a name and initialize it** | + | **Try to automatically detect new removable media (enable polling)**: when checked, SheepShaver periodically checks for a newly inserted CD.\\ |
+ | **Enable "My Computer" | ||
+ | **Mount drives**: shows the host drives that will be available through the My Computer icon on the desktop.\\ | ||
- | Now you can install Mac OS. Figure six shows the desktop of an emulated Macintosh that has booted from a Mac OS 9 CD (or CD image). | ||
- | {{http:// | + | {{:sheep-gui1-boot-fromcd.png}}\\ |
- | **Figure | + | **Figure |
- | The actual installation of Mac OS is fairly straightforward, | + | {{: |
+ | **Figure 2: the Volumes tab, set to boot from CD image** | ||
- | {{http:// | + | {{:sheep-gui3-create-hard-file.png}}\\ |
- | **Figure | + | **Figure |
- | When Mac OS finishes installing, select "Shut Down" from the " | ||
- | {{http:// | + | {{:sheep-gui3a-cd-image-hardfile-added.png}}\\ |
- | **Figure | + | **Figure |
- | Congratulations, | + | Switch to the " |
+ | ==== Graphics/ | ||
- | ===== Notes, First Run and Possible Issues | + | Set your video type to " |
+ | |||
+ | {{: | ||
+ | **Figure 5: The " | ||
+ | |||
+ | |||
+ | Switch to the Keyboard/ | ||
+ | ==== Keyboard/ | ||
+ | |||
+ | The keyboard/ | ||
+ | |||
+ | {{: | ||
+ | **Figure 6: Keyboard/ | ||
+ | |||
+ | |||
+ | Switch to the Serial tab. | ||
+ | ==== Serial Tab ==== | ||
+ | |||
+ | SheepShaver can direct the Mac OS Modem or Printer port output to various Windows ports or a file. Select the desired port, or write the output to a file.\\ | ||
+ | |||
+ | |||
+ | {{: | ||
+ | **Figure 7: The Serial tab.**\\ | ||
+ | |||
+ | Switch to the Network tab. | ||
+ | ==== Network Tab ==== | ||
+ | |||
+ | Select which Ethernet interface to use. When you select " | ||
+ | For more advanced networking support (including running Appletalk) see below at Internet access/ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **Figure 8: The Network tab.** | ||
+ | |||
+ | Switch to the " | ||
+ | ==== Memory/Misc Tab ==== | ||
+ | |||
+ | Set the ram size available for Mac OS and select the rom file to use. Click " | ||
+ | Select " | ||
+ | |||
+ | **Note**: Always select " | ||
+ | |||
+ | |||
+ | {{: | ||
+ | **Figure 9: The Memory/Misc tab** | ||
+ | |||
+ | Switch to the JIT Compiler tab. | ||
+ | ==== Jit Compiler Tab ==== | ||
+ | Enabling the JIT Compiler greatly improves performance. It might, however, cause some sporadic crashes, so you can disable it. As PPC Macs contained a 68k Mac emulator, the experimental option is provided to enable it. If you enable it, your mileage may vary... | ||
+ | |||
+ | |||
+ | {{: | ||
+ | **Figure 10: The JIT Compiler tab** | ||
+ | |||
+ | You are now ready to run SheepShaver. Click " | ||
+ | ===== Booting and Installing ===== | ||
+ | |||
+ | When the Mac boots, it will ask you to initialize the hard disk file you created. Give the disk a name and click " | ||
+ | |||
+ | {{: | ||
+ | **Figure 11: Give your hard disk a name and initialize it.** | ||
+ | |||
+ | Now you can install Mac OS. Figure 12 shows the desktop of an emulated Macintosh that has booted from a Mac OS 9 CD (or CD image). | ||
+ | |||
+ | {{: | ||
+ | **Figure 12: The Mac desktop before installation of Mac OS 9.** | ||
+ | |||
+ | The actual installation of Mac OS is fairly straightforward, | ||
+ | |||
+ | {{: | ||
+ | **Figure 13: Mac OS 9 installing.** | ||
+ | |||
+ | {{: | ||
+ | **Figure 14: Installation has finished.** | ||
+ | |||
+ | When Mac OS has finished installing, select "Shut Down" from the " | ||
+ | |||
+ | If you installed from a real CD, eject it.\\ | ||
+ | Start the SheepShaverGUI (if you started from a CD image, remove the CD image from the list of mounted volumes). If need be, at "Boot From" select " | ||
+ | Click " | ||
+ | |||
+ | {{: | ||
+ | **Figure 15: A fresh installation of Mac OS 9.** | ||
+ | |||
+ | **This concludes the initial setup.** | ||
+ | ===== Running SheepShaver without the GUI ===== | ||
+ | |||
+ | SheepShaver needs a set of preferences to run. Both SheepShaver itself and the SheepShaverGUI create an initial SheepShaver_prefs file at first run. | ||
+ | However, SheepShaver can also be started from a command line. | ||
+ | |||
+ | === Starting SheepShaver directly after the initial configuration === | ||
+ | The SheepShaver program reads the SheepShaver_prefs file when it starts. So once SheepShaver is configured to your satisfaction through the GUI, you no longer have to run the SheepShaverGUI to start it. \\ | ||
+ | |||
+ | This is particularly convenient (or even required) when you manually added preferences that cannot yet be set by the GUI, as using the GUI might delete or overwrite those preferences. | ||
+ | |||
+ | === Starting SheepShaver from the command line === | ||
+ | |||
+ | SheepShaver can be started from the command line in two ways: \\ | ||
+ | - By pointing SheepShaver to a preferences file aleady existing. You start SheepShaver with the argument " | ||
+ | - By adding all prefs on the command line. You start SheepShaver with all arguments normally found in the prefs file, each prepended with " | ||
+ | **Please note that " | ||
+ | |||
+ | === The prefs file name === | ||
+ | |||
+ | Prefs file naming: On Windows hosts, the prefs file is called " | ||
+ | |||
+ | A full list of prefs (work in progress) can be found here: https:// | ||
+ | |||
+ | ===== Additional configuration | ||
==== The Configuration Assistant ==== | ==== The Configuration Assistant ==== | ||
+ | At first run, Mac OS starts the Configuration Assistant. This Assistant will lock-up while configuring network settings. Quit the Assistant when it arrives at the network settings and do the remaining configuration manually in the various control panels. | ||
- | When you launch | + | ==== Internet access / Networking ==== |
+ | After following the guide above, | ||
- | ==== 64-bit Windows compatibility ==== | + | === Slirp === |
- | Both the cdenable.sys driver | + | Slirp provides network address translation (NAT), name resolution (DNS) and a small DHCP server to Mac OS. The TCP/IP settings |
+ | * IP address: 10.0.2.15 | ||
+ | * Subnet mask: 255.255.255.0 | ||
+ | * Router address: 10.0.2.2 | ||
+ | * Name server address: 10.0.2.3 | ||
- | **Cd ROM access:** You can make .iso images of your cd roms and add them to the volumes list in the SheepShaver GUI. You can place the cdenable.sys driver in the \Windows\SysWOW64\drivers folder to get rid of the (faulty) error reported about not being able to find the driver in the \windows\system32\drivers folder.\\ | + | === Tap === |
- | **Update**: A [[http:// | + | Fuller networking capacities can be had when connecting through a tap device. This requires installation of the openvpn tap device. You can then either:\\ |
+ | | ||
+ | * **Bridge** the tap device with your default network connection. **This also allows Appletalk | ||
- | **Internet access:** In order to use internet access | + | When set up with **sharing**, you can select |
- | **Preferences GUI:** The currently available experimental 64-bit GTK package has not been tested with SheepShaver.\\ | + | When set up with **bridging**, you can select the **tap device** in the Network tab of the SheepShaverGUI and start SheepShaver. SheepShaver then gets its network settings from the DHCP server in your network. In this case, however, you can also set the network settings yourself in the TCP/IP control panel.\\ |
- | ==== Early Crash ==== | + | |
- | If SheepShaver | + | You can network two instances of SheepShaver |
+ | **Note**: Use [[http:// | ||
- | ==== Sound ==== | + | === Router |
- | In “Sound” control panel, select “built-in” for the output device. In Mac OS 9 the Sound control panel is installed with the other control panels and can be accessed | + | The BasiliskII-router option lets SheepShaver piggyback on your default ethernet connection. You should configure the tcp/ip settings |
+ | |||
+ | * Connect via: Ethernet | ||
+ | * Configure: Manually | ||
+ | * IP address: a free IP-address in your network range | ||
+ | * Subnet mask: 255.255.255.0 | ||
+ | * Router address: | ||
+ | * Name server address: the IP-address of the dns server used by your host. | ||
+ | |||
+ | === Redirecting a TCP/IP port from the guest to the host or the network === | ||
+ | |||
+ | You can redirect a guest port to a host port so you can run services on Mac OS that are accessible on your host or on the network.\\ | ||
+ | Add a preference to the SheepShaver_prefs file in your SheepShaver folder.\\ | ||
+ | **Note:** All manual editing of the prefs file might be lost when running the SheepShaverGUI.exe! | ||
+ | |||
+ | To forward a running **webserver** add: | ||
+ | * redir tcp: | ||
+ | On your host navigate to localhost: | ||
+ | |||
+ | To forward an **FTP server** (such as netpresenz) add: | ||
+ | * redir tcp: | ||
+ | Use an ftp client capable of connecting to old ftp servers (such as FileZilla) to connect to the IP address of your host and port number 2121. | ||
+ | |||
+ | To share files over the **Apple Filing Protocol** (AFP, file sharing over tcp/ip) add: | ||
+ | * redir tcp:548:10.0.2.15:548 | ||
+ | And enable file sharing, including the option to share over TCP/IP. Then run SheepShaver or Basilisk (or Qemu) on another computer and use the chooser option " | ||
+ | |||
+ | **Note: | ||
+ | |||
+ | Redirecting | ||
+ | ==== Start-up Sound ==== | ||
+ | |||
+ | When you place a wav file called " | ||
+ | |||
+ | ==== Sound ==== | ||
+ | If sound output doesn' | ||
+ | * With Mac OS 9: Select “built-in” for the output device in the “Sound” control panel.\\ | ||
+ | * With Mac OS 8.5/6: The Sound control panel is installed in the “Apple Extras” folder. Use it to select the built-in output device. | ||
==== QuickTime ==== | ==== QuickTime ==== | ||
Line 116: | Line 269: | ||
- | ==== Internet ==== | ||
- | To access the internet in the emulated system, check out the [[sheepshaver online guide|online guide]]. | ||
==== Printing ==== | ==== Printing ==== | ||
Line 123: | Line 274: | ||
Consult the [[sheepshaver_basilisk_printing|Printing guide]] | Consult the [[sheepshaver_basilisk_printing|Printing guide]] | ||
- | ==== Appletalk ==== | ||
- | Consult | + | ==== Getting a rom file from a real machine or an installation disk ==== |
+ | You can get one from an actual Macintosh computer or you can skulk around | ||
- | ===== Conclusion | + | ==== Conclusion ==== |
- | We're all done! For more assistance, | + | For more community-driven |