Comandos Compatíveis com os Principais Switches Ubiquiti

Esta lista reúne comandos utilizados nos principais switches Ubiquiti. Além disso, o conteúdo contempla linhas UniFi, EdgeSwitch, EdgeSwitch XP, UISP e equipamentos UFiber, abrangendo operações de administração, interfaces, VLANs, LACP, STP e diagnóstico.

UniFi Switch – Linha Enterprise, Campus e Acesso

• UniFi Switch – Linha Enterprise / Campus / Acesso
  • USW Flex
  • USW Lite 8 / Lite 16
  • USW 24 / USW 24 PoE
  • USW 48 / USW 48 PoE
  • USW Pro 24 / Pro 24 PoE
  • USW Pro 48 / Pro 48 PoE
  • USW Enterprise 8 PoE
  • USW Enterprise 24 PoE
  • USW Enterprise 48 PoE

UniFi Aggregation – Agregação 10G/25G

• UniFi Aggregation – Agregação 10G/25G
  • USW Aggregation
  • USW Aggregation Pro
  • USW Mission Critical

EdgeSwitch – Linha Clássica

• EdgeSwitch – Linha clássica (CLI semelhante a roteadores Edge)
  • EdgeSwitch 8 / 8HP
  • EdgeSwitch 16 / 16XG
  • EdgeSwitch 24 / 24 Lite / 24 PoE
  • EdgeSwitch 48 / 48 Lite / 48 PoE
  • EdgeSwitch ES-10X / ES-10XP

EdgeSwitch XP – Linha PoE Passivo

• EdgeSwitch XP – Linha PoE passivo (antigo ToughSwitch)
  • ES-5XP
  • ES-8XP

UISP Switch – Linha para Provedores e WISPs

• UISP Switch – Linha para provedores / WISPs (antiga UFiber/UISP)
  • UISP Switch
  • UISP Switch Pro
  • UISP Switch 8
  • UISP Switch 16
  • UISP Switch 24
  • UISP Aggregation

UFiber OLT/ONU – Redes FTTH

• UFiber OLT/ONU – Switches integrados para redes FTTH
  • UFiber OLT
  • UFiber OLT-4
  • UFiber OLT-XG

Acesso e Administração da CLI

Primeiramente, utilize os comandos básicos da CLI para navegar entre os diferentes modos do equipamento. Dessa forma, você pode acessar configurações, consultar informações e salvar alterações.

Entrar no modo privilegiado

Para começar, entre no modo privilegiado utilizando o comando abaixo.

 enable 

Entrar no modo de configuração

Em seguida, acesse o modo de configuração para realizar alterações no equipamento.

 configure 

Sair do modo atual

Quando necessário, utilize este comando para retornar ao modo anterior.

 exit 

Sair completamente

Por outro lado, utilize o comando abaixo para sair completamente da sessão ou do contexto atual.

 quit 

Mostrar ajuda

Além disso, consulte a ajuda disponível na CLI para verificar comandos e opções.

 ? 

Salvar configuração

Depois de realizar alterações, salve a configuração na memória do equipamento.

 write memory 

Mostrar versão do sistema

Em seguida, consulte a versão do sistema para identificar o software em execução.

 show version 

Mostrar configuração atual

Assim, você pode visualizar a configuração atualmente em execução no switch.

 show running-config 

Mostrar configuração gravada

Por fim, consulte a configuração armazenada no equipamento.

 show startup-config 

Sistema

Após acessar a CLI, configure os parâmetros básicos do sistema conforme a necessidade de administração do switch. Nesse contexto, é possível definir o hostname, criar usuários e reiniciar o equipamento.

Configurar hostname

Primeiramente, defina o nome utilizado para identificar o switch na rede.

 hostname nome-switch 

Criar usuário

Além disso, adicione um usuário para acesso administrativo ao equipamento.

 username usuario password senha 

Remover usuário

Quando necessário, remova um usuário existente utilizando o comando abaixo.

 no username usuario 

Reiniciar o switch

Por fim, caso seja necessário reiniciar o equipamento, utilize o comando:

 reload 

Interfaces

Para administrar as interfaces, consulte primeiro o estado das portas e, em seguida, acesse a interface desejada. Dessa maneira, você pode configurar descrição, estado operacional, velocidade e duplex.

Listar interfaces

Primeiramente, consulte o status das interfaces disponíveis no switch.

 show interfaces status 

Mostrar interface específica

Depois disso, informe uma porta específica para visualizar seus detalhes.

 show interfaces ethernet 0/1 

Entrar na interface

