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

以 Cumulus 模式安装 Cumulus Linux

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

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

备注 可以在交换机运行 Cumulus Linux 或 ONIE 时安装 Cumulus Linux (CL) 操作系统（请参阅 "以 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 脚本" 。