MINIX 3

For CSIF Computers

Last updated 10.22.2013 (Instructions for VirtualBox)

This section is specifically for integrating the 405MB MINIX 3 default installation virtual machine for use on CSIF computers

Tips and notes before starting

Since the CSIF uses NFS, it is recommended to unpack the Minix image to /tmp and point VirtualBox to use that image instead of unpacking the image to one’s home directory. This reduces latency especially when recompiling the kernel. However, one must not forget to repack and save the image to their home directory after use. Otherwise, the image will be deleted after the nightly reboot. If the system is ever rebooted then /tmp is removed so it is a good idea save it to your home directory every so once in a while.

VMware Player

  • To grab the MINIX 3 Virtual Machine and put it in your CSIF home directory, execute the following commands in terminal assuming that you are logged into the CSIF computers
$ cd ~/
$ tar -jxvf /home/software/vm/minix320.tar.bz2
  • The above commands will extract the compressed files and put them in ~/Minix-book, so make sure you have at least 405MB of free space on your home directory
  1. Start VMware Player if you haven’t already done so; this can be done by either typing in vmplayer in a GUI terminal, or hitting the Windows key on your keyboard that sits between the Ctrl and Alt keys, and then typing in “vmware” with no quotes before clicking on the icon labeled VMware Player
    • If you get prompted to update VMware Player, or if you are taken to a screen where it stops the VMware services, and updates components of VMware Player, then please contact CSIF Support
  2. Accept the End User License Agreement if you haven’t already done so by clicking the Accept button, and then click on Open a New Virtual Machine in the right-hand side column of VMware Player’s main window
    • Ignore any prompts to upgrade to VMware Workstation
  3. Navigate to where you extracted your file and into the folder named Minix-book, and there should be a Minix-book.vmx file
  4. Highlight the Minix-book.vmx file and click the Open button
  5. Highlight the new virtual machine in the left-hand side column of WMware Player’s main window, and select Play virtual machine on the right-hand side column
  6. When a prompt comes up notifying you of the virtual machine being edited, clicked the I copied it… button
  7. When a prompt comes up informing you that the disk file (Minix3.vmdk) is on a remote file system, which might affect disck write performance, check the Never show this hint again box and click the OK button
Now you are ready to use the MINIX 3 virtual machine on CSIF computers

VirtualBox

  1. Unpack /home/software/vm/minix320.tar.bz2 to /tmp or to your home directory if you prefer using the commands above
  2. Open VirtualBox
  3. Click New
  4. Type Minix3 for the name
  5. Select Other for the type
  6. Select Other/Unknown for the version
  7. Adjust memory size to 128MB. Click Next.
  8. Select use an existing virtual hard drive file
  9. Locate and select minix3.vmdk. This should be located in the extracted directory.
  10. Click Create
  11. Select the virtual machine Minix3 and click Start to start the virtual machine.
  12. Log in as root
  13. To shutdown, type “poweroff”

Now you are ready to use the MINIX 3 virtual machine on CSIF computers

Using SSH on Minix 3

By default, OpenSSH is not installed on the Minix system. To install OpenSSH, first populate the package database with the latest packages:

$ pkgin update

To install OpenSSH type

$ pkgin install openssh

Type “y” to proceed. The SSH utility should now be installed.

Repacking files into a tarball

  1. Poweroff virtual machine session
  2. Close the virtual machine
  3. cd into the parent directory of minix320
  4. Pack the folder using
  5. $ tar -jcf minix320.tar.bz2 minix320/
  6. Move tarball to home using
  7. $ mv minix320.tar.bzp ~/

Release mouse capture

Press the right Ctrl key to release mouse capture.

For Non-CSIF Computers

Last updated 1.25.2013 (Reflected changes to MINIX VM files)

