Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Problem

When you run into a problem with TonidoPlug, which couldn't resolved by any other workarounds, you might need to collect the debug logs from TonidoPlug and send it to support team.

Resolution

Follow these steps to collect necessary debug information for support:

You are experiencing a problem that can't be fixed by conventional solutions. The Tonido support team has asked you to send them your TonidoPlug's debug logs in order to determine what's wrong.

Solution

  1. Download the debug log collector Download the log collecter package from the following link: http://www.tonidoplug.com/packages/datacollector.zip
  2. Unzip the contents of the zip file onto an USB stick (FAT32 formatted stick preferably). Ensure that the zip directory has the following structure. <USB_Stick>\tonido\autoexe\collectLogs.sh
  3. Now plug the USB stick into TonidoPlug and wait for a minute.
  4. Copy the file you downloaded to a USB storage device and then unzip it. For best compatibility, we recommend using a USB device that uses the FAT32 file system. Browse to <Device's drive letter>\tonido\autoexe and make sure that collectLogs.sh is there.
  5. Connect the USB storage device to your TonidoPlug. Wait for about a minute.
  6. Disconnect the USB storage device. Connect it to your PC or MacRemove the USB stick from TonidoPlug and insert it into your PC or MAC.
  7. You should see a new file called "debug.tar created under <USB_Stick>" in <Device's drive letter>\tonido\autoexe\debug. tar Send that this file to the support team.

 

What Information is collected?

Here is the list of logs and informations that are collected from your TonidoPlug.

  • System logs (/var/log/messages*)
  • Tonido logs (<tonido_home>/approot/logs/*)
  • Network settings (file /etc/network/interfaces)
  • Current network card information (Output of ifconfig command)
  • Current process tree (Output of ps auxf command)
  • Current live network connections (Output of netstat -an command)
  • Free memory (Output of free -m)
  • Disk space usage (Output of du -h)
  • Mount space usage (Output of df -h)

Image Modified Warning

   Not all USB disks or sticks are compatible for this procedure to be successful. At end of the procedure, if the logs are not collected on the USB stick, please repeat the procedure with a different USB stick.

Image Removed   Please ensure to remove all the sensitive information from your log files (if you have any) before sending the collected data to support.

Some USB storage devices aren't compatible with this procedure. If you don't see "debug.tar" in in <Device's drive letter>\tonido\autoexe after following the steps above, try again with a different device.

Image Added   Remember to remove any sensitive information from the log files before you submit them.

...