---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# Upgrade ACC manually on a macOS system

# Upgrade Agent Client Collector manually on a macOS system {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Perform a manual upgrade of your existing Agent Client Collector version on a system running a macOS. Manual upgrade is useful if the single-line command script isn't connected to the instance or you want to use enhanced customization options.

## Before you begin

* The upgrade procedure is the same for both MID Server and MID-less deployments.
* Enable golden image mode for cloning additional agents by setting the golden image marker located at /Library/Preferences/acc.rc.plist.
* Role required: agent_client_collector_admin
{#acc-macos-upgrade-manual__ul_rqq_xfw_zfc}

## Procedure

1. **Optional:** Manually back up the agent-id and acc.yml configuration files by running the following commands.  

       mkdir -p /tmp/acc-upgrade-backup

       cp -rp /Library/Application\ Support/servicenow/agent-client-collector/acc.yml /tmp/acc-upgrade-backup

       cp -rp /Library/Application\ Support/servicenow/agent-client-collector/check-allow-list.json /tmp/acc-upgrade-backup

       cp -rp /Library/Application\ Support/servicenow/agent-client-collector/agent_now_id /tmp/acc-upgrade-backup

   Manually backing up the configuration files provides an added layer of security by ensuring that your files are backed up before beginning the upgrade process.
2. Navigate to AllAgent Client CollectorDeploymentAgent Downloads.
3. In the macOS Downloads section, download the relevant agent package and signature .pkg files.
4. Perform package upgrade, based on the cpu your macOS runs with.  
   * Intel cpu:

         sudo installer -pkg agent-client-collector-<version number>-macos_x64.pkg

   * Apple silicon cpu:

   {#acc-macos-upgrade-manual__ul_n1d_clc_cgc}

       sudo installer -pkg agent-client-collector-<version number>-macos_arm64.pkg

   This command also backs up and restores the agent-id and configuration files before upgrading.
5. Verify that the upgrade was successful.
   1. Navigate to AllAgent Client CollectorAgents.
   2. Verify the following values for your agent:  
      * Host data collection = Collected
      * Version = \<Relevant version number\>
      {#acc-macos-upgrade-manual__ul_okj_hks_zbc}
   {#acc-macos-upgrade-manual__substeps_nkj_hks_zbc}

*[\>]: and then