Page History

...

After the framework changes as mentioned in [1], It is easier to add support for non-US keyboard for console proxy. To do so one has to just add the mappings for their locale keyboard in one designated file.

How to propagate changes to CPVM

To get these changes take effect in CPVM, one has to stop the console proxy, so that modified files gets copied to CPVM when they are started again by CloudStack.

Glossary:

RAW keyboard

    Primarily translates KeyDown/KeyUp event, either as is (if there is no mapping entry) or through mapped result.
    For KeyPress event, it translates it only if there exist a mapping entry in jsX11KeysymMap map and the entry meets the condition 

...

               }

           }

]

Here KEYBOARD_TYPE_SC is constant "sc" as defined above.

After creating index its time to add the conditional map entries into X11 and keyPress array. It will depend on your keyboard in which you want to put your conditional entries.

Conditional map entries looks likecan be of two types

Type 1 (entry is numeric code)

{keycode: 34,      entry: 0x40,   guestos: "windows"},

{keycode: 160,  entry : 0x5e,  guestos: "windows",    browser: "Firefox"},

Here keycode is input keycode and entry is output which will determine the key shown on VM console. This entry will only applied if it matches condition which are mentioned next to it.

Here in first entry condition is guestos: "windows" i.e. match only if guestos is windows while in second conditional map entry one more condition is added that match only if guestos is windows and browser is firefox. 

Conditional mapping entries can be defined on the conditions which are mentioned in glossary conditional mapping entry.

How to identify input keycode and output keycode

To find input keycode open the console logger. It can be opened by clicking big green button on top right of console. 

Press the input and see what keycode are generated. There will be three different kind of events will be generated KEY-UP, KEY-DOWN and KEY-PRESS.

Take a note of code and try to find the corresponding  output code from this. Finding output code is sometimes a big task as it could be dependent on various parameters. 

entry is numeric code. If entry doesn't match the conditions then default handling will be done. 

Type 2 (entry is of array type)

{keycode: 43, entry: [
                      {type: KEY_DOWN, code: X11_KEY_SHIFT, modifiers: 0, shift: false },
                      {type: KEY_DOWN, code: X11_KEY_ADD, modifiers: 0, shift: false },
                      {type: KEY_UP, code: X11_KEY_ADD, modifiers: 0, shift: false },
                      {type: KEY_UP, code: X11_KEY_SHIFT, modifiers: 0, shift: false },
                      {type: KEY_DOWN, code: X11_KEY_ADD, modifiers: 0, shift: true },
                      {type: KEY_UP, code: X11_KEY_ADD, modifiers: 0, shift: true },
                      ]
}

Here entry is array of entries. Each entry states the conditions on which it will match and the code to which it will match. If one specifying entry in this format then he/she has to specify entry for all the possible combinations. By possible combiations it means that entries should be able to find mapping. If they are not able to identify mapping then no event will be sent. So If you are specifying browser in one condition then you have to specify entries for all browsers. 

Here keycode is input keycode and entry is output which will determine the key shown on VM console. This entry will only applied if it matches condition which are mentioned next to it.

Here in first entry condition is guestos: "windows" i.e. match only if guestos is windows while in second conditional map entry one more condition is added that match only if guestos is windows and browser is firefox. 

Conditional mapping entries can be defined on the conditions which are mentioned in glossary conditional mapping entry.

We should normally be using only Type 1 entries but in some exceptional cases Type 2 entries can also be used. Type 2 entries can be used if one want different code KEY_DOWN and KEY_UP for keycode.

How to identify input keycode and output keycode (Taken from FS)

If you don't want to go into details then go directly to section Key type events though it will be a good idea to get some understanding.

The journey of a key

When a key is pressed on the user keyboard, before it reaches its destination and displays a key output on the user VM, it passes through the browser the client uses, the client OS, the console proxy, the server side hypervisor, host OS, and displays a key on the VM. Even when console proxy does the key translation correctly according to the standard and keyboard layout, any component in this path can change the key translation, hence it can make the key output at the end user VM incorrect. 

Each component, for example, the OS, usually has its own key translation mechanism. With all the components’ own key translation involved, it adds complication to the console proxy key translation. In the end, the correct key translation for the console proxy is to make the correct key gets displayed at the end user VM.

