If you want to hard code a script to be executed every boot, configure the following.

conf t
    ztp bootscript /disk0:/myscript
commit

The above configuration will wait for the first data-plane interface to be configured and then wait an additional minute for the management interface to be configured with an IP address, to ensure that we have connectivity in the third party namespace for applications to use. If the delay is not desired, use:

conf t
    ztp bootscript preip /disk0:/myscript
commit

Note	When the above command is first configured, you will be prompted if you wish to invoke it now. The prompt helps with testing.

ZTP includes a set of shell utilities that can be sourced within the user script. ztp_helper.sh is a shell script that can be sourced by the user script. ztp_helper.sh provides simple utilities to access some XR functionalities. Following are the bash functions that can be invoked:

• xrcmd—Used to run a single XR exec command:

  xrcmd “show running”

• xrapply—Applies the block of configuration, specified in a file:

  
  cat >/tmp/config <<%%
  !! XR config example
  hostname node1-mgmt-via-xrapply
  %%
  xrapply /tmp/config

• xrapply_with_reason—Used to apply a block of XR configuration along with a reason for logging purpose:

  
  cat >/tmp/config <<%%
  !! XR config example
  hostname node1-mgmt-via-xrapply
  %%
  xrapply_with_reason "this is a system upgrade" /tmp/config

• xrapply_string—Used to apply a block of XR configuration in one line:

  
  xrapply_string "hostname foo\ninterface GigabitEthernet0/0/0/0\nipv4 address 1.2.3.44 255.255.255.0\n"

• xrapply_string_with_reason—Used to apply a block of XR configuration in one line along with a reason for logging purposes:

  
  xrapply_string_with_reason ”system renamed again" "hostname venus\n interface TenGigE0/0/0/0\n ipv4 address 172.30.0.144/24\n”

• xrreplace—Used to apply XR configuration replace in XR namespace via a file.

  
  cat rtr.cfg <<%%
  !! XR config example
  hostname node1-mgmt-via-xrreplace
  %%
  xrreplace rtr.cfg

• admincmd—Used to run an admin CLI command in XR namespace. Logs can be found in /disk0:/ztp/ztp_admincmd.log

  
  admincmd running [show platform]
  
  ztp-user connected from 192.0168.0.1 using console on host
  sysadmin-vm:0_RP0# show platform | nomore
  Tue Jan 30 23:12:30.757 UTC
  Location Card Type HW State SW State Config State 
  ----------------------------------------------------------------------------
  0/RP0 NCS-5501 OPERATIONAL OPERATIONAL NSHUT 
  0/FT0 NCS-1RU-FAN-FW OPERATIONAL N/A NSHUT 
  0/FT1 NCS-1RU-FAN-FW OPERATIONAL N/A NSHUT 
  0/PM0 NCS-1100W-ACFW OPERATIONAL N/A NSHUT 
  0/PM1 NCS-1100W-ACFW OPERATIONAL N/A NSHUT 
  
  

• xrapply_with_extra_auth—Used to apply XR configuration that requires authentication, in XR namespace via a file. The xrapply_with_extra_auth API is used when configurations that require additional authentication to be applied such as alias, flex groups.

  
  cat >/tmp/config <<%%
  !! XR config example
  alias exec alarms show alarms brief system active
  alias exec version run cat /etc/show_version.txt
  %%
  xrapply_with_extra_auth >/tmp/config 
  
  

• xrreplace_with_extra_auth—Used to apply XR configuration replace in XR namespace via a file The xrreplace_with_extra_auth API is used when configurations that require additional authentication to be applied such as alias, flex groups

  
  cat >/tmp/config <<%%
  !! XR config example
  alias exec alarms show alarms brief system active
  alias exec version run cat /etc/show_version.txt
  %%
  xrreplace_with_extra_auth >/tmp/config 

ZTP logs its operation on the flash file system in the directory /disk0:/ztp/. ZTP logs all the transaction with the DHCP server and all the state transition.

The following example displays the execution of a simple configuration script downloaded from a data interface using the command ztp initiate interface Ten 0/0/0/0 verbose , this script will unshut all the interfaces of the system and configure a load interval of 30 seconds on all of them.

#!/bin/bash
#############################################################################
# *** Be careful this is powerful and can potentially destroy your system ***
#                *** !!! Use at your own risk !!! ***
#
# Script file should be saved on the backend HTTP server
#############################################################################

source ztp_helper.sh
config_file="/tmp/config.txt"
interfaces=$(xrcmd "show interfaces brief")

function activate_all_if(){
  arInt=($(echo $interfaces | grep -oE '(Te|Fo|Hu)[0-9]*/[0-9]*/[0-9]*/[0-9]*'))
  for int in ${arInt[*]}; do
    echo -ne "interface $int\n no shutdown\n load-interval 30\n" >> $config_file
  done
  xrapply_with_reason "Initial ZTP configuration" $config_file
}

### Script entry point
if [ -f $config_file ]; then
  /bin/rm -f $config_file
else
  /bin/touch $config_file
fi
activate_all_if;
exit 0

The following example displays the the console log of ztp initiate interface hundredGigE 0/1/0/4:

RP/0/RSP0/CPU0:vkg1#ztp initiate interface hundredGigE 0/1/0/4 verbose
Invoke ZTP? (this may change your configuration) [confirm] [y/n] :y
ZTP will now run in the background.
Please use "show logging" or look at /disk0:/ztp/ztp.log to check progress.
RP/0/RSP0/CPU0:vkg1#(Global VRF NS                 ) Fri Sep  1 12:47:46 UTC 2017: (pid  2984) (/pkg/bin/ztp.sh)                       : State change to IS_STARTING
(Global VRF NS                 ) Fri Sep  1 12:47:49 UTC 2017: (pid  2984) (/pkg/bin/ztp.sh)                       : Mgmt interface is brought up and ipv6 enabled
(Global VRF NS                 ) Fri Sep  1 12:48:04 UTC 2017: (pid  2984) (/pkg/bin/ztp.sh)                       : Final interface list: Hg0_1_0_4
(Global VRF NS                 ) Fri Sep  1 12:48:09 UTC 2017: (pid  4270) (/pkg/bin/ztp_invoke_dhcp.sh)           : Starting Global VRF dhclient for: Hg0_1_0_4
(Global VRF NS                 ) Fri Sep  1 12:48:14 UTC 2017: (pid  2984) (/pkg/bin/ztp.sh)                       : ERROR: There is no gateway IP as the server is behind the gateway
(Global VRF NS                 ) Fri Sep  1 12:48:34 UTC 2017: (pid  2984) (/pkg/bin/ztp.sh)                       : Download finished. Waiting on config to be applied now.
(Global VRF NS                 ) Fri Sep  1 12:49:00 UTC 2017: (pid  2984) (/pkg/bin/ztp.sh)                       : ZTP is applying config
(Global VRF NS                 ) Fri Sep  1 12:49:13 UTC 2017: (pid  2984) (/pkg/bin/ztp.sh)                       : Exiting SUCCESSFULLY