VMware vCloud Director Host vCDNI Statistics Utility

After reading a colleagues (Kamau Wanguhu) blog article on vCD Network Isolation today I found out about a tool included with the VMware vCloud Director agent installed on ESX/ESXi Hosts. This is a really easy way to look at configuration and statistics for vCD Network Isolation configured on that host.

Kamau’s article tells us the following about the tool

To get per host vCDNI statistics use:

/opt/vmware/vslad/fence-util

The utility can be used to display:

• Configured Networks and there MTU settings
• Acitve Ports and there port IDs
• Switch State including inside and outside MAC addresses
• Port Statistics on a port ID basis

When running the command with no options, this provides the help for the utility:

~ # /opt/vmware/vslad/fence-util
vsla-fence log at Thu Mar 24 09:09:54 2011
fence-util [options] command [arguments [arguments]]
-h This help message.
-v Turn on verbose mode
-q Turn on quiet mode
-r Reset statistics after executing command.
info Show module and port information.
moduleInfo Show module information.
portInfo [] Show port information of all ports or a specific port if a portId is specified.
portCount Show number of active non-relay ports.
setHosKey Set the module’s hostKey (in decimal).
clearBridge Clear learnt bridge table entries.
setLanMtu Set the MTU of a LAN segment.
resetStats Reset statistics.
setSwitchMode <0/1> Set the switch mode to unicast (0) or broadcast (1).
setRelay<0/1> Connect (1) or disconnect (0) relay for unicast on a portset and LAN.
setLogLevel Set the module’s log level. Applies only to obj modules.
moduleRelease Release resources used by a module but still keep it resident.

Lets say we want to look at the configured MTU settings, using the option moduleinfo

~ # /opt/vmware/vslad/fence-util moduleinfo
vsla-fence log at Thu Mar 24 09:17:37 2011
Log Level:0
Module Parameters:
HostKey: 0x10010
Configured LAN MTUs:
+——————————————————————————————+
| LAN ID | 1 2 3 4 5 6 7 8 9 10 – – – – – – |
| MTU | 1500 1500 1500 1500 1500 1500 1500 1500 1500 1500 – – – – – – |
+——————————————————————————————+
Active Ports:
+—————————————–+
| ID | OPI | LanID | MTU |
+—————————————–+
| 3000002 | 00,fffffe | 1 | 1500 |
+—————————————–+

You may notice that the MTU is set at 1500. We need to change this to 1524 as per the VMware best practices for using vCDNI. We can do this using the setLanMtu option:

~ # /opt/vmware/vslad/fence-util setLanMtu 1 1524
vsla-fence log at Thu Mar 24 09:20:13 2011

If we run the command with the moduleinfo option again, we can see that the MTU has changed to 1524.

~ # /opt/vmware/vslad/fence-util moduleinfo
vsla-fence log at Thu Mar 24 09:20:19 2011
Log Level:0
Module Parameters:
HostKey: 0x10010
Configured LAN MTUs:
+——————————————————————————————+
| LAN ID | 1 2 3 4 5 6 7 8 9 10 – – – – – – |
| MTU | 1524 1500 1500 1500 1500 1500 1500 1500 1500 1500 – – – – – – |
+——————————————————————————————+
Active Ports:
+—————————————–+
| ID | OPI | LanID | MTU |
+—————————————–+
| 3000002 | 00,fffffe | 1 | 1524 |
+—————————————–+