Skip to main content
简体中文版经机器翻译而成，仅供参考。如与英语版出现任何冲突，应以英语版为准。

以 Cumulus 模式安装 Cumulus Linux

贡献者 netapp-yvonneo netapp-jolieg netapp-jsnyder
PDF

当交换机运行在 Cumulus 模式下时，请按照以下步骤安装 Cumulus Linux (CL) 操作系统。

备注 Cumulus Linux (CL) 操作系统可以在交换机运行 Cumulus Linux 或 ONIE 时安装（参见"以 ONIE 模式安装"）。
开始之前

确保以下各项可用：

  • 具备中级Linux知识。

  • 熟悉基本的文本编辑、UNIX 文件权限和进程监控。预装了多种文本编辑器，包括 vi`和 `nano。

  • 能够访问 Linux 或 UNIX shell。如果您运行的是 Windows 系统，请使用 Linux 环境作为与 Cumulus Linux 交互的命令行工具。

  • 对于NVIDIA SN2100 交换机控制台访问，串行控制台交换机的波特率要求必须设置为 115200，具体如下：

    • 115200 波特

    • 8 位数据

    • 1 停止位

    • 奇偶性：无

    • 流量控制：无

关于此任务

请注意以下事项：

备注 每次安装 Cumulus Linux 时，整个文件系统结构都会被擦除并重建。
注意 Cumulus 用户帐户的默认密码是 cumulus。首次登录 Cumulus Linux 时，必须更改此默认密码。安装新镜像之前，请务必更新所有自动化脚本。 Cumulus Linux 提供命令行选项，可在安装过程中自动更改默认密码。
示例 1. 步骤
Cumulus Linux 4.4.3

  1. 登录到该交换机。

    首次登录交换机需要用户名/密码为 cumulus/cumulus。 `sudo`特权。

    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. 检查 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. 配置主机名、IP地址、子网掩码和默认网关。新的主机名只有在重启控制台/SSH会话后才会生效。

    备注 Cumulus Linux 交换机至少提供一个专用的以太网管理端口，称为 eth0。此接口专门用于带外管理。默认情况下，管理接口使用 DHCPv4 进行地址分配。
    注意 主机名中不要使用下划线（_）、撇号（'）或非 ASCII 字符。 
    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

    此命令会同时修改以下两项： `/etc/hostname`和 `/etc/hosts`文件。

  4. 请确认主机名、IP 地址、子网掩码和默认网关已更新。

    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. 在交换机上设置日期、时间、时区和 NTP 服务器。

    1. 请确认当前时区：

      cumulus@sw1:~$ cat /etc/timezone

    2. 更新至新的时区：

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

    3. 请确认您当前的时区：

      cumulus@switch:~$ date +%Z

    4. 要使用引导式向导设置时区，请运行以下命令：

      cumulus@sw1:~$ sudo dpkg-reconfigure tzdata

    5. 根据配置的时区设置软件时钟：

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

    6. 将软件时钟的当前值设置为硬件时钟的值：

      cumulus@switch:~$ sudo hwclock -w

    7. 如有需要，请添加 NTP 服务器：

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

    8. 确认 `ntpd`正在系统上运行：

      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. 指定NTP源接口。默认情况下，NTP 使用的源接口是 eth0。您可以按如下方式配置不同的 NTP 源接口：

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

  6. 安装 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

    安装程序开始下载。出现提示时，请输入 y。

  7. 重启NVIDIA SN2100交换机：

    cumulus@sw1:mgmt:~$ sudo reboot

  8. 安装会自动开始，并出现以下 GRUB 屏幕选项。请勿进行任何选择。

    • Cumulus-Linux GNU/Linux

    • ONIE：安装操作系统

    • 积云安装

    • Cumulus-Linux GNU/Linux

  9. 重复步骤 1 至 4 登录。

  10. 请确认 Cumulus Linux 版本为 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. 创建一个新用户并将该用户添加到 `sudo`团体。该用户仅在控制台/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

  1. 登录到该交换机。

    首次登录交换机需要用户名/密码为 cumulus/cumulus。 `sudo`特权。

    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. 检查 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. 配置主机名、IP地址、子网掩码和默认网关。新的主机名只有在重启控制台/SSH会话后才会生效。

    备注 Cumulus Linux 交换机至少提供一个专用的以太网管理端口，称为 eth0。此接口专门用于带外管理。默认情况下，管理接口使用 DHCPv4 进行地址分配。
    注意 主机名中不要使用下划线（_）、撇号（'）或非 ASCII 字符。 
    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

    此命令会同时修改以下两项： `/etc/hostname`和 `/etc/hosts`文件。

  4. 请确认主机名、IP 地址、子网掩码和默认网关已更新。

    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. 在交换机上设置时区、日期、时间和 NTP 服务器。

    1. 设置时区：

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

    2. 请确认您当前的时区：

      cumulus@switch:~$ date +%Z

    3. 要使用引导式向导设置时区，请运行以下命令：

      cumulus@sw1:~$ sudo dpkg-reconfigure tzdata

    4. 根据配置的时区设置软件时钟：

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

    5. 将软件时钟的当前值设置为硬件时钟的值：

      cumulus@sw1:~$ sudo hwclock -w

    6. 如有需要，请添加 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

      请参阅知识库文章"NTP 服务器配置与NVIDIA SN2100 交换机不兼容。"更多详情请见下文。

    7. 确认 `ntpd`正在系统上运行：

      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. 指定NTP源接口。默认情况下，NTP 使用的源接口是 eth0。您可以按如下方式配置不同的 NTP 源接口：

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

  6. 安装 Cumulus Linux 5.4.0：

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

    安装程序开始下载。出现提示时，请输入 y。

  7. 重启NVIDIA SN2100交换机：

    cumulus@sw1:mgmt:~$ sudo reboot

  8. 安装会自动开始，并出现以下 GRUB 屏幕选项。请勿进行任何选择。

    • Cumulus-Linux GNU/Linux

    • ONIE：安装操作系统

    • 积云安装

    • Cumulus-Linux GNU/Linux

  9. 重复步骤 1 至 4 登录。

  10. 请确认 Cumulus Linux 版本为 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

  11. 确认每个节点都与每个交换机有连接：

    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. 创建一个新用户并将该用户添加到 `sudo`团体。该用户仅在控制台/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. 添加其他用户组以供管理员用户访问 `nv`命令：

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

    看 "NVIDIA用户帐户"了解更多信息。

