La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Installare Cumulus Linux in modalità Cumulus

08/29/2025 Collaboratori

PDF

Seguire questa procedura per installare il sistema operativo Cumulus Linux (CL) quando lo switch è in esecuzione in modalità Cumulus.

Il sistema operativo Cumulus Linux (CL) può essere installato quando lo switch esegue Cumulus Linux o ONIE (vedere "Installare in modalità ONIE").

Prima di iniziare

Assicurarsi che siano disponibili i seguenti elementi:

Conoscenza di livello intermedio di Linux.
Familiarità con la modifica di base del testo, le autorizzazioni dei file UNIX e il monitoraggio dei processi. Sono preinstallati diversi editor di testo, tra cui vi e. nano.
Accesso a una shell Linux o UNIX. Se si utilizza Windows, utilizzare un ambiente Linux come strumento della riga di comando per interagire con Cumulus Linux.
Il requisito di velocità di trasmissione deve essere impostato su 115200 sullo switch della console seriale per l'accesso alla console dello switch NVIDIA SN2100, come segue:
- 115200 baud
- 8 bit di dati
- 1 bit di stop
- parità: nessuna
- controllo di flusso: nessuno

A proposito di questa attività

Tenere presente quanto segue:

Ogni volta che Cumulus Linux viene installato, l'intera struttura del file system viene cancellata e ricostruita.

La password predefinita per l'account utente cumulus è cumulus. La prima volta che si accede a Cumulus Linux, è necessario modificare questa password predefinita. Assicurarsi di aggiornare gli script di automazione prima di installare una nuova immagine. Cumulus Linux offre opzioni della riga di comando per modificare automaticamente la password predefinita durante il processo di installazione.

Esempio 1. Fasi

Cumulus Linux 4.4.3

Accedere allo switch.

La prima volta che si accede allo switch, è necessario specificare il nome utente/la password cumulus/cumulus con sudo privilegi.

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>

Controllare la versione di 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

Configurare il nome host, l'indirizzo IP, la subnet mask e il gateway predefinito. Il nuovo nome host diventa effettivo solo dopo il riavvio della sessione console/SSH.

Uno switch Cumulus Linux fornisce almeno una porta di gestione Ethernet dedicata chiamata eth0. Questa interfaccia è specificamente per l'utilizzo della gestione fuori banda. Per impostazione predefinita, l'interfaccia di gestione utilizza DHCPv4 per l'indirizzamento.

