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

Mettez à niveau les versions de Cumulus Linux

Contributeurs

Procédez comme suit pour mettre à niveau votre version de Cumulus Linux si nécessaire.

Ce dont vous avez besoin
  • Connaissance Linux de niveau intermédiaire.

  • Connaissance de l'édition de texte de base, des autorisations de fichier UNIX et de la surveillance des processus. Plusieurs éditeurs de texte sont pré-installés, y compris vi et nano.

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

  • La vitesse de transmission requise est définie sur 115200 sur le commutateur de console série pour l'accès à la console du commutateur NVIDIA SN2100, comme suit :

    • 115200 bauds

    • 8 bits de données (data bits)

    • 1 bit de stop

    • parité : aucune

    • contrôle de flux : aucun

Description de la tâche

Gardez à l'esprit les points suivants :

Remarque Chaque fois que Cumulus Linux est mis à niveau, l'ensemble de la structure du système de fichiers est effacé et reconstruit. Votre configuration existante sera effacée. Vous devez enregistrer et enregistrer votre configuration de commutateur avant de mettre à jour Cumulus Linux.
Avertissement Le mot de passe par défaut pour le compte utilisateur du umulus est cumulus. La première fois que vous vous connectez à Cumulus Linux, vous devez changer 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 de ligne de commande pour modifier automatiquement le mot de passe par défaut pendant le processus d'installation.

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

Exemple 1. Étapes
De Cumulus Linux 4.4.x à Cumulus Linux 5.x.
  1. Vérifiez la version actuelle de Cumulus Linux et les ports connectés :

    admin@sw1: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
    
    admin@sw1: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))
    .
    .
  2. Téléchargez l'image Cumulux Linux 5.x:tmp

    admin@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.
  3. Redémarrez le commutateur :

    admin@sw1:mgmt:~$ sudo reboot
  4. Modifier 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'
  5. 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
  6. Modifiez 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
    .
    .
  7. Déconnectez-vous et reconnectez-vous au commutateur pour voir le nom du commutateur 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:~$
  8. Définissez 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
  9. Créez un nouvel utilisateur et ajoutez cet utilisateur à la sudo groupe. Cet utilisateur ne prend effet 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:~$
  10. Ajoutez des groupes d'utilisateurs supplémentaires auxquels l'utilisateur admin peut 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 d'utilisateur NVIDIA" pour en savoir plus.

De Cumulus Linux 5.x à Cumulus Linux 5.x.
  1. Vérifiez la version actuelle de Cumulus Linux et les ports connectés :

    admin@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
    
    admin@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
  2. Téléchargez l'image de Cumulux Linux 5.4.0 :

    admin@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.
  3. Redémarrez le commutateur :

    admin@sw1:mgmt:~$ sudo reboot
  4. Modifier 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'
  5. 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
  6. Modifiez 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
    .
    .
  7. Déconnectez-vous et reconnectez-vous au commutateur pour voir le nom du commutateur 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:~$
  8. Définissez 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
  9. Créez un nouvel utilisateur et ajoutez cet utilisateur à la sudo groupe. Cet utilisateur ne prend effet 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:~$
  10. Ajoutez des groupes d'utilisateurs supplémentaires auxquels l'utilisateur admin peut 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 d'utilisateur NVIDIA" pour en savoir plus.