Cumulus Linux 5.11.0

  1. 登录到该交换机。

    首次登录交换机时，需要输入用户名/密码 cumulus/cumulus。 `sudo`特权。

    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. 检查 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

  3. 配置主机名、IP地址、子网掩码和默认网关。新的主机名只有在重启控制台/SSH会话后才会生效。

    备注 Cumulus Linux 交换机至少提供一个专用的以太网管理端口，称为 eth0。此接口专门用于带外管理。默认情况下，管理接口使用 DHCPv4 进行地址分配。
    注意 主机名中不要使用下划线（_）、撇号（'）或非 ASCII 字符。 
    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

    此命令会同时修改以下两项： `/etc/hostname`和 `/etc/hosts`文件。

  4. 请确认主机名、IP 地址、子网掩码和默认网关已更新。

    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. 在交换机上设置时区、日期、时间和 NTP 服务器。

    1. 设置时区：

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

    2. 请确认您当前的时区：

      cumulus@switch:~$ date +%Z

    3. 要使用引导式向导设置时区，请运行以下命令：

      cumulus@sw1:~$ sudo dpkg-reconfigure tzdata

    4. 根据配置的时区设置软件时钟：

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

    5. 将软件时钟的当前值设置为硬件时钟的值：

      cumulus@sw1:~$ sudo hwclock -w

    6. 如有需要，请添加 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

      请参阅知识库文章"NTP 服务器配置与NVIDIA SN2100 交换机不兼容。"更多详情请见下文。

    7. 确认 `ntpd`正在系统上运行：

      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. 指定NTP源接口。默认情况下，NTP 使用的源接口是 eth0。您可以按如下方式配置不同的 NTP 源接口：

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

  6. 安装 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

    安装程序开始下载。出现提示时，请输入 y。

  7. 重启NVIDIA SN2100交换机：

    cumulus@sw1:mgmt:~$ sudo reboot

  8. 安装会自动开始，并出现以下 GRUB 屏幕选项。请勿进行任何选择。

    • Cumulus-Linux GNU/Linux

    • ONIE：安装操作系统

    • 积云安装

    • Cumulus-Linux GNU/Linux

  9. 重复步骤 1 至 4 登录。

  10. 请确认 Cumulus Linux 版本为 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

  11. 确认每个节点都与每个交换机有连接：

    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

看 "NVIDIA用户帐户"了解更多信息。

下一步是什么？

在 Cumulus 模式下安装 Cumulus Linux 后，您可以……"安装或升级 RCF 脚本" 。