Installing DMF Switches
This chapter describes installing DANZ Monitoring Fabric (DMF) switches and performing initial setup and configuration.
DMF supports secure HTTPS connectivity for Controller-hosted URLs using ZTP.
Before DMF version 8.4, the Controller used HTTP to access ZTP install scripts and software images. HTTP does not provide the security required in today’s network environments, so the need for HTTPS support arose in those customer environments where all port 80 traffic (HTTP) is blocked. Blocking HTTP access makes the DHCP-based installation of Switch Light and other required software impossible. This new feature allows access to ZTP install scripts and software images via secure HTTPS.
HTTPS Support for Controller Hosted URLs using ZTP
DANZ Monitoring Fabric (DMF) supports secure HTTPS connectivity for controller-hosted URLs using ZTP.
Before DMF version 8.4, the Controller used HTTP to access ZTP install scripts and software images. HTTP does not provide the security required in today’s network environments, so the need for HTTPS support arose in those customer environments where all port 80 traffic (HTTP) is blocked. Blocking HTTP access makes the DHCP-based installation of Switch Light and other required software impossible. This new feature allows access to ZTP install scripts and software images via secure HTTPS.
This feature does not require any special configuration.
Use the CLI show switch-image url command to display the URLs for the ZTP install script and images.
The output contains HTTP and HTTPS URLs for the script and each available image, as shown in the following example.
C1> show switch-image url
# FileUrlAlternative Url
-|-------------------------|------------------------------------------------------------|---------------|
1 arista-ztp-install-script http://<controller IP>/switchlight/arista-ztp-install-script
2 arista-ztp-install-script https://<controller IP>/switchlight/arista-ztp-install-script
3 install-amd64 http://<controller IP>/switchlight/install-amd64
4 install-amd64 https://<controller IP>/switchlight/install-amd64
5 update-amd64http://<controller IP>/switchlight/amd64
6 update-amd64https://<controller IP>/switchlight/amd64
7 update-aristaeoshttp://<controller IP>/eos/x86_64
8 update-aristaeoshttps://<controller IP>/eos/x86_64
Zero Touch Fabric Provisioning Modes
- Layer 2 Zero Touch Fabric (L2ZTF, Auto-discovery switch provisioning mode): In this mode, which is the default, Switch ONIE software automatically discovers the Controller via IPv6 local link addresses and downloads and installs the appropriate Switch Light OS image from the Controller. This installation method requires all the fabric switches and the DMF Controller to be in the same Layer 2 network (IP subnet). If the fabric switches need IPv4 addresses to communicate with SNMP or other external services, configure IPAM, which provides the Controller with a range of IPv4 addresses to allocate to the fabric switches.
- Layer 3 Zero Touch Fabric (L3ZTF, Preconfigured switch provisioning mode): When fabric switches are in a different Layer 2 network from the Controller, log in to each switch individually to configure network information and download the ZTF installer. Subsequently, the switch automatically downloads Switch Light OS from the Controller. This mode requires communication between the Controller and the fabric switches to occur using IPv4 addresses, and no IPAM configuration is required.
controller-1(config)# switch <name>
controller-1(config-switch)# mac <mac-address>The following table summarizes the requirements for installation using each mode:
| Requirements | Layer 2 mode | Layer 3 mode |
|---|---|---|
| Any switch in a different subnet from the Controller? | No | Yes |
| IPAM configuration for SNMP and other IPv4 services? | Yes | No |
| IP address assignment | IPv4 or IPv6 | IPv4-only |
| Refer to this section | Using L2 ZTF (Auto-Discovery) Provisioning Mode | Changing to Layer 3 (Pre-Configured) Switch Provisioning Mode |
Install all the fabric switches in a single fabric using the same mode. If there are any fabric switches in a different IP subnet than the Controller, DANZ Monitoring Fabric (DMF) requires using Layer 3 mode to install all the switches, even those in the same Layer 2 network as the Controller. Installing switches in mixed mode, with some switches using ZTF in the same Layer 2 network as the Controller, while other switches in a different subnet are installed manually or using DHCP is unsupported.
Using L2 ZTF (Auto-Discovery) Provisioning Mode
Requirements
- The DANZ Monitoring Fabric 8.5 Hardware Compatibility List lists the supported fabric switches.
- Connect the management Ethernet interface of each physical switch to the management network and power it up.
- Connect the DANZ Monitoring Fabric (DMF) Controller appliance management interface to the same Layer 2 management network as the management Ethernet interface of every physical switch.
- When upgrading switches from a previous deployment, ensure the Switch Light OS image is compatible with your Controller version.
- Designate a range of IPv4 addresses to be assigned using IPAM when switches must communicate with SNMP, NTP, syslog, or other IPv4 services.
Switch Installation Procedure
As shown in the illustration, services can be provided by the DMF Service Node Appliance or a third-party Network Packet Broker (NPB).
To use ZTF to bring up a DMF switch in this deployment, complete the following steps:
- Initiate the ONIE request on the switch.
- Select ONIE: Install OS.
This selection puts the switch into the installer mode, and the rest of the process runs automatically, beginning with the following message.
### START - switch console output for installer : ONIE: OS Install Mode ... ...The switch discovers the Controller on the management plane as part of the installation process that occurs when it starts. The following figure illustrates the process after registering a connected fabric switch on the Controller.Figure 2. Switch Boot and ZTF Configuration 
When powering on a compatible switch, it boots using the U-boot service, which is pre-installed, and this starts the ONIE loader.
The remainder of the steps in the installation and configuration process happen automatically after powering on the registered and physically connected switch. These automated steps are shown in the figure above and are summarized below.
Note: Steps 5 through 7 below are performed automatically during the ZTF process and typically require no user intervention. If a switch is in a different subnet than the Controller, refer to the Changing to Layer 3 (Pre-Configured) Switch Provisioning Mode section for details about how to install it. - Select ONIE: Install OS.
Arista Switch Installation Procedure for 7050X Series and 7260X Series
The initial installation of Switch Light OS on the Arista platforms is accomplished by dropping it into the Aboot shell interface at boot time and telling it to boot the Switch Light switch image. This operation will install Switch Light on the system. This is a one-time extra step needed during the first installation of Switch Light OS in DMF. The boxes will subsequently boot as expected under Switch Light.
This procedure is also required for any Arista switches currently running EOS. Perform the following steps for the Arista switch to boot from the DMF Controller:
Allocating IPv4 Addresses to Fabric Switches
When using L2 ZTF, the DANZ Monitoring Fabric (DMF) Controllers and fabric switches use link-local IPv6 for communication. To enable switches to communicate with external (IPv4) services, configure IP address management (IPAM), which assigns IPv4 addresses to the switches in the fabric from a configured pool of addresses. This configuration enables a fabric switch in L2-ZTN mode to communicate with external services such as NTP, SNMP, and Syslog.
No IPv4 address is required for the switch to interact with the Controller for time synchronization (NTP) and logging (syslog).
Static IP Addresses
Static IPv4 addresses can be configured on switches in a fabric managed by IPAM.When IPAM is enabled, IPAM will automatically assign IPv4 addresses to switches on which a static IPv4 address has not been configured as long as there are allocated IP addresses available. DMF preserves both automatically and statically allocated IP addresses in the event of a reboot or Controller failure.
Using the GUI to Allocate IPv4 Addresses
- Select from the main menu and click on the IP Address Allocation tab.
Figure 3. Accessing the Switches Page 
The Switches page lists the switches connected to the DANZ Monitoring Fabric (DMF) Controller, and the IP Address Allocation tab provides controls for configuring a pool of IPv4 addresses for IPAM assignment to the fabric switches.
- Click the Edit Configuration control at the top of the IP Address Allocation tab.
Figure 4. IP Address Allocation Tab 
- In the Edit Switch IP Address Allocation dialog, enable IPAM using the Status switch, and specify the gateway, DNS server, and subnet mask length.
Figure 5. Edit Switch IP Address Allocation Dialog 
- To view the operational state of IPAM in the fabric and confirm the address range, select from the main menu and click on the IP Address Allocation tab.To view the IP address assignment for each switch, click on the + icon.
Figure 6. Viewing Operational State 
Figure 7. Viewing IP Address Assignments 
Using the CLI to Allocate IPv4 Addresses with IPAM
Assigning Static IPv4 Addresses
If needed, a static IPv4 address can be assigned to a switch in a fabric managed by IPAM. Removing the assigned address will return the switch to IPAM address management, and an IPv4 address will be assigned to it from the allocated pool if one is available.
Using the GUI to Assign a Static IPv4 Address
- Select from the main menu and select the IP Address Allocation tab.
Figure 8. Accessing the Switches Page - On the Switches tab, click the menu icon next to the switch to which the address will be assigned, and select Configure from the menu.
Figure 9. Configure 
- In the Configure Switch dialog, set the IP Assignment Type to
Manualand enter the desired IPv4 address for the switch.Figure 10. Configure Switch 
Note: The assigned static address must be in the defined IPAM subnet. - To confirm the IP address assignment for the switch, select from the main menu and click on the IP Address Allocation tab, then click on the + icon to display IP addresses for all switches.
Figure 11. Viewing IP Address Assignments
Using the CLI to Assign a Static IPv4 Address
auto as shown below:
controller-1(config)# show running-config switch core1
! switch
switch core1
ip-address auto 10.0.0.2
mac 00:53:00:57:c9:3b
Static Address Assignment Troubleshooting and Limitations
Syslog Messages and Tracing
There are no syslog messages associated with this feature. To gain insight into the IPAM IP allocation process, enable tracing logs.
controller-1(config)#logging level org.projectfloodlight.core.ipalloc trace
controller-1(config)#logging level org.projectfloodlight.zerotouch.startupconfig trace
controller-1(config)#show logging controller | grep Ipam
Locate relevant log output in the floodlight syslog at /var/log/floodlight/floodlight.log.
Troubleshooting
When troubleshooting, be sure to use the show ipam switch command to display actual IP address allocations instead of the show running-config ipam switch command, which only displays the configuration and last used auto IP addresses of the switches.
- IPAM is enabled.
- Make sure that the
allocatefield is present in the IPAM configuration. If not, configure the deployment mode as shown below:controller-1(config)#ipam switch controller-1(config-ipam-switch)#allocate - Make sure that the ZTN deployment mode is set to
auto-discovery.If not, configure the deployment mode as shown below:controller-1(config)deployment-mode auto-discovery
- Make sure that the
- For a configured s IP address, make sure that the address is in the defined IPAM subnet.
- For an
autoIP address, make sure that there are enough IP addresses in the defined IP address ranges for all switches.Note: AnautoIP address in a switch configuration does not necessarily result in an actual IP address assignment and stays there even if the allocated IP address is unavailable, e.g., if IPAM is disabled or the corresponding IP address range is removed. If a configuration change (such as enabling IPAM or adding an IP address range that includes the allocated address), the switch will get this IP address, which was the last automatically allocated IP address, to promote IP stability. - You may cross-check the applied IP address on the running configuration of the switch as shown below:
controller-1#show switch core1 running-config | grep ip-address swl interface ip-address 10.0.0.3 prefix 21 - An alternative way to cross-check the IP address of the switch is to connect to it and then execute the ifconfig command to view the IP address of the interface:
> connect switch core1 Switch Light OS SWL-OS-DMF-8.5.x(0), 2023-12-01.02:24-4be6844 Linux core1 4.19.296-OpenNetworkLinux #1 SMP Fri Dec 1 02:35:57 UTC 2023 x86_64 SwitchLight ZTN Manual Configuration. Type help or ? to list commands. (ztn-config) debug bash *****************************WARNING****************************** Any/All activities within bash mode are UNSUPPORTED This is intended ONLY for additional debugging ONLY by Arista TAC. Please type "exit" or Ctrl-D to return to the CLI *****************************WARNING****************************** root@core1:~# ifconfig -a eth1: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>mtu 1500 inet6 2001:0DB8:0:1:5054:ff:fe59:b9b6prefixlen 64scopeid 0x20<link> ... ma1: flags=5187<UP,BROADCAST,RUNNING,MASTER,MULTICAST>mtu 1500 inet 10.0.0.2netmask 255.255.248.0broadcast 0.0.0.0 ...
Limitations
- Note that the show switch command does not display IPv4 addresses. To cross-check the assigned IPv4 number, examine the running config of the switch. (See Troubleshooting section.)
- In order to enable IPAM, ZTN deployment mode must be configured as
auto-discovery. - IPAM can only manage switch IP addresses in a single subnet, but multiple IP address ranges can be defined in that subnet.
Using L3 ZTN (Pre-Configured) Switch Provisioning Mode
deployment-mode pre-configured command is entered on the DMF Controller to enable Layer 3 ZTF.
Installing a Switch Using L3 ZTF (Preconfigured) Provisioning Mode
Installing Arista 7050X and 7260X Series Switch Using L3 ZTF (Preconfigured) Provisioning Mode
Procedure
Installing Arista 7280R Series Switch Using L3 ZTF (Preconfigured) Provisioning Mode
This is a one-time setup needed to load the DMF-compatible EOS image. When set up, the next Controller upgrade will also automatically upgrade the switches.
Perform these steps on the 7280R Series switch to boot from the DMF Controller.
Configuring the Switch Static IP and Controller IP in Interactive ZTF Mode
zcsh CLI, complete the following steps:Installing Arista 7050X and 7260X Series using DHCP with bootfile-name option
The Arista ZTP boot script is served to the Arista switch using DHCP’s bootfile-name option (option #67). The Arista switch downloads and executes this Arista ZTP boot script during its ZTP (Zero Touch Provisioning) phase following boot. The Arista ZTP boot script copies the Switch Light OS files from the DMF Controller and configures the appropriate boot settings on the Arista switch.
Procedure
Installing Arista 7280R Series using DHCP with bootfile-name option
Using DHCP with Default URL for Switch Installation in Preconfigured Provisioning Mode
Registering a Switch After Initial Deployment
To add a switch to the fabric after initial deployment, register the name and MAC address of the switch with the active DANZ Monitoring Fabric (DMF) Controller. The switch downloads a compatible Switch Light OS image and configuration from the Controller and uses the registered switch name to refer to the switch in the CLI output and GUI displays.
Using the GUI to Register a Switch
- Select from the main menu.
Figure 12. Fabric Switches Option 
This page lists the switches connected to the DANZ Monitoring Fabric (DMF) Controller, with the current alias of the switch providing a link to the Switch View for the specified switch.
- To add an alias or change the existing alias, click the Menu control next to the switch name and select Configure from the pull-down menu that appears.
Figure 13. Configure Switch (Page 1) 
This dialog provides the means to assign an alias and a MAC address, shut down or re-enable the switch, and change the password for direct remote connections to the switch.
- This dialog also provides access to a series of dialogues used to override the default configuration pushed from the DMF Controller to the switch. To advance to another page, click the numbered link for the page or click Next.
Figure 14. Continue Configuration 
Using the CLI to Register a Switch
switch switch-name command to enter the config-switch submode, to associate the switch name with the MAC address of a physical switch. Replace switch-name with a unique alphanumeric text string. For example, the following commands assign the switch names core-sw-1, filter-sw-1, and delivery-sw-1 to three switches:
controller-1(config)# switch DMF-CORE-SWITCH-1
controller-1(config-switch)# mac 00:00:00:00:00:09
controller-1(config-switch)# switch DMF-FILTER-SWITCH-1
controller-1(config-switch)# mac 00:00:00:00:00:0b
controller-1(config-switch)# switch DMF-DELIVERY-SWITCH-1
controller-1(config-switch)# mac 00:00:00:00:00:0eshow
switch command from any mode, as in the following example:
controller-1> show switch
# Switch NameIP Address StatePipeline Mode
- |--------------- |--------------------------- |--------- |---------------------
1 bigtap-switch-1fe80::ce37:abff:fe60:d474%2connectedbigtap-l3l4-push-vlan
2 bigtap-switch-2fe80::ce37:abff:fe60:cf8a%2connectedbigtap-l3l4-push-vlan
3 bigtap-switch-3fe80::ce37:abff:fea0:9071%2connectedbigtap-l3l4-push-vlanThe output shows the switch alias, IP address, state and pipeline mode.
no switch command.
controller-1(config)# no switch DMF-CORE-SWITCH-1
After removing the switch registration, perform a new switch registration using the new switch name.
Changing the ZTF Mode After Deployment
Changing to Layer 3 (Pre-Configured) Switch Provisioning Mode
ZTF cannot be used to install the switches when the switch management network connects the DANZ Monitoring Fabric (DMF) Controllers through a Layer 3 network. However, when a switch is in a different subnet than the Controller, manually configure the switches or use a DHCP server to download the Switch Light OS image to each fabric switch. To do this, change the switch provisioning mode to Pre-Configured.
If the switches and Controllers are in the same L2 broadcast domain, use the default switch deployment-mode (auto-discovery) for L2-ZTF deployment. If the switches and Controllers are not in the same L2 broadcast domain, change the provisioning mode to pre-configured to enable L3-ZTF deployment. The entire fabric must be in a single provisioning mode; DMF only supports the auto-discovery provisioning mode if all the switches are in the same Layer 2 domain.
Using the GUI to Change the Switch Provisioning Mode
Procedure
- Click the Settings control in the Features section on the Controller landing page.
Figure 15. Changing the Switch Provisioning Mode 
Note: For information about the other options in this section, refer to the DMF User Guide. - Click the Settings controller to the right of the Device Provisioning Mode option and click Submit.
Control the configuration of this feature using the Edit icon by clicking on the pencil icon.
Figure 16. Edit Device Deployment Mode 
Using the CLI to Change the Switch Provisioning Mode
Procedure
Changing to Layer 3 ZTF (Preconfigured) Mode
Procedure
Changing to Layer 2 ZTF (Auto-Discovery) Mode
Procedure
System Reinstall for an EOS Switch
Perform a system reinstall by removing the local startup-config/zerotouch-config on the switch so the DANZ Monitoring Fabric (DMF) Controller no longer manages it.
Rebooting the switch restarts the Arista-native ZTP process and requests a fresh image from the Controller.
Use the following command to perform a system reinstall:
C1# system reinstall switch eos-switch-name rebootThe following is an example where the switch name is core1.
C1(config)# system reinstall switch core1 reboot
system switch reinstall: "deployment-mode pre-configured"
system switch reinstall: l3-ztn currently configured
system switch reinstall: l3-ztn implies switches are remote
system switch reinstall: l3-ztn and some switches may not rejoin
reinstall may cause service interruption
system switch reinstall ("y" or "yes" to continue): y
An optional parameter called reboot forces the switch to reboot and begin the re-installation process.
CLI Show Commands
When the switch is rebooting, ZTN cannot communicate with the switch, so a Zerotouch state error hint and Zerotouch
state error msg appear when using the following show command:
(config)# show switch core1 zerotouch
Name : core1
Ip address : 10.243.254.25
Last update: 2023-06-02 07:18:35.749000 UTC
Zerotouch state: reloading
Zerotouch state error hint : Rest API Client problem
Zerotouch state error msg: Connect to 10.243.254.25:80 [/10.243.254.25] failed: Connection refused (Connection refused)
The error message changes after the switch has fully booted.
SM-InspiringPare-Broadwater-C1(config-crypto)# show switch core1 zerotouch
Name : core1
Ip address : 10.243.254.25
Last update: 2023-06-02 07:29:34.850000 UTC
Zerotouch state: reloading
Zerotouch state error hint : Rest API Client problem
Zerotouch state error msg: No route to host (Host unreachable)
At this point, the switch has booted up entirely. Still, the Controller cannot talk to the switch, as the necessary configuration is absent. Kick-start the DMF ZTN process on the switch again using the commands below:
(config)# management dmf
(config-mgmt-dmf)# controller address ip-address
(config-mgmt-dmf)# no disabled
Troubleshooting
Check the status using the command show switch switch-name zerotouch.
After performing the steps above for reconnecting an EOS switch, and if the state remains stuck in reloading (and there is a Zerotouch state error hint / Zerotouch state error msg output), please contact This email address is being protected from spambots. You need JavaScript enabled to view it..
SKU Reporting for EOS Switches
Like SwitchLight (SWL) OS switches, EOS switches now report their SKUs to the DANZ Monitoring Fabric (DMF) Controller.
View the EOS switch SKU using the DMF Controller CLI or GUI.
Using the CLI to Configure SKU Reporting for EOS Switches
Run the show fabric inventory command from the login mode to view the switch SKUs from the DMF Controller CLI.
SKU column indicates the SKU of each switch.
CONTROLLER-1> show fabric inventory
~~~~~~~~~~~~~~~~~ Controller Inventory ~~~~~~~~~~~~~~~~~
# Node Id Hostname SKUSerial Number
-|-------|-------------------|-----------|-------------|
1 29617 CONTROLLER-1DCA-DM-C450FF99R52
2 23262 CONTROLLER-2DCA-DM-C4503W9D3Y2
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Switch Inventory ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
# Switch SKU Serial Number ManufacturerAsic
-|--------------------|-----------------|-------------|---------------|------------|
1 dmf-arista-7280SR2-2 DCS-7280SR2-48YC6 JPE22123192 Arista Networks jericho-plus
2 dmf-arista-7280CR3-1 DCS-7280CR3-32P4JPE20383391 Arista Networks jericho2
3 dmf-arista-7280SR3-1 DCS-7280SR3-48YC8 JPE22191168 Arista Networks jericho2c
4 dmf-arista-7280CR3-2 DCS-7280CR3-32P4JPE20383398 Arista Networks jericho2
5 dmf-arista-7280SR-1DCS-7280SR-48C6 SGD20370893 Arista Networks jericho
6 dmf-arista-7280SR2-1 DCS-7280SR2-48YC6 JPE20476226 Arista Networks jericho-plus
~~~~~~~~~ Recorder Node Inventory~~~~~~~~~
# Recorder NodeSKUSerial Number
-|-----------------|----------|-------------|
1 DMF-RECORDER-NODE DCA-DM-RA3 FLC1RN3
~~~~~~~~ Service Node Inventory~~~~~~~~
# Service NodeSKUSerial Number
-|-----------------|----------|-------------|
1 DMF-SERVICE-NODEDCA-DM-SDL GS11RN3Using the GUI to Configure SKU Reporting for EOS Switches
To view the switch SKUs from the DMF Controller GUI, hover the mouse over the Fabric menu bar and select Switches.
The Switches page loads.
The SKUs do not appear by default but display after enabling the SKU column. To enable the column, click the menu button in the table. In the menu, select Show/Hide Columns.
In the dialog box, select the SKU checkbox and click Save Preferences.
The SKU column appears in the Switches table and displays the SKU of each switch.
