Release Notes SD-WAN 7.0.0 Collector

Below please find the Release Notes for SD-WAN 7.0.0 collector. Please contact your Technical Account Manager (if applicable) or Systems Engineering Team or Support Team to discuss and plan the installation. Thank you for being a customer.

Note: Terminology usage...

In SD-WAN guides if there is,

  • [any reference to master] OR
  • [[if a CLI command (for NMS or Kubernetes or Redis) contains master] AND/OR
  • [its output contains master]], it means leader or control plane.

And, if there is any reference to slave or worker, it means follower or agent.

Browser Requirements

Minimum Resolution:1200x768 Browsers:

  • Modern, standards-compliant browser
  • JavaScript enabled
  • Pop-up blocker disabled for hostname/IP

The following browsers are supported in the current versions of SevOne.

Browser

Vendor Family
Google Chrome
Mozilla Firefox
Important: Please use the latest browser version for Chrome and Firefox.

Resources and Requirements

Resource Requirement
SevOne NMS Please refer to Compatibility Matrix below for SevOne NMS versions supported.
Helm 3.11.3
Kubernetes

1.27.1 (for upgrades)
1.27.1 (for new provisioning)

Important: If the installed Kubernetes version in your setup is not supported by SD-WAN collector you are provisioning, you will get an error message. Kubernetes must be upgraded prior to upgrading SD-WAN collector.
SOA >= 7.0.0
Kernel 4.18.0-513.9.1.el8_9.x86_64
Ports Required Please refer to SevOne NMS Port Number Requirements Guide > section Solutions Deployment.
VMware vSphere Client >= 6.5
Signature Tools
  • signature-tools- -build.<latest>.tgz
  • signature-tools- -build.<latest>.tgz .sha256.txt
For example,
  • signature-tools-v2.0.3-build.1.tgz
  • signature-tools-v2.0.3-build.1.tgz .sha256.txt
Other
File Type Versa Viptela Fortinet VeloCloud
TAR sevone_solutions_sdwan_versa-v7.0.0-build.68.tgz sevone_solutions_sdwan_viptela-v7.0.0-build.75.tgz sdwan-fortinet-installation-v7.0.0-build.3.tgz VeloCloud is packaged with SevOne NMS as a SDWAN plugin.
CHECKSUM sevone_solutions_sdwan_versa-v7.0.0-build.68.tgz.sha256.txt sevone_solutions_sdwan_viptela-v7.0.0-build.75.tgz.sha256.txt sdwan-fortinet-installation-v7.0.0-build.3.tgz.sha256.txt
OVA sevone_solutions_sdwan_versa-v7.0.0-build.68.ova sevone_solutions_sdwan_viptela-v7.0.0-build.75.ova n/a
QCOW2 sevone_solutions_sdwan_versa-v7.0.0-build.68.qcow2.gz sevone_solutions_sdwan_viptela-v7.0.0-build.75.qcow2.gz n/a
ISO sevone_solutions_sdwan_versa-v7.0.0-build.68.iso sevone_solutions_sdwan_viptela-v7.0.0-build.75.iso n/a
VHD sevone_solutions_sdwan_versa-v7.0.0-build.68.vhd.gz sevone_solutions_sdwan_viptela-v7.0.0-build.75.vhd.gz n/a

Facts and Limitations

The following notes are some facts and limitations that you must be aware of.

Important: SevOne NMS versions > 7.0.0 and SevOne Data Insight versions > 7.0.0 should ideally work with SD-WAN 7.0.0 unless there is some backward compatibility issue which may prevent it from working.
Important: Viptela Collector: vManage rate limits

The vManage overall rate limit is 450 requests per second. Currently, it has an API route related to device statistics which has a much lower rate limit of 43 requests per minute (or 0.72 requests per second). These rate limits are used as default rates in the Viptela collector configuration.

For the Viptela collector, each Agent has a vManage session.

Please refer to https://developer.cisco.com/docs/sdwan/#!browsing-returned-results-sorting-results-filtering-results-and-rate-limits/understanding-pagination for details.

Important: Viptela Collector: vManage data (Case change for names)

