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.