O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Instale o Cumulus Linux no modo Cumulus

08/29/2025 Colaboradores

PDFs

Siga este procedimento para instalar o SO Cumulus Linux (CL) quando o switch estiver em execução no modo Cumulus.

O SO Cumulus Linux (CL) pode ser instalado quando o switch está executando o Cumulus Linux ou ONIE ("Instale no modo ONIE"consulte ).

Antes de começar

Certifique-se de que tem o seguinte:

Conhecimento do Linux de nível intermediário.
Familiaridade com edição de texto básica, permissões de arquivo UNIX e monitoramento de processos. Uma variedade de editores de texto são pré-instalados, vi incluindo e nano.
Acesso a um shell Linux ou UNIX. Se você estiver executando o Windows, use um ambiente Linux como sua ferramenta de linha de comando para interagir com o Cumulus Linux.
O requisito de taxa de transmissão é definido como 115200 no switch de console serial para acesso ao console de switch NVIDIA SN2100, como segue:
- 115200 baud
- 8 bits de dados
- 1 bit de paragem
- paridade: nenhuma
- controle de fluxo: nenhum

Sobre esta tarefa

Tenha em atenção o seguinte:

Cada vez que o Cumulus Linux é instalado, toda a estrutura do sistema de arquivos é apagada e reconstruída.

A senha padrão para a conta de usuário do Cumulus é Cumulus. A primeira vez que você fizer login no Cumulus Linux, você deve alterar essa senha padrão. Certifique-se de atualizar quaisquer scripts de automação antes de instalar uma nova imagem. O Cumulus Linux fornece opções de linha de comando para alterar a senha padrão automaticamente durante o processo de instalação.

Exemplo 1. Passos

Cumulus Linux 4.4.3

Inicie sessão no interrutor.

O login pela primeira vez no switch requer nome de usuário/senha do Cumulus/Cumulus com sudo o Privileges.

cumulus login: cumulus
Password: cumulus
You are required to change your password immediately (administrator enforced)
Changing password for cumulus.
Current password: cumulus
New password: <new_password>
Retype new password: <new_password>

Verifique a versão Cumulus Linux: net show system

cumulus@cumulus:mgmt:~$ net show system
Hostname......... cumulus
Build............ Cumulus Linux 4.4.3
Uptime........... 0:08:20.860000
Model............ Mlnx X86
CPU.............. x86_64 Intel Atom C2558 2.40GHz
Memory........... 8GB
Disk............. 14.7GB
ASIC............. Mellanox Spectrum MT52132
Ports............ 16 x 100G-QSFP28
Part Number...... MSN2100-CB2FC
Serial Number.... MT2105T05177
Platform Name.... x86_64-mlnx_x86-r0
Product Name..... MSN2100
ONIE Version..... 2019.11-5.2.0020-115200
Base MAC Address. 04:3F:72:43:92:80
Manufacturer..... Mellanox

Configure o nome do host, o endereço IP, a máscara de sub-rede e o gateway padrão. O novo nome de host só se torna efetivo após reiniciar a sessão console/SSH.

Um switch Cumulus Linux fornece pelo menos uma porta de gerenciamento Ethernet dedicada eth0 chamada . Esta interface é especificamente para uso de gerenciamento fora da banda. Por padrão, a interface de gerenciamento usa DHCPv4 para endereçamento.