Em seguida, acesse o contexto da interface que será configurada.

 interface ethernet 0/1 

Configurar descrição

Além disso, defina uma descrição para facilitar a identificação da porta.

 description texto 

Habilitar interface

Para ativar administrativamente a interface, utilize:

 no shutdown 

Desabilitar interface

Por outro lado, caso seja necessário desativar a porta, utilize:

 shutdown 

Configurar velocidade

Quando necessário, defina a velocidade da interface utilizando o comando abaixo.

 speed 1000 

Configurar duplex

Da mesma maneira, configure o modo duplex da interface.

 duplex full 

VLAN

As VLANs permitem organizar a segmentação lógica da rede. Para isso, crie as VLANs necessárias e, posteriormente, configure as portas como ACCESS ou TRUNK conforme o cenário.

Criar VLAN

Primeiramente, entre no contexto de VLAN e crie a VLAN desejada.

 vlan database
vlan 10
exit

Mostrar VLANs

Em seguida, consulte as VLANs configuradas no switch.

 show vlan 

Configurar porta ACCESS

Para configurar uma porta de acesso, entre na interface e associe a VLAN desejada.

 interface ethernet 0/1
switchport mode access
switchport access vlan 10

Configurar porta TRUNK

Por outro lado, utilize o modo TRUNK quando a interface precisar transportar as VLANs permitidas.

 interface ethernet 0/1
switchport mode trunk
switchport trunk allowed vlan add all

Link Aggregation: LACP e Port-Channel

Para aumentar a capacidade ou criar agregação entre interfaces, utilize recursos de Link Aggregation. Nesse contexto, os comandos abaixo apresentam a criação do Port-Channel e a associação de interfaces ao LAG.

Criar Port-Channel

Primeiramente, crie o Port-Channel que será utilizado na agregação.

 interface port-channel 1 

Adicionar interfaces ao LAG

Em seguida, associe a interface ao grupo de agregação utilizando o modo active.

 interface ethernet 0/1
channel-group 1 mode active

Mostrar EtherChannel

Depois disso, consulte o resumo dos grupos de agregação configurados.

 show etherchannel summary 

Spanning Tree

O Spanning Tree auxilia no controle da topologia de camada 2. Portanto, consulte o estado do STP e configure os parâmetros necessários para as VLANs e portas.

Mostrar STP

Primeiramente, consulte o estado atual do Spanning Tree.

 show spanning-tree 

Configurar prioridade STP

Em seguida, defina a prioridade do STP para a VLAN desejada.

 spanning-tree vlan 10 priority 4096 

Ativar Portfast (edge)

Quando necessário, habilite o Portfast na interface correspondente.

 spanning-tree portfast 

Endereçamento e Interface VLAN (SVI)

Além da comutação de camada 2, o switch pode utilizar interfaces VLAN para endereçamento. Dessa maneira, é possível criar uma SVI, definir um endereço IP e consultar suas interfaces VLAN.

Criar interface VLAN

Primeiramente, acesse a interface VLAN que será utilizada.

 interface vlan 10 

Configurar IP

Em seguida, configure o endereço IP e a máscara correspondentes.

 ip address x.x.x.x y.y.y.y 

Mostrar interfaces VLAN

Por fim, consulte as interfaces VLAN configuradas no equipamento.

 show interfaces vlan 

Diagnóstico

Durante um troubleshooting, utilize os comandos de diagnóstico para testar conectividade e analisar as informações de encaminhamento. Assim, fica mais fácil identificar problemas relacionados à rede, MAC e ARP.

Ping

Primeiramente, teste a conectividade com o endereço IP desejado.

 ping x.x.x.x 

Traceroute

Em seguida, utilize o traceroute para analisar o caminho até o destino.

 traceroute x.x.x.x 

Mostrar tabela MAC

Além disso, consulte os endereços MAC aprendidos pelo switch.

 show mac-address-table 

Limpar tabela MAC

Quando necessário, limpe os registros dinâmicos da tabela MAC.

 clear mac-address-table dynamic 

Mostrar ARP

Por fim, consulte a tabela ARP disponível no equipamento.

 show arp 

SNMP

Para monitoramento remoto, configure as comunidades SNMP conforme o nível de acesso necessário. Além disso, existem comandos separados para permissões de leitura e escrita.

Configurar comunidade SNMP de leitura

Primeiramente, defina a comunidade com permissão de leitura.

 snmp-server community nome ro 

Configurar comunidade SNMP de escrita

Por outro lado, quando for necessário utilizar uma comunidade com permissão de escrita, configure-a com:

 snmp-server community nome rw