Troubleshooting HCX Storage Accessibility Issues
Article ID: 393972
Updated On:
Products
Issue/Introduction
When performing migrations with VMware HCX, storage accessibility errors can occur in various scenarios. These errors prevent virtual machine migrations from completing successfully and may appear as "Storage not accessible error observed" messages or as TCP 902 connection failures in diagnostic reports. This hub article provides guidance on troubleshooting common storage accessibility issues in HCX.
Common symptoms include:
- Failed migrations with "Storage not accessible error observed" errors
- TCP port 902 connectivity issues reported in Service Mesh Diagnostics
- Failures during Base Sync phase of migrations
- Error messages in IX logs referring to storage accessibility
Environment
VMware HCX
VMware ESXi
Cause
Storage accessibility issues in HCX migrations typically stem from:
- Port 902 connectivity problems between IX appliances and ESXi hosts
- Stale entries in service mesh fleet appliances
- IPv6 compatibility issues with management vmkernel adapters
Resolution
Refer to the following articles for specific troubleshooting steps based on your scenario:
HCX: Reverse Migration fails with error "Storage not accessible error observed" - Addresses storage accessibility errors during reverse migrations
HCX: Bulk Migration failure with Error "Storage not accessible error observed" - Addresses storage accessibility errors during bulk migrations
HCX Service Mesh Diagnostics Reports TCP 902 Failure to Empty Destination IP Address - Explains diagnostic reports showing TCP 902 connection failures
If the error persists after following the steps in these articles, contact Broadcom Support for further assistance.
Additional Information
Port 902 is critical for IX appliances to properly communicate with ESXi hosts for storage access during migrations. Many storage accessibility issues are related to firewall configurations blocking this communication.
To efficiently troubleshoot HCX storage accessibility issues, consider:
- Running Data-Plane Diagnostics to identify any failed probes
- Checking firewall configurations between IX appliances and ESXi hosts
- Reviewing IX appliance connectivity to source and target environments
- Upgrading to the latest HCX version which may contain fixes for known issues
Please provide the below information when opening a support request with Broadcom for this issue:
- Migration details (VM Name, Migration ID, Screenshot of error as seen via UI)
- Source and Target HCX log bundles with IX appliance selected
- Results of any diagnostic tests performed
Feedback
