Skip to main content
La version française est une traduction automatique. La version anglaise prévaut sur la française en cas de divergence.

Mise à niveau des versions Linux de Cumulus

Contributeurs netapp-yvonneo
PDF

Suivez la procédure ci-dessous pour mettre à niveau votre version de Cumulus Linux si nécessaire.

Avant de commencer

Assurez-vous d'avoir les éléments suivants :

  • Connaissances intermédiaires de Linux.

  • Connaissance des bases de l'édition de texte, des permissions de fichiers UNIX et de la surveillance des processus. Plusieurs éditeurs de texte sont préinstallés, notamment vi et nano .

  • Accès à un shell Linux ou UNIX. Si vous utilisez Windows, utilisez un environnement Linux comme outil en ligne de commande pour interagir avec Cumulus Linux.

  • Le débit en bauds requis est fixé à 115 200 sur le commutateur de console série pour l’accès à la console du commutateur NVIDIA SN2100, comme suit :

    • 115200 baud

    • 8 bits de données

    • 1 butée

    • parité : aucune

    • contrôle de flux : aucun

À propos de cette tâche

Soyez attentif aux points suivants :

Remarque À chaque mise à jour de Cumulus Linux, l'intégralité de la structure du système de fichiers est effacée puis reconstruite. Votre configuration actuelle sera effacée. Vous devez sauvegarder et enregistrer la configuration de votre commutateur avant de mettre à jour Cumulus Linux.
Avertissement Le mot de passe par défaut du compte utilisateur Cumulus est cumulus. Lors de votre première connexion à Cumulus Linux, vous devez modifier ce mot de passe par défaut. Vous devez mettre à jour tous les scripts d'automatisation avant d'installer une nouvelle image. Cumulus Linux propose des options en ligne de commande permettant de modifier automatiquement le mot de passe par défaut lors du processus d'installation.

Voir "Installation d'une nouvelle image Cumulus Linux" pour plus d'informations.

Exemple 1. Étapes
Migration de Cumulus Linux 4.4.x vers Cumulus Linux 5.4.0

  1. Connectez le commutateur de cluster au réseau de gestion.

  2. Utilisez la commande ping pour vérifier la connectivité au serveur hébergeant Cumulus Linux et RCF.

  3. Afficher les ports du cluster sur chaque nœud qui sont connectés aux commutateurs du cluster :

    network device-discovery show

  4. Vérifiez l'état administratif et opérationnel de chaque port du cluster.

    1. Vérifiez que tous les ports du cluster sont opérationnels et en bon état :

      network port show -role cluster

    2. Vérifiez que toutes les interfaces du cluster (LIF) sont connectées au port d'accueil :

      network interface show -role cluster

    3. Vérifiez que le cluster affiche les informations pour les deux commutateurs du cluster :

      system cluster-switch show -is-monitoring-enabled-operational true

  5. Désactiver la restauration automatique sur les LIF du cluster. Les LIF du cluster basculent vers le commutateur du cluster partenaire et y restent pendant que vous effectuez la procédure de mise à niveau sur le commutateur cible :

    network interface modify -vserver Cluster -lif * -auto-revert false

  6. Vérifiez la version actuelle de Cumulus Linux et les ports connectés :

    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

cumulus@cumulus:mgmt:~$ net show interface

State  Name    Spd   MTU    Mode        LLDP                    Summary
-----  ------  ----  -----  ----------  ----------------------  --------------------
.
.
UP     swp1    100G  9216   Trunk/L2    node1 (e5b)             Master: bridge(UP)
UP     swp2    100G  9216   Trunk/L2    node2 (e5b)             Master: bridge(UP)
UP     swp3    100G  9216   Trunk/L2    SHFFG1826000112 (e0b)   Master: bridge(UP)
UP     swp4    100G  9216   Trunk/L2    SHFFG1826000112 (e0b)   Master: bridge(UP)
UP     swp5    100G  9216   Trunk/L2    SHFFG1826000102 (e0b)   Master: bridge(UP)
UP     swp6    100G  9216   Trunk/L2    SHFFG1826000102 (e0b)   Master: bridge(UP))
.
.

  7. Téléchargez l'image Cumulux Linux 5.4.0 :

    cumulus@cumulus:mgmt:~$ sudo onie-install -a -i http://<ip-to-webserver>/path/to/cumulus-linux-5.4.0-mlx-amd64.bin