For each different language keyboard, the main engine to be changed is the keyboard key translation rules and tables. There are ten parameters affecting which keyboard translation table to deploy. Five parameters are on server side, which include server OS, hypervisor, and keyboard. Server can obtain this information from the ManagementServer (MS) in Cloudstack. 

Parameters on server side: 

1. s_os: OS type for VM, such as Windows, Linux (Rhel, Centos, …)
2. s_osVersion: os version;
3. s_hypervisor: hypervisor type, such as Vmware, Xen, LVM, Hyper
4. s_hypVersion: version;
5. s_keyb: VM keyboard, such as English keyboard(EN), Japanese, …

There are five parameters on client side:

1. c_os: client OS type, such as Windows, Linux ...
2. c_osVersion: OS version;
3. c_browser: IE(IE can have different versions too, IE8, IE9, etc); Firefox, Chrome, Safari
4. c_browserVersion: browser version;
5. c_keyb: client keyboard, English keyboard(EN), Japanese(jp), ….
   Based on the different combination of the parameters on the server side and the client side, each combination corresponds to one keyboard mapping table.

Console proxy language keyboard translation

At present, if anyone needs to add a new keyboard support for a language, he needs to spend time understanding the console proxy code and the various key translation logic and rules. Then he can modify a javasript file to add the new language key translation table. However, since this javascript file contains complex logic and rules used for other languages, any change to this file needs to be thought out carefully, otherwise it can cause regression and made some existing keys fail. 

To make this process easier, we refactor the console proxy code for keyboard support. Our goal is to save users and developers time to understand the code path, and limit the scope of change as much as possible. Hence it can reduce the possibility of regression and testing time. After the refactor, the majority of keyboard translation rules and logic stay in a file which the users will not need to understand fully and make modifications. Users only need to modify a small table, which has direct input and output mapping, This small file to be modified handles some special keys for the special language keyboard. 

For special keyboard such as Japanese keyboard, it is required that the hypervisor, host OS and browser also need to deploy Japanese version. 
Even though the console proxy does the translation we expect, the final result at the end may not display the correct key, because of the other components and their own key translations along the way. Hence, all we need to find at the console proxy level is to get the input key translated to a value that eventually display the proper key at the user VM terminal.

What is input and output key codes
Ajaxviewer.js is a javascript file handles all the keys translations. We refer to this translation ‘T’. 

There are two codes users need to be aware of and work with:
Input_keycode: this is the keycode when user presses a key, before any translation. It is related to the key’s physical location on the keyboard;

Output_keycode: this is the keycode sent out by console proxy, to display the correct key on the VM, after all the translations;

T(input_keycode) = output_keycode; 

For example, a general ASCII letter a, we may have T(97) = 97; – when the key for ‘a’ is pressed, the input code is 97; when output keycode is 97, letter ‘a’ is displayed on user VM;

 Key type events 
There are two types of key events: key down/key up, and key press. 

There are two main translation schemes: X11 key system and non-X11 key systems. For X11 key system, the translation follows the X11 keys. It handles the key down/key up events, and skip the key press event. For example, a translation for CapsLock key may be like this (we use X11_ prefix to denote the X11 key):

T(KEY_CAPSLOCK) = X11_KEY_CAPSLOCK 

For non-X11 key system, it does not use the standard X11 key code. It mainly handles the key press event. We build a translation table to handle the majority of the keys for non-X11. 

For the majority of the keys, the logic and rules are set up in ajaxviewer.js. Users do not normally need to modify this file, unless there is a need to change or add any rule there. Users for a special keyboard support need to add entries into the table in ajaxkeys.js. This is a table to handle the special keys which are not covered by the rules and tables in ajaxviewer.js. The rules in ajaxviewer.js handles the default key translation and covers the common keys on the keyboard. It has rules for the special keys. It treats the special keys in a conditional mapping table. For each special keyboard, users just add the entries in the conditional event mapping table in ajaxkeys.js. 

Algorithm for the X11 type of keys:
Step 1: if entry exists in the jsX11KeysymMap table in ajaxviewer.js, translate that key to a corresponding X11_key in that table using key down/key up event;
Step 2: if the condition matches, translate the keys in the conditional map table with jsX11KeysymMap;