Non utilizzare caratteri di sottolineatura (_), apostrofo (') o non ASCII nel nome host.

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

Questo comando modifica entrambi /etc/hostname e. /etc/hosts file.

Verificare che il nome host, l'indirizzo IP, la subnet mask e il gateway predefinito siano stati aggiornati.

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

Impostare la data, l'ora, il fuso orario e il server NTP sullo switch.
1. Verificare il fuso orario corrente:
  cumulus@sw1:~$ cat /etc/timezone
2. Aggiornamento al nuovo fuso orario:
  cumulus@sw1:~$ sudo dpkg-reconfigure --frontend noninteractive tzdata
3. Verificare il fuso orario corrente:
  cumulus@switch:~$ date +%Z
4. Per impostare il fuso orario mediante la procedura guidata, eseguire il seguente comando:
  cumulus@sw1:~$ sudo dpkg-reconfigure tzdata
5. Impostare l'orologio del software in base al fuso orario configurato:
  cumulus@switch:~$ sudo date -s "Tue Oct 28 00:37:13 2023"
6. Impostare il valore corrente dell'orologio del software sull'orologio hardware:
  cumulus@switch:~$ sudo hwclock -w
7. Se necessario, aggiungere un server NTP:
  cumulus@sw1:~$ net add time ntp server <cumulus.network.ntp.org> iburst cumulus@sw1:~$ net pending cumulus@sw1:~$ net commit
8. Verificare che ntpd sia in esecuzione sul 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. Specificare l'interfaccia di origine NTP. Per impostazione predefinita, l'interfaccia di origine utilizzata da NTP è eth0. È possibile configurare una diversa interfaccia di origine NTP nel modo seguente:
  cumulus@sw1:~$ net add time ntp source <src_int> cumulus@sw1:~$ net pending cumulus@sw1:~$ net commit
Installare 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
```
Il programma di installazione avvia il download. Digitare y quando richiesto.
Riavviare lo switch NVIDIA SN2100:
```
cumulus@sw1:mgmt:~$ sudo reboot
```
L'installazione viene avviata automaticamente e vengono visualizzate le seguenti opzioni della schermata di GRUB. Non effettuare alcuna selezione.
- Cumulus-Linux GNU/Linux
- ONIE: Installare il sistema operativo
- INSTALLAZIONE DI CUMULUS
- Cumulus-Linux GNU/Linux
Ripetere i passaggi da 1 a 4 per accedere.

Verificare che la versione di Cumulus Linux sia 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"

Creare un nuovo utente e aggiungerlo a. sudo gruppo. Questo utente diventa effettivo solo dopo il riavvio della sessione console/SSH.

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

Accedere allo switch.

La prima volta che si accede allo switch, è necessario specificare il nome utente/la password cumulus/cumulus con sudo privilegi.

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>

Controllare la versione di 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

Configurare il nome host, l'indirizzo IP, la subnet mask e il gateway predefinito. Il nuovo nome host diventa effettivo solo dopo il riavvio della sessione console/SSH.

Non utilizzare caratteri di sottolineatura (_), apostrofo (') o non ASCII nel nome 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

Questo comando modifica entrambi /etc/hostname e. /etc/hosts file.

Verificare che il nome host, l'indirizzo IP, la subnet mask e il gateway predefinito siano stati aggiornati.

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

Impostare il fuso orario, la data, l'ora e il server NTP sullo switch.
1. Per impostare il fuso orario:
  cumulus@sw1:~$ nv set system timezone US/Eastern cumulus@sw1:~$ nv config apply
2. Verificare il fuso orario corrente:
  cumulus@switch:~$ date +%Z
3. Per impostare il fuso orario mediante la procedura guidata, eseguire il seguente comando:
  cumulus@sw1:~$ sudo dpkg-reconfigure tzdata
4. Impostare l'orologio del software in base al fuso orario configurato:
  cumulus@sw1:~$ sudo date -s "Tue Oct 28 00:37:13 2023"
5. Impostare il valore corrente dell'orologio del software sull'orologio hardware:
  cumulus@sw1:~$ sudo hwclock -w
6. Se necessario, aggiungere un server NTP:
  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
  Vedi l'articolo della Knowledge Base "La configurazione del server NTP non funziona con gli switch NVIDIA SN2100" per ulteriori dettagli.
7. Verificare che ntpd sia in esecuzione sul 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. Specificare l'interfaccia di origine NTP. Per impostazione predefinita, l'interfaccia di origine utilizzata da NTP è eth0. È possibile configurare una diversa interfaccia di origine NTP nel modo seguente:
  cumulus@sw1:~$ nv set service ntp default listen <src_int> cumulus@sw1:~$ nv config apply
Installare Cumulus Linux 5.4.0:
```
cumulus@sw1:mgmt:~$ sudo onie-install -a -i http://<web-server>/<path>/cumulus-linux-5.4-mlx-amd64.bin
```
Il programma di installazione avvia il download. Digitare y quando richiesto.
Riavviare lo switch NVIDIA SN2100:
```
cumulus@sw1:mgmt:~$ sudo reboot
```
L'installazione viene avviata automaticamente e vengono visualizzate le seguenti opzioni della schermata di GRUB. Non effettuare alcuna selezione.
- Cumulus-Linux GNU/Linux
- ONIE: Installare il sistema operativo
- INSTALLAZIONE DI CUMULUS
- Cumulus-Linux GNU/Linux
Ripetere i passaggi da 1 a 4 per accedere.

Verificare che la versione di Cumulus Linux sia la 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

Verificare che i nodi dispongano di una connessione a ciascuno 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

Creare un nuovo utente e aggiungerlo a. sudo gruppo. Questo utente diventa effettivo solo dopo il riavvio della sessione console/SSH.

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:~$

Aggiungere ulteriori gruppi di utenti a cui l'utente amministratore può accedere nv comandi:

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

Vedere "NVIDIA User account (account utente NVIDIA)" per ulteriori informazioni.

Cumulus Linux 5.11.0

Accedere allo switch.

Quando si accede allo switch per la prima volta, richiede il nome utente/password di cumulus/cumulus con sudo 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>

Controllare la versione di 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

Configurare il nome host, l'indirizzo IP, la subnet mask e il gateway predefinito. Il nuovo nome host diventa effettivo solo dopo il riavvio della sessione console/SSH.

Non utilizzare caratteri di sottolineatura (_), apostrofo (') o non ASCII nel nome 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

Questo comando modifica entrambi /etc/hostname e. /etc/hosts file.

Verificare che il nome host, l'indirizzo IP, la subnet mask e il gateway predefinito siano stati aggiornati.

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

Impostare il fuso orario, la data, l'ora e il server NTP sullo switch.
1. Per impostare il fuso orario:
  cumulus@sw1:~$ nv set system timezone US/Eastern cumulus@sw1:~$ nv config apply
2. Verificare il fuso orario corrente:
  cumulus@switch:~$ date +%Z
3. Per impostare il fuso orario mediante la procedura guidata, eseguire il seguente comando:
  cumulus@sw1:~$ sudo dpkg-reconfigure tzdata
4. Impostare l'orologio del software in base al fuso orario configurato:
  cumulus@sw1:~$ sudo date -s "Tue Oct 28 00:37:13 2023"
5. Impostare il valore corrente dell'orologio del software sull'orologio hardware:
  cumulus@sw1:~$ sudo hwclock -w
6. Se necessario, aggiungere un server NTP:
  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
  Vedi l'articolo della Knowledge Base "La configurazione del server NTP non funziona con gli switch NVIDIA SN2100" per ulteriori dettagli.
7. Verificare che ntpd sia in esecuzione sul 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. Specificare l'interfaccia di origine NTP. Per impostazione predefinita, l'interfaccia di origine utilizzata da NTP è eth0. È possibile configurare una diversa interfaccia di origine NTP nel modo seguente:
  cumulus@sw1:~$ nv set service ntp default listen <src_int> cumulus@sw1:~$ nv config apply
Installare 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
```
Il programma di installazione avvia il download. Digitare y quando richiesto.
Riavviare lo switch NVIDIA SN2100:
```
cumulus@sw1:mgmt:~$ sudo reboot
```
L'installazione viene avviata automaticamente e vengono visualizzate le seguenti opzioni della schermata di GRUB. Non effettuare alcuna selezione.
- Cumulus-Linux GNU/Linux
- ONIE: Installare il sistema operativo
- INSTALLAZIONE DI CUMULUS
- Cumulus-Linux GNU/Linux
Ripetere i passaggi da 1 a 4 per accedere.

Verificare che la versione di Cumulus Linux sia 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

Verificare che ogni nodo disponga di una connessione a ciascuno 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

Per ulteriori informazioni, vedere "NVIDIA User account (account utente NVIDIA)" .

Quali sono le prossime novità?

"Installare o aggiornare lo script RCF" .

Installare Cumulus Linux in modalità Cumulus

Creating your file...