Collector handles the case change scenario for vManage data. Migration script removes the device / object group rules and adds new case-insensitive rules in the next run of deviceDescription / objectDescription agent.

Limitations:
  • Collector handles the case change only and not a complete name change.
  • In case of device name changes, collector does not change the actual device name in SevOne NMS. However, it keeps pushing data in the existing device.
  • In case of site / tenant name changes, collector does not update the device / object group name in SevOne NMS. However, it holds all the devices / objects available in the group.
  • In case of interface name changes, collector does not update the interface, interface queue, or tunnel name. However, it keeps pushing data for that object.
  • Collector does not support a scenario in which the device / interface name is same with a case difference in vManage. For example, device names, abc and ABC are not allowed.
Important: Viptela / Versa Collector

When upgrading the collector from a newly deployed SD-WAN 2.9 or SD-WAN 2.10 OVA to SD-WAN 7.0.0, please perform the steps mentioned in SD-WAN Viptela Collector Troubleshooting Guide or SD-WAN Versa Collector Troubleshooting Guide > section Upgrade Collector.

Important: Versa Collector

Tunnel data is coming from two different sources (sdwanB2BSlamLog and monStatsLog). Hence, the data gap might be visible in SevOne NMS.

Important: for Fresh Installs or Upgrades

The SOA version on SevOne NMS must be >= 7.0.0 otherwise, the pre-checks will fail. SD-WAN 7.0.0 package contains (SOA 7.0.0) .rpm file. Execute the following command to upgrade the SOA version on SevOne NMS.

Note: SOA Version

SOA must be on the latest version on all appliances in SevOne NMS cluster. Command Line Interface (CLI) must be used to upgrade SOA on all peers as the graphical user interface (GUI) only upgrades SOA for the NMS appliance you are connected to.

Execute the command to install / upgrade SOA only on NMS' Cluster Master and HSA

$ sevone-cli soa upgrade \
/opt/SevOne/upgrade/utilities/SevOne-soa-*.rpm
 
Execute the command to install / upgrade SOA on ALL peers in the NMS cluster
$ sevone-cli soa upgrade \
/opt/SevOne/upgrade/utilities/SevOne-soa-*.rpm \
--all-peers

Compatibility Matrix

Collector / Augmenter SevOne NMS / NMS REST API SOA Version SevOne Data Insight Widget Version
NMS REST API
7.0

7.0.0 (T & S)
6.8.0 (T & S)
6.7.0 (T & S)

2.1.47
2.1.46
2.1.44 - 2.1.45

>= 7.0.0 7.0 (T & S) 7.0.0

CONTROLLERS

Versa Viptela Fortinet VeloCloud


- 21.1.4 (T & S)
- 22.1.2 (S)
- 21.2.3 (S)

vManage:
- 20.13.1 (S)
- 20.11.1.1 (T & S)
- 20.9.4 (S)
- 20.9.1 (S)
- 20.6.4 (T & S)
- 20.6.2.1 (S)
- 20.5.1.2 (S)
- 20.5.1 (S)
- 20.4.1.1 (S)
- 20.3.6 (S)
- 20.3.5 (T & S)
- 20.3.4.1 (S)
- 20.3.4 (S)
- 20.3.3.1 (S)
- 20.3.1 (S)
- 20.1.1 (S)
- 19.2.2 (S)
- 18.3.4 (S)

vEdge:
- 20.9.1 (T & S)
- 20.6.1 - .2 (T & S)
- 18.3.4 (S)

cEdge:
- 17.9.1 (T & S)
- 17.6.02 (T & S)
- 16.9.2 (S)

v7.4.2 FortiManager (T & S)
v7.4.1 FortiManager (S)

VMware SASE 5.4.0.1 (T & S)
VMware SASE 5.4.0.0 (S)

Minimum resource needed on NMS:
CPU: 4 or more
RAM: 8GB or more
HDD: 20GB or more

Minimum resource needed on NMS:
CPU: 4 or more
RAM: 8GB or more
HDD: 20GB or more

