I should probably do this in a better manner, but hopefully I can edit this as I go and this won't be too error prone...
First off, I'm going to be using the following ROM:
And ISO file:
This corresponds to A/UX 3.0.0* A note on using Shoebill. The mouse will be captured when the window is selected. To release the mouse, click the right mouse button
First you may want to verify that Shoebill and the ISO work by booting off of it (I HIGHLY HIGHLY recommend you use a copy of the ISO as it'll be mounted read/write and there is always the chance that it can become corrupted)
shoebill.exe rom=macii.rom ram=64 disk0=Apple_UNIX.iso
If everything goes well you'll be greeted by a login window. Login as root, with no password.
You may get an error about your appletalk configuration, but after that you should now be at the desktop. Under the top right icon (program switcher?) you can jump to a command prompt. You can verify you are running A/UX by doing a 'uname -a'. Also you can check the MacOS version and it should report System Software 7.0.1
So the first thing you will probably want to do is create a new disk for an "installation". A/UX can mount both HFS and UFS disks, but only the 'System 7' side of things can read both sides. Depending on what you want to do with A/UX will depend on how big you want the slices. Because virtual disks are cheap, and you can have 6 SCSI disks, I highly recommend going with additional disks for whatever task at hand you want. Because this is old software with some signed 32bit integer issues I try to keep everything under 1GB (Shoebill on Win32 has issues with disks bigger than 1GB). I like to use qemu-img for this task.
qemu-img.exe create -f raw root.dsk 1000M
Formatting 'root.dsk', fmt=raw size=1048576000
I don't know how to initialize a disk from the command line, and currently Apple HD SC Setup crashes Shoebill, but my build of Basilisk II (Cockatrice III
) will run it (as long as your disk image is under 1024MB) And you can run HD SC Setup to partition your disk image.
I went ahead and used a 868MB root with the remainder for swap. Also take note that you still have to format the partition.
Now booting back into Shoebill. This time we need to change the session type to console, in order for us to be able to properly copy the CD-ROM onto our target disk. Change the session type like tihs:
And once we are in 'text' mode we can start by formatting the harddisk.
newfs /dev/rdsk/c1d0s0 other
And some numbers will go flying by.
Once this is done, we are going to use the Apple sanctioned method of doing a dump/restore
to copy the disk. First we need to mount the drive that we just formatted:
mount /dev/dsk/c1d0s0 /mnt
Now we run the following:
dump.bsd 0f - /dev/rdsk/c0d0s0 | (cd /mnt; restore xf -)
As you can see there are a few things we need to take care of. We need to create some named pipes (as dump/restore cannot recreate those) So we can issue:
mknod /mnt/usr/lib/cron/FIFO p
mknod /mnt/usr/spool/lpd/AppleTalk/pipe p
chmod 600 /mnt/usr/lib/cron/FIFO
chmod 660 /mnt/usr/spool/lpd/AppleTalk/pipe
And that has everything recreated. Finally let's dismount and check the disk for errors. This should be clean, but it's always good to verify.
fsck -y /dev/rdsk/c1d0s0
All being well you won't see anything about errors so we can go ahead and shutdown the VM
shutdown -h now* A quick note, always try to shut down the guest, quitting the VM, while it is not at this blank 'You may now switch off your Macintosh safely." screen may result in file corruption/loss and even a non-booting disk image!
Now we can boot from our newly created disk.
shoebill.exe rom=macii.rom disk0=root.dsk ram=64
And if everything went well, you should be presented with the login screen!Additional Tasksfsck
Now that we are booting up, this is a great time to make a small alteration to /etc/sysinitrc so when it runs fsck you aren't prompted every time.Networking
I'm going to assume you are running one of my SLiRP enabled builds as it is much easier to get connected compared to tun/tap. first open a console window and type in 'newconfig'
regardless of your LAN configuration, the following addresses must be used for SLiRP:
Internet address: 10.0.2.15
for DNS to work, you'll need to create the file /etc/resolv.conf it should contain:
at the bottom of the /etc/sysinitrc file you'll want to add the default gateway
route add default 10.0.2.2 1
And now you can reboot the system once these files are created/updated.
After a reboot, you can ping the address 10.0.2.2, and you should get a reply. * NOTE that this is the ONLY address that you can ping from SLiRP!
You can also telnet to bbs.superglobalmegacorp.com (or vert.synchro.net) and the DNS should resolve, and you should get prompted to login to a BBS. This is only meant to demonstrate that the TCP/IP connection is working.
With this completed, you can now telnet into your A/UX VM on TCP/IP port 42323
redirected ports are:
tcp 42323 to 23 (telnet)
tcp 42324 to 24 (mud?)
tcp 42370 to 70 (gopher)
tcp 42372 to 7000 (NUTS)
tcp 42380 to 80 (http)
udp 42326 to 26000 (quake)usr/local disk
You can download my 'usr/local' disk from here
. I start the VM like this to add in the 2nd disk:
shoebill.exe rom=macii.rom ram=64 disk0=root.dsk disk1=usr-local.dmg
Take note that the SCSI ID does matter! In this case disk1 means SCSI ID of 1. If you are going to use a different number the /dev/dsk/cXd0s0 will have to reflect that different number.
To get the disk to automatically mount, I alter the file /etc/fstab to add in the following line:
/dev/dsk/c1d0s0 /usr/local 4.2 rw 1 2
To give me a /etc/fstab like this:
/dev/dsk/c0d0s0 / ignore rw 1 1
/dev/dsk/c1d0s0 /usr/local 4.2 rw 1 2
rhost_1:/filesystem /mnt ignore rw 0 0
Now if the file is modified correctly you can mount the partition and verify it's mounted.
# mount /usr/local
fluffy.root # df
/ /dev/dsk/c0d0s0 1512712 blocks 407941 i-nodes
/usr/local /dev/dsk/c1d0s0 872890 blocks 231671 i-nodes
To get the most out of it, you'll want to add two users to /etc/passwd
This is for NetHack, and HTTPD.
Running this will link NetHack into your games directory.
ln -s /usr/local/games/nethack /usr/games
And optionally adding these to the end of /etc/sysinitrc will enable the httpd web server, and a gopher server (you don't have to)
/usr/local/etc/gopherd -c -C
/usr/local/etc/httpd/httpd -d /usr/local/etc/httpd
Naturally you'll want to add /usr/local/bin into your path. According to here
, the best way is to modify /etc/profile.