Cisco
Login
Search
Software Secure Workload
Activity Configure

Deploy Software Agents on Workloads Deploy Software Agents (Manual Installations Only) Update the User Configuration File

Last updated: Jun 09, 2025

(Manual Installations Only) Update the User Configuration File

The following procedure is required only for installations involving all of the following:

  • Secure Workload SaaS, or on-premises clusters with multiple tenants (on-premises clusters that use only the default tenant do NOT need this procedure)

  • Manual installation

  • Linux or Windows platform

Agents require an activation key to register to the Secure Workload cluster. they require a cluster activation key. Additionally, they might need an HTTPS proxy to reach the cluster.


 

In Windows Environment, you do not need to manually configure user.cfg, if activationkey and proxy options are used during manual installation.

Before installation, configure the required variables in the user configuration file:

Procedure

1

To retrieve your activation key, navigate to Manage > Agents, click the Installer tab, click Manual Install using classic packaged installers, then click Agent Activation Key.
2

Open the user.cfg file in the Secure Workload Agent installation folder. (Example: /usr/local/tet on Linux or C:\\Program Files\\Cisco Tetration on Windows). The file contains a list of variables in the form of “key=value”, one on each line.
3

Add the activation key to the ACTIVATION_KEY variable. Example: ACTIVATION_KEY=7752163c635ef62e6568e9e852d07bd21bfd60d0

4

If the agent requires an HTTPS proxy, add the http protocol proxy server and port using the HTTPS_PROXY variable. Example: HTTPS_PROXY=http://proxy.my-company.com:80

Previous topic Verify Solaris Agent Installation Next topic Other Agent-Like Tools