View source for Manuals/Station Mapping/Virtual Machine/Getting Started With Virtual Machines

#REDIRECT [[Docs/Virtual_Machines]]

{{Public Support Wiki}}
{{DISPLAYTITLE:
Getting Started with Virtual Machines
}}
{{CopyrightNotice|{{REVISIONYEAR}}}}


==Introduction ==

Userful's Virtual Desktop Infrastructure (VDI) solution is a feature that makes it possible to map full-screen Virtual Desktop sessions to stations. 

This guide provides step-by-step instructions for installing virtual machines (VMs) to use with the Userful Virtual Desktop Infrastructure (VDI) station mapping session container. It also includes instructions for saving and copying VM Master Images.
"Station Mapping" lets a system administrator configure what type of Virtual Desktop session to launch on each station. Once the system administrator has mapped a Virtual Desktop session to a station, it will automatically launches a full-screen session on that station.

The simple instructions provided here are sufficient for creating VMs for demonstration purposes; in production environments, system administrators should refer to either  [[Manuals/Station Mapping/Virtual Machine/Optimizing Windows Virtual Machines  | Virtual Machine Optimization guide]] for how to configure.


{| {{Notes}}
|
Userful VDI technology relies on third-party virtual machine players ''(also known as [http://wikipedia.org/wiki/Hypervisor "hypervisors"])'' like Oracle&reg; VirtualBox&trade; to create and configure Virtual Machines.

'''For deployments in production environments, Userful strongly recommends accessing the third-party documentation for detailed information, instructions and troubleshooting of VMs created with that VM player.'''

For example, VirtualBox has [https://www.virtualbox.org/wiki/End-user_documentation extensive online documentation].  

|}


== Licensing is Your Responsibility ==
{| {{Notes}}
|
'''Please Note: You are responsible for complying with all operating system and application vendors’ license agreements when you clone a virtual machine or make it available for multiple users.'''
|}

== Considerations When Using Virtual Machines ==
* Make sure that sufficient system resources, especially RAM, are available for all mapped stations. For example, if the master VM is 512MB, and there are 15 stations, the system must have at least 8GB RAM available. 
* The BIOS of the host PC must be configured to enable the hardware virtualization CPU setting.
* Though not required, performance will be better with a solid state drive (SDD). '''In particular, it is recommended to store the VM images on SSD.''' 
* If cloned VMs are to be bound to an Active Directory domain: 
** The Master VM must not be bound to an Active Directory domain prior to cloning, and 
** "Writable" clones must be used. The reason is that (for security purposes) Windows performs automatic machine password changing at regular intervals. You can disable this automatic password changing according a Microsoft KB article: http://support.microsoft.com/kb/154501.
* Zero-client devices must be connected to the host PC, assigned, and configured.
* All Master VM image(s) must be stored under the same user account, such as "administrator" (or any other user who will "own" the VM images).
* '''If you access the internet through a proxy, it is important to configure your golden master image with the correct proxy settings.'''
* Install VirtualBox Extension Pack through  <tt>''' Control Center > System Operations > Third-Party Add-ons '''</tt>

==Creating a Master VM Image ==

A key advantage of Userful's design is that cloning is automatic and quick; clones are copied from "known good" virtual machine master images known as golden masters. 
Plan to build one or more master system images and have end-users only use clones of these. Once an optimized golden master image is created, it can be copied to several systems. 

To create a Master VM Image, follow one of the following options:
* [[#Transferring_an_OVA_file_to_host_PC | From an existing <tt>ova</tt> file]], or
* [[#Creating_a_Master_VM_Image_From_Installation_Media_or_Disk_Image_.28.iso.29 | From Installation Media or Disk Image (.iso)]]


===Creating a Master VM Image From Installation Media or Disk Image (.iso)===
It is not necessary to create a Master VM image on host PC; you can create image on any desktop environment(laptops etc) and copy the same on the host PC. Following steps can be used to create a "golden master" VM image that can be copied to host PCs as an <tt>ova</tt> format for VDI funtionality:

* [[#Creating_a_Master_VM_Image| Creating a Master VM Image ]]
* [[#Creating.2FExporting_Virtual_Appliance_Files| Exporting Master VM Image to an OVA format]]
* [[#Transferring_an_OVA_file_to_host_PC | Transferring an OVA file]] to the Host PC
* [[#Importing_Master_VM_Image | Importing a Master VM]]
* [[Manuals/Station_Mapping/Virtual_Machine#Station_Mapping:_Creating_a_Virtual_Machine_Session_Container  | Station Mapping]]

====Creating a Master VM Image====

This process can be used to create a "golden master" VM image that can then be copied to other machines.
<ol start="1">
[[File:VM-Name-Type-Version.png|right|300px]]
<li> Login to the Desktop. </li>
* Userful recommends logging in with an administrator account, as this account will have access to create, configure and/or delete VMs.
<li>Launch VirtualBox by going to <tt>Applications > System Tools > Oracle VM VirtualBox</tt></li>
<li>Create a new VM by clicking the "New" button (at the top left hand side of the Oracle VirtualBox Manager). This opens the "Create Virtual Machine" window.
* ''Note: At any point in the following instructions, press '''F1''' to access VirtualBox help instantly.''
<li>First, you are asked to select a name for the VM, and provide the type and version of the OS being installed. VirtualBox uses this information to properly configure and run the VM. 
* The '''Name''' can be whatever you like, but Userful recommends using a short but descriptive name. In the example to the right, ''Windows 7'' is the Name. 
* Select a '''Type''' from the drop-down list. In the example to the right, the Type is ''Microsoft Windows''. 
* Select a '''Version''' from the drop-down list.  In the example to the right, the Version is "Windows 7".
** '''Important:''' If your operating system is 64-bit, '''you ''must'' select the 64-bit Version of the OS.
<li>Click "Next" to proceed. </li>
<br clear="right" /br>
[[File:VM-Memory-Allocation.png|right|300px]]
<li>The next step is to select the amount of memory (RAM) that will be allocated to the virtual machine. In the example to the right, 1024MB (1GB) of RAM is allocated to the VM. 
* The more RAM is allocated to a VM, the better the performance will be. 
* Each VM (or VM clone) is restricted to use only the amount of RAM (plus a small overhead) allocated. 
* Ensure that your host PC has enough RAM to handle the number of VMs you plan to run, at the memory allocation you select.
** ''There is a wealth of information online regarding memory allocation for VMs. Userful recommends researching the memory requirements for the operating system you wish to install as a VM.''


{| {{Callout}}
| Userful suggests the following '''minimum''' memory allocations for selected operating systems:  
* Windows&reg; 7: 1024MB
* Windows&reg; 8: 2048MB 

''These are good starting points for demonstration purposes, but may not be sufficient for production use, depending on system hardware and/or intensity of usage.''
|}
<li> Click "Next" to proceed. </li>
<br clear="right" /br>
[[File:VM-Storage-Allocation.png|right|300px]]
<li> Create a virtual hard drive for your VM. Click to select "Create a virtual hard drive now" and click "Create".</li>
<li> Choose the "VDI" (VirtualBox Disk Image) type, and click "Next".</li>
<li> Select either dynamically allocated or fixed storage size for the virtual hard drive. </li>
* Choosing "Fixed size" means that a portion of your hard disk storage will be reserved for the VM disk file. 
* Choosing "Dynamically allocated" means that the VM hard drive will only use space on the host PC's physical hard drive as it is needed (up to a maximum size that you will choose in the next step). Note that storage space is not "returned" to the host PC even if the VM is no longer using it. 
* According to [https://www.virtualbox.org/manual/ch01.html#gui-createvm VirtualBox documentation], "While occupying much more space, a fixed-size file incurs less overhead and is therefore slightly faster than a dynamically allocated file."
<li>Next, you must name the virtual hard drive file and set a storage size. (See example, at right, where 25 GB of host (physical) hard disk storage is being allocated to the virtual machine.)</li>
* Ensure that your physical hard drive has enough capacity for the number of VMs you plan to run. 
<li> Click "Create" to finish virtual hard drive creation. The "Create Virtual Hard Drive" window will close, leaving the "Oracle VM VirtualBox Manager" window; do not close this window. 
* Note: Your newly-created VM hard drive should appear in the VM list on the left side of the window. 
<br clear="right" /br>
[[File:VM-Network-Settings.png|right|300px]]
<li> Make sure that your new VM is selected; then, in the "VirtualBox Manager" window, click the "Settings" button in the upper left. </li>
<li> Click on "Network" in the list on the left-hand side of the "[VM-Name] - Settings" window. </li>
<li> Ensure that "Enable Network Adapter" is checked, and select "Bridged Adapter" from the dropdown list. </li>
<li> Click "OK". </li>
<br clear="right" /br>
[[File:VM-Install-Disk.png|right|300px]]
<li> You are now ready to install the operating system onto the virtual hard disk that you have just created.</li> 
* If installing from media, insert the installation media (typically an optical disk) and wait several seconds for it to spin up or be mounted.
<li> In the "VirtualBox Manager" window, click "Start" to power up the VM. </li>
<li> The VM player will typically give you one or two windows that contain tips and/or important information about working in your VM.  ''Read these messages carefully before dismissing them.''</li>
<li> Next, the VM player will ask you to select a start-up disk; this is your installation CD/DVD or .iso file. </li>
* Click on the small "Folder" icon to browse to your host PC's optical drive, or the location of the .iso file, then click "Start".
<br clear="right" /br>
[[File:VM-Window-Anatomy.png|right|300px]]
<li> From this point, installation will proceed as if you were installing your chosen OS on a physical system. 
* Follow the instructions for installing your chosen operating system. 
* When installation is finished, you should have the VM running in VirtualBox and the same VM would be listed under '''<tt> Control Center > Virtual Machines > Master Virtual Machines Summary </tt> '''tab.


{| {{Callout}}
|
The image to the right is an example of what a VirtualBox VM looks like, when running in windowed mode. 

'''Note that at the top and bottom of the window are elements from the VirtualBox application.'''
* The VirtualBox Menu Bar appears above the Guest OS window. 
* The Device Status Bar appears below the Guest OS. 

'''When a VM is run in fullscreen mode, no VirtualBox control elements will be visible.''' Stations mapped to VM stations will always run in fullscreen mode. 
|} 
<br clear="right" /br>
[[File:VM-Guest-Additions.png|right|300px]]
<li> The next important step is to '''install Guest Additions''', if they are available for the Guest OS you have installed. </li>
* For a list of Guest operating systems, including whether or not Guest Additions are available, please go to the [https://www.virtualbox.org/wiki/Guest_OSes Virtualbox Guest OS Status page].
<li> To install Guest Additions, you must work within a running VM.  Use the VirtualBox Menu Bar and go to <tt>Devices > Install Guest Additions</tt>; see the example on the right.</li>
<li> Guest Additions will be loaded via a '''virtual CD/DVD drive'''. </li>
* Methods of accessing virtual optical drives will vary, depending on which Guest OS you are using. '''Make sure that the virtual CD/DVD drive is enabled in the VM player''' (refer to [https://www.virtualbox.org/manual/ch05.html#storage-cds VirtualBox documentation] for more information) and that '''the VM "owner" is in the <tt> cdrom </tt> user group'''.
* To install, access the CD/DVD drive, find the appropriate <tt>.exe</tt> or <tt>.sh</tt> file (depending on the OS type), and follow the on-screen prompts to complete the installation. For detailed help installing Guest Additions, please see the [https://www.virtualbox.org/manual/ch04.html#idp11154112 VirtualBox documentation].
</ol>
<br clear="right" /br>

====Creating/Exporting Virtual Appliance Files ====

[[File:Export_Virtual_Appliance.png|right|300px]]
Once a virtual machine is created and optimized, you may wish to create a virtual appliance (.ova to use as a Golden Master Image, to be deployed on several Userful systems. 
The most common file format for virtual appliances is [http://en.wikipedia.org/wiki/Open_Virtualization_Format Open Virtualization Format], which is not specific to any  system architecture. These files have an <tt>.ova</tt> format and includes VM configuration data.
To create an <tt>ova</tt> file from a Master VM:
<ol start="1">
<li> Launch VirtualBox by going to <tt>Applications > System Tools > Oracle VM VirtualBox</tt></li>
* ''Note: At any point in the following instructions, press '''F1''' to access VirtualBox help instantly.''
<li>Create an <tt>.ova</tt> file by going to  <tt>File > Export Appliance </tt> in the Oracle VirtualBox Manager. This opens the "Export Virtual Appliance" window.</li> 
<li> Select the Master VM.</li>
<li> Next, choose a filename and location for the exported appliance by clicking on the "Choose" button. </li>
* Navigate to the folder where you wish to save the appliance file, and enter a filename with the <tt>.ova</tt> extension. 
* In the example to the right, the file path is <tt>/shared-files/Win8.ova</tt>.
<li> Click "Next" to continue. </ol>
<br clear="right" /br>
[[File:OVA_Storage_Setting.png|right|300px]]
<li> A window will open showing the configuration options that are to be exported along with the virtual hard disk file.
* To change any of the configuration settings, simply double-click on the description. 
<li> Click "Export" to continue. 
* The export process will take several minutes. 
<li> Once finished, navigate to the folder where the appliance file has been saved (see image to the right)and copy that file to your removable storage media (or transfer to another system by other means). 

<br clear="all" /br>


====Transferring an OVA file to host PC====

Virtual Appliance is a virtual machine, complete with all customizations and settings (including memory allocation and network configuration). 

The most common file format for virtual appliances is <tt> Open Virtualization Format</tt>, which is not specific to any system architecture. 
An OVF package is a directory containing several files; for ease of copying and redistributing, OVF packages are often compressed with the tar utility into a single .ova file. <br>
<br>If you have an existing <tt>.ova</tt> file, it can be used quickly to create a Guest OS VM on host PC, complete with pre-configurated settings. To do so:
<br>
* Copy the .ova file using any storage medium (e.g. USB keys) from any desktop environment to your host PC (under '''"/shared-files"''' directory). Alternatively, you can transfer files through ssh or another mechanism that you are familiar with. For information on accessing storage medium, visit [[Manuals/Removable_Storage_and_Optical_Drives]].
<br>
Once finished, next step is to [[#Importing Master VM Image |import Master VM]] from an ova file.


{|{{Notes}}
|
'''Please Note: Before using an <tt>.ova</tt> file for creating Master VM image, please ensure Guest Additions are installed as supported by Guest OS. For the complete list of OS and supported guest additions, visit https://www.virtualbox.org/wiki/Guest_OSes'''
|}
<br clear="all"/>

====Importing Master VM Image====
[[Image:Control_Center_VM.png |right|400px| thumb|Importing an ova file]]
To import a Master VM from an ova file:
* Ensure .ova file exists in '''/shared-files''' directory. If not, copy .ova file in '''/shared-files''' directory of the host PC
* Open Control Center > Virtual Machines 
* Click “Import VM image” button and wait for few seconds 
* Click “Ready to Import” button next to (.ova) file to create the master image. This process takes some time
* Once finished, Master VM Image  will be listed under <tt> Control Center > Virtual Machines > Master Virtual Machines Summary </tt> and is ready for use through '''<tt>[[ Manuals/Station_Mapping/Virtual_Machine#Station_Mapping:_Creating_a_Virtual_Machine_Session_Container|Control Center > Station Mapping]]</tt>'''.
<br>

<br clear="all"/>
<br>
<br>

==Saving and Exporting VMs==

===Saving and Copying Virtual Hard Disk Files(VDI file)===
It can be very time-consuming to create Master Images on each system manually, by installing from media. Fortunately, VM players allow users to create VMs much more quickly by using an existing virtual machine as a template. 
Virtual machine "templates" can be either: 
* VM player-specific; that is, a file type that is created by a specific VM player and is compatible only with that player. 
:* If using Oracle VirtualBox, the "virtual hard drive" file has a .vdi extension. 
:* When installing new Master VM Images from a .vdi file, some configuration will still need to be done on the target system. 
* VM-player neutral; that is, in a virtual appliance format that can be exported and/or imported from many VM players. 
:* The most common file format for virtual appliances is Open Virtualization Format, which is not specific to any VM player or system architecture. These files have a .ova format. 
:* When installing new Master VM Images from a .ova file, configuration data is also imported. 

====Saving and Copying Virtual Hard Disk Files to Use as Golden Master Images====

[[File:VM-VDI-File-Location.png|right|300px]]

Once a virtual machine is created and optimized, you may wish to use the VM's virtual hard disk file (.vdi as a Golden Master Image, to be deployed on several Userful systems. 

To do so: <br>
1. First, ensure you have a removable storage medium (such as a CD/DVD or USB flash drive) with enough capacity to save the <tt>.vdi</tt> file. <br>
:: Alternatively, you can transfer files through ssh or another mechanism that you are familiar with. 
2. Next, find the <tt>.vdi</tt> file. Unless you have specified a different directory for VM storage, the virtual hard drive file will be in the directory that the VM player creates. <br>
:: With Oracle VirtualBox, that directory is in the home directory of the user who "owns" the VMs. Typically the file path is: /home/<VM-Owner>/VirtualBox VMs/<Guest-OS-Name>/ 
3. Locate the file with the <tt>.vdi</tt> extension. <br>
4. Copy that file onto your removable storage media.


{{forcewhitespace}}
[[Category:Manuals]]
[[Category:Station Mapping]]
[[Category:Userful Multiplatform]]