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.

Installez Cumulus Linux en mode Cumulus

Contributeurs
PDF

Suivre cette procédure pour installer le système d'exploitation Cumulus Linux (CL) lorsque le commutateur est en mode Cumulus.

Remarque Le système d'exploitation Cumulus Linux (CL) peut être installé lorsque le commutateur exécute Cumulus Linux ou ONIE (voir "Installez en mode ONIE").
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 installé, l'intégralité de la structure du système de fichiers est effacée et reconstruite.
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. Veillez à 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.
Exemple 1. Étapes
Cumulus Linux 4.4.3

  1. Connectez-vous au commutateur.

    La première connexion au commutateur requiert le nom d'utilisateur/mot de passe cumulus/cumulus avec sudo privilèges.

    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>

  2. Vérifiez la version de 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

  3. Configurez le nom d'hôte, l'adresse IP, le masque de sous-réseau et la passerelle par défaut. Le nouveau nom d'hôte ne devient effectif qu'après le redémarrage de la session console/SSH.

    Remarque Un commutateur Cumulus Linux fournit au moins un port de gestion Ethernet dédié appelé eth0. Cette interface est spécifiquement destinée à la gestion hors bande. Par défaut, l'interface de gestion utilise DHCPv4 pour l'adressage.
    Avertissement N'utilisez pas de trait de soulignement (_), d'apostrophe (') ou de caractères non ASCII dans le nom d'hôte. 
    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

    Cette commande modifie les deux /etc/hostname et /etc/hosts fichiers.

  4. Vérifiez que le nom d'hôte, l'adresse IP, le masque de sous-réseau et la passerelle par défaut ont été mis à jour.

    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

  5. Définissez la date, l'heure, le fuseau horaire et le serveur NTP sur le commutateur.

    1. Vérifiez le fuseau horaire actuel :

      cumulus@sw1:~$ cat /etc/timezone

    2. Mise à jour vers le nouveau fuseau horaire :

      cumulus@sw1:~$ sudo dpkg-reconfigure --frontend noninteractive tzdata

    3. Vérifiez votre fuseau horaire actuel :

      cumulus@switch:~$ date +%Z

    4. Pour définir le fuseau horaire à l'aide de l'assistant, exécutez la commande suivante :

      cumulus@sw1:~$ sudo dpkg-reconfigure tzdata

    5. Réglez l'horloge logicielle en fonction du fuseau horaire configuré :

      cumulus@switch:~$ sudo date -s "Tue Oct 28 00:37:13 2023"

    6. Réglez la valeur actuelle de l'horloge logicielle sur l'horloge matérielle :

      cumulus@switch:~$ sudo hwclock -w

    7. Ajoutez un serveur NTP si nécessaire :

      cumulus@sw1:~$ net add time ntp server <cumulus.network.ntp.org> iburst
cumulus@sw1:~$ net pending
cumulus@sw1:~$ net commit

    8. Vérifiez que ntpd s'exécute sur le système :

      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. Spécifiez l'interface source NTP. Par défaut, l'interface source utilisée par NTP est eth0. Vous pouvez configurer une interface source NTP différente comme suit :

      cumulus@sw1:~$ net add time ntp source <src_int>
cumulus@sw1:~$ net pending
cumulus@sw1:~$ net commit

  6. Installez 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

    Le programme d'installation démarre le téléchargement. Tapez y lorsque vous y êtes invité.

  7. Redémarrez le commutateur NVIDIA SN2100 :

    cumulus@sw1:mgmt:~$ sudo reboot

  8. L'installation démarre automatiquement et les options d'écran GRUB suivantes s'affichent. Effectuer pas de sélections.

    • Cumulus-Linux GNU/Linux

    • ONIE : installez le système d'exploitation

    • CUMULUS - INSTALLATION

    • Cumulus-Linux GNU/Linux

  9. Répétez les étapes 1 à 4 pour vous connecter.

  10. Vérifiez que la version de Cumulus Linux est 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"

  11. 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:~$
Cumulus Linux 5.x.

  1. Connectez-vous au commutateur.

    La première connexion au commutateur requiert le nom d'utilisateur/mot de passe cumulus/cumulus avec sudo privilèges.

    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>

  2. Vérifiez la version de 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

  3. Configurez le nom d'hôte, l'adresse IP, le masque de sous-réseau et la passerelle par défaut. Le nouveau nom d'hôte ne devient effectif qu'après le redémarrage de la session console/SSH.

    Remarque Un commutateur Cumulus Linux fournit au moins un port de gestion Ethernet dédié appelé eth0. Cette interface est spécifiquement destinée à la gestion hors bande. Par défaut, l'interface de gestion utilise DHCPv4 pour l'adressage.
    Avertissement N'utilisez pas de trait de soulignement (_), d'apostrophe (') ou de caractères non ASCII dans le nom d'hôte. 
    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

    Cette commande modifie les deux /etc/hostname et /etc/hosts fichiers.

  4. Vérifiez que le nom d'hôte, l'adresse IP, le masque de sous-réseau et la passerelle par défaut ont été mis à jour.

    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

  5. Définissez le fuseau horaire, la date, l'heure et le serveur NTP sur le commutateur.

    1. Définissez le fuseau horaire :

      cumulus@sw1:~$ nv set system timezone US/Eastern
cumulus@sw1:~$ nv config apply

    2. Vérifiez votre fuseau horaire actuel :

      cumulus@switch:~$ date +%Z

    3. Pour définir le fuseau horaire à l'aide de l'assistant, exécutez la commande suivante :

      cumulus@sw1:~$ sudo dpkg-reconfigure tzdata

    4. Réglez l'horloge logicielle en fonction du fuseau horaire configuré :

      cumulus@sw1:~$ sudo date -s "Tue Oct 28 00:37:13 2023"

    5. Réglez la valeur actuelle de l'horloge logicielle sur l'horloge matérielle :

      cumulus@sw1:~$ sudo hwclock -w

    6. Ajoutez un serveur NTP si nécessaire :

      cumulus@sw1:~$ nv set service ntp default server <cumulus.network.ntp.org> iburst on
cumulus@sw1:~$ nv config apply
cumulus@sw1:~$ nv config save

    7. Vérifiez que ntpd s'exécute sur le système :

      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. Spécifiez l'interface source NTP. Par défaut, l'interface source utilisée par NTP est eth0. Vous pouvez configurer une interface source NTP différente comme suit :

      cumulus@sw1:~$ nv set service ntp default listen <src_int>
cumulus@sw1:~$ nv config apply

  6. Installez Cumulus Linux 5.4 :

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

    Le programme d'installation démarre le téléchargement. Tapez y lorsque vous y êtes invité.

  7. Redémarrez le commutateur NVIDIA SN2100 :

    cumulus@sw1:mgmt:~$ sudo reboot

  8. L'installation démarre automatiquement et les options d'écran GRUB suivantes s'affichent. Effectuer pas de sélections.

    • Cumulus-Linux GNU/Linux

    • ONIE : installez le système d'exploitation

    • CUMULUS - INSTALLATION

    • Cumulus-Linux GNU/Linux

  9. Répétez les étapes 1 à 4 pour vous connecter.

  10. Vérifiez que la version de Cumulus Linux est 5.4 : 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

  11. Vérifier que les nœuds chacun ont une connexion à chaque commutateur :

    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

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

  13. 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.

Et la suite ?

"Installez le script RCF (Reference Configuration File)".