Fortinet Plugin comes integrated with SevOne NMS. If there are specific NMS hardware sizing requirements, please contact IBM SevOne Support. VeloCloud Plugin comes integrated with SevOne NMS. If there are specific NMS hardware sizing requirements, please contact IBM SevOne Support.
Note: For additional details on hardware requirements such as, CPUs, RAM, flow limits, number of rack units, etc., for various hardware components, please contact your SevOne Technical Account Manager.
  • T & S - Tested & Supported
  • S - Supported
Note: SevOne Data Insight
  • Please refer to Release Notes SevOne Data Insight for details.
SevOne NMS
  • An administrator-level account in SevOne NMS.
  • User name and password for the administrator-level account.
  • IP address of the PAS.
  • 20k (vPAS_20K) appliance (minimum requirement).

Resolved Issues

Important: It is strongly recommended to run the external security scans such as Nessus, Snyk, or similar on the latest available patch for this release to verify whether the vulnerability has been addressed. If upgrading the production environment is not currently possible, these scans can still be performed in a lab or test environment.
Important: VeloCloud is packaged with SevOne NMS as a SDWAN plugin.
Component/s Key Release Notes
SDWAN VeloCloud S1NPM-77453

VeloCloud: The following object has been added along with its associated indicators.

Object: QoE - After

Indicators:

  1. scoreAfterVoice
  2. scoreAfterVideo
  3. scoreAfterTrans
SDWAN-Versa S1NPM-77523 Versa Collector: When installing or upgrading the collector using Graphical User Interface (GUI), a check box Show advanced config is added in the Configure stage, to display advanced configuration settings, along with default basic configuration fields .
SDWAN-Versa S1NPM-77597 Versa Collector: collector_name variable has been removed from the example configuration file and replaced with deployment_name in the logging path for both the collector and augmenter.
SDWAN Cisco Catalyst S1NPM-77636 Viptela Collector: A new configurable variable collectorConfig.vendor.vmanage_api.proxy has been added that defines the proxy URL for vManage. The default value is " ".
SDWAN Cisco Catalyst S1NPM-77665 Viptela Collector: In addition to WAN interfaces, the new IOS-XE also includes support for tunnelxxx interfaces, sharing the same configurations with WAN interfaces. Also, the interface type iana-type-tunnel, associated with interfaces named Tunnelxxx, has been eliminated from the tunnel object creation, as these interfaces were generating unnecessary tunnels on SevOne NMS.
SDWAN VeloCloud S1NPM-77676

VeloCloud: The following object has been added along with its associated indicators.

Object: QoE - {Link Name}. The field Link Name dynamically appears based on the values returned from API calls to individual devices.

Indicators:

  1. scoreBeforeVoice
  2. scoreBeforeVideo
  3. scoreBeforeTrans
SDWAN Cisco Catalyst S1NPM-100849

Viptela Collector: A new variable prechecks.dnc.enabled has been added to enable/disable DNC-related prechecks. The default value is true.

  • If set to true, all prechecks related to DNC will be executed.
  • If set to false, the following prechecks will be skipped.
    • Validate DNC IPs are part of the cluster
    • Check reachability to DNC
    • Check reachability to DNC IP address
SDWAN Solution, SDWAN Versa S1NPM-100851

Versa Collector: Flow augmentor now creates a separate log folder for each version.

To review the augmentor logs, log into the node IP (via SSH) where the augmentor pod is running, and then navigate to the directory /var/log/sdwan-versa/<deployment_name>/<build_version>/FlowAugmentor/

SDWAN Data Insight, SDWAN Solution S1NPM-100883 SD-WAN Widgets: Run the following command to delete old widgets.
$ ./deploy.sh <widget-tar-file-name> --force --delete-old-widgets
SDWAN Versa S1NPM-100884

Versa Collector: The following metadata fields have been added to store the source and destination access circuits for tunnels.

  • SDWAN_TUNNEL.SRC_TRANSPORT
  • SDWAN_TUNNEL.DST_TRANSPORT
