Activate the agent

If you haven't already installed the agent, see Use deployment scripts to add and protect computers or Manually install the Deep Security Agent for instructions.

Before the installed agent can protect its computer or be converted to a relay, you must activate the agent with Workload Security. Activation registers the agent with Workload Security during an initial communication.

To do this, you can either:

  • Activate the agent through a deployment script. See Use deployment scripts to add and protect computers for details.
  • Activate the agent from the computer where the agent is installed. Run this command:
    dsa_control -a dsm://agents.deepsecurity.trendmicro.com:443/ "tenantID:<tenant ID>" "token:<token>"
    To find the appropriate values for <tenant ID> and <token>, in the Workload Security console, go to Support > Deployment Scripts, scroll to the end of the script that is generated, and copy the tenantID and token values.
    For details on this command, including additional parameters, see Command-line basics.
  • Activate the agent through an event-based task ("Computer Created (by System)" event) to automatically activate computers when they connect to Workload Security or when Workload Security syncs with an LDAP directory or cloud account. For more information, see Create an event-based task.

Before activation, the agent will have one of these statuses:

  • No Agent: Indicates one of the following situations:
    • No agent is running or listening on the default port.
    • An agent is installed and running but is working with another manager and communications are configured as agent-initiated. In this case, the agent is not listening for Workload Security. To correct this situation, deactivate the agent from the computer.
  • Activation Required: The agent is installed and listening, and is ready to be activated by Workload Security.
  • Reactivation Required: The agent is installed and listening and is waiting to be reactivated by Workload Security.
  • Deactivation Required: The agent is installed and listening, but has already been activated by another manager.
  • Unknown: The computer has been imported (as part of an imported Computers list) without state information, or has been added by way of an LDAP directory discovery process.

After a successful activation, the agent state is Online. If the activation failed, the computer status is Activation Failed with the reason for the failure in brackets. Click this link to display the system event for more details on the reason for the activation failure.

Although IPv6 traffic is supported by Deep Security 8.0 and earlier agents, it is blocked by default. To allow IPv6 traffic on Deep Security 8.0 Agents, open a Computer or Policy editor and go to Settings > Advanced > Advanced Network Engine Settings. Set the Block IPv6 for 8.0 and Above Agents option to No.

Deactivate the agent

You can normally deactivate the agent from the Workload Security console. If Workload Security cannot communicate with the agent, you may have to perform the deactivation manually. To run the commands below, you must have administrator privileges on the local machine.

To deactivate the agent on Windows:

  1. From a command line, change to the agent directory (Default is C:\Program Files\Trend Micro\Deep Security Agent)
  2. Run the following: dsa_control -r

To deactivate the agent on Linux:

  1. Run the following: /opt/ds_agent/dsa_control -r

Start or stop the agent

To start or stop the agent on Windows:

  • Start: sc start ds_agent
  • Stop: sc stop ds_agent

To start or stop the agent on Linux:

Using SysV init scripts:

  • Start: /etc/init.d/ds_agent start
  • Stop: /etc/init.d/ds_agent stop

Using systemd commands:

  • Start: systemctl start ds_agent
  • Stop: systemctl stop ds_agent