How to send Iguana Crash Dump

This page documents how to send a crash dump to the iNTERFACEWARE FTP server. These crash dump files can be used by our development team to diagnose and resolve issues of this nature.

Crash Dump For Windows

Retrieving Crash Dump Files

The first step is to locate the crash dump files. The following files can be found in the Iguana install directory, and all three should be included in the crash dump:

  • ServiceErrorLog.txt

  • Files with the extension *.dmp and *.mdmp

As these files can be quite large, we recommend you zip them into a single zip archive. If there are any additional file(s) you find necessary to report to us, include them in this zip archive.

Name this archive with a distinguishable name, we recommend this format:

YYYY-MM-DD[_#TicketIfKnown]_Company_Name_OriginalFileName.ext

Sending the Crash Dump Archive

The next step is to upload the archive you created to our FTP site. Sending the archive using File Explorer can be done following these steps:

  1. In the path bar of File Explorer, input the FTP connection command:

    ftp://upload@ftp.interfaceware.com/

     

    image-20240111-195317.png

 

  1. Drag and drop the archive file you created into the File Explorer window.

    image-20240111-195839.png

The archive will now appear in the file explorer window. Inform your iNTERFACEWARE representative when you have uploaded the file, and we will begin the debugging process.

Crash Dump for Mac

Retrieving Crash Dump files

In order for crash dump files to be created on a Mac machine, core dump must be enabled. This must command must run before Iguana in the same session. A guide describing how to enable core dumps can be found below.

https://help.interfaceware.com/v6/using-linuxmac-crash-dumps

As these files can be quite large, we recommend you zip them into a single zip archive. If there are any additional file(s) you find necessary to report to us, include them in this zip archive.

Name this archive with a distinguishable name, we recommend this format:

YYYY-MM-DD[_#TicketIfKnown]_Company_Name_OriginalFileName.ext

Sending the Crash Dump Archive

The next step is to upload the archive you created to our FTP site. Sending the archive using the Mac terminal can be done following these steps:

  1. Navigate to the directory where your crash dump archive is stored.
    (In the example, the crash dump is stored on the desktop)

  2. Input the following command, replacing the FileName and Password paramaters with your information.
    Password: (your full e-mail address)

    curl -T FileName.zip ftp://ftp.interfaceware.com --user upload:Password
  1. After inputting the command with your information, wait until the progress percentage reaches 100%. The file has now been uploaded to our FTP server.

    Inform your iNTERFACEWARE representative when you have uploaded the file, and we will begin the debugging process.

FTP Server Credentials

If you are using third party software to upload your archive, you may require the following credentials:

  • FTP Server: ftp.interfaceware.com

  • Username: upload

  • Password: (your full e-mail address)

Possible Errors

You may receive the following errors while uploading your archive to our FTP site. Please contact your iNTERFACEWARE representative and they can help resolve these issues.

Overwrite error when attempting to add files with the same name:

Deleting folder error when attempting to remove files already uploaded:

Reference

For more crash dump information, please reference our help page: https://help.interfaceware.com/v6/how-to-report-problems#ftp

Related pages