How to Collect the Scanning Tool / Secure Storage Debug Log

  • Updated on Sep 20, 2024
  • Published on Jun 14, 2023
  • 2 minute(s) read
Prev Next

Summary

A step-by-step guide on how to collect the Portable Inspector scanning tool / secure storage debug log on Windows and Linux platforms.

Applicable Version

Portable Inspector / Portable Inspector Pro

Details

Windows Platform

  • Enabling the Scanning Tool debug log
1. Plug-in the Portable Inspector ( Pro) Scanning Tool to the endpoint and navigate to the “PI SYS” drive.

image.png

  1. Launch the "SmallDebugTool.exe" found in the SmallDebugTool folder to collect logs.

image.png

3.The debugging wizard will start automatically. Select Scanning Tool or Secure Storage and click the Start button.

image.png

  1. Scanning tool / secure storage will start debug mode.
  2. Reproduce the issue with the scanning tool.
  3. When the issue is reproduced, select “Troubleshooting data has been collected” and click “Stop Debugging Mode”.

image.png

  1. After data is done saving, click "Transfer Data".

image.png

  1. The program will start transferring the logs to the Scanning Tool. It may take a while for the process to complete.
  2. After the debug log is collected, click “Close”.

image.png

 
  • Exporting logs from Scanning Tool

  1. Plug the Portable Inspector ( Pro) into the machine that is ready to export the debug log.

  2. Navigate to the “PISYS” drive and access the “SupportTool” folder.
    image.png

  3. Choose the directory appropriate for your environment and execute the “PISuprt.exe”.
    image.png

  4. In the Debug tab, select Load logs from the Scanning Tool and click Start.
    image.png

  5. Connect the Scanning Tool to the endpoint and click Next. The storage path of the logs are indicated.
    image.png

  6. Click Open Folder to navigate to the path. Locate and open the zip file to verify that the debug logs have been successfully generated.

image.png

 

  • If you are unable to collect debug logs by using SmallDebugTool, collect debug logs manually.
Note: This is only support for the machines that do NOT have Management Program or Scanning Tool agent installed.
  1. Launch command prompt with administrator privileges.
  2. Navigate to the PI SYS drive.
  3. Create a folder for storing log files. e.g., C:\pi_log_temp
  4. Enter the following command:
    Launcher.exe –st_debug <debug_log_target_directory>
    e.g. E:\Launcher.exe –st_debug C:\pi_log_temp
  5. The scanning tool will be launched.
  6. Reproduce the issue
  7. After the issue is reproduced, close the scanning tool program.
  8. Find the specified directory and collect the files.

image.png

 

Linux Platform

  1. Collect troubleshooting logs for issues that occur during using Protable Inspector ( Pro) for Linux scanning. Refer to the following:
    $sudo sh ./LauncherLinux.sh --debug -c scan [target folder] > /tmp/pi.log 2>&1
    $dmesg > /tmp/dmesg.log
  1. Send the following files to TXOne for further analysis
    o /tmp/pi.log
    o /tmp/dmesg.log
    o /var/log/syslog
For support assistance, please contact us at support@txone.com or your Support Provider.