Note: this is the old page, see [[Aranym/Quick]] for the current version of this page.

[[Aranym]] is a virtual Atari machine which is useful for [[M68k/Porting|M68k Porting]]. This is a one page installation intended to get Debian/m68k sid running quickly. The disk image is fairly minimal, but it has [[http://packages.debian.org/build-essential|build-essential]] and [[http://packages.debian.org/openssh-client|openssh-client]] installed.

 * [[#install|Install Aranym]]
 * [[#download|Download Files]]
 * [[#network|Configure Networking]]
 * [[#start|Start Aranym]]
 * [[M68k/Cowbuilder|Set up cowbuilder afterwards]]

Contact: <<MailTo(debian-68k@lists.debian.org)>>

<<Anchor(install)>>
== Install Aranym ==

Aranym recommends [[http://packages.debian.org/bridge-utils|bridge-utils]], [[http://packages.debian.org/ipmasq|ipmasq]], and [[http://packages.debian.org/uml-utilities|uml-utilities]]. [[http://packages.debian.org/ipmasq|ipmasq]] may cause you networking grief if you aren't aware.

{{{
apt-get install aranym
}}}


<<Anchor(download)>>
= New image =

This image was prepared by Thorsten Glaser in July 2011.

 * Download the tarball from [[http://people.debian.org/~tg/f/m68k/dc11m68k.tgz|people.debian.org]]
 * Download the signature from [[http://people.debian.org/~tg/f/m68k/dc11m68k.tgz.asc|people.debian.org]]
 * Verify cryptographic integrity: 「gpg dc11m68k.tgz.asc」
 * Extract the tarball
 * Follow the instructions inside for customising the configuration and setting up your network (also read the network notes below)
 * Start up the VM
 * Log in as root/root, change the hostname, (optionally) run 「_getrnd」 to download entropy from the MirBSD service ☺, then run this to set up the system: 「dpkg-reconfigure openssh-server; apt-get update; apt-get install popularity-contest「 (the first command generates the SSH private keys, which were omitted from the image so every copy will have their own ones)
 * Also follow the other instructions in the 0-NOTE.txt file (just read it carefully)
 * You can probably dist-upgrade now, and run 「eatmydata cowbuilder --update」

= Old image =

This image was prepared by Stephen Marenka in… 2009? 2010? It’s pre-TLS.

== Download Files ==

Put all the downloaded files in one directory.

 * Download the [[http://people.debian.org/~smarenka/aranym/sid/disk.tar.7z|disk image]] (97M).
  * The 10G sparse file is 642M uncompressed.
  * Requires DebianPkg:p7zip to decompress: {{{
7zr x -so disk.tar.7z | tar xvf -
}}}
 * Download the [[http://people.debian.org/~smarenka/aranym/sid/aranym.config|configuration file]].
 * Download the [[http://people.debian.org/~smarenka/aranym/sid/vmlinuz|kernel]].

<<Anchor(network)>>
== Configure Networking ==

Make sure [[Aranym/Networking#tun|tun]] is available and setup correctly.

The disk image is setup for [[Aranym/Networking#ptp|point-to-point]] networking. On your host add the following to /etc/network/interfaces.

{{{
auto tap0
iface tap0 inet static
        address 192.168.1.1
        pointopoint 192.168.1.2
        netmask 255.255.255.255
        tunctl_user stephen
        up iptables -t nat -A POSTROUTING -s 192.168.1.2 -j MASQUERADE
        down iptables -t nat -D POSTROUTING -s 192.168.1.2 -j MASQUERADE
}}}

Enable forwarding.

{{{
echo 1 > /proc/sys/net/ipv4/ip_forward
}}}

Then start the network.

{{{
ifup tap0
}}}

For more details on networking, see [[Aranym/Networking]].

Note that the default network setup on the image is broken, see [[Aranym/Networking#ptp|the point-to-point section]] for a correct /etc/network/interfaces (change netmask from /24 to /32 and add a pointopoint stanza).


<<Anchor(start)>>
== Start Aranym ==

aranym is an SDL application, so you need [[http://packages.debian.org/xorg|X]] or something like [[Aranym/Headless]]. The configuration file specifies the amount of RAM aranym gets (see FastRAM). It's currently set at 768MB, adjust to taste. Aranym will happily drive a single cpu core on the host to 100%, but usually isn't that demanding.

{{{
aranym-mmu -l -c aranym.config
}}}
----
CategoryPorts