---
sourceDocument: Australia IT Operations Management
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/it-operations-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# File or directory check

# File or directory check {#ariaid-title1}

Release version: Australia  
Updated September 29, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
OS-level permission requirements for the file or directory check.

## Agent Client Collector Agent OS account {#file-or-directory-check__section_llg_tbv_skc}

The Agent Client Collector agent OS account is only required if the target file or directory is owned by another service account. The Agent Client Collector agent OS account needs the following permissions:

* Read permission, and for directories, execute or traverse permission, on the target `--directory`, `--dirpath`, or `--filepath`.
* For `check-file-response-time`, read access to the contents of the file, not just metadata, because it measures read latency.
{#file-or-directory-check__ul_adl_vbv_skc}

A file or directory owned by another application, such as its own log or data directory, is frequently not world-readable. In that case, the Agent Client Collector agent account needs group membership or an ACL grant to read it.  
Configuration Prerequisites:

* Confirm the target path exists and is spelled or cased correctly. Paths are case-sensitive on Linux.
* Confirm read and execute permission on the full path, including every parent directory, not just the final file or directory. A missing execute bit on a parent directory blocks traversal even if the file itself is readable.
{#file-or-directory-check__ul_mk5_ybv_skc}  
Troubleshooting:

* A file not found result for a file that exists means a missing execute bit on a parent directory rather than a problem with the file itself.
* For files owned by another service account, add the Agent Client Collector agent OS account to the owning group, or grant an ACL, rather than loosening the file's world permissions.
{#file-or-directory-check__ul_wdg_bcv_skc}