SDWAN VeloCloud S1NPM-100902 VeloCloud: Added support for displaying object-level metadata for link objects.
SDWAN Cisco Catalyst S1NPM-100921 Viptela Collector: A new configurable variable collectorConfig.vendor.vmanage_api.follow_redirects has been added to enable automatic following of HTTP redirects for vManage API calls. The default value is false.
SDWAN Cisco Catalyst S1NPM-100922 Viptela Collector: Site name is now mapped correctly to location-based device groups. After completing the mapping process, kindly remove any incorrectly created sites manually.
SDWAN Cisco Catalyst, SDWAN Versa S1NPM-100943 Versa / Viptela Collector: Added support for gathering evidence for troubleshooting purposes.
SDWAN Cisco Catalyst S1NPM-100959

Viptela Collector: A new variable prechecks.dnc.enabled has been added to enable/disable DNC-related prechecks. The default value is true.

  • If set to true, all prechecks related to DNC will be executed.
  • If set to false, the following prechecks will be skipped.
    • Validate DNC IPs are part of the cluster
    • Check reachability to DNC
    • Check reachability to DNC IP address
SDWAN Viptela S1NPM-102967 Viptela Collector: DeviceDescriptionAgent runs automatically after all devices are discovered.
SDWAN Cisco Catalyst S1NPM-103046 Viptela Collector: PolicyParserAgent can now parse and remove inline comments when parsing data-prefix-list.
SDWAN Cisco Catalyst S1NPM-108748 Viptela Collector: collector_name variable has been removed from the example configuration file and replaced with deployment_name in the logging path for both the collector and augmenter.
SDWAN VeloCloud S1NPM-108793 VeloCloud: VMware is now using the name VeloCloud for its SD-WAN solution, previously called VMware SD-WAN.
SDWAN Versa S1NPM-108844 Versa Collector: Flow Object mapping will be created for all interfaces regardless of their state.
SDWAN Cisco Catalyst S1NPM-109338 Viptela Collector: Flow Object mapping will be created for all interfaces regardless of their state.

21 issues

Known Issues

Warning: FYI
  • The default interval for the updation of the augmenter cache is 24 hours. If a policy is changed or added on vManage, it is necessary to update the cache forcefully to augment the flows correctly. Please run the PolicyParserAgent to update the cache forcefully.
    Note: Applicable to Viptela Collector only.
    • $ kubectl exec <COLLECTOR_POD_ID> -- ./collector-viptela -run PolicyParserAgent
    • To find the <COLLECTOR_POD_ID>, execute the following command.
      $ kubectl get pods
  • Data gaps might be seen on the graphs in SevOne NMS for indicators of the objects of type SD-WAN Device Health as they are being polled at different timestamps. For example, SevOne NMS shows the data for the following indicators related to SD-WAN Device Health object.
    • memory_utilization
    • disk_utilization
    • cpu_utilization

    When querying data for these indicators from vManage, if the data is missing for any of the indicators, then the data gap might be visible in SevOne NMS.

  • If you are using SevOne NMS version < 5.7.2.23 (without the NMS-75375 hotfix), you may experience an impact on the performance of the collector. At a same time, collectors will not support tunnels > 10k.
  • Widgets
    • When the alternate name is enabled in SevOne Data Insight, Network Topology Widget 2.8.x / 2.9 does not show any tunnels for SD-WAN 2.6 collectors.
Component/s Key Known Issues
SDWAN Versa S1NPM-77542 Versa / Viptela Collectors: After deleting a deployment using the command sevone-cli solutions stop_collector and attempting to reinstall the collector using the sevone-cli solutions reload command, an error is encountered stating provided port is already allocated.

Workaround: Please try to deploy the collector after ~ 10 minutes, as Kubernetes requires some time to clean up stale ports.

SDWAN Cisco Analyst S1NPM-77627 Viptela / Versa Collectors: When installing / upgrading the collector via GUI, you can proceed to the Upgrade SOA stage in the following scenarios:
  • Without selecting or updating the configuration file (in the Config stage).
  • Even if there are errors in the configuration file (in the Config stage).
SDWAN Solution, SDWAN Versa, SDWAN Cisco Catalyst S1NPM-100519 Platform: Depending on the scale of the environment, Jaeger may quickly consume its allotted memory and in turn, restart. The maximum allotted memory can be adjusted when Jaeger is enabled.
SDWAN Solution, SDWAN Versa S1NPM-100816 Versa Collector: Tunnel objects will be pinned to their respective object groups either after 24 hours or according to the discovery schedule in SevOne NMS.
SDWAN Solution, SDWAN Versa S1NPM-101078

