View source for Installing a XubunTOS Virtual Machine on VMWare Server

This tutorial provides instructions for installing XubunTOS inside a VMware virtual machine. Instructions are provided for both Debian-based Linux as well as Windows users. If you run into problems, find that something doesn't work, or want to provide feedback of any kind, feel free to email me (Kevin Klues) at [mailto:klueska@gmail.com klueska(at)gmail.com] and I'll try and update this tutorial as soon as possible.

<font color="#ff0000">Note:<font color="#000000"> 
You will need to make sure you administrative rights on your machine before starting. Otherwise, you will have to get your system administrator to follow these instructions instead.</font></font>

OK, lets get started.....

__TOC__
==Debian Linux VMware Server Installation==
First thing you want to do is get VMware Server installed and running on your system. Do do so, you will need a registration key. Obtaining a key is free, so just go to [http://register.vmware.com/content/registration.html this website], put in your information, and viola, you now have a key. Write this key down somewhere, you will need it again later at the end of the installation process.

Once you have your key you will want to install VMware using aptitude. To do so, you will need to edit your source list to include the repository where the VMware server can be downloaded from.

Open a terminal window, change to the /etc/apt directory, open the sources.list file, and add the following lines to it
 <font face="Courier New"><nowiki># Repository for VMWare</nowiki>
 </font><font face="Courier New">deb http://archive.canonical.com/ubuntu feisty-commercial main</font>
Exit the file and update aptitude (you may need to run this a couple of times before it completes successfully)
 <font face="Courier New">sudo apt-get update</font>
Now that aptitude has been updated to include packages from the commercial repository, you can install VMware Server by issuing the following command:
 <font face="Courier New"> sudo apt-get install vmware-server vmware-tools-kernel-modules </font>
After some downloading time, the VMWare server installation will eventually start, and you will be asked some configuration questions.

First it will show you the VMware license agreement. Just select OK (by pressing tab) and press enter.

<center>[[Image:One.png]]</center>

Next it will prompt you for acceptance of the terms in the VMware server license. Select <Yes> and press enter.

<center>[[Image:Two.png]]</center>

Finally it will prompt you for the serial number you obtained during the registration process with VMware. Just enter the serial number, select <OK> and press enter.

<center>[[Image:Three.png]]</center>

This completes the VMware server installation. You will want to restart your computer now to finalize all your VMware settings.

To open the VMware server either type the following command into a terminal window (I like to open it as a background process):
 <font face="Courier New"> vmware & </font>
Or open it from the menubar (picture below is for Gnome, probably somewhere similar in KDE or other window manager):

<center>[[Image:File.png]]</center>

The next step is now to install the actual XubunTOS image into a virtual machine. Jump down to the section for the XubunTOS installation by following the link found [[#XubunTOS Installation| here.]]

==Windows VMware Server Installation==
First thing you want to do is get VMware installed and running on your system. Do do so, you will need a registration key. Obtaining a key is free, so just go to [http://register.vmware.com/content/registration.html this website], put in your information, and voilà, you now have a key. Write this key down somewhere, you will need it again later at the end of the installation process.

Now go to the web address found [http://register.vmware.com/content/eula.html here] to download VMware for windows.  Agree to the end user license agreement and then select to install the binary installer seen below: 

<center>[[Image:File-1.png]]</center>

Once it is downloaded, go ahead and open it up to start the installation process.

<font color="#000000">Go ahead and follow all the instructions and choose all the default values to get VMware for windows installed. Once installed, open it up and follow the instructions found in the next section to install the actual XubunTOS image into a virtual machine on your PC.</font>

==XubunTOS Installation==
First you need to get a copy of the XubunTOS 2.0 cd image from [http://toilers.mines.edu/files-XubunTOS/XubunTOS-2.0.iso here] or [http://5secondfuse.com/tinyos/XubunTOS-2.0.iso here].
Once you have the image you can start up VMware and install it into a virtual machine.
<font color="#ff0000">Note: </font>Some of the icons look different than below if you installed VMware on a windows machine. The process for installation is still the same though, just find the icons with the same names as the ones indicated and you should be fine.

Go ahead and open up VMware following the instructions for your particular operating system from above. In the window that pops up, choose 'Local Host' and click on connect.

<center>[[Image:File-2.png]]</center>

Once you have clicked on 'Connect', the following window will open up. Go ahead and click on 'Create a new virtual machine'

<center>[[Image:File-3.png]]</center>

The following window should now pop up. Go ahead and click on 'Next'.

<center>[[Image:File-4.png]]</center>
 
Choose 'Typical' installation and click on 'Next'

<center>[[Image:File-5.png]]</center>

Now choose your operating system. XubunTOS is based on Ubuntu, so you should choose the following set of options and click on 'Next'

<center>[[Image:File-6.png]]</center>

Now give your virtual machine a name. I chose XubunTOS 2, but you can really choose anything you want. Go ahead and leave the installation location with its default value. This is where your virtual machine will be installed on your hard disk. If you change this location, you will have to configure things differently later so that the VMware server can find your virtual machine installation.

<center>[[Image:File-7.png]]</center>

Now you need to choose how much space you want reserved for your virtual machine installation. I have chosen 10 GB, but you may wish to choose more or less depending on how much TinyOS development work you actually do. Once you select this value, it can't be changed. This is all the space your virtual machine will ever be able to use, so choose this value wisely.

Additionally, you must choose if you want all this space allocated now or if you want the disk size to increase over time as you add files to you virtual machine. I have chosen to let it grow as I add more files, but you can choose either option and it should work just fine.

Once you've made your selections click 'Finish'.

<center>[[Image:File-8.png]]</center>

Now its time to actually install XubunTOS onto your newly created virtual machine. Go ahead and select 'Edit virtual machine settings'

<center>[[Image:File-9.png]]</center>

In order to install XubunTOS, you need to tell the virtual machine to boot from the 'iso' image you downloaded earlier. Go to the 'Hardware' tab, select connection from an ISO image, and insert the location of the XubunTOS iso image into the field below it. Make sure the rest of the options are as seen below and then click on 'OK'.

<center>[[Image:File-10.png]]</center>

Now its time to power on the virtual machine and install XubunTOS. Just click on 'Power on this virtual machine'

<center>[[Image:File-11.png]]</center>

Once you power on the virtual machine, it will automatically boot from the XubunTOS cd image. Click on the Install icon on the desktop.

<center>[[Image:Img_modification_wiki_instal_vmware.png]]</center>

Next, just follow the onscreen instructions to install XubunTOS into the virtual machine. Installation may take a while, but once it is finished, you will want to turn off the virtual machine and proceed to the next step below.

Once the virtual machine has been powered down, you will need to add configurations to allow it to access your serial and USB devices in order to communicate with the motes. First go to 'Edit Virtual Machine Settings' and click on it.

<center>[[Image:File-12.png]]</center>

Then choose 'Add...'

<center>[[Image:File-13.png]]</center>

Select 'USB Controller' and press 'Next'

<center>[[Image:File-14.png]]</center>

Now go ahead and click 'Finish'

<center>[[Image:File-15.png]]</center>

Now select 'Add..." again

<center>[[Image:File-16.png]]</center>

And this time choose "Serial Port' and click 'Next'

<center>[[Image:File-17.png]]</center>

You will want to use the physical serial port on your host, so go ahead a leave it as the default value and click 'Next'

<center>[[Image:File-18.png]]</center>

Choose 'Auto Select' From the pop down menu and then click Finish

<center>[[Image:File-19.png]]</center>

Verify that both the USB controller and the Serial Port now appear in the menu on the left and press 'OK'

<center>[[Image:File-20.png]]</center>

Now go ahead and power on the virtual machine again to start using XubunTOS in VMware.
If you ever close VMware, you can always open the XubunTOS virtual machine again by choosing to connect from a local host and selecting the XubunTOS virtual machine from the menu bar on the left.

<font color="#ff0000">Note: </font>To access motes connected over the USB port you will need to manually select each device for connection after powering up your XubunTOS virtual machine. To do this go to VM->Removable Devices->USB Devices and select each USB connected mote you would like to access.

<center>[[Image:File-21.png]]</center>

After this go ahead and log in and you should be good to go!!!!
----
And thats it! You should now be up and running with your virtual machine installation of XubunTOS in VMware. Questions or comments can either be sent directly to me ([mailto:klueska@gmail.com klueska(at)gmail.com]) or the [http://tinyos-help@millennium.berkeley.edu/ tinyos-help] mailing list.