Creating a VIX API SR
The following is a summary of the steps to file a VIX API SR.
-
Collect the required diagnostic files and information. This information is required to properly diagnose your VIX API issue:
-
VIX API information
-
VIX Logs
-
VMX Logs
-
ESX Data
-
-
Collecting VIX API information
All of the information needed to evaluate your support request is listed in the VIX support form.
- Download and unzip VMware VIX Support Form. See 1019561_VMware_VIX_Support_Form.zip, attached to this article.
- Complete the form, providing as much detail about your computing environment as possible. Include any log files and other information you feel might be helpful.
- Upload the completed form with your support request.
Collecting VIX logs
If you are running a separate program that uses the VIX library, it generates a VIX log.
- On Linux, VIX Logs are located at /tmp/vmware-<username>/vix-<pid>.log.
- On Windows, VIX Logs are located at %TEMP%\vmware-<username>\vix-<pid>.log
Collecting VMX logs
This VMX log file (vmware.log) is found in the same directory as the VMX file for the virtual machine that you are running.
Set the following property in configuration file in /etc/vmware/ on the ESX host:
vix.debugLevel = "9"
Collecting ESX Data
To collect ESX-related data:
-
Enable VIX debug level logging and hostd trivia level logging:
-
On each host, open the file hostd configuration file (/etc/vmware/hostd/config.xml) for editing.
-
To enable VIX debug logging, add the following to your hostd configuration file, inside the <config> element:
<vix>
<longOpts>
<vix.debugLevel>9</vix.debugLevel>
</longOpts>
<boolOpts>
<vix.LogRefcountOnFinalRelease>TRUE</vix.LogRefcountOnFinalRelease>
</boolOpts>
</vix>
-
To enable hostd trivia-level logging set the <level> tag to trivia mode. For example:
<log>
<level>trivia</level>
</log>
-
-
Run vm-support to collect logs (including the hostd logs).
Note: The hostd logs rotate when they become large, and the debug logging that you have enabled is very verbose. For this reason, it is important to collect the logs promptly after the incident. Otherwise, the logs may rotate, and you may lose the logging. As of VIX 1.11, logs rotate at 1MB and you can disable log rotation by setting vix.log.rotateSize = 0 in the hostd configuration file. However this could result in huge log files.
-
Disable debug logging when you are done.
Note: The debug logging that you have enabled is very verbose. VMware recommends that you disable it when you are done collecting support information. Reverse the changes made in step one, and restart the management services. Restarting the Management agents on an ESX or ESXi Server (1003490).