Versa Collector: When upgrading the SD-WAN Versa Collector from version 2.15 or later to 7.0.0, you may encounter the following error.

msg": "Timeout when waiting...

To resolve this issue, perform the following steps:

  1. Login to master node, applicable for both single and multi-node scenarios.
  2. $ sevone-cli playbook reset
  3. $ sudo reboot
  4. $ sevone-cli cluster up
  5. $ sevone-cli playbook postcheck
SDWAN Cisco Catalyst S1NPM-109664 Viptela Collector: When the NEXT_HOP_IP field is not present in a flow, the following fields will be set to Unknown.
  • Wan Path Source (4323)
  • Wan Path Source Alternate Name (4354)
  • Wan Path Destination (4323)
  • Wan Path Destination Alternate Name (4355)
  • Tunnel (4353)
  • Tunnel Alternate Name (4356)
SDWAN Solution S1NPM-110248 Platform: In a multi-node, multi-vDirector setup, the Collector and Augmenter Evidence Framework is currently unable to collect evidence information or generate the .tar.gz file. However, the must-gather functionality continues to work as expected.
SDWAN Cisco Catalyst S1NPM-110676 Viptela Collector: Upgrading the collector from version 6.7.5 or above to Red Hat Enterprise Linux (RHEL) versions 6.8 or above fails with the error No package matching 'convert2rhel' found because the yum metadata still refers to the previously installed CentOS package.
Workaround: Run the following command and repeat the upgrade process. For more details, please refer to SD-WAN Viptela Collector Upgrade Process Guide.

$ sudo yum clean metadata
 
SDWAN Solution S1NPM-112181

Interface statistics are not generated for the sub-interfaces; an expected behavior from Cisco. sdwan::device-interface objects for interfaces are created to provide interface statistics datapoints.

Since the mapping is performed for interface objects available in SevOne NMS, the ifIndex is not renamed to interface name for the sub-interfaces in Flow Interface Manager.

SDWAN Solution S1NPM-112216 Platform: The requester ID's data source is used to load the OOTB report during the post-check process. However, if multiple users are present in SevOne Data Insight, the post-check task that loads OOTB reports is expected to fail with the an error in the post-check output under the Execute script to load OOTB report task as shown. below.

Error: Type Error: "None Type" object is not subscriptable.

Workaround: By following these steps, you should be able to retrieve the requester's user datasource, update the post-checks, and complete the post-check process without any errors

  1. Create a backup of the current version of client.py file.
    
    $ cp /opt/SevOne/upgrade/ansible/playbooks/roles/reports/files/di_client/client.py \
    /opt/SevOne/upgrade/ansible/playbooks/roles/reports/files/di_client/client.py.bkp
  2. Run the following command to obtain the token.
    
    $ curl -X POST -L -k 'http://<hostname>/retinaserver' --header 'Content-Type: application/json' \
    --data-raw '{"query":"mutation($user:String!, $password:String!, $tenant:String!)
    {\nauthenticate(name: $user, password: $password, tenant: $tenant){\nsuccess\ntoken\n}\n}",
    "variables":{"user":"<user>","password":"<password>","tenant":"<tenant>"}}'
    Note:

    where,

    • <hostname> - collectorConfig.di.api[0].host in the config file
    • <user> - collectorService.di.api.username in the config file

      Run the following command to obtain the decoded username.

      
      $ echo -n <base64 encoded SevOne Data Insight username> | base64 --decode
    • <password> - collectorService.di.api.password in the config file

      Run the following command to obtain the decoded password.

      
      $ echo -n <base64 encoded SevOne Data Insight password> | base64 --decode
    • <tenant> - collectorConfig.di.api[0].tenant in the config file
  3. Run the following command, replacing <token> with the token obtained from the previous step.
    
    $ curl -X POST -L -k 'http://<hostname>/retinaserver' --header 'x-auth-token:<token>' \
    --header 'Content-Type: application/json' \
    --data-raw '{"query":"query getAllDatasources {\n users {\n  tenant {\n   datasources {\n    id\n    name\n    address\n   }\n  }\n }\n}","variables":"{}"}'
  4. Based on the output from the previous step, locate the entry where the datasources key is not None and take note of its index. If the output resembles the example below, the index is 1.

    Example:

    [{'tenant': None},
    
    {'tenant': {'datasources': [{'id': 4, 'name': 'device01', 'address': 'http://example.net'}]}}},
    
    {'tenant': None}]
     
  5. Run the following command, replacing <your index here> with the index obtained from the previous step.
    
    $ sed -i "s/data = result\['data'\]\['users'\]\[0\]/data = result\['data'\]\['users'\]\[<your index here>\]/" \
    /opt/SevOne/upgrade/ansible/playbooks/roles/reports/files/di_client/client.py
  6. Rerun the post-check.
    $ sevone-cli playbook postcheck

