Knowledge Base

The VMware Knowledge Base provides support solutions, error messages and troubleshooting guides
 
Search the VMware Knowledge Base (KB)   View by Article ID
 

Converting a snapshot file to memory dump using the vmss2core tool (2003941)

Symptoms

  • Cannot run the vmss2core tool.
  • Running the vmss2core tool fails.
  • In the command line, you see the error:

    Failed to locate memory. Memory block and no separate .vmem file supplied.

Purpose

This article provides steps to convert a snapshot file to a memory dump using vmss2core tool. Developers can use this tool to debug guest operating systems and applications by converting a virtual machine checkpoint into a core dump file. The checkpoint can either be a snapshot or suspend file. You can select a variety of core dump formats that standard debuggers understand.

Resolution

To create the memory dump if the virtual machine is installed on Workstation 7.x and above or Fusion 3.x and above.

  1. Change directory to one of these locations depending on your installation type:

    • Windows – C:\Program Files\VMware\VMware Workstation\
    • Linux – /usr/bin/
    • Mac OS – /Library/Application Support/VMware Fusion/

      Note: If vmss2core is not available in these install directories, you can download it here.

  2. Run the vmss2core tool with the option to create a memory dump.

    vmss2core -W virtual_machine_name.vmss virtual_machine_name.vmem

    Note: If you are using Microsoft Windows 8/8.1 or Windows Server 2012, run this command:

    vmss2core -W8 virtual_machine_name.vmss virutal_machine_name.vmem 

To create the memory dump if the virtual machine is on an ESX/ESXi host:

  1. Start a SSH session to the host.
  2. Run this command to determine the world ID of the virtual machine:

    vm-support -x

  3. Run this command to suspend the virtual machine:

    vm-support –Z  world_ID

    For alternative methods, see Suspending a virtual machine on ESX/ESXi to collect diagnostic information (2005831).

  4. Copy the virtual_machine_name.vmss file to the location where you have the vmss2core tool.
  5. Run the vmss2core tool with the option to create a memory dump.

    vmss2core –W virtual_machine_name.vmss

    Note: If you are using Microsoft Windows 8/8.1 or Windows Server 2012, run this command:

    vmss2core -W8 
    virtual_machine_name.vmss

Additional Information

See Also

Update History

10/08/2012 - Added command to determine the world ID 10/12/2012 - Added link to download vmss2core 03/28/2013 - Added link to article 2005831

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 5 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.
What can we do to improve this information? (4000 or fewer characters)
  • 5 Ratings
Actions
KB: