Troubleshooting NSX Installation Operations
Article ID: 376813
Updated On:
Products
Issue/Introduction
When troubleshooting NSX component installation, a specific set of data must be gathered at the time of the event. This article details what documentation is required and how to gather it prior to opening a support request with Broadcom.
Environment
VMware NSX
Resolution
General Installation Instructions
Interoperability
- Be sure to check interoperability/compatibility between all components with the VMware Interoperability Matrix.
During research, it may be necessary to review component logs. Below are the log locations for various components and events:
Log locations:
NSX Manager - OVA deployment
- vCenter Server -
/var/log/vmware/vpxd/vpxd-####.log
NSX Manager - GUI deployment
NSX Manager
-
/var/log/syslog*/var/log/proton/nsxapi*/var/log/policy/nsxapi*/var/log/cm-inventory/cm-inventory*
vCenter Server
-
/var/log/vmware/vpxd/vpxd-####.log
ESXi host
NSX Manager
-
/var/log/syslog*/var/log/proton/nsxapi*/var/log/proxy/reverse-proxy*/var/log/cm-inventory/cm-inventory*
ESXI host
-
/var/log/esxupdate*/var/log/hostd*/var/log/vmkernel.log
NSX Edge OVA deployment
vCenter
-
/var/log/vmware/vpxd/vpxd-####.log
NSX Edge GUI deployment
NSX Manager
-
/var/log/syslog*
NSX Edge
-
/var/log/syslog*/var/log/core/*/var/log/nvpapi/api_server*/var/log/join_mp*
ESXi host
-
/var/log/vmkernel*
NSX Manager clustering
NSX Manager
-
/var/log/corfu/corfu.9000.log/var/log/corfu/corfu-compactor-audit*/var/log/corfu-nonconfig/corfu.9040*/var/log/corfu-nonconfig/nonconfig-corfu-compactor-audit*/var/log/proton/nsxapi*/var/log/cbm/cbm*/var/log/syslog*
Known issues with NSX Manager/Edge OVA deployment
- NON Embeded OVA Used during Embedded deployment
- Embedded OVA deprecated notice
- Unable to deploy NSX manager - Datastore: "Error in retrieving data. Refresh to try again"
Known issues with NSX Manager GUI deployment
- When reconfiguring NSX Manager node in NSX-T Data Center, Deployment fails with the Error code: 21016
- Upgrading or deploying an VMware NSX Edge node or Manager appliance from NSX manager UI fails: no alternative certificate subject name matches target host name
- Installing NSX on an ESXi host fails reporting the node already exists in NSX
- Additional NSX-T manager nodes are stuck at "VM Clustering in Progress"
Known issues with NSX Edge GUI deployment
- Edge deployment from NSX-T Manager ui fails with ‘connect timeout’ error
- NSX edge node deployment triggered from NSX Manager UI, fails with following error, "OVF certificate validation failed. Error: Error while fetching ovf file. e has expired"
- NSX-T Edge node deployment fails when Orchestrator node is shutdown/unavailable
- NSX-T Edge node failing to deploy with error "Invalid configuration for device '0'"
- Edge node fails to complete deployment in an NSX-T federation setup on NSX-T 3.2.0.x
Known issues with ESXi host installation
- NSX-T Install on a host in a vLCM enabled cluster fails with "Setting NSX depot(s) on Compute Manager"
- Preparing ESXi host with NSX-T fails with an error "Waiting for connection to Managers"
- NSX install on ESXi Transport Node fails at 48% "Waiting for Connection to Managers" due to stale NVDS reference
- NSX-T 3.2.2 ESXi host installation stuck at 0%
- Installing NSX on an ESXi host fails reporting the node already exists in NSX
- NSX-T ESXi install stuck at 0%
- NSX-T Install on a host in a vLCM enabled cluster fails with "Setting NSX depot(s) on Compute Manager"
- After NSX 4.x install/upgrade, ESXi Hosts are in a "Not Responding" state in vCenter and VMs cannot connect to their network
- NSX-T fails to install VIBs on vLCM enabled cluster
- NSX-T ESXi host shows as not installed "Host is not reachable. Cannot complete login due to an incorrect username or password"
- NSX-T VIBs fail to install/upgrade, due to insufficient space in bootbank on ESXi host
- NSX-T 3.2.2 ESXi host installation stuck at 0%
- ESXi Host goes into NSX INSTALL FAILED state with error "Node has invalid version <vib verision> of <vib name>" post upgrade of ESX host OS and NSX vibs together
Additional Information
If you are contacting Broadcom support about this issue, please provide the following:
- Record all steps necessary to recreate the error
- Record all text of any error messages
- Include timestamps of when the error was experienced
- Retrieve log bundles from all NSX components involved (NSX Managers and ESXi hosts/Edges)
Handling Log Bundles for offline review with Broadcom support
Feedback
