Configurar e solucionar problemas do ZTP nos Catalyst 9000 Series Switches (Cat9k/C9k)

Introdução

Este documento descreve a configuração e o provisionamento do ZTP (Zero Touch Provisioning) em switches Cisco Catalyst 9k Series. 

Pré-requisitos

Requisitos 

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Configuração do servidor DHCP no switch
• Código Python básico 
• Conceitos básicos do serviço HTTP/TFTP

Plataformas suportadas

• Catalyst 9300 Series Switches executando a versão 16.5.1a
• Catalyst 9500 Series Switches executando a versão 16.5.1a
• Catalyst 9400 Series Switches executando a versão 16.6.2

Configurando o serviço HTTP

Etapa 1. Instalar o Serviço HTTP no Host Final (Exemplo Linux)

sudo apt update
sudo apt install apache2

Etapa 2. Criar arquivo Python ztp_http.py

Se algum problema de permissão surgir, use  chmod 777  para dar permissão completa ao arquivo.

O arquivo Python tem estas tarefas:

1. Mostrar verificação de comando.

2. Configuração de loopback.

3. Verificação da configuração.

#Importing cli module
import cli

print "\n\n Running show version \n\n"
cli.executep('show version')

print "\n\n Configure a Loopback Interface \n\n"
cli.configurep(["interface loop 25", "ip address 192.168.0.25 255.255.255.255", "end"])

print "\n\n Running show ip interface brief \n\n"
cli.executep('show ip int brief | i up')

print "\n\n ZTP is success \n\n"

Este arquivo deve ser armazenado em  /var/www/html  na máquina Linux.

vm: /var/www/html$ -ls -l ztp_http.py
-rwxrwxrwx 1 root root 346 Apr 04 14:14 ztp_http.py

Etapa 3. Verificar Serviço HTTP e Porta de Escuta

Use o comando service para verificar se o serviço HTTP foi iniciado e está em execução agora.

vm: /var/www/html$ sudo service apache2 status
Active: active (running)

Verifique com qual porta o serviço HTTP está escutando agora.

vm: /var/www/html$ sudo netstat -anp | grep apache
tcp6 0 :::80 :::* LISTEN 1998/apache2 <<<< Listens at 80

Etapa 4. Verificação de Porta do Navegador

Verifique se o arquivo pode ser baixado usando qualquer navegador da Web.

1. Abra qualquer navegador dentro da mesma máquina, neste caso o Linux.

2. Informe-o na barra de pesquisa  localhost:80/ztp_http.py

3. O arquivo é baixado automaticamente.

Configurando o serviço DHCP

Etapa 1. Configuração da interface de provisionamento (novo dispositivo)

Espera-se que o novo switch seja conectado a G1/0/1.

enable
configure terminal
interface g1/0/1
description New_9300_switch
switchport
switchport mode access
switchport access vlan 1

Etapa 2. Configuração da interface conectada ao servidor HTTP

O servidor HTTP (Linux) está diretamente conectado a switches 3850, por exemplo, na interface G1/0/2.

enable
configure terminal
interface g1/0/2
description Linux_is_connected_here
switchport
switchport mode access
switchport access vlan 1

Etapa 3. Configuração de Escopo DHCP

Exemplo de configuração do pool DHCP com a opção 67.

enable
configure terminal
ip dhcp pool ZTP_Pool
network 10.0.0.0 255.255.255.0
default-router 10.0.0.1
option 67 ascii http://10.0.0.2:80/ztp_http.py
end

Verificar

No momento, não há procedimento de verificação disponível para esta configuração.

Saídas de trabalho

No startup-config, starting autoinstall/pnp/ztp...

Autoinstall will terminate if any input is detected on console


--- System Configuration Dialog ---

Would you like to enter the initial configuration dialog? [yes/no]: <<<<<<<< Do not provide any input during this time.
Autoinstall trying DHCPv6 on Vlan1

Autoinstall trying DHCPv4 on Vlan1

Acquired IPv4 address 10.0.0.10 on Interface Vlan1
Received following DHCPv4 options:
bootfile : http://10.0.0.2:80/ztp_http.py

stop Autoip process
OK to enter CLI now...

pnp-discovery can be monitored without entering enable mode

Entering enable mode will stop pnp-discovery

Attempting bootfile http://10.0.0.2:80/ztp_http.py

Loading http://10.0.0.2:80/ztp_http.py
Loading http://10.0.0.2:80/ztp_http.py day0guestshell activated successfully
Current state is: ACTIVATED
day0guestshell started successfully
Current state is: RUNNING
Guestshell enabled successfully


Running show version         <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< show command executed


Cisco IOS XE Software, Version 17.06.04
Cisco IOS Software [Bengaluru], Catalyst L3 Switch Software (CAT9K_IOSXE), Version 17.6.4, RELEASE SOFTWARE (fc1)

<snipped>

Model Number : C9300L-48T-4X
System Serial Number : FOC2531LGM8
CLEI Code Number :
Switch Ports Model SW Version SW Image Mode
------ ----- ----- ---------- ---------- ----
* 1 53 C9300L-48T-4X 17.06.04 CAT9K_IOSXE BUNDLE




