Installer Cumulus Linux en mode Cumulus
Suivez cette procédure pour installer le système d'exploitation Cumulus Linux (CL) lorsque le commutateur fonctionne en mode Cumulus.
|
|
Le système d'exploitation Cumulus Linux (CL) peut être installé soit lorsque le commutateur exécute Cumulus Linux, soit lorsqu'il exécute ONIE (voir"Installer en mode ONIE" ). |
Assurez-vous que les éléments suivants sont disponibles :
-
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
vietnano. -
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 doit être réglé sur 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
-
Soyez attentif aux points suivants :
|
|
À chaque installation de Cumulus Linux, l'intégralité de la structure du système de fichiers est effacée puis reconstruite. |
|
|
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. Veillez à 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. |
-
Connectez-vous au commutateur.
La première connexion au commutateur nécessite un nom d'utilisateur et un mot de passe de cumulus/cumulus avec
sudoprivilè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>
-
Vérifiez la version de Cumulus Linux :
net show systemcumulus@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
-
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 sera effectif qu'après le redémarrage de la console/session SSH.
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.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 à la fois le
/etc/hostnameet/etc/hostsfichiers. -
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
-
Configurez la date, l'heure, le fuseau horaire et le serveur NTP sur le commutateur.
-
Vérifiez le fuseau horaire actuel :
cumulus@sw1:~$ cat /etc/timezone
-
Mise à jour vers le nouveau fuseau horaire :
cumulus@sw1:~$ sudo dpkg-reconfigure --frontend noninteractive tzdata
-
Vérifiez votre fuseau horaire actuel :
cumulus@switch:~$ date +%Z
-
Pour définir le fuseau horaire à l'aide de l'assistant, exécutez la commande suivante :
cumulus@sw1:~$ sudo dpkg-reconfigure tzdata
-
Réglez l'horloge du logiciel en fonction du fuseau horaire configuré :
cumulus@switch:~$ sudo date -s "Tue Oct 28 00:37:13 2023"
-
Réglez la valeur actuelle de l'horloge logicielle sur la valeur de l'horloge matérielle :
cumulus@switch:~$ sudo hwclock -w
-
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
-
Vérifiez que
ntpdest en cours d'exécution 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
-
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
-
-
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
L'installateur démarre le téléchargement. Tapez y lorsque vous y êtes invité.
-
Redémarrez le commutateur NVIDIA SN2100 :
cumulus@sw1:mgmt:~$ sudo reboot
-
L'installation démarre automatiquement et les options suivantes s'affichent à l'écran GRUB. Ne faites aucune sélection.
-
Cumulus-Linux GNU/Linux
-
ONIE : Installer le système d'exploitation
-
INSTALLATION DE CUMULUS
-
Cumulus-Linux GNU/Linux
-
-
Répétez les étapes 1 à 4 pour vous connecter.
-
Vérifiez que la version de Cumulus Linux est bien la 4.4.3 :
net show versioncumulus@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"
-
Créez un nouvel utilisateur et ajoutez-le à la liste.
sudogroupe. Cet utilisateur ne devient effectif qu'après le redémarrage de la session console/SSH.sudo adduser --ingroup netedit admincumulus@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:~$
-
Connectez-vous au commutateur.
La première connexion au commutateur nécessite un nom d'utilisateur et un mot de passe de cumulus/cumulus avec
sudoprivilè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>
-
Vérifiez la version de Cumulus Linux :
nv show systemcumulus@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
-
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 sera effectif qu'après le redémarrage de la console/session SSH.
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.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 à la fois le
/etc/hostnameet/etc/hostsfichiers. -
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
-
Configurez le fuseau horaire, la date, l'heure et le serveur NTP sur le commutateur.
-
Définissez le fuseau horaire :
cumulus@sw1:~$ nv set system timezone US/Eastern cumulus@sw1:~$ nv config apply
-
Vérifiez votre fuseau horaire actuel :
cumulus@switch:~$ date +%Z
-
Pour définir le fuseau horaire à l'aide de l'assistant, exécutez la commande suivante :
cumulus@sw1:~$ sudo dpkg-reconfigure tzdata
-
Réglez l'horloge du logiciel en fonction du fuseau horaire configuré :
cumulus@sw1:~$ sudo date -s "Tue Oct 28 00:37:13 2023"
-
Réglez la valeur actuelle de l'horloge logicielle sur la valeur de l'horloge matérielle :
cumulus@sw1:~$ sudo hwclock -w
-
Ajoutez un serveur NTP si nécessaire :
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
Consultez l'article de la base de connaissances"La configuration du serveur NTP ne fonctionne pas avec les commutateurs NVIDIA SN2100." pour plus de détails.
-
Vérifiez que
ntpdest en cours d'exécution 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
-
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
-
-
Installez Cumulus Linux 5.4.0 :
cumulus@sw1:mgmt:~$ sudo onie-install -a -i http://<web-server>/<path>/cumulus-linux-5.4-mlx-amd64.bin
L'installateur démarre le téléchargement. Tapez y lorsque vous y êtes invité.
-
Redémarrez le commutateur NVIDIA SN2100 :
cumulus@sw1:mgmt:~$ sudo reboot
-
L'installation démarre automatiquement et les options suivantes s'affichent à l'écran GRUB. Ne faites aucune sélection.
-
Cumulus-Linux GNU/Linux
-
ONIE : Installer le système d'exploitation
-
INSTALLATION DE CUMULUS
-
Cumulus-Linux GNU/Linux
-
-
Répétez les étapes 1 à 4 pour vous connecter.
-
Vérifiez que la version de Cumulus Linux est bien la 5.4.0 :
nv show systemcumulus@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
-
Vérifiez que chaque nœud est connecté à 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
-
Créez un nouvel utilisateur et ajoutez-le à la liste.
sudogroupe. Cet utilisateur ne devient effectif qu'après le redémarrage de la session console/SSH.sudo adduser --ingroup netedit admincumulus@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:~$
-
Ajouter des groupes d'utilisateurs supplémentaires pour que l'utilisateur administrateur puisse y accéder
nvcommandes :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.
-
Connectez-vous au commutateur.
Lors de votre première connexion au commutateur, le nom d'utilisateur et le mot de passe cumulus/cumulus vous seront demandés.
sudoprivilè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>
-
Vérifiez la version de Cumulus Linux :
nv show systemcumulus@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
-
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 sera effectif qu'après le redémarrage de la console/session SSH.
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.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 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
Cette commande modifie à la fois le
/etc/hostnameet/etc/hostsfichiers. -
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
-
Configurez le fuseau horaire, la date, l'heure et le serveur NTP sur le commutateur.
-
Définissez le fuseau horaire :
cumulus@sw1:~$ nv set system timezone US/Eastern cumulus@sw1:~$ nv config apply
-
Vérifiez votre fuseau horaire actuel :
cumulus@switch:~$ date +%Z
-
Pour définir le fuseau horaire à l'aide de l'assistant, exécutez la commande suivante :
cumulus@sw1:~$ sudo dpkg-reconfigure tzdata
-
Réglez l'horloge du logiciel en fonction du fuseau horaire configuré :
cumulus@sw1:~$ sudo date -s "Tue Oct 28 00:37:13 2023"
-
Réglez la valeur actuelle de l'horloge logicielle sur la valeur de l'horloge matérielle :
cumulus@sw1:~$ sudo hwclock -w
-
Ajoutez un serveur NTP si nécessaire :
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
Consultez l'article de la base de connaissances"La configuration du serveur NTP ne fonctionne pas avec les commutateurs NVIDIA SN2100." pour plus de détails.
-
Vérifiez que
ntpdest en cours d'exécution 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
-
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
-
-
Installez 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
L'installateur démarre le téléchargement. Tapez y lorsque vous y êtes invité.
-
Redémarrez le commutateur NVIDIA SN2100 :
cumulus@sw1:mgmt:~$ sudo reboot
-
L'installation démarre automatiquement et les options suivantes s'affichent à l'écran GRUB. Ne faites aucune sélection.
-
Cumulus-Linux GNU/Linux
-
ONIE : Installer le système d'exploitation
-
INSTALLATION DE CUMULUS
-
Cumulus-Linux GNU/Linux
-
-
Répétez les étapes 1 à 4 pour vous connecter.
-
Vérifiez que la version de Cumulus Linux est bien la 5.11.0 :
nv show systemcumulus@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
-
Vérifiez que chaque nœud est connecté à chaque commutateur :
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
Voir "Comptes utilisateurs NVIDIA" pour plus d'informations.
Après avoir installé Cumulus Linux en mode Cumulus, vous pouvez"installer ou mettre à niveau le script RCF" .