For non-X11 type of keys: it handles only the keyPress events; 
Step 1: for every keyPress event, do the key translation;
Step 2: shall only handles key down/up event if all the conditions are true for a special key in the conditional mapping table. 

The conditional mapping table is in a separate file ajaxkeys.js, it has the format for each conditional entry:

    guestosDisplayName: <guest os display name condition>  -- matches on specific version of guest os
                      provide the guest os display name substring to uniquely identify version
                      for example if guestosDisplayName CentOS 5.2 (32-bit), then to match this condition
                      give unique substring to identify like 5.2 or CentOS 5.2 etc.
    hypervisor: <hypervisor match condition>   --match on hypervisor
    hypervisorVersion: <hypervisor version match condition>    --match on hypervisor version

For example a match for a particular browser can be like this:

Browser, type and guestos all have string type.

Where should key entry go

If key is printable (can be seen after typing in document like ascii characters) then it should go in keyPress map. For prinatble keys we are guaranteed of keyPress event. One can verify whether keyPress event is generated using sites available online. One such site is http://unixpapa.com/js/testkey.html. All other keys except printable should go in X11 keys.

Find the input_keycode and output_keycode for a particular key

The new translation table in ajaxkeys.js handles the conditional mappings for some special keys. It implements the “T” function: T(input_keycode) = output_keycode. 

When a key is pressed, we need to know its input_keycode, so that we can find out if it already has an entry in the table. If it has an entry in the table, but the output is not correct, we need to modify or add a conditional entry to match the current browser and os conditions. If there is no existing entry for this key, we need to add a new entry in the table. So by all means, we need to know its input_keycode. 

To find out the Input_keycode, we can turn on the keyboard logger window which will show the keycode for every key pressed. “CTRL-ATL-SHIFT+SPACE” turns on the lodger or click on green circle icon on top-right corner. To have a fresh window to show the code for a new key, clear the window first, and then press a key.

However, for the value of output_keycode, it is tricky. It is more of a trial and error process. We can search the keyboard standard key document, and try various values. We can try pressing different keys and see what input_keycode  generates what output on console. Using these trials we can get the output_code of the key. 

For example:

User pressed Key "$", for this say input_keycode is 36 but on screen we are getting "&". Now user tries different key

say User pressed Key "^", and say its input_keycode is 40 but on screen we are getting "$"

so we can safely deduce from that output_keycode (If it already exists in key mapping) of "^" should be output_code of "$".

If key mapping doesn't exist then we can try putting input_keycode of "^" as output_keycode of "$"For details refer [1].

Changes to be done in ajaxviewer.js

...

