Comment on page

Docker Agent Configuration Options

You can configure the Enterprise Agent by setting environment variables, such as run-opts 1, on your Cisco Catalyst switch as follows:
Device(config)# app-hosting appid thousandeyes_enterprise_agent
Device(config-app-hosting)# app-resource docker
Device(config-app-hosting-docker)# prepend-pkg-opts
Device(config-app-hosting-docker)# run-opts 1 "-e TEAGENT_ACCOUNT_TOKEN"
Device(config-app-hosting-docker)# run-opts 2 "--hostname DESIRED_AGENT_HOSTNAME"
Device(config-app-hosting-docker)# run-opts 3 "-e TEAGENT_PROXY_TYPE=STATIC
Device(config-app-hosting-docker)# run-opts 4 "-e TEAGENT_PROXY_LOCATION=proxy.something.other:80"
Device(config-app-hosting-docker)# exit
Device(config-app-hosting)# exit
Device(config)# exit
This article lists the available configuration options for these run-opts variables.
  • APT_PROXY_LOCATION
    When PROXY_APT is set, the hostname or hostname:port to use for the apt proxy. Default: Not set.
  • APT_PROXY_PASS
    When PROXY_APT is set, the password to use for the apt proxy. Default: Not set.
  • APT_PROXY_USER
    When PROXY_APT is set, the username to use for the apt proxy. Default: Not set.
  • HOSTNAME
The agent hostname you would like to assign. Default: the hostname of the switch.
  • PROXY_APT
    Specifies whether a proxy is necessary to reach apt repositories when PROXY_TYPE is PAC. Setting this to anything enables proxying for apt. Default: not set.
Note: When PROXY_TYPE is STATIC, apt will be configured to use the proxy defined at TEAGENT_PROXY_LOCATION with the authentication defined by TEAGENT_PROXY_USER and TEAGENT_PROXY_PASS. Also note that apt supports basic proxy authentication only.
  • TEAGENT_ACCOUNT_TOKEN
    The account group token for registration. This option must be set.
  • TEAGENT_AUTO_UPDATES
    Specifies whether the agent will perform automatic self-updates of ThousandEyes packages. Valid values are 0 and 1. Default: 1.
    Note: This setting does not affect base OS-level packages; only ThousandEyes software.
  • TEAGENT_KERBEROS_RDNS
    Specifies whether reverse DNS lookups should be performed and checked for Kerberos hostnames. Valid values are 0 and 1. Default: 1.
  • TEAGENT_KERBEROS_WHITELIST
    Not needed for IOS XE 17.3.3.
  • TEAGENT_KDC_HOST
    When using KERBEROS proxy authentication, the hostname where the KDC can be reached. Default: Not set.
  • TEAGENT_KDC_PASS
    When using KERBEROS proxy authentication, the password to use for communication with the KDC. Default: Not set.
  • TEAGENT_KDC_PORT
    When using KERBEROS proxy authentication, the port to use for communication with the KDC. Default: 88
  • TEAGENT_KDC_REALM
    When using KERBEROS proxy authentication, the realm to use for communication with the KDC. Default: Not set.
  • TEAGENT_KDC_USER
    When using KERBEROS proxy authentication, the username to use for communication with the KDC. Default: Not set.
  • TEAGENT_PROXY_AUTH_TYPE
    The type of authentication to use when connecting to the configured proxy. Default: Not set.
    • Not set: Do not use authentication.
    • BASIC: Use HTTP BASIC authentication. TEAGENT_PROXY_USER and TEAGENT_PROXY_PASS must be set.
    • NTLM: Use HTTP NTLM authentication. TEAGENT_PROXY_USER and TEAGENT_PROXY_PASS must be set.
    • KERBEROS: Use Kerberos authentication. TEAGENT_KDC_USER, TEAGENT_KDC_PASS, TEAGENT_KDC_REALM, TEAGENT_KDC_HOST, and TEAGENT_KDC_PORT must be set.
  • TEAGENT_PROXY_BYPASS_LIST
    When using a STATIC proxy, a list representing the endpoints that should not require proxy use. Default: Not set.
    The list should be separated by semicolons and each entry should be one of the following:
    • A specific hostname or IP address. eg, foo.somedomain.com or 128.1.10.24. In the case of an IP address, the proxy will be bypassed only if the IP is present in the URL itself. This will not apply to an IP address used as a result of DNS resolution on a hostname.
    • A wildcard hostname starting with a *. eg, *.somedomain.com. A proxy will not be used for any request targeting subdomains of somedomain.com. Note that requests to somedomain.com itself will still use the proxy.
    • A network prefix. eg, 128.1.0.0/24. If the requested URL is for a literal IP address, bypass the proxy if the IP lies within this network prefix.
  • TEAGENT_PROXY_LOCATION
    Proxy location. Default: Not set.
    • For STATIC proxies, the hostname:port where the proxy is located (eg, proxy.thousandeyes.com:3128).
    • For PAC proxies, a URL where the PAC file can be downloaded (eg, https://somewhere.com/pac).
    • Should not be set if TEAGENT_PROXY_TYPE is DIRECT.
  • TEAGENT_PROXY_PASS
    The password for proxy authentication. Default: Not set.
  • TEAGENT_PROXY_TYPE
    The type of proxy to use for communication with the ThousandEyes platform. Default: DIRECT.
    • DIRECT: Do not use a proxy, go directly to the destination.
    • STATIC: Use a statically configured proxy location.
    • PAC: Use a PAC file to determine the proxy’s location
  • TEAGENT_PROXY_USER
    The username for proxy authentication. Default: Not set.