[CLOUDSTACK-4438] Improve documentation for traffic labels configuration KVM, vSphere, and XenServer

• Type: Bug
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 4.2.0
• Component/s: Doc
• Security Level: Public (Anyone can view this level - this is the default.)
• Labels: installguide kvm networking vsphere xenserver
• Assignee: Unassigned
• Reporter: Kirk Kosinski
• Created: 22/Aug/13 06:17
• Updated: 22/Aug/13 11:20

Description

The installation guide currently has a "Physical Networking Setup for XenServer" section (see CLOUDSTACK-661). There should be corresponding sections for KVM and vSphere, and the XenServer section can use some slight improvements.

For KVM, the traffic labels defined in CloudStack should correspond to the bridge name on the hypervisor, and for vSphere the traffic labels should correspond to the vSwitch name.

For vSphere, a VLAN ID can be included for management traffic (see CLOUDSTACK-3870). There are some references to this currently but no clear explanation. The syntax is (currently) "<vSwitch_Name>,<VLAN_ID>", for example "vSwitch0,100" for vSwitch0 and VLAN ID 100. This might change if CLOUDSTACK-3398 is implemented.

Considering that vSphere supports a VLAN ID for management traffic, in the XenServer section it would be wise to explicitly state that management server traffic must not be put on a VLAN. This is explained in the XenServer documentation but is commonly misunderstood.