Using the Deployment Script

Procedure

1. In the Trend Vision One console, go to Endpoint Security → Endpoint Inventory.
2. Click Agent Installer.
3. In the Agent Installer window, go to Deployment Script.
4. Select the Protection type.
   • Server & Workload Protection: Deploy an agent with the endpoint sensor and Server & Workload Protection features, and automatically assign it to an endpoint group for management.
5. Select the Operating system of the target endpoint.
6. Assign the endpoint group.
   You must assign a Protection Manager. All other endpoint group settings are optional.
   1. Select the Protection Manager instance to manage the endpoint agent.
   2. Select the Group to assign the endpoint agent.
   3. Select the Agent policy.
   4. Select the Relay group.

   Tip You can edit the group, agent policy, and relay group directly in the deployment script by modifying the following attributes: GROUP_ID POLICY_ID RELAY_GROUP_ID

7. Select the Proxy for deployment.
   • Direct connect: The agent installer attempts to connect directly to Trend Vision One without using a proxy.
   • Custom proxy: The agent installer attempts to connect using a user-defined proxy.
     To use this option, you must provide values the following attributes in the custom script before attempting to deploy:
     • PROXY_ADDR_PORT: The IP address or FQDN and port of the proxy server. For example: 127.0.0.1:40
     • PROXY_USERNAME: If the proxy server requires credentials, provide the username.
     • PROXY_PASSWORD: If the proxy server requires credentials, provide the password.
   • Service Gateway: The agent installer attempts to connect using a deployed Service Gateway with Forward Proxy Service enabled.
     This option requires a Service Gateway with Forward Proxy Service installed and enabled. For more information, see Deploy a Service Gateway and Configure Firewall Exceptions.

   Important The deployment script does not utilize the custom proxies defined in the Agent Installer Proxy settings. Agents adopt the Runtime Proxy settings assigned to their endpoint group after installation and registration is successfully completed.

8. To include TLS validation, select Validate Trend Vision One server TLS certificate.
   When enabled, the deployment script checks if the Trend Vision One download server is using a valid TLS certificate from a trusted certificate authority (CA). Trend Micro recommends enabling this feature to help prevent "man in the middle" attacks.
9. To include signature validation, select Validate the signature on the agent installer.
   When enabled, the deployment script performs a digital signature check on the downloaded agent installer file. The installation process is stopped if the check fails.
10. Review and obtain the deployment script.
    • Click the download icon () to save the script.
      For Windows deployments, the script is saved as a PowerShell script (.PS1). For Linux deployments, the script is saved as a Bash script (.SH).
    • Click the copy icon () to copy the script.
11. Copy or download the script to your target endpoint.
12. Run the script from the command line interface.
    Use the command which corresponds to your operating system and interface:

    • Windows
      • Command prompt: Run the command powershell.exe -File scriptname.ps1
      • PowerShell: Run the command .\scriptname.ps1
    • Linux terminal: Add the execute permission to the file and run ./scriptname.sh
    The deployment script downloads the agent installer package to the endpoint and begins installation. After installation successfully completes, the agent registers to Trend Vision One and appears in the Endpoint Inventory. The agent automatically adopts any settings or policies assigned to the managing endpoint group.