Bug #71193 for Catalyst-Manual: Getting the Tutorial VM running on a mac

I had a heck of a time getting the VirtualBox tutorial VM up and running on my Mac. Here's some instructions that may be of use to add as an appendix or some such. I also tried importing the VMWare image into Parallels Desktop 5 Mac, but it had some errors where it didn't like debian as a bootable disk. I Haven't tried it on the most recent version of Parallels. (my setup is Mac Os X 10.6.8, VirtualBox 4.1.2r73507, on a 2011 MacBook Pro 17" 2.3 Ghz i7, 8GB ram) 1) Before installing VirtualBox, repair the disk permissions via the Disk Utility in Applications/Utilities. 2) Install VirtualBox 3) Decompress the download archive of the VM for VirtualBox. Double click the CatalystTutorial.vbox file. This starts up the VirtualBox GUI. 4) Select the "Catalyst Tutorial" from the left hand bar listing the available VM's. Click the "Settings" icon just above this list. 5) Go to the "Network" settings, select the actual interface you want to bridge (en1: AirPort for example). The default from the downloaded setup is a realtek card that doesn't exist on macs. 6) Note the "MAC Address" 7) Go to the "Storage" settings, select the "IDE Controler" and click the icon to "Add Hard Disk" 8) Browse to the CatalystTutorial folder you decompressed, and select the CatalystTutorial.vdi file 9) If you get a red exclamation and some errors like "UUID ... of medium does not match the value ...stored in the media registry": a) run the following from the Terminal app (also found in /Applications/Utilities) /Applications/VirtualBox.app/Contents/MacOS/VBoxManage closemedium disk /path/to/CatalystTutorial.vdi 10) Restart VirtualBox, and make sure the Settings->Storage list CatalystTutorial.vdi under the IDE Controller, without any red exclamations. If it does, remove and re-add it as in steps 7 through 9. 11) start the VM, login as "catalyst", password "catalyst" 12) execute "ifconfig". If you only have the "lo" interface, then we have some more work to do: a) Debian notes when a Mac address has changed, and makes a new interface, i.e. eht1. We need to change the file that remembers these seen Mac adresses so that our device is "eth0" not "eth1". b) Change to the udev rules.d folder: "cd /etc/udev/rules.d" c) Edit the "70-persistent-net.rules" file. (you'l have to do something like "sudo vi 70-persistent-net.rules") 1.) Note there should be two entries here, one ending in eth0 and one in eth1. 2.) The eth1 line should have the Mac Address noted in step #6 3.) Delete the eth0 line. (dd is the vi command to delete a line) 4.) Edit the eth1 line changing "eth1" to "eth0" (in vi: i turns on insert mode, esc exits a mode, x deletes the char the cursor is over) 5.) Save and quit the editor (in vi ":wq" is this command) d) Reboot the VM via "sudo reboot" e) login, and check the "ifconfig" you should have a functioning eth0 and lo devices now. 13) Continue with the setup as documented in the Catalyst::Manual from here...