Users Guide

Dell EMC SmartFabric OS10 zero-touch
deployment
Zero-touch deployment (ZTD) allows OS10 users to automate switch deployment:
● Upgrade an existing OS10 image.
● Execute a CLI batch file to configure the switch.
● Execute a post-ZTD script to perform additional functions.
ZTD is enabled by default when you boot up a switch with a factory-installed OS10 for the first time or when you perform an
ONIE: OS Install from the ONIE boot menu. When a switch boots up with OS10 in ZTD mode, it starts the DHCP client on
all interfaces — management and front-panel ports. ZTD configures all interfaces for untagged VLAN traffic. The switch obtains
an IP address and a ZTD provisioning script URL from a DHCP server running on the network, and downloads and executes the
ZTD script.
NOTE: Zero-touch deployment refers to an OS10 feature, and not the ONIE automated provisioning.
● ZTD is supported only in an IPv4 network. ZTD is not supported by DHCPv6.
● ZTD is not supported if PowerEdge MX Ethernet switches operate in SmartFabric mode.
● If the switch accesses the DHCP server using a front-panel port, the port interface must be in non-breakout mode.
● At least one of the front-panel ports connected to the network on which the DHCP server is running must be in non-
breakout mode.
● After booting up in ZTD mode, if a switch receives no DHCP server response with option 240 within five minutes, it
automatically exits ZTD mode. During this time, you can abort ZTD by entering the ztd cancel command. The command
unlocks the switch configuration so that you can enter OS10 CLI commands.
● When ZTD is enabled, the CLI is locked so you cannot enter OS10 configuration commands. Only the show commands are
available.
According to the contents of the provisioning script, ZTD performs these tasks in thie following sequence. Although Steps 2, 3
and 4 are optional, you must enter a valid URL path for at least one of the IMG_FILE, CLI_CONFIG_FILE, and
POST_SCRIPT_FILE variables. For example, if you only want to configure the switch, enter only a CLI_CONFIG_FILE URL
value. In this case, ZTD does not upgrade the OS10 image and does not execute a post-ZTD script.
1. ZTD downloads the files specified in the ZTD provisioning script — OS10 image, CLI configuration batch file, and post-ZTD
script.
● In the provisioning script, enter the file names for the IMG_FILE, CLI_CONFIG_FILE, and POST_SCRIPT_FILE
variables as shown in ZTD provisioning script.
● If no file names are specified, OS10 immediately exits ZTD and returns to CLI Configuration mode.
● If the download of any of the specified files fails, ZTD stops. OS10 exits ZTD and unlocks CLI Configuration mode.
2. If you specify an OS10 image for IMG_FILE, ZTD installs the standby image. If you do not specify a configuration file for
CLI_CONFIG_FILE, ZTD reloads the switch with the new OS10 image.
3. If you specify an OS10 CLI batch file with configuration commands for CLI_CONFIG_FILE, ZTD executes the commands in
the PRE-CONFIG and POST-CONFIG sections. After executing the PRE-CONFIG commands, the switch reloads with the
new OS10 image and then executes the POST-CONFIG commands. For more information, see ZTD CLI batch file.
4. If you specify a post-ZTD script file for POST_SCRIPT_FILE, ZTD executes the script. For more information, see Post-ZTD
script.
NOTE:
The ZTD process performs a single switch reboot. The switch reboot occurs only if either a new OS10 image is
installed or if the PRE-CONFIG section of the CLI batch file has configuration commands that are executed.
ZTD prerequisites
● Store the ZTD provisioning script on a server that supports HTTP connections.
● Store the OS10 image, CLI batch file, and post-ZTD script on a file server that supports either HTTP, FTP, SFTP, or TFTP
connections.
● Configure the DHCP server to provide option 240 that returns the URL of the ZTD provisioning script.
6
104 Dell EMC SmartFabric OS10 zero-touch deployment