Diagnosing a Single PC Issue

If you’re experiencing a problem with your Agilicus Agent on a single PC, these are the primary diagnostic steps you can take:

1. Review Log Files:
   First, check the contents of the log files located in your agent’s logs directory. These files often contain valuable information about recent activities and errors.
   • Path: %LOCALAPPDATA%\Agilicus\Agent\logs
   • What to look for: Examine the most recent log files for any error messages, warnings, or unexpected behavior.
2. Run a Debug Refresh:
   If the log files don’t reveal the issue, you can force a client refresh with debug logging enabled. This can provide more detailed output about the agent’s operation.
   • Steps:
     1. Open a cmd (Command Prompt) window.
     2. Run the following command:
        %LOCALAPAPPDATA%\Agilicus\Agent\agilicus-agent.exe client --cfg-file %LOCALAPPDATA%\Agilicus\Agent\agent.conf.enc.yaml --client-refresh true --debug
   • Sharing Results (Optional): If you need to share the results of this debug refresh with Agilicus support, you can append the following to the command to save the output to a file:
     %LOCALAPAPPDATA%\Agilicus\Agent\agilicus-agent.exe client --cfg-file %LOCALAPPDATA%\Agilicus\Agent\agent.conf.enc.yaml --client-refresh true --debug > "%USERPROFILE%\Desktop\debug.log" 2>&1
     After running this, a file named debug.log will be created on your desktop, which you can then share.
3. Debug a Specific Launcher:
   If the previous steps don’t identify the problem, you can debug the specific launcher directly. This allows you to see any issues related to its specific command execution.
   • Steps:
     1. Locate the shortcut icon for the specific launcher you are having trouble with (e.g., on your desktop or Start Menu).
     2. Right-click the shortcut and select “Properties.”
     3. In the “Shortcut” tab, find the “Target” field. This field contains the full command line used to launch the application.
     4. Copy the entire command line from the “Target” field.
     5. Open a cmd (Command Prompt) window as your regular user (not as an administrator).
     6. Paste the copied command line into the cmd window.
     7. Append --debug to the end of the command line.
     8. Press Enter to run the command.
   • This will execute the launcher with debug logging, and any remaining issues or output will be displayed directly in the command prompt window.