Frequent Errors

Frequent User‑Side Mac Agent Errors

Agent not starting

** Cause: LaunchDaemon not loaded or plist missing.

** Solution: Run

sudo launchctl list | grep com.mac.agent

** If not present, reload with:

** sudo launchctl bootstrap system /Library/LaunchDaemons/com.mac.agent.plist

Logs not found

** Cause: Agent hasn’t generated output yet, or log files were deleted.

** Solution: Restart the agent and check /tmp/macagent.out and /Library/Logs/MacAgent.

Data not showing in portal

** Cause: Agent running but unable to send data (network/firewall issue).

** Solution: Verify internet connectivity and ensure portal endpoints are reachable.

Duplicate agent installation

** Cause: Agent installed multiple times, causing conflicts.

** Solution: Uninstall old agent completely, then reinstall once.

High CPU or memory usage

** Cause: Agent stuck in a loop or processing large inventory.

** Solution: Restart the agent service; if issue persists, reinstall.

Uninstallation incomplete

** Cause: Some files remain after uninstall commands.

** Solution: Manually check /usr/local/bin and /Library/LaunchDaemons for leftover files and remove them.

We are continuously improving our documentation to ensure it meets your needs. This document will be updated regularly, so please check back for the latest information. If you have any questions or encounter any issues, feel free to reach out to us at support@itassetmanagement.in.