src/MacOSX/HowTo.html

<!DOCTYPE html PUBLIC "-//IETF//DTD HTML 2.0//EN"><HTML>
<HEAD><TITLE>Basilisk II, Mac OS X port, HowTos</TITLE></HEAD>
<BODY>

<H1> Index </H1>

<UL>
<LI> <A HREF="#minreq"> Minimum Requirements</A> </LI>
<LI> <A HREF="#rom">    Macintosh ROM image     </A> </LI>
<LI> <A HREF="#b-disk"> Creating a boot disk</A> </LI>
<LI> <A HREF="#mount">  Mounting Unix Files</A> </LI>
</UL>

<HR>

<H2> <A NAME="minreq"> Minimum Requirements </A> </H2>

To run Basilisk II, you need both:
<UL>
<LI>A Mac ROM image. Even though there is a ROM in your OS X Mac,
        it is too new for a 68k Mac to make use of. Any Mac II ROM,
        and most of the Quadra ROMS, will work.
        <BR> (Quadra 660av and 840av ROMs are currently unusable.
        I don't know about Mac LC ROMs. In the near future, Mac Plus,
        SE or Classic ROMS may also be usable, though only for emulating
        a monochrome Mac). </LI>
<LI>A copy of the MacOS, which at the moment has to either be on
        a CD-ROM, or on a disk image </LI>
</UL>

<HR>

<H2> <A NAME="rom"> Macintosh ROM image </A> </H2>

<P> To run Basilisk II, you need a ROM image, which is a data file
containing a copy of the ROM chips from a real 68k Macintosh. </P>

<P> The best way (<I>i.e.</I> most legally acceptable) to get a ROM
image is to produce it from your old Mac. Take a program like CopyROM,
download it onto your old Mac, and use it to produce the image file,
which you then upload to your OS X Mac. </P>

<P> The easiest way to get a ROM image is to get one from someone else
(<I>e.g.</I> another Basilisk II user, or an emulation web site).
Note that this probably contravenes several copyright laws. </P>

<P>Once you have your ROM image, you need to tell Basilisk II to use it:
<OL>
<LI> Open the Basilisk II application </LI>
<LI> Go to the 'BasiliskII' menu, then the Preferences...' menu item </LI>
<LI> On the Emulation tab, there is a field 'ROM file:'. Either type in the
        path to the ROM file, or click the Browse button and Open the ROM file </LI>
<LI> Click the Save button, so that Basilisk II will be able to find the ROM
        each time you boot it </LI>
</OL>
</P>

<P> If you want to test this, press the Run or Power button
(in the top right corner of the 'BasiliskII Emulator' window).
After a few moments you should see a Mac screen, with a picture of a floppy
disk with a flashing question mark. That is the Mac telling you that it needs
a disk to boot from. </P>

<HR>

<H2> <A NAME="b-disk"> Creating a boot disk </A> </H2>

<P> Basilisk II needs a copy of the MacOS to boot from. Anything from System 7
through to MacOS 8.1 should be usable.
<BR> (Felix Eng and I have only tested System 7.0.1, 7.1, 7.5.3 and 7.6,
although Felix also got System 6.0.8 to work with SE/30 Roms) </P>

<P> It is possible to use Basilisk II with a CD-ROM, but because most bootable
CDs have a minimal System Folder, it is better if you use a disk image with the
MacOS installed on it. </P>

<P> There are two options: either grab an image that someone else has made,
or create one yourself. If you have some time, and access to a MacOS install CD,
then these instructions will help you do the latter. </P>

<P> Note that there is currently no Install CD image on Apple's Web site -
they only seem to have MacOS 7.5.3 floppy disk images (all 19 of them).
If you do not have a friend with an install CD, you can possibly make one
by copying the System Folder from a bootable OS 7 or 8 CD, and burning that
onto a CD with the floppy disk images.
<BR>Thanks to Attilio Farina for this tip! </P>


<H3> Create a new BasiliskII disk </H3>

<P> Before you can install the MacOS onto a disk volume,
you need to create a disk to install onto: </P>

<OL>
<LI> Start up the Basilisk application.<BR>
        (If it is already running, skip this step)</LI>
<LI> Open the preferences. </LI>
<LI> Go to the Disk Volumes tab. </LI>
<LI> Press the 'Create...' button
     (go with the defaults, unless you think you will need a huge disk). </LI>
</OL>

<P> If you want to have more than one hard disk available to Basilisk II,
you could create additional volumes here. </P>


<H3> Installing the MacOS </H3>

<P> Insert your MacOS install CD-ROM, and wait a few moments for
the Finder to mount the disk. While still in your preferences: </P>