Não use um sublinhado (_), apóstrofo (') ou carateres não-ASCII no nome do host.

cumulus@cumulus:mgmt:~$ net add hostname sw1
cumulus@cumulus:mgmt:~$ net add interface eth0 ip address 10.233.204.71/24
cumulus@cumulus:mgmt:~$ net add interface eth0 ip gateway 10.233.204.1
cumulus@cumulus:mgmt:~$ net pending
cumulus@cumulus:mgmt:~$ net commit

Este comando modifica os /etc/hostname ficheiros e /etc/hosts.

Confirme se o nome do host, o endereço IP, a máscara de sub-rede e o gateway padrão foram atualizados.

cumulus@sw1:mgmt:~$ hostname sw1
cumulus@sw1:mgmt:~$ ifconfig eth0
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
inet 10.233.204.71  netmask 255.255.254.0  broadcast 10.233.205.255
inet6 fe80::bace:f6ff:fe19:1df6  prefixlen 64  scopeid 0x20<link>
ether b8:ce:f6:19:1d:f6  txqueuelen 1000  (Ethernet)
RX packets 75364  bytes 23013528 (21.9 MiB)
RX errors 0  dropped 7  overruns 0  frame 0
TX packets 4053  bytes 827280 (807.8 KiB)
TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0 device memory 0xdfc00000-dfc1ffff

cumulus@sw1::mgmt:~$ ip route show vrf mgmt
default via 10.233.204.1 dev eth0
unreachable default metric 4278198272
10.233.204.0/23 dev eth0 proto kernel scope link src 10.233.204.71
127.0.0.0/8 dev mgmt proto kernel scope link src 127.0.0.1

Defina a data, a hora, o fuso horário e o servidor NTP no switch.
1. Verifique o fuso horário atual:
  cumulus@sw1:~$ cat /etc/timezone
2. Atualizar para o novo fuso horário:
  cumulus@sw1:~$ sudo dpkg-reconfigure --frontend noninteractive tzdata
3. Verifique o fuso horário atual:
  cumulus@switch:~$ date +%Z
4. Para definir o fuso horário usando o assistente guiado, execute o seguinte comando:
  cumulus@sw1:~$ sudo dpkg-reconfigure tzdata
5. Defina o relógio do software de acordo com o fuso horário configurado:
  cumulus@switch:~$ sudo date -s "Tue Oct 28 00:37:13 2023"
6. Defina o valor atual do relógio do software para o relógio do hardware:
  cumulus@switch:~$ sudo hwclock -w
7. Adicione um servidor NTP, se necessário:
  cumulus@sw1:~$ net add time ntp server <cumulus.network.ntp.org> iburst cumulus@sw1:~$ net pending cumulus@sw1:~$ net commit
8. Verifique se ntpd está em execução no sistema:
  cumulus@sw1:~$ ps -ef | grep ntp ntp 4074 1 0 Jun20 ? 00:00:33 /usr/sbin/ntpd -p /var/run/ntpd.pid -g -u 101:102
9. Especifique a interface de origem NTP. Por padrão, a interface de origem que o NTP usa é eth0. Você pode configurar uma interface de origem NTP diferente da seguinte forma:
  cumulus@sw1:~$ net add time ntp source <src_int> cumulus@sw1:~$ net pending cumulus@sw1:~$ net commit

Instale o Cumulus Linux 4,4.3:

cumulus@sw1:mgmt:~$ sudo onie-install -a -i http://<web-server>/<path>/cumulus-linux-4.4.3-mlx-amd64.bin

O instalador inicia a transferência. Digite y quando solicitado.

Reinicie o switch NVIDIA SN2100:
```
cumulus@sw1:mgmt:~$ sudo reboot
```
A instalação é iniciada automaticamente e as seguintes opções de tela GRUB são exibidas. Não faça nenhuma seleção.
- Cumulus-Linux GNU/Linux
- ONIE: Instale os
- CUMULUS-INSTALL
- Cumulus-Linux GNU/Linux
Repita os passos 1 a 4 para iniciar sessão.

Verifique se a versão Cumulus Linux é 4,4.3: net show version

cumulus@sw1:mgmt:~$ net show version
NCLU_VERSION=1.0-cl4.4.3u0
DISTRIB_ID="Cumulus Linux"
DISTRIB_RELEASE=4.4.3
DISTRIB_DESCRIPTION="Cumulus Linux 4.4.3"

Crie um novo usuário e adicione esse usuário ao sudo grupo. Este usuário só se torna efetivo após a sessão console/SSH ser reiniciada.

sudo adduser --ingroup netedit admin

cumulus@sw1:mgmt:~$ sudo adduser --ingroup netedit admin
[sudo] password for cumulus:
Adding user 'admin' ...
Adding new user 'admin' (1001) with group `netedit' ...
Creating home directory '/home/admin' ...
Copying files from '/etc/skel' ...
New password:
Retype new password:
passwd: password updated successfully
Changing the user information for admin
Enter the new value, or press ENTER for the default
Full Name []:
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n] y

cumulus@sw1:mgmt:~$ sudo adduser admin sudo
[sudo] password for cumulus:
Adding user `admin' to group `sudo' ...
Adding user admin to group sudo
Done.
cumulus@sw1:mgmt:~$ exit
logout
Connection to 10.233.204.71 closed.

[admin@cycrh6svl01 ~]$ ssh admin@10.233.204.71
admin@10.233.204.71's password:
Linux sw1 4.19.0-cl-1-amd64 #1 SMP Cumulus 4.19.206-1+cl4.4.1u1 (2021-09-09) x86_64
Welcome to NVIDIA Cumulus (R) Linux (R)

For support and online technical documentation, visit
http://www.cumulusnetworks.com/support

The registered trademark Linux (R) is used pursuant to a sublicense from LMI, the exclusive licensee of Linus Torvalds, owner of the mark on a world-wide basis.
admin@sw1:mgmt:~$

Cumulus Linux 5.4.0

Inicie sessão no interrutor.

O login pela primeira vez no switch requer nome de usuário/senha do Cumulus/Cumulus com sudo o Privileges.

cumulus login: cumulus
Password: cumulus
You are required to change your password immediately (administrator enforced)
Changing password for cumulus.
Current password: cumulus
New password: <new_password>
Retype new password: <new_password>

Verifique a versão Cumulus Linux: nv show system

cumulus@cumulus:mgmt:~$ nv show system
operational         applied              description
------------------- -------------------- ---------------------
hostname            cumulus              cumulus
build               Cumulus Linux 5.3.0  system build version
uptime              6 days, 8:37:36      system uptime
timezone            Etc/UTC              system time zone

Configure o nome do host, o endereço IP, a máscara de sub-rede e o gateway padrão. O novo nome de host só se torna efetivo após reiniciar a sessão console/SSH.

Não use um sublinhado (_), apóstrofo (') ou carateres não-ASCII no nome do host.

cumulus@cumulus:mgmt:~$ nv set system hostname sw1
cumulus@cumulus:mgmt:~$ nv set interface eth0 ip address 10.233.204.71/24
cumulus@cumulus:mgmt:~$ nv set interface eth0 ip gateway 10.233.204.1
cumulus@cumulus:mgmt:~$ nv config apply
cumulus@cumulus:mgmt:~$ nv config save

Este comando modifica os /etc/hostname ficheiros e /etc/hosts.

Confirme se o nome do host, o endereço IP, a máscara de sub-rede e o gateway padrão foram atualizados.

cumulus@sw1:mgmt:~$ hostname sw1
cumulus@sw1:mgmt:~$ ifconfig eth0
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
inet 10.233.204.71  netmask 255.255.254.0  broadcast 10.233.205.255
inet6 fe80::bace:f6ff:fe19:1df6  prefixlen 64  scopeid 0x20<link>
ether b8:ce:f6:19:1d:f6  txqueuelen 1000  (Ethernet)
RX packets 75364  bytes 23013528 (21.9 MiB)
RX errors 0  dropped 7  overruns 0  frame 0
TX packets 4053  bytes 827280 (807.8 KiB)
TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0 device memory 0xdfc00000-dfc1ffff

cumulus@sw1::mgmt:~$ ip route show vrf mgmt
default via 10.233.204.1 dev eth0
unreachable default metric 4278198272
10.233.204.0/23 dev eth0 proto kernel scope link src 10.233.204.71
127.0.0.0/8 dev mgmt proto kernel scope link src 127.0.0.1

Defina o fuso horário, a data, a hora e o servidor NTP no switch.
1. Defina o fuso horário:
  cumulus@sw1:~$ nv set system timezone US/Eastern cumulus@sw1:~$ nv config apply
2. Verifique o fuso horário atual:
  cumulus@switch:~$ date +%Z
3. Para definir o fuso horário usando o assistente guiado, execute o seguinte comando:
  cumulus@sw1:~$ sudo dpkg-reconfigure tzdata
4. Defina o relógio do software de acordo com o fuso horário configurado:
  cumulus@sw1:~$ sudo date -s "Tue Oct 28 00:37:13 2023"
5. Defina o valor atual do relógio do software para o relógio do hardware:
  cumulus@sw1:~$ sudo hwclock -w
6. Adicione um servidor NTP, se necessário:
  cumulus@sw1:~$ nv set service ntp mgmt listen eth0 cumulus@sw1:~$ nv set service ntp mgmt server <server> iburst on cumulus@sw1:~$ nv config apply cumulus@sw1:~$ nv config save
  Veja o artigo da Base de Conhecimento "A configuração do servidor NTP não está funcionando com os switches NVIDIA SN2100" para mais detalhes.
7. Verifique se ntpd está em execução no sistema:
  cumulus@sw1:~$ ps -ef | grep ntp ntp 4074 1 0 Jun20 ? 00:00:33 /usr/sbin/ntpd -p /var/run/ntpd.pid -g -u 101:102
8. Especifique a interface de origem NTP. Por padrão, a interface de origem que o NTP usa é eth0. Você pode configurar uma interface de origem NTP diferente da seguinte forma:
  cumulus@sw1:~$ nv set service ntp default listen <src_int> cumulus@sw1:~$ nv config apply

Instale o Cumulus Linux 5,4.0:

cumulus@sw1:mgmt:~$ sudo onie-install -a -i http://<web-server>/<path>/cumulus-linux-5.4-mlx-amd64.bin

O instalador inicia a transferência. Digite y quando solicitado.

Reinicie o switch NVIDIA SN2100:
```
cumulus@sw1:mgmt:~$ sudo reboot
```
A instalação é iniciada automaticamente e as seguintes opções de tela GRUB são exibidas. Não faça nenhuma seleção.
- Cumulus-Linux GNU/Linux
- ONIE: Instale os
- CUMULUS-INSTALL
- Cumulus-Linux GNU/Linux
Repita os passos 1 a 4 para iniciar sessão.

Verifique se a versão Cumulus Linux é 5,4.0: nv show system

cumulus@cumulus:mgmt:~$ nv show system
operational         applied              description
------------------- -------------------- ---------------------
hostname            cumulus              cumulus
build               Cumulus Linux 5.4.0  system build version
uptime              6 days, 13:37:36     system uptime
timezone            Etc/UTC              system time zone

Verifique se os nós têm uma conexão com cada switch:

cumulus@sw1:mgmt:~$ net show lldp

LocalPort  Speed  Mode        RemoteHost                          RemotePort
---------  -----  ----------  ----------------------------------  -----------
eth0       100M   Mgmt        mgmt-sw1                            Eth110/1/29
swp2s1     25G    Trunk/L2    node1                               e0a
swp15      100G   BondMember  sw2                                 swp15
swp16      100G   BondMember  sw2                                 swp16

Crie um novo usuário e adicione esse usuário ao sudo grupo. Este usuário só se torna efetivo após a sessão console/SSH ser reiniciada.

sudo adduser --ingroup netedit admin

cumulus@sw1:mgmt:~$ sudo adduser --ingroup netedit admin
[sudo] password for cumulus:
Adding user 'admin' ...
Adding new user 'admin' (1001) with group `netedit' ...
Creating home directory '/home/admin' ...
Copying files from '/etc/skel' ...
New password:
Retype new password:
passwd: password updated successfully
Changing the user information for admin
Enter the new value, or press ENTER for the default
Full Name []:
Room Number []:
Work Phone []:
Home Phone []:
Other []:
Is the information correct? [Y/n] y

cumulus@sw1:mgmt:~$ sudo adduser admin sudo
[sudo] password for cumulus:
Adding user `admin' to group `sudo' ...
Adding user admin to group sudo
Done.
cumulus@sw1:mgmt:~$ exit
logout
Connection to 10.233.204.71 closed.

[admin@cycrh6svl01 ~]$ ssh admin@10.233.204.71
admin@10.233.204.71's password:
Linux sw1 4.19.0-cl-1-amd64 #1 SMP Cumulus 4.19.206-1+cl4.4.1u1 (2021-09-09) x86_64
Welcome to NVIDIA Cumulus (R) Linux (R)

For support and online technical documentation, visit
http://www.cumulusnetworks.com/support

The registered trademark Linux (R) is used pursuant to a sublicense from LMI, the exclusive licensee of Linus Torvalds, owner of the mark on a world-wide basis.
admin@sw1:mgmt:~$

Adicione grupos de usuários adicionais para que o usuário admin acesse nv comandos:

cumulus@sw1:mgmt:~$ sudo adduser admin nvshow
     [sudo] password for cumulus:
     Adding user 'admin' to group 'nvshow' ...
     Adding user admin to group nvshow
     Done.

Consulte "Contas de usuário do NVIDIA" para obter mais informações.

Cumulus Linux 5.11.0

Inicie sessão no interrutor.

Quando você faz login no switch pela primeira vez, ele requer o nome de usuário/senha do Cumulus/Cumulus com sudo o Privileges.

cumulus login: cumulus
Password: cumulus
You are required to change your password immediately (administrator enforced)
Changing password for cumulus.
Current password: cumulus
New password: <new_password>
Retype new password: <new_password>

Verifique a versão Cumulus Linux: nv show system

cumulus@cumulus:mgmt:~$ nv show system
operational         applied              description
------------------- -------------------- ---------------------
hostname            cumulus              cumulus
build               Cumulus Linux 5.4.0  system build version
uptime              6 days, 8:37:36      system uptime
timezone            Etc/UTC              system time zone

Configure o nome do host, o endereço IP, a máscara de sub-rede e o gateway padrão. O novo nome de host só se torna efetivo após reiniciar a sessão console/SSH.

Não use um sublinhado (_), apóstrofo (') ou carateres não-ASCII no nome do host.

cumulus@cumulus:mgmt:~$ nv unset interface eth0 ip address dhcp
cumulus@cumulus:mgmt:~$ nv set interface eth0 ip address 10.233.204.71/24
cumulus@cumulus:mgmt:~$ nv set interface eth0 ip gateway 10.233.204.1
cumulus@cumulus:mgmt:~$ nv config apply
cumulus@cumulus:mgmt:~$ nv config save

Este comando modifica os /etc/hostname ficheiros e /etc/hosts.

Confirme se o nome do host, o endereço IP, a máscara de sub-rede e o gateway padrão foram atualizados.

cumulus@sw1:mgmt:~$ hostname sw1
cumulus@sw1:mgmt:~$ ifconfig eth0
eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
inet 10.233.204.71  netmask 255.255.254.0  broadcast 10.233.205.255
inet6 fe80::bace:f6ff:fe19:1df6  prefixlen 64  scopeid 0x20<link>
ether b8:ce:f6:19:1d:f6  txqueuelen 1000  (Ethernet)
RX packets 75364  bytes 23013528 (21.9 MiB)
RX errors 0  dropped 7  overruns 0  frame 0
TX packets 4053  bytes 827280 (807.8 KiB)
TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0 device memory 0xdfc00000-dfc1ffff

cumulus@sw1::mgmt:~$ ip route show vrf mgmt
default via 10.233.204.1 dev eth0
unreachable default metric 4278198272
10.233.204.0/23 dev eth0 proto kernel scope link src 10.233.204.71
127.0.0.0/8 dev mgmt proto kernel scope link src 127.0.0.1

Defina o fuso horário, a data, a hora e o servidor NTP no switch.
1. Defina o fuso horário:
  cumulus@sw1:~$ nv set system timezone US/Eastern cumulus@sw1:~$ nv config apply
2. Verifique o fuso horário atual:
  cumulus@switch:~$ date +%Z
3. Para definir o fuso horário usando o assistente guiado, execute o seguinte comando:
  cumulus@sw1:~$ sudo dpkg-reconfigure tzdata
4. Defina o relógio do software de acordo com o fuso horário configurado:
  cumulus@sw1:~$ sudo date -s "Tue Oct 28 00:37:13 2023"
5. Defina o valor atual do relógio do software para o relógio do hardware:
  cumulus@sw1:~$ sudo hwclock -w
6. Adicione um servidor NTP, se necessário:
  cumulus@sw1:~$ nv set service ntp mgmt listen eth0 cumulus@sw1:~$ nv set service ntp mgmt server <server> iburst on cumulus@sw1:~$ nv config apply cumulus@sw1:~$ nv config save
  Veja o artigo da Base de Conhecimento "A configuração do servidor NTP não está funcionando com os switches NVIDIA SN2100" para mais detalhes.
7. Verifique se ntpd está em execução no sistema:
  cumulus@sw1:~$ ps -ef | grep ntp ntp 4074 1 0 Jun20 ? 00:00:33 /usr/sbin/ntpd -p /var/run/ntpd.pid -g -u 101:102
8. Especifique a interface de origem NTP. Por padrão, a interface de origem que o NTP usa é eth0. Você pode configurar uma interface de origem NTP diferente da seguinte forma:
  cumulus@sw1:~$ nv set service ntp default listen <src_int> cumulus@sw1:~$ nv config apply

Instale o Cumulus Linux 5,11.0:

cumulus@sw1:mgmt:~$ sudo onie-install -a -i http://<web-server>/<path>/cumulus-linux-5.11.0-mlx-amd64.bin

O instalador inicia a transferência. Digite y quando solicitado.

Reinicie o switch NVIDIA SN2100:
```
cumulus@sw1:mgmt:~$ sudo reboot
```
A instalação é iniciada automaticamente e as seguintes opções de tela GRUB são exibidas. Não faça nenhuma seleção.
- Cumulus-Linux GNU/Linux
- ONIE: Instale os
- CUMULUS-INSTALL
- Cumulus-Linux GNU/Linux
Repita os passos 1 a 4 para iniciar sessão.

Verifique se a versão Cumulus Linux é 5,11.0:

nv show system

cumulus@cumulus:mgmt:~$ nv show system
operational         applied                description
------------------- ---------------------- ---------------------
build               Cumulus Linux 5.11.0
uptime              153 days, 2:44:16
hostname            cumulus                cumulus
product-name        Cumulus Linux
product-release     5.11.0
platform            x86_64-mlnx_x86-r0
system-memory       2.76 GB used / 2.28 GB free / 7.47 GB total
swap-memory         0 Bytes used / 0 Bytes free / 0 Bytes total
health-status       not OK
date-time           2025-04-23 09:55:24
status              N/A
timezone            Etc/UTC
maintenance
  mode              disabled
  ports             enabled
version
  kernel            6.1.0-cl-1-amd64
  build-date        Thu Nov 14 13:06:38 UTC 2024
  image             5.11.0
  onie              2019.11-5.2.0020-115200

Verifique se cada nó tem uma conexão com cada switch:

cumulus@sw1:mgmt:~$ nv show interface lldp

LocalPort  Speed  Mode        RemoteHost                          RemotePort
---------  -----  ----------  ----------------------------------  -----------
eth0       100M   eth   mgmt-sw1                                  Eth110/1/14
swp2s1     25G    Trunk/L2    node1                               e0a
swp1s1     10G    swp   sw2                                       e0a
swp9       100G   swp   sw3                                       e4a
swp10      100G   swp   sw4                                       e4a
swp15      100G   swp   sw5                                       swp15
swp16      100G   swp   sw6                                       swp16

Consulte "Contas de usuário do NVIDIA" para obter mais informações.

O que se segue?

"Instale o script RCF (Reference Configuration File)".

Instale o Cumulus Linux no modo Cumulus

Creating your file...