# Troubleshooting the macOS Agent

## Checking the Agent:

 Some of the actions to be carried out for troubleshooting are summarized below. Some of the actions to be carried out for troubleshooting are outlined below. 

*   **Log file location**: Please check the "`/tmp/ccmacagent`" directory for logs and temporary files for possible exceptions. 
* **Checking the agent file system**: Please check the "`/Library/Application Support/CyberCyteMacAgent`" directory for config and setting files; these files are not temporary like others.
* **Check the executable in the agent directory**: Please check the "`/usr/local/bin/ccmacagent`" directory to see if the main executable exists. 
* **Check the agent version**: Please check the agent version with this command: `/usr/local/bin/ccmacagent –version`
* **Check if the agent is running**: Please check if the agent is running or not with this command: `ps -ef | grep /usr/local/bin/ccmacagent`

## Checking the Portal:

Please check the macOS policy, the rules should be assigned like below. The users can customize the policy rules as their requirements.

<figure><img src="/files/7F9GNxQdTU6BkbomsVHa" alt=""><figcaption></figcaption></figure>

After checking the macOS policy, please check the assigned policy group. The default group is "macOS Devices Group", make sure the macOS policy are assigned to the group, if it is not the agent will not start the collection.

<figure><img src="/files/fhCSRjbdlmRSD6bWDmrX" alt=""><figcaption></figcaption></figure>

## Uninstalling Agent

For Uninstalling agent,  the below command can be executed: `usr/local/bin/ccmacagent --uninstall`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudcyte.com/troubleshooting/the-agent-troubleshooting/troubleshooting-the-macos-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.