When troubleshooting OS-Assisted Migration (OSAM) issues in HCX, enabling debug logging provides detailed insights into the migration process. Debug logs are essential for
Standard logging levels does not always provide sufficient detail for advanced troubleshooting of OSAM-related issues. Debug-level logging must be enabled across multiple HCX components to capture comprehensive diagnostic information.
1. HCX Manager Debug Logging (Connector and Cloud)
<logger name="com.vmware.vchs.hybridity.service.migration" additivity="false" level="DEBUG">
<appender-ref ref="APP_FILE"/>
<appender-ref ref="SYSLOG"/>
</logger>
<logger name="com.vmware.vchs.hybridity.service.os_assisted_replication" additivity="false" level="DEBUG">
<appender-ref ref="APP_FILE"/>
<appender-ref ref="SYSLOG"/>
</logger>
<logger name="com.vmware.vchs.hybridity.service.sentinelinventory" additivity="false" level="DEBUG">
<appender-ref ref="APP_FILE"/>
<appender-ref ref="SYSLOG"/>
</logger>
<logger name="com.vmware.vchs.hybridity.adapter.sentinelgateway" additivity="false" level="DEBUG">
<appender-ref ref="APP_FILE"/>
<appender-ref ref="SYSLOG"/>
</logger>
<logger name="com.vmware.vchs.hybridity.adapter.sentineldatareceiver" additivity="false" level="DEBUG">
<appender-ref ref="APP_FILE"/>
<appender-ref ref="SYSLOG"/>
</logger>
:w!
in visudo systemctl restart app-engine
3. HCX Sentinel Data Receiver Debug Logging
SSH to HCX Cloud Manager: ssh admin@<hcx-cloud-manager-ip>
Locate SDR appliance: ccli list go <sdr-id> ssh
Edit: sudo vi /etc/systemd/journald.conf
Set: MaxLevelSyslog=debug
Restart service: sudo systemctl restart systemd-journald
Edit: sudo vi /opt/vmware/sdr/config/sdrd.conf
{
"loglevel": "debug"
}
sudo systemctl restart sdrd
After completing troubleshooting, follow these steps to revert debug logging:
1. Revert HCX Manager Logging
Connect via SSH to the HCX Manager: ssh admin@<hcx-manager-ip>
Edit the configuration file: sudo vi /opt/vmware/config/app-logback.xml
Save the file using :w!
in vi
Restart the service: sudo systemctl restart app-engine
2. Revert SDR Logging
SSH to HCX Cloud Manager: ssh admin@<hcx-cloud-manager-ip>
Access SDR: ccli list go <sdr-id> ssh
Edit: sudo vi /etc/systemd/journald.conf
Change: MaxLevelSyslog=debug
to MaxLevelSyslog=info
Restart service: sudo systemctl restart systemd-journald
Edit: sudo vi /opt/vmware/sdr/config/sdrd.conf
{
"loglevel": "info"
}
Restart service: sudo systemctl restart sdrd
If issues persist after enabling debug logging, contact Broadcom Support with the following information
Sub-Components for Debug Logging
Component | Location | Purpose |
---|---|---|
service.migration |
Both HCX-Connector and HCX-Cloud | Debugging OSAM migration-related issues |
service.os_assisted_replication |
Both HCX-Connector and HCX-Cloud | Debugging OSAM replication-related issues |
service.sentinelinventory |
HCX-Connector only | Debugging Sentinel Inventory service |
adapter.sentinelgateway |
HCX-Connector only | Debugging communication between HCX-Connector and SGW |
sentineldatareceiver |
HCX-Cloud only | Debugging communication between HCX-Cloud and SDR |