<OL>
<LI> Go to the Emulation tab and check that your emulation is appropriate
     for your install image
     <BR>(<I>e.g.</I> I had to change from Quadra900 to IIci,
          because my generic 7.1 install CD didn't support the Quadra),
     and that you have the RAM size set appropriately
         <BR>(<I>e.g.</I> 8MB RAM may not be enough for a 7.5.3 install). </LI>
<LI> Click the save button. </LI>
<LI> In the BasiliskII Emulator window, click Run. <BR>
        (If it is already running, but showing the floppy with the question mark,
         press the restart button - the triangle in the bottom right hand corner) <BR>
     You should get a HappyMac, and the emulator will start to boot from the CD.
     You should then a dialog asking you to format a disk. </LI>
<LI> Click Initialize, then Erase, give the disk an appropriate name
     (<I>e.g.</I> Hard Disk), then click OK. </LI>
<LI> Find the OS installer (in my case the CD booted into At Ease, and one of
     the first buttons was 'Install System'), and go with the defaults. </LI>
</OL>

<P> After the installer finishes it may try to reboot (or you may need to
force a reboot). When it reboots, BasiliskII may exit. Start it again,
and you should boot into your installed OS. </P>

<HR>

<H2> <A NAME="mount">Mounting Unix Files</A> </H2>

<P> If Basilisk II is running MacOS 7.5.3 or newer, you can easily access some
of the files from your OS X disks. Just set the 'Unix directory to mount' in the
Volumes tab of the Preferences. Next time the Emulator starts up, a new disk will
appear on its Desktop (called Unix). </P>

<P> To prevent clashes with the OS X desktop files, I suggest that the directory
you select is not a whole disk (<I>e.g.</I> '/' or '/Volumes/disk'). Mount a
sub-folder instead (like '/Applications (Mac OS 9)'). </P>

<HR>

$Id: HowTo.html,v 1.1 2003/03/26 22:26:32 nigel Exp $
<BR>
Written by Nigel Pearson on 26th March, 2003.

</BODY>

</HTML>
Revision:	1.2
Committed:	2003-04-01T03:17:47Z (21 years, 8 months ago) by nigel
Content type:	text/html
Branch:	MAIN
CVS Tags:	nigel-build-13
Changes since 1.1:	+25 -13 lines
Log Message:	Some extra versions tested, extra tips, ExtFS 7.5.3
#	User	Rev	Content
1	nigel	1.1	<!DOCTYPE html PUBLIC "-//IETF//DTD HTML 2.0//EN"><HTML>
2			<HEAD><TITLE>Basilisk II, Mac OS X port, HowTos</TITLE></HEAD>
3			<BODY>
4
5			<H1> Index </H1>
6
7			<UL>
8			<LI> <A HREF="#minreq"> Minimum Requirements</A> </LI>
9			<LI> <A HREF="#rom"> Macintosh ROM image </A> </LI>
10			<LI> <A HREF="#b-disk"> Creating a boot disk</A> </LI>
11			<LI> <A HREF="#mount"> Mounting Unix Files</A> </LI>
12			</UL>
13
14			<HR>
15
16			<H2> <A NAME="minreq"> Minimum Requirements </A> </H2>
17
18			To run Basilisk II, you need both:
19			<UL>
20			<LI>A Mac ROM image. Even though there is a ROM in your OS X Mac,
21			it is too new for a 68k Mac to make use of. Any Mac II ROM,
22	nigel	1.2	and most of the Quadra ROMS, will work.
23			<BR> (Quadra 660av and 840av ROMs are currently unusable.
24			I don't know about Mac LC ROMs. In the near future, Mac Plus,
25			SE or Classic ROMS may also be usable, though only for emulating
26			a monochrome Mac). </LI>
27	nigel	1.1	<LI>A copy of the MacOS, which at the moment has to either be on
28			a CD-ROM, or on a disk image </LI>
29			</UL>
30
31			<HR>
32
33			<H2> <A NAME="rom"> Macintosh ROM image </A> </H2>
34
35			<P> To run Basilisk II, you need a ROM image, which is a data file
36			containing a copy of the ROM chips from a real 68k Macintosh. </P>
37
38			<P> The best way (<I>i.e.</I> most legally acceptable) to get a ROM
39			image is to produce it from your old Mac. Take a program like CopyROM,
40			download it onto your old Mac, and use it to produce the image file,
41			which you then upload to your OS X Mac. </P>
42
43			<P> The easiest way to get a ROM image is to get one from someone else
44			(<I>e.g.</I> another Basilisk II user, or an emulation web site).
45			Note that this probably contravenes several copyright laws. </P>
46
47			<P>Once you have your ROM image, you need to tell Basilisk II to use it:
48			<OL>
49			<LI> Open the Basilisk II application </LI>
50			<LI> Go to the 'BasiliskII' menu, then the Preferences...' menu item </LI>
51			<LI> On the Emulation tab, there is a field 'ROM file:'. Either type in the
52			path to the ROM file, or click the Browse button and Open the ROM file </LI>
53			<LI> Click the Save button, so that Basilisk II will be able to find the ROM
54			each time you boot it </LI>
55			</OL>
56			</P>
57
58	nigel	1.2	<P> If you want to test this, press the Run or Power button
59			(in the top right corner of the 'BasiliskII Emulator' window).
60			After a few moments you should see a Mac screen, with a picture of a floppy
61	nigel	1.1	disk with a flashing question mark. That is the Mac telling you that it needs
62			a disk to boot from. </P>
63
64			<HR>
65
66			<H2> <A NAME="b-disk"> Creating a boot disk </A> </H2>
67
68	nigel	1.2	<P> Basilisk II needs a copy of the MacOS to boot from. Anything from System 7
69			through to MacOS 8.1 should be usable.
70			<BR> (Felix Eng and I have only tested System 7.0.1, 7.1, 7.5.3 and 7.6,
71			although Felix also got System 6.0.8 to work with SE/30 Roms) </P>
72	nigel	1.1
73			<P> It is possible to use Basilisk II with a CD-ROM, but because most bootable
74			CDs have a minimal System Folder, it is better if you use a disk image with the
75			MacOS installed on it. </P>
76
77			<P> There are two options: either grab an image that someone else has made,
78			or create one yourself. If you have some time, and access to a MacOS install CD,
79			then these instructions will help you do the latter. </P>
80
81	nigel	1.2	<P> Note that there is currently no Install CD image on Apple's Web site -
82			they only seem to have MacOS 7.5.3 floppy disk images (all 19 of them).
83			If you do not have a friend with an install CD, you can possibly make one
84			by copying the System Folder from a bootable OS 7 or 8 CD, and burning that
85			onto a CD with the floppy disk images.
86			<BR>Thanks to Attilio Farina for this tip! </P>
87
88	nigel	1.1
89			<H3> Create a new BasiliskII disk </H3>
90
91			<P> Before you can install the MacOS onto a disk volume,
92			you need to create a disk to install onto: </P>
93
94			<OL>
95	nigel	1.2	<LI> Start up the Basilisk application.<BR>
96	nigel	1.1	(If it is already running, skip this step)</LI>
97			<LI> Open the preferences. </LI>
98			<LI> Go to the Disk Volumes tab. </LI>
99			<LI> Press the 'Create...' button
100			(go with the defaults, unless you think you will need a huge disk). </LI>
101			</OL>
102
103			<P> If you want to have more than one hard disk available to Basilisk II,
104			you could create additional volumes here. </P>
105
106
107			<H3> Installing the MacOS </H3>
108
109			<P> Insert your MacOS install CD-ROM, and wait a few moments for
110			the Finder to mount the disk. While still in your preferences: </P>
111
112			<OL>
113			<LI> Go to the Emulation tab and check that your emulation is appropriate
114			for your install image
115			<BR>(<I>e.g.</I> I had to change from Quadra900 to IIci,
116	nigel	1.2	because my generic 7.1 install CD didn't support the Quadra),
117			and that you have the RAM size set appropriately
118			<BR>(<I>e.g.</I> 8MB RAM may not be enough for a 7.5.3 install). </LI>
119	nigel	1.1	<LI> Click the save button. </LI>
120			<LI> In the BasiliskII Emulator window, click Run. <BR>
121			(If it is already running, but showing the floppy with the question mark,
122			press the restart button - the triangle in the bottom right hand corner) <BR>
123			You should get a HappyMac, and the emulator will start to boot from the CD.
124			You should then a dialog asking you to format a disk. </LI>
125			<LI> Click Initialize, then Erase, give the disk an appropriate name
126			(<I>e.g.</I> Hard Disk), then click OK. </LI>
127			<LI> Find the OS installer (in my case the CD booted into At Ease, and one of
128			the first buttons was 'Install System'), and go with the defaults. </LI>
129			</OL>
130
131			<P> After the installer finishes it may try to reboot (or you may need to
132			force a reboot). When it reboots, BasiliskII may exit. Start it again,
133			and you should boot into your installed OS. </P>
134
135			<HR>
136
137			<H2> <A NAME="mount">Mounting Unix Files</A> </H2>
138
139	nigel	1.2	<P> If Basilisk II is running MacOS 7.5.3 or newer, you can easily access some
140	nigel	1.1	of the files from your OS X disks. Just set the 'Unix directory to mount' in the
141			Volumes tab of the Preferences. Next time the Emulator starts up, a new disk will
142			appear on its Desktop (called Unix). </P>
143
144			<P> To prevent clashes with the OS X desktop files, I suggest that the directory
145			you select is not a whole disk (<I>e.g.</I> '/' or '/Volumes/disk'). Mount a
146			sub-folder instead (like '/Applications (Mac OS 9)'). </P>
147
148			<HR>
149
150	nigel	1.2	$Id: HowTo.html,v 1.1 2003/03/26 22:26:32 nigel Exp $
151	nigel	1.1	<BR>
152			Written by Nigel Pearson on 26th March, 2003.
153
154			</BODY>
155
156			</HTML>