[sudo] password for cumulus:
Fetching installer: http://<ip-to-webserver>/path/to/cumulus-linux-5.4.0-mlx-amd64.bin
Downloading URL: http://<ip-to-webserver>/path/to/cumulus-linux-5.4.0-mlx-amd64.bin
# 100.0%
Success: HTTP download complete.
EFI variables are not supported on this system
Warning: SecureBoot is not available.
Image is signed.
.
.
.
Staging installer image...done.
WARNING:
WARNING: Activating staged installer requested.
WARNING: This action will wipe out all system data.
WARNING: Make sure to back up your data.
WARNING:
Are you sure (y/N)? y
Activating staged installer...done.
Reboot required to take effect.

  8. Redémarrez le commutateur :

    cumulus@cumulus:mgmt:~$ sudo reboot

  9. Changer le mot de passe :

    cumulus login: cumulus
Password:
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>
Linux cumulus 5.10.0-cl-1-amd64 #1 SMP Debian 5.10.162-1+cl5.4.0u1 (2023-01-20) x86_64

Welcome to NVIDIA Cumulus (R) Linux (R)

ZTP in progress. To disable, do 'ztp -d'

  10. Vérifiez la version de Cumulus Linux : nv show system

    cumulus@cumulus:mgmt:~$ nv show system
           operational    applied
---------- -------------- ----------
hostname   cumulus        cumulus
build      Cumulus Linux 5.4.0
uptime     14:07:08
timezone   Etc/UTC

  11. Modifier le nom d'hôte :

    cumulus@cumulus:mgmt:~$ nv set system hostname sw1
cumulus@cumulus:mgmt:~$ nv config apply
Warning: The following files have been changed since the last save, and they WILL be overwritten.
- /etc/nsswitch.conf
- /etc/synced/synced.conf
.
.

  12. Déconnectez-vous puis reconnectez-vous au commutateur pour voir le nom mis à jour à l'invite :

    cumulus@cumulus:mgmt:~$ exit
logout

Debian GNU/Linux 10 cumulus ttyS0

cumulus login: cumulus
Password:
Last login: Tue Dec 15 21:43:13 UTC 2020 on ttyS0
Linux cumulus 5.10.0-cl-1-amd64 #1 SMP Debian 5.10.162-1+cl5.4.0u1 (2023-01-20) x86_64

Welcome to NVIDIA Cumulus (R) Linux (R)


ZTP in progress. To disable, do 'ztp -d'

cumulus@sw1:mgmt:~$

  13. Configurer l'adresse IP :

    cumulus@sw1:mgmt:~$ nv set interface eth0 ip address 10.231.80.206/22
cumulus@sw1:mgmt:~$ nv set interface eth0 ip gateway 10.231.80.1
cumulus@sw1:mgmt:~$ nv config apply
applied [rev_id: 2]
cumulus@sw1:mgmt:~$ ip route show vrf mgmt
default via 10.231.80.1 dev eth0 proto kernel
unreachable default metric 4278198272
10.231.80.0/22 dev eth0 proto kernel scope link src 10.231.80.206
127.0.0.0/8 dev mgmt proto kernel scope link src 127.0.0.1

  14. Créez un nouvel utilisateur et ajoutez-le à la liste. sudo groupe. Cet utilisateur ne devient effectif qu'après le redémarrage de la session 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:~$

  15. Ajouter des groupes d'utilisateurs supplémentaires pour que l'utilisateur administrateur puisse y accéder nv commandes :

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

    Voir "Comptes utilisateurs NVIDIA" pour plus d'informations.

