alexeygorbunov / cloudvision-ztpaas-utils

Utilities for ZTP as a Service with CloudVision

CloudVision ZTPaaS Utils

Introduction

Arista’s Zero Touch Provisioning is used to configure a switch without user intervention. Built to leverage Arista’s Extensible Operating System (EOS), ZTP as-a-Service provides a flexible solution to onboard EOS devices into CloudVision as-a-Service.

CloudVision ZTPaaS Utils hosts different tools and scripts to support the Zero Touch Provisioning on CVaaS.

Bootstrap Script with a Token

Bootstrap script with a token provides an alternative way of ZTP enrolling an Arista device against CVaaS. The cluster URL and the organisation wide enrollment token can be supplied by the script as opposed to the two being supplied using a USB drive. A DHCP server co-located with the Arista device can be configured to serve this bootstrap script using the bootfile-name option. This bootstrap script, then, takes over and perform all the steps necessary to initate ZTP against the correct CVaaS cluster and tenant.

• Log in to the CVaaS cluster and generate a token using the "Generate" option under "Devices/Onboard Devices" menu

• Download the custom bootstrap script and modify the "USER INPUT" section to specify the cluster URL and the enrollment token:

    ########### USER INPUT ############
    cvAddr = "www.cv-mycluster.arista.io"
    enrollmentToken = "eyJhbGciOiJSUzI1Nixxx..."
  

• Host the script on a server locally, and modify the DHCP server to point to this script via option-67/bootfile-name option

• Boot up the EOS device into ZTP mode. It should download the script and enroll with the desired CVaaS cluster against the correct tenant.

Troubleshooting tips

ZTP-4-EXEC_SCRIPT_SIGNALED: Config script exited with an uncaught signal. Signal code: 1

This usually indicates a problem executing the config script. In most cases this happens when the script is edited on a Microsoft Windows machine due to which each line is ending in Windows(CR LF) instead of Unix(LF). There are multiple ways to replace CR LF with LF, one way is to use Notepad++, click on Edit - EOL Conversion and select Unix(LF) and save the file. This is also described in A Practical Guide to Zero Touch Provisioning (ZTP) in CloudVision as a Service (CVaaS) Community central article.