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
Role required: agent_client_collector_admin
Procedure
- 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.
-
Navigate to .
-
In the macOS Downloads section, download the relevant agent package and signature .pkg files.
-
Perform package upgrade.
sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /
This command also backs up and restores the agent-id and configuration files before upgrading.
-
Verify that the upgrade was successful.
-
Navigate to .
-
Verify the following values for your agent:
- Host data collection = Collected
- Version = <Relevant version number>