Deploy ThousandEyes Container in Cisco SD-WAN Manager Using a CLI Add-On Profile

Create a CLI Add-On Profile

For NFVIS devices managed by Cisco SD-WAN Manager, follow these steps to deploy the ThousandEyes container:

1. From the Cisco SD-WAN Manager menu, choose Configuration > Configuration Groups.

2. Adjacent to a configuration group, click … and choose Edit.

3. In the Feature Profiles - Unconfigured area, locate CLI Profile.

   Note	If the configuration group already has a CLI profile configured, this option will not appear.

4. On the CLI Profile card, click Start Configuration.

   An Edit Config Feature pane opens.

5. Enter a name and, optionally, a description for a new CLI add-on profile.

6. Enter configuration commands in the CLI Configuration area or click Import Config File to import a configuration.

   Use the following sample CLI configuration for image registration and deployment:

   vm_lifecycle images image thousandeyes-enterprise-agent-0.33.0
    src https://downloads.thousandeyes.com/enterprise-agent/thousandeyes-enterprise-agent-0.33.0-nfvis.docker
    locator vim_id container
    properties property vnf_type
     value THOUSANDEYES
    !
   !
    
   vm_lifecycle flavors flavor thousandeyes-flavor vcpus 2 memory_mb 1024 root_disk_mb 20480
   !
   vm_lifecycle tenants tenant admin
    deployments deployment THOUSANDEYES-DEMO
     vm_group THOUSANDEYES-DEMO
      locator vim_id container
      image              thousandeyes-enterprise-agent-0.33.0
      flavor             thousandeyes-flavor
      vim_vm_name        THOUSANDEYES-DEMO
      bootup_time        -1    
      config_data configuration bootstrap_config
       data            "{ \"env_variables\" : { \"TEAGENT_ACCOUNT_TOKEN\" : \"${TEAGENT_ACCOUNT_TOKEN}\", \"TEAGENT_INET\" : \"${TEAGENT_INET}\"} }"
       template_engine VELOCITY
       variable TEAGENT_ACCOUNT_TOKEN
        val [ 53rettywagbuouhw06hu65767rtyuyyui ]
       !
       variable TEAGENT_INET
        val [ 4 ]
      !   !
    !

7. To convert a configuration value to a variable, select the value and click Create Variable.

   Enter the variable name, and click Create Variable. You can also type a variable name directly, in the format {{variable-name}}. Example: {{hostname}}

   Variables enable you to enter values for the variables individually for each device when you deploy a configuration group to devices. During the deployment, you can enter values manually or using a CSV file.

8. To encrypt a plain-text password using type 6 encryption, select the password and click Encrypt Type 6.

   In the example below, you can select the password, ABCD, and click Encrypt Type 6 to encrypt the password.

   server-private 10.0.0.1 key 0 ABCD

   For more information about type 6 encryption, see Type 6 Passwords on Cisco IOS XE SD-WAN Routers in the Cisco Catalyst SD-WAN Systems and Interfaces Configuration Guide, Cisco IOS XE Catalyst SD-WAN Release 17.x.

   Note	Encrypt only passwords. Encrypting a CLI command may cause a failure when deploying the configuration group to devices.

9. Click Save and proceed to associate and deploy the device to the appropriate Configuration Group.

Upgrade ThousandEyes Agent Container in Cisco SD-WAN Manager Using a CLI Add-On Profile

Edit the Existing Add-On CLI Profile:

1. From the Cisco SD-WAN Manager menu, choose Configuration > Configuration Groups.

2. In the CLI add-on profile, adjacent to the config feature, click … and choose Edit Feature.

3. Modify the deployment payload to replace the existing image path with the path of the new version of the ThousandEyes image in the CLI Configuration area or click Import Config File to import a configuration.

   Use the following sample CLI configuration for updating the image version:

   vm_lifecycle tenants tenant admin
    deployments deployment THOUSANDEYES-DEMO
     vm_group THOUSANDEYES-DEMO
      locator vim_id container
      image              https://downloads.stg.thousandeyes.com/enterprise-agent/thousandeyes-enterprise-agent-0.34.0-nfvis.docker

4. To convert a configuration value to a variable, select the value and click Create Variable.

   Enter the variable name, and click Create Variable. You can also type a variable name directly, in the format {{variable-name}}. Example: {{hostname}}

   Variables enable you to enter values for the variables individually for each device when you deploy a configuration group to devices. During the deployment, you can enter values manually or using a CSV file.

5. To encrypt a plain-text password using type 6 encryption, select the password and click Encrypt Type 6.

   In the example below, you can select the password, ABCD, and click Encrypt Type 6 to encrypt the password.

   server-private 10.0.0.1 key 0 ABCD

   For more information about type 6 encryption, see Type 6 Passwords on Cisco IOS XE SD-WAN Routers in the Cisco Catalyst SD-WAN Systems and Interfaces Configuration Guide, Cisco IOS XE Catalyst SD-WAN Release 17.x.

   Note	Encrypt only passwords. Encrypting a CLI command may cause a failure when deploying the configuration group to devices.

6. Click Save to complete the update process.