Dell EMC SmartFabric OS10 User Guide Release 10.5.0

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 command-line interface is locked so that you cannot enter OS10 configuration commands. Only 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.

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.
If you specify an OS10 image for IMG_FILE, ZTD installs the software image in the standby partition. If you do not specify a configuration file for CLI_CONFIG_FILE, ZTD reloads the switch with the new OS10 image.
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.
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.
In the ZTD provisioning script, enter the URL locations of an OS10 image, CLI batch file, and/or post-ZTD script. Enter at least one URL, otherwise the ZTD fails and exits to CLI Configuration mode.

ZTD guidelines

You can store the ZTD provisioning script, OS10 image, CLI batch file, and post-ZTD script on the same server, including the DHCP server.
Write the ZTD provisioning script in bash.
Write the post-ZTD script in bash or Python. Enter #!/bin/bash or #!/usr/bin/python as the first line in the script. The default python interpreter in OS10 is 2.7.
Use only common Linux commands, such as curl, and common Python language constructs. OS10 only provides a limited set of Linux packages and Python libraries.
ZTD is disabled by default on automatically provisioned switch fabrics, such as Isilon backend, PowerEdge MX, and VxRail.

Cancel ZTD in progress

To exit ZTD mode and manually configure a switch by entering CLI commands, stop the ZTD process by entering the ztd cancel command. You can enter ztd cancel only when ZTD is in a waiting state; that is, before it receives an answer from the DHCP server. Otherwise, the command returns an error message; for example:

OS10# ztd cancel
% Error: ZTD cancel failed. ZTD process already started and cannot be cancelled at this stage.

Disable ZTD

To disable ZTD, enter the reload command. The switch reboots in ZTD disabled mode.

Re-enable ZTD

To automatically upgrade OS10 and/or activate new configuration settings, re-enable ZTD by rebooting the switch using the reload ztd command. You are prompted to confirm the deletion of the startup configuration.

NOTE To upgrade OS10 without losing the startup configuration, back up the startup configuration before ZTD runs the provisioning script. Then use the backup startup configuration to restore the previous system configuration.

OS10# reload ztd
This action will remove startup-config [confirm yes/no]:

View ZTD status

OS10# show ztd-status

-----------------------------------
ZTD Status     : disabled
ZTD State      : completed
Protocol State : idle
Reason         : ZTD process completed successfully at Mon Jul 16 19:31:57 2018
-----------------------------------

ZTD logs

ZTD generates log messages about its current status.

[os10:notify], %Dell EMC (OS10) %ZTD-IN-PROGRESS: Zero Touch Deployment 
applying post configurations.

ZTD also generates failure messages.

[os10:notify], %Dell EMC (OS10) %ZTD-FAILED: Zero Touch Deployment failed to 
download the image.

Troubleshoot configuration locked

When ZTD is enabled, the CLI configuration is locked. If you enter a CLI command, the error message configuration is locked displays. To configure the switch, disable ZTD by entering the ztd cancel command.

OS10# configure terminal
% Error: ZTD is in progress(configuration is locked).
OS10# ztd cancel

ようこそ

Dellへようこそ

Dell EMC SmartFabric OS10 User Guide Release 10.5.0

Dell EMC SmartFabric OS10 zero-touch deployment

このコンテンツを評価する