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.
● The ZTD process does not time out and runs continuously. To stop the ZTD process, you must enter one of the following
commands: ztd-stop, ztd-cancel, or configure terminal.
If you accidentally stop the ZTD process; for example, by entering Configuration mode, but have not made any configuration
changes, use the ztd start command to start the ZTD process. This command does not reload the switch, but starts only
the ZTD process.
NOTE:
On rare occasions, when you enter the configure terminal command, the system goes in to the
CONFIGURATION Mode, but you will not be able to enter any configuration commands. An error similar to the following
appears:
% Error: config locked.
To recover from this error, use the ztd cancel EXEC command to cancel the ZTD process.
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.
6
Dell EMC SmartFabric OS10 zero-touch deployment 127