This procedure explains how to modify and apply the agent_config.json configuration file for an individual agent on a single endpoint.
Important
Trellix Endpoint Security (HX) xAgent version 26.21.x introduces support for the sc control parameter paramchange in Windows environments. When the Trellix Endpoint Security (HX) xAgent configuration file is manually modified, this command notifies the agent of the change and generates a restart of the agent service if it is required.
agent_config.json file for a single endpoint:Verify that you are logged in as an administrator of the machine on which the agent is installed.
Turn off the agent default policy to permit the agent services to be stopped and restarted on all host endpoints.
Wait for the policy to propagate.
Note
The policy takes approximately 10 to 20 minutes to propagate.
On the command line, navigate to the version agent installation directory where the
xagt.exefile is stored. The default location is%ProgramFiles%\FireEye\xagt\(32-bit environments) or%ProgramFiles(x86)%\FireEye\xagt\(64-bit environments).Export the
agent_config.jsonfile from the agent database:xagt -x agent_config.jsonUsing a text editor, modify the configuration file to disable the dynamic update of the configuration file from the Endpoint Security (HX) server. To do this, change the
config_pull_enabledkey tofalsein the configuration file. If you fail to do this, any changes you make to theagent_config.jsonfile will be overwritten the next time the configuration file is dynamically updated.Make other changes (as needed) based on the instructions in the rest of this documentation.
When all changes have been made, run the file through a JSON validator to ensure that the JSON code is valid.
When the file has been validated, save it.
Caution
Saving the
agent_config.jsonfile in a format other than UTF-8 is not supported.Disable Tamper Protection to stop the agent service.
Deny local permission to stop and start agent services.
Import the
agent_config.jsonfile back to the agent database:xagt -i agent_config.jsonRestart the agent.
sc control xagt paramchangeTurn on the policy to permit the agent services to be stopped and restarted on all host endpoints.
Note
See Disabling Tamper Protection for all host endpoints for more information on disabling your Tamper Protection policy.