Migration de Cumulus Linux 5.x vers Cumulus Linux 5.4.0

  1. Connectez le commutateur de cluster au réseau de gestion.

  2. Utilisez la commande ping pour vérifier la connectivité au serveur hébergeant Cumulus Linux et RCF.

  3. Afficher les ports du cluster sur chaque nœud qui sont connectés aux commutateurs du cluster :

    network device-discovery show

  4. Vérifiez l'état administratif et opérationnel de chaque port du cluster.

    1. Vérifiez que tous les ports du cluster sont opérationnels et en bon état :

      network port show -role cluster

    2. Vérifiez que toutes les interfaces du cluster (LIF) sont connectées au port d'accueil :

      network interface show -role cluster

    3. Vérifiez que le cluster affiche les informations pour les deux commutateurs du cluster :

      system cluster-switch show -is-monitoring-enabled-operational true

  5. Désactiver la restauration automatique sur les LIF du cluster. Les LIF du cluster basculent vers le commutateur du cluster partenaire et y restent pendant que vous effectuez la procédure de mise à niveau sur le commutateur cible :

    network interface modify -vserver Cluster -lif * -auto-revert false

  6. Vérifiez la version actuelle de Cumulus Linux et les ports connectés :

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

cumulus@sw1:mgmt:~$ nv show interface
Interface     MTU   Speed State Remote Host         Remote Port- Type      Summary
------------- ----- ----- ----- ------------------- ------------ --------- -------------
+ cluster_isl 9216  200G  up                                      bond
+ eth0        1500  100M  up    mgmt-sw1            Eth105/1/14   eth       IP Address: 10.231.80 206/22
  eth0                                                                      IP Address: fd20:8b1e:f6ff:fe31:4a0e/64
+ lo          65536       up                                      loopback  IP Address: 127.0.0.1/8
  lo                                                                        IP Address: ::1/128
+ swp1s0      9216 10G    up cluster01                e0b         swp
.
.
.
+ swp15      9216 100G    up sw2                      swp15       swp
+ swp16      9216 100G    up sw2                      swp16       swp

  7. Téléchargez l'image Cumulux Linux 5.4.0 :

    cumulus@sw1:mgmt:~$ sudo onie-install -a -i http://<ip-to-webserver>/path/to/cumulus-linux-5.4.0-mlx-amd64.bin
[sudo] password for cumulus:
Fetching installer: http://<ip-to-webserver>/path/to/cumulus-linux-5.4.0-mlx-amd64.bin
Downloading URL: http://<ip-to-webserver>/path/to/cumulus-linux-5.4.0-mlx-amd64.bin
# 100.0%
Success: HTTP download complete.
EFI variables are not supported on this system
Warning: SecureBoot is not available.
Image is signed.
.
.
.
Staging installer image...done.
WARNING:
WARNING: Activating staged installer requested.
WARNING: This action will wipe out all system data.
WARNING: Make sure to back up your data.
WARNING:
Are you sure (y/N)? y
Activating staged installer...done.
Reboot required to take effect.

  8. Redémarrez le commutateur :

    cumulus@sw1:mgmt:~$ sudo reboot

  9. Changer le mot de passe :

    cumulus login: cumulus
Password:
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>
Linux cumulus 5.10.0-cl-1-amd64 #1 SMP Debian 5.10.162-1+cl5.4.0u1 (2023-01-20) x86_64

Welcome to NVIDIA Cumulus (R) Linux (R)

ZTP in progress. To disable, do 'ztp -d'

  10. Vérifiez la version de Cumulus Linux : nv show system

    cumulus@cumulus:mgmt:~$ nv show system
operational    applied
-------------- ----------------
hostname       cumulus cumulus
build          Cumulus Linux 5.4.0
uptime         14:07:08
timezone       Etc/UTC

  11. Modifier le nom d'hôte :

    cumulus@cumulus:mgmt:~$ nv set system hostname sw1
