diff --git a/etc/nsx.ini b/etc/nsx.ini
index 5e07b0e7ea..39c74c7634 100644
--- a/etc/nsx.ini
+++ b/etc/nsx.ini
@@ -66,34 +66,34 @@
 # is ignored if "ca_file" is set.
 # insecure = true
 
-# (Required) Datacenter ID for Edge deployment
+# (Required) Datacenter MoRef ID for Edge deployment
 # datacenter_moid =
 
-# (Required) Cluster IDs for clusters containing OpenStack hosts
+# (Required) Cluster MoRef IDs for OpenStack compute clusters, comma separated
 # cluster_moid =
 
-# (Optional) Deployment Container ID for NSX Edge deployment
+# (Optional) Deployment Container MoRef ID for NSX Edge deployment
 # If not specified, either a default global container will be used, or
 # the resource pool and datastore specified below will be used
 # deployment_container_id =
 
-# (Optional) Resource pool ID for NSX Edge deployment
+# (Optional) Resource pool MoRef ID for NSX Edge deployment
 # resource_pool_id =
 
-# (Optional) Datastore ID for NSX Edge deployment
+# (Optional) Datastore MoRef ID for NSX Edge deployment
 # datastore_id =
 
-# (Required) UUID of logic switch for physical network connectivity
+# (Required) Portgroup MoRef ID for Edge physical network connectivity
 # external_network =
 
 # (Optional) Asynchronous task status check interval
 # default is 2000 (millisecond)
 # task_status_check_interval = 2000
 
-# (Optional) Network scope ID for VXLAN virtual wires
+# (Optional) Transport Zone MoRef ID for VXLAN logical networks
 # vdn_scope_id =
 
-# (Optional) DVS ID for VLANS
+# (Optional) DVS MoRef ID for DVS connected to Management / Edge cluster
 # dvs_id =
 
 # (ListOpt) Define backup edge pool's management range with the four-tuple:
@@ -112,10 +112,10 @@
 # Maximum number of API retries
 # retries = 10
 
-# (Optional) Network ID for management network connectivity
+# (Optional) Portgroup MoRef ID for metadata proxy management network
 # mgt_net_moid =
 
-# (Optional) Management network IP address for metadata proxy
+# (Optional) Management network IP address for metadata proxy, comma separated
 # mgt_net_proxy_ips =
 
 # (Optional) Management network netmask for metadata proxy