Configure a Loopback interface    <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< configuration


Line 1 SUCCESS: interface loop 25
Line 2 SUCCESS: ip address 192.168.0.25 255.255.255.255
Line 3 SUCCESS: end




Running show ip int brief  <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< Config Verification


Vlan1 10.0.0.10 YES DHCP up up
Vlan4094 192.168.2.1 YES manual up down
GigabitEthernet0/0 unassigned YES unset up up
GigabitEthernet1/0/2 unassigned YES unset up up
GigabitEthernet1/0/3 unassigned YES unset up up
Ap1/0/1 unassigned YES unset up up
Loopback25 192.168.0.25 YES other up up




ZTP is success




Guestshell destroyed successfully
Script execution success!  <<<<<<<<<<<<<<<<<<< Success message

Troubleshooting

Esta seção fornece informações que podem ser usadas para o troubleshooting da sua configuração.

Problemas comuns

1. Outro Servidor DHCP Presente na Rede

No startup-config, starting autoinstall/pnp/ztp...

Autoinstall will terminate if any input is detected on console


--- System Configuration Dialog ---

Would you like to enter the initial configuration dialog? [yes/no]:
Autoinstall trying DHCPv6 on Vlan1

Autoinstall trying DHCPv4 on Vlan1

Acquired IPv4 address 192.168.45.117 on Interface Vlan1 <<<<<<<<<< Gets different ip from another DHCP server.
Received following DHCPv4 options:
hostname : Switch

stop Autoip process
OK to enter CLI now...

pnp-discovery can be monitored without entering enable mode

Entering enable mode will stop pnp-discovery
Guestshell destroyed successfully

stop Autoip process
% Please answer 'yes' or 'no'.
Would you like to enter the initial configuration dialog? [yes/no]: no

2. Erro de Arquivo Python

--- System Configuration Dialog ---

Would you like to enter the initial configuration dialog? [yes/no]:
Autoinstall trying DHCPv6 on Vlan1

Autoinstall trying DHCPv4 on Vlan1

Acquired IPv4 address 10.106.37.69 on Interface Vlan1
Received following DHCPv4 options:
bootfile : http://10.106.37.59:80/ztp_http.py

stop Autoip process
OK to enter CLI now...

pnp-discovery can be monitored without entering enable mode

Entering enable mode will stop pnp-discovery

Attempting bootfile http://10.106.37.59:80/ztp_http.py

Loading http://10.106.37.59:80/ztp_http.py
Loading http://10.106.37.59:80/ztp_http.py day0guestshell activated successfully
Current state is: ACTIVATED
day0guestshell started successfully
Current state is: RUNNING
Guestshell enabled successfully
File "/bootflash/guest-share/downloaded_script.py", line 1
print "\n\n Running show version \n\n"
^
SyntaxError: Missing parentheses in call to 'print'. Did you mean print("\n\n Running show version \n\n")?  <<<<<< Error

Guestshell destroyed successfully
Script execution success!

3. Número da Porta do Serviço HTTP

O serviço HTTP está escutando em portas diferentes, como 8080, mas a configuração DHCP para a opção 67 está apontando para 80.

enable
configure terminal
ip dhcp excluded-address 10.0.0.2
ip dhcp pool ZTP_Pool
network 10.0.0.0 255.255.255.0
default-router 10.0.0.1
option 67 ascii http://10.0.0.2:80/ztp_http.py    <<<<<<<<<<<<< Change to 8080

4. Endereço IP duplicado

Verifique o escopo do DHCP e exclua o endereço IP atribuído ao servidor HTTP.

enable
configure terminal
ip dhcp excluded-address 10.0.0.2     <<<<<<<<<<<<<<<< Exclude HTTP server address.
ip dhcp pool ZTP_Pool
network 10.0.0.0 255.255.255.0
default-router 10.0.0.1
option 67 ascii http://10.0.0.2:80/ztp_http.py

5. Verificar o Serviço HTTP, Parar e Reiniciar

vm: /var/www/html$ sudo service apache2 stop
vm: /var/www/html$ sudo service apache2 start
vm: /var/www/html$ sudo service apache2 status

Captura do pacote

Resumo do intercâmbio HTTP:

10.0.0.10    10.0.0.2    HTTP  183  GET /http_ztp.py HTTP/1.1        <<<<<< HTTPGETrequest
10.0.0.2     10.0.0.10   HTTP  245  HTTP/1.1 200 OK (text/x-python)  <<<<<< Response

Resposta HTTP em detalhes:

Hypertext Transfer Protocol
HTTP/1.1 200 OK\r\n
Content-Type: text/x-python\r\n
Content-Length: 20\r\n 
Date: Tue, 04 Apr 2023 12:24:02 GMT\r\n
Connection: keep-alive\r\n
Keep-Alive: timeout=5\r\n
\r\n
[HTTP response 1/2]
[Time since request: 0.204568243 seconds]
[Request in frame: 21]
[Next request in frame: 25]
[Next response in frame: 26]
[Request URI: http://10.0.0.2:80/http_ztp.py] >>>>>>> URL