cumulus@cumulus:mgmt:~$ nv config apply
Warning: The following files have been changed since the last save, and they WILL be overwritten.
- /etc/nsswitch.conf
- /etc/synced/synced.conf
.
.

  12. Déconnectez-vous puis reconnectez-vous au commutateur pour voir le nom mis à jour à l'invite :

    cumulus@cumulus:mgmt:~$ exit
logout

Debian GNU/Linux 10 cumulus ttyS0

cumulus login: cumulus
Password:
Last login: Tue Dec 15 21:43:13 UTC 2020 on ttyS0
Linux cumulus 5.10.0-cl-1-amd64 #1 SMP Debian 5.10.162-1+cl5.4.0u1 (2023-01-20) x86_64

Welcome to NVIDIA Cumulus (R) Linux (R)


ZTP in progress. To disable, do 'ztp -d'

cumulus@sw1:mgmt:~$

  13. Configurer l'adresse IP :

    cumulus@sw1:mgmt:~$ nv unset interface eth0 ip address dhcp
cumulus@sw1:mgmt:~$ nv set interface eth0 ip address 10.231.80.206/22
cumulus@sw1:mgmt:~$ nv set interface eth0 ip gateway 10.231.80.1
cumulus@sw1:mgmt:~$ nv config apply
applied [rev_id: 2]
cumulus@sw1:mgmt:~$ ip route show vrf mgmt
default via 10.231.80.1 dev eth0 proto kernel
unreachable default metric 4278198272
10.231.80.0/22 dev eth0 proto kernel scope link src 10.231.80.206
127.0.0.0/8 dev mgmt proto kernel scope link src 127.0.0.1

  14. Créez un nouvel utilisateur et ajoutez-le à la liste. sudo groupe. Cet utilisateur ne devient effectif qu'après le redémarrage de la session 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:~$

  15. Ajouter des groupes d'utilisateurs supplémentaires pour que l'utilisateur administrateur puisse y accéder nv commandes :

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

    Voir "Comptes utilisateurs NVIDIA" pour plus d'informations.

Cumulus Linux 5.4.0 à Cumulus Linux 5.11.0

  1. Connectez le commutateur de cluster au réseau de gestion.

  2. Utilisez la commande ping pour vérifier la connectivité au serveur hébergeant Cumulus Linux et RCF.

  3. Afficher les ports du cluster sur chaque nœud qui sont connectés aux commutateurs du cluster :

    network device-discovery show

  4. Vérifiez l'état administratif et opérationnel de chaque port du cluster.

    1. Vérifiez que tous les ports du cluster sont opérationnels et en bon état :

      network port show -role cluster

    2. Vérifiez que toutes les interfaces du cluster (LIF) sont connectées au port d'accueil :

      network interface show -role cluster

    3. Vérifiez que le cluster affiche les informations pour les deux commutateurs du cluster :

      system cluster-switch show -is-monitoring-enabled-operational true

  5. Désactiver la restauration automatique sur les LIF du cluster. Les LIF du cluster basculent vers le commutateur du cluster partenaire et y restent pendant que vous effectuez la procédure de mise à niveau sur le commutateur cible :

    network interface modify -vserver Cluster -lif * -auto-revert false

  6. Vérifiez la version actuelle de Cumulus Linux et les ports connectés :

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

cumulus@sw1:mgmt:~$ nv show interface
Interface     MTU   Speed State Remote Host         Remote Port- Type      Summary
------------- ----- ----- ----- ------------------- ------------ --------- -------------
+ cluster_isl 9216  200G  up                                      bond
+ eth0        1500  100M  up    mgmt-sw1            Eth105/1/14   eth       IP Address: 10.231.80 206/22
  eth0                                                                      IP Address: fd20:8b1e:f6ff:fe31:4a0e/64
