QEMU/Guests/Mac OS 9: Difference between revisions

no edit summary
No edit summary
No edit summary
 
(7 intermediate revisions by the same user not shown)
{{DISPLAYTITLE:How to install Mac OS 9 in QEMU}}
[[File:MacOS9.2 Desktop.png|thumb|Mac OS 9.2 desktop]]
This page details how to install Mac OS 9 in QEMU. '''Mac OS 9''' is an operating system created and released by Apple in October of 1999. This was the final release in the classic Mac OS series. The OS was famously discontinued in 2002 with a mock funeral by Steve Jobs at the Apple Worldwide Developers Conference.
 
This article will describe in detail how to install Mac OS 9.2 with mouse drivers, sound, networking, and graphics. This tutorial should work with Mac OS 9.0 and 9.1 (which needs an additional flag; more details below).
 
==Prerequisites==
==Before you start==
===SoundQEMU===
Versions of Mac OS prior to 10.4 (Tiger) did not run on x86 hardware. Instead, it used a PowerPC CPU. Because of this, it's not possible to run this OS with KVM, so we'll need to use pure software emulation, which may be a little slow but shouldn't be agonizing if you're on a newer PC.
You need [[QEMU/Installation|QEMU]] installed, specifically the PowerPC version since old Macs used PowerPC instead of x86. On Arch you can install it with <code>pacman -S qemu-system-ppc</code> and on Debian/Ubuntu you can install it with <code>apt install qemu-system-ppc</code>. The Windows version should come with it already installed.
 
===Mac OS 9.2.1 CD===
You canwill grabneed a Mac OS 9.2.1 ISOCD. You can either use a physical disc or download one from [https://winworldpc.com/product/mac-os-9/92 WinWorldPC].
 
==InstallationStarting up==
===Pre-installationInstallation===
As always, the first thing we want to do is create the hard disk image by opening the Terminal or Command Prompt and typing this:
 
<pre>qemu-img create -f qcow2 macos9.img 2G</pre>
 
'''2G''' can be replaced with however big you want the hard drive to be (with G standing for Gigabytes). Mac OS 9 is a very old OS and thus does not take up a lot of space. [[How to create a disk image in QEMU|See this page for more information on how this command works.]]
 
When that's done, we can start up QEMU with the following command:
You should see an output like this:
 
[[File:MacOS Img Created.png|700px]]
 
Now we're ready to go.
 
===Installation===
Now, we'll start QEMU like this:
<pre>qemu-system-ppc -M mac99 -m 512 -hda macos9.img -cdrom /path/to/macos-9-cd.iso -netdev user,id=mynet -device sungem,netdev=mynet -device usb-mouse -device usb-kbd -boot d</pre>
 
This sets the machine type to "mac99" (basically a G4 Mac). You can also set it to <code>-M g3beige</code> which is a Power Mac G3. We also add a USB mouse and keyboard for far smoother input.
A breakdown of this command: <code>qemu-system-ppc</code> is the name of the QEMU emulator, of course. <code>-M mac99</code> tells it to emulate a "Mac99" model (which is a G4 Mac). QEMU also supports a Beige PowerMac G3. You can type <code>-M ?</code> for a full list. <code>-m 512</code> adds 512 MB of RAM to the machine. The system becomes really unstable with more than 1 GB of RAM so I recommend setting this to about 896 MB (the maximum supported by Mac OS 9) at most. <code>-hda macos9.img</code> is the hard drive. <code>-cdrom /path/to/macos-9-cd.iso</code> adds a CDrom drive, which needs to be changed to point to the Mac OS ISO. <code>-netdev user,id=mynet</code> adds a virtual "user" network and sets up some network configuration. It'll also attach to your host's LAN. <code>-device sungem,netdev=mynet</code> adds a virtual NIC (in this case, a SunGEM network card) and assigns it to the virtual network specified before. <code>-device usb-mouse</code> and <code>-device usb-kbd</code> add a USB mouse and keyboard which will allow for much better input (especially if you are hosting this on [[CollabVM]]). And finally, <code>-boot d</code> tells the machine to boot from the CD-ROM drive.
 
We set the RAM to 512 MB, though you can run it with as little as 40 MB and as high as 768 MB. The OS starts becoming severely unstable if more than a GB of RAM is given.
If you are installing Mac OS 9.0 or 9.1, you will also need to add <code>-cpu G3</code> to the flags for it to work.
 
If you are installing Mac OS 9.0 or 9.1, you will'll also need to add <code>-cpu G3</code> to the flags for it to work.
With all that in mind, we are now ready to start.
 
When you start QEMU, you should see a yellow screen with some details like this:
You may have a "Setup Assistant" appear. You can go through and set everything up or close it, it doesn't matter much, though it will help you set up some basic network functions like shared folders and the like, so I recommend it. It's a very simple wizard.
 
===Software===
MacNow OSthat 9we hadhave lotsour ofsystem softwareset releasedup, forwe'll itprobably backwant into theinstall day,some andsoftware. fortunatelyFortunately, a lot of it was preserved thanks to the efforts of [https://macintoshgarden.org/ Macintosh Garden], [https://www.macintoshrepository.org/ Macintosh Repository], and the Internet Archive. Pretty much every major software for OS 9 is on Macintosh Garden and Repository, so I recommend checking thatthose oneones out first. AtSome theconvenient endand ofinteresting thissoftware tutorialis I'lllisted list some useful softwarebelow.
 
Note: You may have to right click some of the links and click "Save link as...". This is due to a recent change in policy in browsers such as Chrome regarding HTTP links.
===Sound===
 
*[https://macintoshgarden.org/apps/classilla Classilla (Firefox 2 fork)]
*[http://files.mac-attic.com/downloads/internet/browsers/Internet-Explorer-5.1.7.hqx Internet Explorer 5.1.7 (final version of IE for OS 9)]
*[https://macintoshgarden.org/apps/official-macintosh-garden-sherlock-plugins Official Macintosh Garden Sherlock Plugins]
*[http://files.mac-attic.com/downloads/utilities/Virtual-CD.hqx Virtual CD/DVD-ROM Utility]
*[https://www.macintoshrepository.org/809-stuffit-deluxe-1-5-x-8-x StuffIt Deluxe] (for HQX/SIT files)
*[https://winworldpc.com/product/microsoft-office/2001-mac Microsoft Office 2001]
 
==Sound support==
Unfortunately, the stock QEMU does not come with proper sound drivers for Mac OS 9, so we'll need to build a fork of QEMU that adds these sound card drivers. This section will be technically advanced and is only recommended for more experienced users. The instructions change depending on your OS.
 
<code>cd</code> into the folder. We'll configure the build here. We're only going to compile the PowerPC version of QEMU to save time, though if you want to build every version, just remove the <code>--target-list=ppc-softmmu</code> flag at the very end. Execute the following command:
 
<pre>./configure --target-list=ppc-softmmu</codepre>
 
Finally, build QEMU:
==Credits==
*[https://gist.github.com/akemin-dayo/0e9bdcd74b2ad7f0bcf56e0680256103 akemin-dayo's QEMU Screamer guide]
 
[[Category:OS Installation guides]]
[[Category:Tutorials]]
[[Category:QEMU guides]]