How to generate a VMware VeloCloud SD-WAN™ Edge diagnostic bundle via Local Web UI

Products

• VMware SD-WAN by VeloCloud
• VMware VeloCloud SD-WAN
• VMware VeloCloud SD-WAN with Premier Support

Issue/Introduction

This article outlines to our partners and customers how to generate a diagnostic bundle via Local Web UI. This is useful in technical support cases where a bundle is required for analysis but the VMware SD-WAN Edge is not accessible via the Orchestrator or internet.

Environment

VMware SD-WAN by VeloCloud

Cause

Prerequisites:

On an Edge that has been activated and carries a configuration, access to the Edge's local Web UI is disabled by default.  In order to allow local Web UI access, an IP address belonging to a local device must be allowed in the firewall configuration of the VMware SD-WAN Edge. This can be configured via Profile or the Edge.

This change must be done while the device is connected to the VMware SD-WAN Orchestrator. If the Edge is offline and the firewall configuration was not done prior, then a factory reset would be required to access the device.

At the Edge level, this is the screen you see under Configure->Edge->Firewall>Edge Access of the Orchestrator UI.  Profile level would be similar except you are applying this exception across multiple Edges.



Note: If the Edge has not been activated, or was factory reset, the Local Web UI access will be enabled for all LAN hosts using the IP address 192.168.2.1.

 

 

Resolution

Steps:

1) To access the Edge's Local Web UI, connect a client device to one of the Edge's LAN interfaces.

2) There are two paths after this depending on whether the VMware SD-WAN was activated and uses a configuration, or is in an unactivated (factory settings) state.

Activated Edge:

• Locate a VLAN IP address associated with the Edge interface you are connected to.  This can be found on the Configure->Edge->Device screen and the look for Configure VLAN.  In the below example the Edge uses just one VLAN and so the choice of VLAN IP's is straightforward, but the same goes for an Edge with multiple VLANs.  As long as the interface you are connected to uses that VLAN, the VLAN IP Address will work. 

• Enter this VLAN IP address in a browser window.

• The Graphic Local UI screen will come up but require you to enter in the Local Credentials for that Edge. 
   

  Note: Please check the Configure->Edge->Overview screen and in the "Properties" section you may view the Local Credentials for this Edge.

Unactivated Edge

There is no need to find a VLAN IP address as the Edge is using factory settings and has no configuration.  The default LAN IP is 192.168.2.1.  Please enter that into a browser window.

3) On an unactivated Edge, you will need to click on a "review the configuration" link at the bottom of the page. This step is not needed for an activated Edge as you will be immediately taken to the Overview page.

4) On the Overview page do the following:
On an activated Edge, click on Details.
On an unactivated Edge, click on Details, and then Diagnostics.

5) On the next page, click on the "Download Diagnostic Bundle" button.

Note: The bundle must be first generated before it is downloaded. During this process, the "Download Diagnostic Bundle" button will remain grayed out. It will take a few minutes for the Edge to process the bundle before the download commences. Please be patient and do not take any other actions until the bundle generation is complete.

Activated Edge Screen:

Unactivated Edge Screen:

6) Once the bundle is generated, the file will be automatically downloaded into your the computer connected to the Edge. You may then send this file to VMware SD-WAN Support or your supporting Partner for analysis.


For support assistance, please refer to the following article: Contact Broadcom support