The task Execute script to load the OOTB report has now completed successfully.

SDWAN Versa S1NPM-112339 Versa Collector: When upgrading a single-node or multi-node Versa setup from version 6.8.x or later to 7.1.x, executing the command below may trigger an error, which is an expected behavior.
$ /usr/local/sbin/SevOne-validate-image \
-i $(ls -Art /opt/SevOne/upgrade/sevone_solutions_sdwan_versa-*.tgz | tail -n 1) \
-s $(ls -Art /opt/SevOne/upgrade/sevone_solutions_sdwan_versa-*.tgz.sha256.txt | tail -n 1) \
--installer solutions  --installer-opts '--no_screen'
 

Error:

TASK [helm upgrade/install default/solutions-sdwan-versa] ***************************************************************************
fatal: [sevonek8s]: 
FAILED! => {"changed": true, "cmd": "helm upgrade solutions-sdwan-versa local/solutions-sdwan-versa -o json --install --create-namespace --namespace default --timeout=5m --insecure-skip-tls-verify --devel --atomic  -f /tmp/ansible.wLFGEx/solutions-sdwan-versa_custom_guii.yaml  \n", "delta": "0:10:02.543798", "end": "2023-03-27 02:44:03.478942", "msg": 
"non-zero return code", "rc": 1, "start": "2023-03-27 02:34:00.935144", "stderr": "W0327 02:34:02.451394  997524 warnings.go:70] spec.template.spec.containers[0].env[7].name: duplicate name \"MINER_DATA_SOURCE\"\nW0327 02:34:02.712946  997524 warnings.go:70] spec.template.spec.containers[0].env[4].name: 
duplicate name \"SECRETS_API_NAME\"\nW0327 02:39:03.266490  997524 warnings.go:70] spec.template.spec.containers[0].env[7].name: duplicate name \"MINER_DATA_SOURCE\"\nW0327 02:39:03.348819  997524 warnings.go:70] spec.template.spec.containers[0].env[4].name: duplicate name \"SECRETS_API_NAME\"\nError: 
UPGRADE FAILED: an error occurred while rolling back the release. original upgrade error: timed out waiting for the condition: release solutions-sdwan-versa failed: timed out waiting for the condition", "stderr_lines": ["W0327 02:34:02.451394  997524 warnings.go:70] spec.template.spec.containers[0].env[7].name: 
duplicate name \"MINER_DATA_SOURCE\"", "W0327 02:34:02.712946  997524 warnings.go:70] spec.template.spec.containers[0].env[4].name: duplicate name \"SECRETS_API_NAME\"", "W0327 02:39:03.266490  997524 warnings.go:70] spec.template.spec.containers[0].env[7].name: duplicate name \"MINER_DATA_SOURCE\"", "W0327 02:39:03.348819  997524 warnings.go:70] spec.template.spec.containers[0].env[4].name: duplicate name \"SECRETS_API_NAME\"", 
"Error: UPGRADE FAILED: an error occurred while rolling back the release. original upgrade error: timed out waiting for the condition: release solutions-sdwan-versa failed: timed out waiting for the condition"], "stdout": "", "stdout_lines": []}
 
Workaround: Run the commands as shown below and proceed with the upgrade process.

$ ssh sevone@<SD-WAN collector 'control plane' node IP address or hostname>
 

$ sevone-cli cluster down
 

$ sevone-cli cluster up
 

Please refer to SD-WAN Versa Collector Upgrade Process Guide for details.

SDWAN Cisco Catalyst S1NPM-112561 Viptela Collector: When upgrading a multi-node Viptela setup from version 6.8.x or later to 7.1.x, executing the command below may trigger an error, which is an expected behavior.
$ /usr/local/sbin/SevOne-validate-image \
-i $(ls -Art /opt/SevOne/upgrade/sevone_solutions_sdwan_viptela-*.tgz | tail -n 1) \
-s $(ls -Art /opt/SevOne/upgrade/sevone_solutions_sdwan_viptela-*.tgz.sha256.txt | tail -n 1) \
--installer solutions  --installer-opts '--no_screen'
Error:

TASK [helm : helm upgrade/install default/solutions-sdwan-viptela] *****************************************************
fatal: [sevonek8s]: FAILED! =>

{"changed": true, "cmd": "helm upgrade solutions-sdwan-viptela local/solutions-sdwan-viptela -o json --install --create-namespace --namespace default --timeout=5m --insecure-skip-tls-verify --devel --atomic  -f /tmp/ansible.phf6sgc1/solutions-sdwan-viptela_custom_guii.yaml   --set=multiTenant=False\n",
 "delta": "0:05:36.590937", "end": "2024-09-25 11:39:10.474620",
 "msg": "non-zero return code", "rc": 1, "start": "2024-09-25 11:33:33.883683",
 "stderr": "W0925 11:33:47.000633 1465726 warnings.go:70] spec.template.spec.containers[0].env[4].name: duplicate name \"SECRETS_API_NAME\"\nW0925 11:38:48.180808 1465726 warnings.go:70] spec.template.spec.containers[0].env[4].name: duplicate name \"SECRETS_API_NAME\"\nError: UPGRADE FAILED: release solutions-sdwan-viptela failed, and has been rolled back due to atomic being set: context deadline exceeded",
 "stderr_lines": ["W0925 11:33:47.000633 1465726 warnings.go:70] spec.template.spec.containers[0].env[4].name: duplicate name \"SECRETS_API_NAME\"", "W0925 11:38:48.180808 1465726 warnings.go:70]spec.template.spec.containers[0].env[4].name: duplicate name \"SECRETS_API_NAME\"", "Error: UPGRADE FAILED: release solutions-sdwan-viptela failed, and has been rolled back due to atomic being set: context deadline exceeded"],
 "stdout": "", "stdout_lines": []}

Workaround: Rerun the command above and proceed with the upgrade process. Refer to SD-WAN Viptela Collector Upgrade Process Guide.

SDWAN Solution S1NPM-113717
Platform: The MetadataAgent fails to complete metadata updates for devices/objects because its runtime exceeds the default 1hour timeout limit. As a result, the metadata is not accurately reflected in the device/object with the following error.
2024-06-24T16:49:37Z ERR agent run canceled error="context deadline exceeded" agent=MetadataAgent
Workaround:
  1. Locate and change the timeout for MetadataAgent from 1h to greater than or equal to 2h (but, less than 12h) in the config file, /opt/SevOne/chartconfs/<config-file>, as shown below.
    
    collectorConfig:
    
    agent:
    
    override:
    
    MetadataAgent:
    
    timeout: 2h
     
  2. Run the below command in the collector to apply the changes.
    $ sevone-cli solutions reload
  3. Manually execute the below command in separate screen session if needed, or wait for its next automatic cycle and then check the logs.
    $ sevone-cli solutions run_agent --deployment_name solutions-sdwan-viptela --agent_name MetadataAgent --log_level info > /tmp/metadataLog.log
SDWAN Solution S1NPM-117472 Device and object metadata may appear incomplete in SevOne NMS, with the Viptela / Versa Metadata Agent reporting the following message: 2024-06-24T16:49:37Z ERR agent run canceled error="context deadline exceeded" agent=MetadataAgent.

14 issues