Upgrade Agent Client Collector manually on a macOS system

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

Procedure

1. 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 All > Agent Client Collector > Deployment > Agent 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:

   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 All > Agent Client Collector > Agents.

   2. Verify the following values for your agent:

      • Host data collection = Collected
      • Version = <Relevant version number>

Parent Topic:Agent Client Collector installation on a macOS system