Emaculation.com
 

SheepShaver for Linux

(updated November 15, 2010)

Introduction

SheepShaver emulates a Macintosh computer capable of running Mac OS version 9.0.4 and earlier.

This guide is a work-in-progress, but it should walk you through the basic set-up of SheepShaver in Linux.

Parts of this guide are adapted from Ronald P. Regensburg's SheepShaver for Mac OS X setup guide.

Before you begin, you'll need a few things:

  • A SheepShaver build for Linux
  • A valid PPC Macintosh ROM image (see below for notes)
  • A generic retail MacOS install CD or a disk image (.ISO). Note that a system CD provide with a specific Macintosh will not not work.

Preparation

Some SheepShaver builds for Linux are available.

We provide a pair of packages that were built on Ubuntu Intel/AMD 64 bit. Find them at our forum entry SheepShaver for Linux. There is a build that runs in full-screen (if you are experiencing bad mouse movement, check the forum notes). And a build that runs in a window (the full-screen build crashes a lot when running in a window). These builds are dated 03-09-2010.

Set memory access

Due to a change in how programs in Linux are allowed to use memory, before using SheepShaver you need to set a variable in the file
/etc/sysctl.conf

At the end of the file add this line: vm.mmap_min_addr = 0

Assuming you're using KDE, to edit sysctl.conf graphically just type:
"kdesu kwrite /etc/sysctl.conf" into your run box (Alt + F2).
If you're using Gnome then: "gksu gedit /etc/sysctl.conf"
Networking

If you plan to use the sheep_net driver for networking (see the networking section below for more detail), you can set it up now:

Download the sheep_net.ko file from the same forum entry and place it in your home folder. Then open a terminal window and execute:

-sudo modprobe sheep_net.ko
-sudo chown “your username” /dev/sheep_net
If this doesn't work, please refer to the Self-help section below.

Please be aware that the SDL versions of SheepShaver do not show a warning when the Sheep_net driver is not installed, the X window version does.

Older Builds

If the 2010 builds don't work for you, try an older build from 2006:

There is a 32 bit Intel/AMD package and a 64bit Intel/AMD package from 2006. These are described in this forum thread.

Getting Started

Install your SheepShaver application. Start SheepShaver.

Configuration

The SheepShaver GUI is the first thing you see on launch.

Now you can configure the emulator. The following configuration instructions are fairly basic, but should get you going. Consult the SheepShaver for Mac OS X setup guide for more in-depth instructions (the emulator is set-up in a similar way in both host systems).

Volumes

Start with the “volumes” tab.

Click “create” to create a hard-file to which you will later install MacOS. To accomodate a typical install of Mac OS 8 or 9, this should be more than 200 MB in size.

The “Unix Root” is a shared directory which you can use to transfer files between the emulated system and your host system. This should probably not be left at default (the default setting is to share your entire system). Create some directory and point to it, instead. This is ESPECIALLY important if you are running SheepShaver as root, as in that case the emulator has read-write access to your entire system.

Leave “Boot from” as “any” and leave the “disable CD-ROM driver” box unchecked.

Graphics/Sound

Note that fullscreen is only available in the full-screen build linked at the start of this article. Likewise, stable windowed mode is only available in the windowed build and the old 2006 builds. There is a bug in the SheepShaver GUI that prevents the Window refresh rate from being set in the fullscreen build. Check the forum notes (at the download link) for a work-around. Increasing the refresh rate can result in smoother mouse movement.

If you are running in a window, you can set the width and height here.

Keyboard/Mouse

A keycodes file is not necessary is you are using a US English QWERTY keyboard. If you need one, a keycodes file is available here.

Serial/Network

Leave the modem and printer port values at default. If you want use the network/internet, you have two options (the second one only showing up if you installed the sheep_net driver)

slirp

To get online in the emulated system, locate the TCP/IP control panel in MacOS and enter the following values:

Connect via: Ethernet
Configure: DHCP

However, if that does not work, enter:

Connect via: Ethernet
Configure: Manually
IP address: 10.0.2.5
Subnet Mask: 255.255.255.0
Router Address: 10.0.2.2
Name server addr: 10.0.2.3

There are a few more words about slirp in the SheepShaver online guide.

eth0

-Select “eth0” (this only shows up when the sheep_net driver has been installed correctly).

In MacOS, you'll have to set TCP/IP to manual and set an IP-address in your local network, including your subnet, router and dns information)

Memory/Misc

Give your emulated system some memory.

Next, you need a ROM file. ROM files that will work with SheepShaver for Mac OS X are either an “old world” rom extracted from an actual hardware PowerMacintosh or the “new world” rom file extracted from the “Mac OS ROM Update 1.0” with TomeViewer. There is a guide to getting a ROM using Tomeviewer on a physical Macintosh.

Emaculation.com site policy is to not offer or link to ROM files, although Apple seems to have stopped taking action against distribution of ROM files. You can find compatible files when you search the web for “redundant robot sheepshaver” (without the quotes).

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 9.0.4, best use the new world rom.

JIT Compiler

Leave these values at default. “JIT Compiler” should be checked.

Booting

Insert your Mac OS cd and click “start” to boot. If you haven't installed the networking driver, you'll see an error message about that until you do.

Once the emulation has started, you can install Mac OS. You will first be prompted to initialize the hard disk image you created.

If you are using a CD image instead of a physical CD, mount it in the “volumes” tab. You must also mark this image as “read-only” (do this by right clicking in Ubuntu to change its permissions). If you are running SheepShaver as root, your CD image will never be read-only and you will not be able to install from it.

Enjoy.

Get Help

Check it at our SheepShaver forum for more help.

Self-help

OpenSuse: Compile the sheep_net driver
In order to compile the sheep_net module, you need to install the kernel source software for your current kernel. You can do this with software update.

Goto SheepShaver/src/Unix/Linux/Netdriver and enter
“make”,
“sudo make install”,
“sudo chown “yourusername” /dev/sheep_net

OpenSuse: Cannot map Low Memory Globals: Permission denied.
Due to a change in how programs in Linux are allowed to use memory, before using SheepShaver you need to set a variable in the file /etc/sysctl.conf. Add this line: vm.mmap_min_addr = 0
and do as root:
echo 0 > /proc/sys/vm/mmap_min_addr

In addition to this general issue, for OpenSuse to run SheepShaver, you need to disable Novell AppArmor. You can do this by entering the startup parameter “apparmor=0” at boot (at every boot) or choose a more permanent solution by using Yast2 and set the apparmor service to not start at all.

Ubuntu 11.04 32 bit: Compile the sheep_net driver
Goto SheepShaver/src/Unix/Linux/Netdriver and enter
“make”,
“sudo make install”,
“sudo chown “yourusername” /dev/sheep_net”
Use the sheep_net driver:
“sudo modprobe sheep_net”

ubuntu.txt · Last modified: 2014/06/09 21:02 by cat_7
 
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki