Setting up VirtualBox¶
- Download VirtualBox. You want the one for Windows hosts.
During installation, you may want to disable the VirtualBox Bridged Networking and the VirtualBox Host-Only Networking. This prevents two virtual network adapters to be added to Windows, which you don’t need anyway:
During installation, Windows may ask about a USB driver. You can safely accept that.
- After the installation has finished, start VirtualBox.
Creating a virtual machine¶
- Download Fedora. In case you end up on a page where you must choose between Gnome, KDE, LXDE or Xfce, choose Gnome as that’s what we’ll be using for this guide.
- In VirtualBox, click New and follow the wizard.
- Type Fedora as name, set 1024 MB of RAM in case your computer has at least 3 GB of RAM or keep the default otherwise.
- Choose to create a new virtual hard disk.
A new wizard will appear to create the virtual hard drive. All defaults are fine as they are. Finish both wizards to create the new virtual machine. This new virtual machine will now be displayed in the VirtualBox main window.
- Select the newly created virtual box, and click the Settings button.
- Go to Storage, select Empty below the IDE Controller and then click the little disk icon at the right:
- Select Choose a virtual CD/DVD disk file and browse to the Fedora ISO image you just downloaded. Click OK to confirm.
- Back in the main window, click Start to boot the virtual machine.
Installing Fedora inside the virtual machine¶
- You’ll be presented with a message about colour mode, close it. As soon as Fedora has booted, it will complain about a GNOME 3 failure. Close that as well.
- In the top left, click Applications, then go to System Tools and click Install to Hard Drive.
- It will then ask you for your keyboard layout. Basic Storage Devices is fine in the next window. In the storage device warning, click “*Yes, discard any data*”. Note that this refers to the virtual hard drive you made earlier, not your actual hard drive! You will not lose any date.
In the following window you need to enter a hostname for the virtual computer. Anything will do really, so think of something funny. I just used Fedora-grfdev.
- Select the time zone in the next window. Then you’ll be asked for a username and password. As this is a virtual machine, these need not to be strong. For ease of use I used “foobar” for both.
- In the following window, select “Use all space” for the installation type. Confirm with “Write changes to disk”. Now you’ll have to do some waiting. You might as well use the lavatory or something.
When that’s done, you’ll be congratulated.
- Now you’re still in the live cd environment, so you need to shut this down, remove the live cd image and reboot again. Click Live System User in the top right, click Shut Down and again Shut Down in the window that appears.
Configuring the newly installed Fedora¶
- Now that you’re back in the VirtualBox main window, go back into the Settings window.
- Again, go to storage, select the iso image below the IDE Controller. Again click the little disk icon at the right and select “*Remove disk from virtual drive*”. Click OK to close the window.
- Now start the virtual Fedora machine once more. It will present you with a short wizard. Enter the same user details as you did before and leave the rest as it is.
- Next you can log in with these details.
- Now to silence the Gnome 3 error: click your user name in the top right and select System Settings. Then doubleclick System Info. Select Graphics, and set “forced fallback mode” to ON. Close the window.
- Now go to Applications, then System Tools and click Add/Remove Programs. Use the search thingy to find the following and select it:
- python (you might already have this)
- grfcodec (this includes nforenum)
- Click Apply to download everything. You’ll be presented with an “additional confirmation window”. In case this window doesn’t fit your screen to be able to see the Confirm button, press tab exactly four times followed by enter. Next it will ask for your password. Now wait for everything to be installed. You can follow the progress in the bottom left of the window:
Install Guest additions¶
The guest additions allow for mouse integration as well as access to your Windows filesystem.
- Click Devices in the window’s menu bar and then Install Guest Additions.
A new window will appear inside Fedora. Choose Open Folder from the dropdown and click OK.
- Then a file browser window will appear with a button “*Open Autorun Prompt*”, click it.
- In the next dialog, click Run. Then enter your password.
When this is done, shut down Fedora.
Note: In case you get a red FAILED in the output window and a complaint above that that kernel-devel could not be found (although you did download it), the guest additions assume some older version of kernel devel.
You need to solve this in order to use the shared folders. Time to boot up the terminal:
- Go to Applications > System Tools > Terminal.
Enter the following command:
(note the dash, that’s part of the command)
- Enter your password when asked. It will not be shown while typing, just hit enter when you’ve typed the password.
yum install kernel-devel18.104.22.168-26.rc1.fc15.i686
You can copy/paste this from the other window using rightclick.
- Enter y followed by enter when asked.
- When completed, exit all terminal windows and try to reinstall the guest additions. The file explorer window should still be open. Don’t forget to shut down Fedora when done.
Shared folder and 3D acceleration¶
- Again open the Settings window for your VirtualBox virtual machine.
- Next, go to Shared Folders, click the icon with the green +. In the new window, set the path to C:\TTD\grf-dev (or whatever you have) and select Auto-mount:
Remember the Folder Name you set in this window.
- Next, go to Display and enable 3D video acceleration. Close with OK.
- Start Fedora.
- When started, go to Applications > Other > Users and Groups. Again with the password.
- Now select your username and click Properties. In the new window, go to the Groups tab and check the “vboxsf” group.
- Log out (click username in right top) and log in again to apply the change. This will actually give you access to the shared folder.
- Next, you need to make sure that Mercurial trusts the vboxsf group as well, to avoid a load of warnings when using the makefile.
- Click Places at the top of the screen and click Home Folder. Right-click on some empty space in that folder, choose Create New Document and click Empty Document. # Type as name “.hgrc” (without the quotes, including the period at the beginning.
- Click View in the toolbar and Show Hidden Files. Files and folders preceded by a period are hidden folders in Linux and this makes the .hgrc file visible again. # Doubleclick the .hgrc file and enter the following contents in the text editor:
users = username
groups = username, vboxsf
Where you replace username with your actual username. Save the changes and close the editor.
These instructions are based on FooBar's guide and released under the Creative Commons Attribution