CentOS 4.5 (32-bit) 
CentOS 4.6 (32-bit)    
CentOS 4.7 (32-bit)    
CentOS 4.8 (32-bit)    
CentOS 5.0 (32-bit)    
CentOS 5.0 (64-bit)    
CentOS 5.1 (32-bit)    
CentOS 5.1 (64-bit)    
CentOS 5.2 (32-bit)    
CentOS 5.2 (64-bit)    
CentOS 5.3 (32-bit)    
CentOS 5.3 (64-bit)    
CentOS 5.4 (32-bit)    
CentOS 5.4 (64-bit)    
Debian GNU/Linux 5.0 (64-bit)  
Oracle Enterprise Linux 5.0 (32-bit)
Oracle Enterprise Linux 5.0 (64-bit)
Oracle Enterprise Linux 5.1 (32-bit)
Oracle Enterprise Linux 5.1 (64-bit)
Oracle Enterprise Linux 5.2 (32-bit)
Oracle Enterprise Linux 5.2 (64-bit)
Oracle Enterprise Linux 5.3 (32-bit)
Oracle Enterprise Linux 5.3 (64-bit)
Oracle Enterprise Linux 5.4 (32-bit)
Oracle Enterprise Linux 5.4 (64-bit)
Oracle
Red Hat Enterprise Linux 4.5.3 (32-bit)
OracleRed Hat Enterprise Linux 54.36 (6432-bit)
OracleRed Hat Enterprise Linux 54.47 (32-bit)
OracleRed Hat Enterprise Linux 54.48 (6432-bit)
Red Hat Enterprise Linux 45.50 (32-bit)
Red Hat Enterprise Linux 45.60 (3264-bit)
Red Hat Enterprise Linux 45.71 (32-bit)
Red Hat Enterprise Linux 45.81 (3264-bit)
Red Hat Enterprise Linux 5.02 (32-bit)
Red Hat Enterprise Linux 5.02 (64-bit)
Red Hat Enterprise Linux 5.13 (32-bit)
Red Hat Enterprise Linux 5.13 (64-bit)
Red Hat Enterprise Linux 5.24 (32-bit)
Red Hat Enterprise Linux 5.24 (64-bit)
SUSE Linux Enterprise Server 9 SP4 (32-bit)    
RedSUSE HatLinux Enterprise Server Linux10 5.3SP1 (32-bit)
RedSUSE HatLinux Enterprise Server Linux10 5.3SP1 (64-bit)
RedSUSE HatLinux Enterprise Server Linux10 5.4SP2 (32-bit)
RedSUSE HatLinux Enterprise Server Linux10 5.4SP2 (64-bit)
SUSE Linux Enterprise Server 910 SP4SP3 (3264-bit)    
SUSE Linux Enterprise Server 1011 SP1 (32-bit)   
SUSE Linux Enterprise Server 10 SP1 (64 11 (64-bit)   
Windows 7 (32-bit) 
SUSE Linux EnterpriseWindows 7 (64-bit) 
Windows Server 102003 SP2Enterprise Edition(32-bit)
SUSE LinuxWindows Enterprise Server 102003 SP2Enterprise Edition(64-bit)
SUSEWindows Server Linux Enterprise2008 (32-bit)
Windows Server 102008 SP3 (64-bit)
SUSEWindows LinuxServer Enterprise2008 ServerR2 11 (3264-bit)    
SUSEWindows Linux Enterprise2000 Server 11SP4 (6432-bit)   
Windows 7Vista (32-bit) 
Windows 7XP SP2 (6432-bit) 
Windows ServerXP 2003 EnterpriseSP3 Edition(32-bit)
WindowsOther Server 2003 Enterprise Edition(64Ubuntu (32-bit)
Other (32-bit)
Windows 2000 Server 2008 (32-bit)
Windows Server 2008 (64
Windows 98
Windows 95
Windows NT 4
Windows 3.1 
Red Hat Enterprise Linux 3(32-bit)
WindowsRed ServerHat 2008Enterprise R2Linux 3(64-bit)    
WindowsOpen 2000Enterprise Server
Asianux SP4 3(32-bit)  
WindowsAsianux Vista 3(3264-bit)  
WindowsDebian XP SP2 (32GNU/Linux 5(64-bit)
WindowsDebian XP SP3 GNU/Linux 4(32-bit)
OtherDebian UbuntuGNU/Linux 4(3264-bit)
Other 2.6x Linux (32-bit)
Windows 2000 Server
Windows 98
Windows 95
Windows NT 4
Windows 3Other 2.6x Linux (64-bit)
Novell Netware 6.x 
Novell Netware 5.1 
Red Hat Enterprise Linux 3(32Sun Solaris 10(32-bit) 
Sun Solaris 10(64-bit)
Red Hat Enterprise Linux 3(64-bit)
Open Enterprise Server
Asianux 3 
Sun Solaris 9(Experimental)    
Sun Solaris 8(Experimental)    
FreeBSD (32-bit)   
AsianuxFreeBSD 3(64-bit)   
DebianSCO GNU/Linux 5(64-bit)
Debian GNU/Linux 4OpenServer 5 
SCO UnixWare 7 
Windows Server 2003 DataCenter Edition(32-bit)
Debian GNU/Linux 4Windows Server 2003 DataCenter Edition(64-bit)
Other 2.6x Linux Windows Server 2003 Standard Edition(32-bit)
Other 2.6x Linux Windows Server 2003 Standard Edition(64-bit)
Novell Netware 6.x 
Novell Netware 5.1 
Sun Solaris 10
Windows Server 2003 Web Edition    
Microsoft Small Bussiness Server 2003
Windows XP (32-bit)    
SunWindows SolarisXP 10(64-bit) 
Sun Solaris 9(Experimental) 
Windows 2000 Advanced 
SunServer Solaris 8(Experimental) 
SUSE Linux Enterprise 
FreeBSD 8(32-bit)    
FreeBSDSUSE Linux Enterprise 8(64-bit)    
SCOOther OpenServer 5 
SCO UnixWare 7 
Windows Server 2003 DataCenter Edition(32-bit)
Windows Server 2003 DataCenter EditionLinux (32-bit)   
Other Linux (64-bit)   
Other Ubuntu (64-bit)  
Windows ServerVista 2003 Standard Edition(3264-bit) 
WindowsDOS  Server 2003 Standard
Other Edition(64-bit) 
OS/2
Windows Server2000 2003Professional Web Edition
Red Hat Enterprise Linux 4(64-bi
MicrosoftSUSE SmallLinux Bussiness Server 2003
Windows XP Enterprise 9(32-bit)    
WindowsSUSE Linux XPEnterprise 9(64-bit)    
WindowsSUSE 2000Linux Advanced Server   Enterprise 10(32-bit)
SUSE Linux Enterprise 8 10(64-bit)
CentOS 5.5 (32-bit)    
SUSECentOS Linux Enterprise 85.5 (64-bit)    
OtherRed Hat Enterprise Linux 5.5 (32-bit)   
Other
Red Hat Enterprise Linux 5.5 (64-bit)  
Fedora 13
Fedora 12
Fedora 
Other Ubuntu (6411
Fedora 10
Fedora 9
Fedora 8
Ubuntu 10.04 (32-bit)  
WindowsUbuntu Vista9.10 (6432-bit) 
DOS    
OtherUbuntu 9.04 (6432-bit) 
OS/2
Windows 2000 Professional  
Red Hat Enterprise Linux 4(64-bi
SUSE Linux Enterprise 9Ubuntu 8.10 (32-bit)
Ubuntu 8.04 (32-bit)    
SUSE Linux Enterprise 9Ubuntu 10.04 (64-bit)    
SUSEUbuntu Linux Enterprise 10(329.10 (64-bit)
SUSE Linux Enterprise 10Ubuntu 9.04 (64-bit)
CentOSUbuntu 58.510 (3264-bit)    
CentOSUbuntu 58.504 (64-bit)    
Red Hat Enterprise Linux 5.5  2 
Debian GNU/Linux 6(32-bit)  
Red Hat Enterprise Linux 5.5 Debian GNU/Linux 6(64-bit)  
FedoraOracle 13
Fedora 12
Fedora 11
Fedora 10
Fedora 9
Fedora 8
Ubuntu 10.04Enterprise Linux 5.5 (32-bit)
Ubuntu  9.10 (32-bit)
UbuntuOracle 9.04 (32-bit)
Ubuntu 8.10 (32Enterprise Linux 5.5 (64-bit)
Ubuntu 8.04   
Red Hat Enterprise Linux 6.0 (32-bit)
Ubuntu 10.04  
Red Hat Enterprise Linux 6.0 (64-bit)
Ubuntu 9.10 (64  
None   
Other PV (32-bit)  
UbuntuOther 9.04PV (64-bit)  
UbuntuCentOS 85.106 (6432-bit)    
UbuntuCentOS 85.046 (64-bit)
Red Hat Enterprise Linux 2 
Debian GNU/Linux 6CentOS 6.0 (32-bit)    
Debian GNU/Linux 6CentOS 6.0 (64-bit)    
Oracle Enterprise Linux 5.56 (32-bit)   
Oracle Enterprise Linux 5.56 (64-bit)   
Red Hat
Oracle Enterprise Linux 6.0 (32-bit)  
RedOracle Hat Enterprise Linux 6.0 (64-bit)  
NoneRed Hat Enterprise 
Other PVLinux 5.6 (32-bit)
Red Hat Enterprise 
Other PVLinux 5.6 (64-bit)
SUSE  
CentOS 5.6Linux Enterprise Server 10 SP3 (32-bit)
SUSE Linux Enterprise Server 
CentOS 5.610 SP4 (64-bit)
SUSE Linux Enterprise Server 
CentOS 6.010 SP4 (32-bit)
SUSE Linux Enterprise Server 
CentOS 6.011 SP1 (64-bit)
SUSE Linux Enterprise Server 
Oracle11 Enterprise Linux 5.6SP1 (32-bit)
Ubuntu 10.10 (32-bit)
Oracle Enterprise Linux 5.6Ubuntu 10.10 (64-bit)
OracleSun EnterpriseSolaris Linux11 6.0 (3264-bit)    
OracleSun Enterprise Linux 6.0Solaris 11 (6432-bit)    
RedWindows Hat Enterprise LinuxPV 
CentOS 5.67 (32-bit)
Red  Hat Enterprise Linux
CentOS 5.67 (64-bit)
SUSE Linux Enterprise Server 10 SP3
Ubuntu 12.04 (32-bit)
SUSE Linux Enterprise Server 10 SP4 Ubuntu 12.04 (64-bit)
SUSEWindows Linux Enterprise Server 10 SP4 (328 (32-bit) 
Windows 8 (64-bit) 
SUSE LinuxWindows Enterprise Server 112012 SP1 (64-bit)
SUSE  Linux Enterprise
Windows Server 112012 SP1R2 (3264-bit)    
Ubuntu 1011.1004 (32-bit))  
Ubuntu 1011.1004 (64-bit)  
Sun Solaris 11CentOS 6.3 (6432-bit)    
Sun Solaris 11CentOS 6.3 (3264-bit)    
Windows PV 
CentOS 5.78 (32-bit)    
CentOS 5.78 (64-bit)    
UbuntuCentOS 125.049 (32-bit)    
UbuntuCentOS 125.049 (64-bit)    
WindowsCentOS 86.1 (32-bit)    
WindowsCentOS 86.1 (64-bit)    
WindowsCentOS Server6.2 2012 (6432-bit)    
Windows Server 2012 R2CentOS 6.2 (64-bit)    
UbuntuCentOS 116.044 (32-bit)    
UbuntuCentOS 116.044 (64-bit)    
CentOS 6.3 Debian GNU/Linux 7(32-bit) 
Debian GNU/Linux 7(64-bit) 
CentOS 6.3SUSE Linux Enterprise Server 11 SP2 (64-bit)   
SUSE  
CentOS 5.8Linux Enterprise Server 11 SP2 (32-bit)   
SUSE Linux Enterprise Server 
CentOS 5.811 SP3 (64-bit)    
CentOS 5.9 (32-bit)    
CentOS 5.9 (64SUSE Linux Enterprise Server 11 SP3 (32-bit)    
CentOS 
Red Hat Enterprise Linux 5.76.1 (32-bit)
Red Hat Enterprise Linux 
CentOS 6.15.7 (64-bit)
Red Hat Enterprise Linux 
CentOS 6.25.8 (32-bit)
Red Hat Enterprise Linux 
CentOS 6.25.8 (64-bit)
Red Hat Enterprise Linux 
CentOS 6.45.9 (32-bit)
Red Hat Enterprise Linux 
CentOS 6.45.9 (64-bit)  
Red Hat 
DebianEnterprise GNU/Linux 6.1 7(32-bit) 
Debian GNU/Linux 7
Red Hat Enterprise Linux 6.1 (64-bit) 
SUSERed LinuxHat Enterprise Server 11 SP2Linux 6.2 (6432-bit)   
SUSERed LinuxHat Enterprise Server 11 SP2Linux 6.2 (3264-bit)   
SUSERed LinuxHat Enterprise Server 11 SP3Linux 6.3 (6432-bit)   
SUSEOther Linux Enterprise Server 11 SP3 (32CentOS (32-bit)  
Other CentOS (64-bit)   
RedOther Hat EnterpriseSUSE Linux 5.7 (32-bit)
RedOther HatSUSE Enterprise Linux 5.7 (64-bit)
Red Hat Enterprise Linux 5.8 (32-bit)
Red Hat Enterprise Linux 5.8 (64-bit)
Red Hat Enterprise Linux 
Oracle Enterprise Linux 5.97 (32-bit)
Red Hat   
Oracle Enterprise Linux 5.97 (64-bit)
Red Hat   
Oracle Enterprise Linux 65.18 (32-bit)   
RedOracle Hat Enterprise Linux 65.18 (64-bit)
Red Hat   
Oracle Enterprise Linux 65.29 (32-bit)
Red Hat   
Oracle Enterprise Linux 65.29 (64-bit)   
RedOracle Hat Enterprise Linux 6.31 (32-bit)
Other CentOS (32-bit)  
Other CentOS
Oracle Enterprise Linux 6.1 (64-bit)   
OtherOracle SUSEEnterprise Linux(32-bit)
Other SUSE Linux(64 6.2 (32-bit)
Red Hat Enterprise Linux 
Red HatOracle Enterprise Linux 
Red Hat Enterprise Linux6.2 (64-bit)   
Oracle Enterprise Linux 56.73 (32-bit)   
Oracle Enterprise Linux 56.73 (64-bit)   
Oracle Enterprise Linux 56.84 (32-bit)   
Oracle Enterprise Linux 56.84 (64-bit)   
OracleApple Mac EnterpriseOS LinuxX 510.96 (32-bit)   
OracleApple Mac EnterpriseOS LinuxX 510.96 (64-bit)   
OracleApple Mac EnterpriseOS LinuxX 610.17 (32-bit)   
OracleApple Mac EnterpriseOS LinuxX 610.17 (64-bit)   
OracleFreeBSD Enterprise Linux 6.2 10 (32-bit)    
Oracle Enterprise Linux 6.2FreeBSD 10 (64-bit)    
OracleCentOS Enterprise Linux 6.35 (32-bit)    
Oracle Enterprise LinuxCentOS 6.35 (64-bit)    
OracleWindows Enterprise Linux 6.48.1 (64-bit)
Windows 8.1 (32-bit)
CentOS 5 (32-bit)  
OracleCentOS Enterprise Linux 6.4 5 (64-bit)   
AppleOracle MacEnterprise OS X 10.6Linux 5 (32-bit)   
AppleOracle MacEnterprise OS X 10.6Linux 5 (64-bit)   
AppleOracle MacEnterprise OSLinux X6 10.7 (32-bit)   
AppleOracle MacEnterprise OS X 10.7Linux 6 (64-bit) 
Red Hat Enterprise 
FreeBSDLinux 105 (32-bit)    
FreeBSD 10Red Hat Enterprise Linux 5 (64-bit)    
CentOSRed Hat Enterprise Linux 6.5 (32-bit)    
CentOSRed Hat Enterprise Linux 6.5 (64-bit)    
WindowsUbuntu 814.104 (6432-bit)
Windows 8.1 (32  
SUSE Linux Enterprise Server 12 (64-bit)
CentOSRed 5 (32-bit)  Hat Enterprise Linux 7
CentOS 5 (64-bit)  7
Oracle Linux Enterprise7 Linux
CentOS 56 (32-bit) 
Oracle Enterprise Linux 5CentOS 6 (64-bit) 
Oracle Enterprise Linux 6.5 (32-bit)   
Oracle Enterprise Linux 6.5 (64-bit)   
Red Hat Enterprise Linux 6.5 (32-bit)    
Red Hat Enterprise Linux 6.5 (64-bit)  
Ubuntu 14.04 
Red Hat Enterprise Linux 6 (32-bit)    
Red Hat Enterprise Linux 6 (64-bit)    
Ubuntu 14.04 (32-bit)  
SUSE Linux Enterprise Server 12 (64-bit)
Red Hat Enterprise Linux 7
CentOS 7
Oracle Linux 7 
CentOS 6 (32-bit)
CentOS 6 (64-bit)
Oracle Enterprise Linux 6.5 (32-bit)   
Oracle Enterprise Linux 6.5 (64-bit)   
Red Hat Enterprise Linux 6.5 (32-bit)  
Red Hat Enterprise Linux 6.5 (64-bit)  
Ubuntu 14.04 (64-bit)
CoreOS (64-bit)
CoreOS 

Possible Values of hypervisor and hypervisorVersion

These values are taken from hypervisor_type and hypervisor_version column of  hypervisor_capabilities table in cloud DB. Refer this table for latest possible values.

default

XCP 1.0

5.6

5.6 FP1

5.6 SP2

6.0

6.0.2

6.1.0

6.2.0

6.5.0

default 

4.0

4.1

5.0

5.1

5.5

default 

default

2.3

default

6.2

3.2

3.3