This section is specifically for creating a MINIX 3 Virtual Machine on non-CSIF computers OR integrating the 409MB (68MB home directory; expandable to 768MB) MINIX 3 default installation virtual machine found on CSIF servers for use on non-CSIF computers

  1. Download the compressed MINIX 3 ISO from the MINIX 3 website.
  2. Extract the ISO by executing the command below on Linux systems while making sure to change [full download path] to the location, including the filename, where the download is stored; if you are on a Windows system, then use winRAR, 7zip, or a similar archiver program to extract the ISO
    • $ bzip2 -dk [full download path]
  3. Start VMware Player if you haven’t already done so, accept the End User License Agreement by clicking the Accept button, and then click on Create a New Virtual Machine in the right-hand side column of VMware Player’s main window
    • Ignore any prompts to upgrade to VMware Workstation
  4. Fill the Use ISO image: bubble and click the Browse button
  5. Navigate to the folder where you downloaded the compressed MINIX 3 ISO, highlight the extracted ISO, and click the Open button.
  6. Click the Next button
  7. Fill the Other bubble under Guest Operating System and select Other from the Version: drop-down menu
  8. Fill in a name for the Name: field and click the Browse button to store the Virtual Machine settings; if you are on the CSIF computers, you will have to put this in your home directory (/home/[username] where [username] is your login username)
  9. Click the Next button
  10. Allocate the desired disk size by typing into the Maximum disk size (in GB): field while making sure you have enough physical hard drive space (this is especially important to people installing MINIX 3 on their CSIF home directories)
    • To install MINIX 3, you will need at least 403MB of disk space
  11. Fill the Store virtual disk as a single file bubble and click the Next button
  12. Un-check the Automatically power on this virtual machine after creation box and click the Finish button
  13. Highlight the created virtual machine in the left-hand side column of WMware Player’s main window, and select Play virtual machine on the right-hand side column
    • If a hint pops up about 64-bit issues, then check the Never show this hint again box and click the Ok button
  14. Follow the instructions in the virtual machine after it boots off the MINIX 3 ISO to install MINIX 3 to the virtual hard drive
    • When prompted to enter in the network adapter, leave it as default
    • After typing in shutdown to the virtual machine, VMware will prompt you about a fault “causing a virtual CPU to enter the shutdown state”; check the Never show this hint again box and click the Cancel button
  15. To unmount the installation ISO, right-click the virtual machine name in the left-hand side column of VMware Player’s main menu, and click on Virtual Machine Settings
  16. Highlight CD/DVD (IDE) in the right-hand list and fill the Use a physical drive: bubble under the Connection section on the right-hand side before clicking the Save button
  17. To start the virtual machine again, repeat #13

Integrating the pre-made CSIF MINIX 3 Virtual Machine

  • Use scp, WinSCP, or a similar program to grab the file DefaultMinix3-1.tar.bz2 from /home/software/vm/; provided below is a sample scp command where [username] is the username you use to log in to the CSIF machines and pcxx is any pc that corresponds to the List of CSIF Lab Computers
    • $ scp [username]@pcxx.cs.ucdavis.edu:/home/software/vm/minix320.tar.bz2 ~/
  • MD5 checksum: c91a1456ffb36397587a09830695835b
    • To verify the file is not corrupt or altered on a Linux system, execute the following command
      • $ md5sum ~/minix320.tar.bz2
    • If the checksum doesn’t match, then re-download and verify the file again; if the problem still persists, then please contact us
  • After copying/downloading the compressed file to your home directory by executing one of the commands above, execute the following code below; if you copied/downloaded the file to a different directory than your home directory, then cd instead into the directory where the file is stored
    • If you are in the Windows environment, then use winRAR, 7zip, or a similar archiver program to extract the tar.bz2 file
$ cd ~/
$ bzip2 -dfv minix320.tar.bz2
$ tar -xvf Minix-book.tar
  1. Start VMware Player if you haven’t already done so, accept the End User License Agreement by clicking the Accept button, and then click on Open a New Virtual Machine in the right-hand side column of VMware Player’s main window
    • Ignore any prompts to upgrade to VMware Workstation
  2. Navigate to where you extracted your file and into the folder named Minix-book, and there should be a Minix-book.vmx file
  3. Highlight the Minix-book.vmx file and click the Open button
  4. Highlight the new virtual machine in the left-hand side column of WMware Player’s main window, and select Play virtual machine on the right-hand side column
  5. When a prompt comes up notifying you of the virtual machine being edited, clicked the I copied it… button
Now you are ready to use the MINIX 3 virtual machine on non-CSIF computers

Comments are closed.