Clear Update Caches
Clear Update Caches frees disk space on an endpoint by removing update downloads and caches that TridentStack Control and the operating system no longer need. Nothing that is installed is changed, and removed downloads are fetched again the next time an install needs them.
Clear Update Caches runs on Linux and macOS endpoints. It is not yet available on Windows endpoints, where the action shows as disabled with "Not yet available on Windows endpoints".
Running it
You can start the action from three places:
- The Actions menu on an endpoint's row in the Endpoints table
- The bulk actions menu, after selecting one or more endpoints
- The Actions menu on the endpoint's own page
A confirmation dialog lists what will be removed.
Linux and macOS endpoints running an older agent version show the action as disabled with "Requires a newer agent version". In a bulk selection, those endpoints are skipped and counted in the result message.
What is removed
| Platform | Removed |
|---|---|
| Linux and macOS | Pre-staged update downloads, application installer downloads, leftover installer files, and temporary and cached files kept by the agent |
| Linux | The package manager's downloaded package cache |
| macOS | The Homebrew download cache and leftover installer packages in the temporary folder |
What is never removed
- Script working folders
- The agent's own update and backup files
- A downloaded macOS OS installer
When the action is skipped
To avoid interfering with servicing, Clear Update Caches does nothing while an install is running or a reboot is pending on the endpoint. The result in History explains why it was skipped. Run it again once the install finishes or the endpoint has rebooted.
Results
Each run appears in the endpoint's History tab as Clear Update Caches, with the amount of space freed for each area cleaned.
Clearing automatically when disk space runs low
Under Settings > Client Settings, the setting Clear update caches automatically when disk space runs low lets TridentStack Control run the cleanup for you. It is off by default.
When it is on, a Linux or macOS endpoint is cleaned automatically when its free space on the system drive drops below 10% of the drive or 5 GB, whichever is larger.
Automatic runs happen at most once every 7 days for each endpoint, and skip endpoints with an install running or a reboot pending. They appear in History as Clear Update Caches, labelled as triggered automatically because of low disk space.