Zero-Touch Provisioning (ZTP) Guide

authoritative;
default-lease-time 600;
max-lease-time 7200;

# This is only needed if the version is lower than 4.4
option loader-pathprefix code 210 = text;


subnet 10.0.0.0 netmask 255.255.255.0 {
  range 10.0.0.200 10.0.0.250;
  option routers 10.0.0.138;
  option domain-name-servers 10.0.0.210;
  option domain-name "local";
  host LEAF01 {
     # Identify client by MAC address.
     hardware ethernet 48:65:ee:11:da:85;
     fixed-address 10.0.0.250;
     option host-name LEAF01;
     # Set DHCP option 114 (default-url) to set the installer image URL.
     # ONIE loads the installer image from the specified URL.
     option default-url "http://managementserver/ztp/image";
     # Set DHCP option 210 (path prefix) to set the configuration base URL.
     # CTRLD loads all configuration files from this base URL.
     option loader-pathprefix "http://managementserver";
 }
}

var fs = require("fs");
var DB = "/usr/share/nginx/html/config.db";
function open_db() {
   var data, map;
   try {
       data = fs.readFileSync(DB);
   } catch (e) {
       data = "{}";
   }
   try {
       map = JSON.parse(data);
   } catch (e) {
       throw Error("open_db: " + e);
   }
   return map;
}

function resolve(r, what) {
   try {
       var map = open_db();
       var data = map[r.headersIn["onie-serial-number"]];
       var result = data[what];
       return result;
   } catch (e) {
       return "not found";
   }
}

function resolveCTRLD(r) {
   return resolve(r,"ctrld")
}

function resolveCTRLDRBAC(r) {
   return resolve(r,"ctrldrbac")
}

function resolveElement(r) {
   return resolve(r,"element")
}

function resolveStartup(r) {
   return resolve(r,"startup")
}

function resolveImage(r) {
   return resolve(r,"image")
}

{
    "591654XK1902037": {               # serial number
        "ctrld": "ctrld.json",         # ctrld configuration file
        "ctrldrbac": "ctrldrbac.json", # ctrld rbac policy file
        "startup": "591654XK1902037_startup.json", # switch startup config file
        "element": "591654XK1902037_element.json", # switch element config file
        "image":                                   # NOS installer file "http://pkg.rtbrick.net/_/images/latest/rtbrick-onl-installer/rtbrick-onl-installer-accessleaf-qmx-20.4.0-g6daily.20200409071129+Bdevelopment.Ce8ba33ec"
    }
}

js_include conf.d/rtb_ztp.js;

 # Maps the ONIE-SERIAL-NUMBER header to the relevant configurations
js_set $ctrld resolveCTRLD;
js_set $ctrldrbac resolveCTRLDRBAC;
js_set $element resolveElement;
js_set $startup resolveStartup;
js_set $image resolveImage;

server {
   listen       80;
   server_name  localhost;

   root   /usr/share/nginx/html;
   #charset koi8-r;
   access_log  /var/log/nginx/ztp.access.log  ztp;

   location = /ztp/config/startup {
       try_files /configs/$startup =404;
       error_page 405 =200 $uri;
   }

   location = /ztp/config/ctrld {
       try_files /configs/$ctrld =404;
       error_page 405 =200 $uri;
   }

   location = /ztp/config/ctrldrbac {
       try_files /configs/$ctrldrbac =404;
       error_page 405 =200 $uri;
   }

   location = /ztp/config/element {
       try_files /configs/$element =404;
       error_page 405 =200 $uri;
   }

   location = /ztp/image {
       return 301 $image;
   }

   location / {
       index  index.html index.htm;
   }
   #error_page  404              /404.html;

   # redirect server error pages to the static page /50x.html
   #
   error_page   500 502 503 504  /50x.html;
   location = /50x.html {
       root   /usr/share/nginx/html;
   }
}

 {
    "_config_name": "ctrld",
    "_config_sha1": "f1e06ef1e53becde6f8baf2b2fafe7dc9c36f6f0",
    "_daemon": "ctrld",
    "_element_name": "leaf01",
    "_log_event": "ZTP0011I",
    "_log_module": "ztp",
    "_serial_number": "591654XK1902037",
    "host": "leaf01",
    "level": 6,
    "short_message": "ztp ctrld config set",
    "timestamp": 1588382356.000511,
    "version": "1.1"
 }