+ lo          65536       up                                      loopback  IP Address: 127.0.0.1/8
  lo                                                                        IP Address: ::1/128
+ swp1s0      9216 10G    up cluster01                e0b         swp
.
.
.
+ swp15      9216 100G    up sw2                      swp15       swp
+ swp16      9216 100G    up sw2                      swp16       swp

  7. Téléchargez l'image Cumulux Linux 5.11.0 :

    cumulus@sw1:mgmt:~$ sudo onie-install -a -i http://<ip-to-webserver>/path/to/cumulus-linux-5.11.0-mlx-amd64.bin
[sudo] password for cumulus:
Fetching installer: http://<ip-to-webserver>/path/to/cumulus-linux-5.11.0-mlx-amd64.bin
Downloading URL: http://<ip-to-webserver>/path/to/cumulus-linux-5.11.0-mlx-amd64.bin
# 100.0%
Success: HTTP download complete.
EFI variables are not supported on this system
Warning: SecureBoot is not available.
Image is signed.
.
.
.
Staging installer image...done.
WARNING:
WARNING: Activating staged installer requested.
WARNING: This action will wipe out all system data.
WARNING: Make sure to back up your data.
WARNING:
Are you sure (y/N)? y
Activating staged installer...done.
Reboot required to take effect.

  8. Redémarrez le commutateur :

    cumulus@sw1:mgmt:~$ sudo reboot

  9. Changer le mot de passe :

    cumulus login: cumulus
Password:
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>
Linux cumulus 5.11.0-cl-1-amd64 #1 SMP Debian 5.10.162-1+cl5.4.0u1 (2023-01-20) x86_64

Welcome to NVIDIA Cumulus (R) Linux (R)

ZTP in progress. To disable, do 'ztp -d'

  10. Vérifiez la version de Cumulus Linux : nv show system

    cumulus@cumulus:mgmt:~$ nv show system
operational    applied
-------------- ----------------
hostname       cumulus cumulus
build          Cumulus Linux 5.11.0
uptime         14:07:08
timezone       Etc/UTC

  11. Modifier le nom d'hôte :

    cumulus@cumulus:mgmt:~$ nv set system hostname sw1
cumulus@cumulus:mgmt:~$ nv config apply
Warning: The following files have been changed since the last save, and they WILL be overwritten.
- /etc/nsswitch.conf
- /etc/synced/synced.conf
.
.

  12. Déconnectez-vous puis reconnectez-vous au commutateur pour voir le nom mis à jour à l'invite :

    cumulus@cumulus:mgmt:~$ exit
logout

Debian GNU/Linux 10 cumulus ttyS0

cumulus login: cumulus
Password:
Last login: Tue Dec 15 21:43:13 UTC 2020 on ttyS0
Linux cumulus 5.11.0-cl-1-amd64 #1 SMP Debian 5.10.162-1+cl5.4.0u1 (2023-01-20) x86_64

Welcome to NVIDIA Cumulus (R) Linux (R)


ZTP in progress. To disable, do 'ztp -d'

cumulus@sw1:mgmt:~$

  13. Configurer l'adresse IP :

    cumulus@sw1:mgmt:~$ nv unset interface eth0 ip address dhcp
cumulus@sw1:mgmt:~$ nv set interface eth0 ip address 10.231.80.206/22
cumulus@sw1:mgmt:~$ nv set interface eth0 ip gateway 10.231.80.1
cumulus@sw1:mgmt:~$ nv config apply
applied [rev_id: 2]
cumulus@sw1:mgmt:~$ ip route show vrf mgmt
default via 10.231.80.1 dev eth0 proto kernel
unreachable default metric 4278198272
10.231.80.0/22 dev eth0 proto kernel scope link src 10.231.80.206
127.0.0.0/8 dev mgmt proto kernel scope link src 127.0.0.1
Quelle est la prochaine étape ?

Après avoir mis à jour votre version de Cumulus Linux, vous pouvez"installer ou mettre à niveau le script RCF" .