Skip to main content
本繁體中文版使用機器翻譯,譯文僅供參考,若與英文版本牴觸,應以英文版本為準。

升級 Cumulus Linux 版本

貢獻者 netapp-yvonneo

請依照以下步驟升級您的 Cumulus Linux 版本(如有需要)。

開始之前

請確保您擁有以下物品:

  • 具備中級Linux知識。

  • 熟悉基本的文字編輯、UNIX 檔案權限和進程監控。預先安裝了多種文字編輯器,包括 vi`和 `nano

  • 能夠存取 Linux 或 UNIX shell。如果您使用的是 Windows 系統,請使用 Linux 環境作為與 Cumulus Linux 互動的命令列工具。

  • 對於NVIDIA SN2100 交換器控制台訪問,序列控制台交換器的波特率要求設定為 115200,具體如下:

    • 115200 波特

    • 8 位元數據

    • 1 停止位

    • 奇偶性:無

    • 流量控制:無

關於此任務

請注意以下事項:

註 每次 Cumulus Linux 升級時,整個檔案系統結構都會被擦除並重建。您現有的配置將被清除。在更新 Cumulus Linux 之前,必須儲存並記錄交換器配置。
警告 Cumulus 使用者帳戶的預設密碼是 cumulus。首次登入 Cumulus Linux 時,必須變更此預設密碼。安裝新鏡像之前,必須先更新所有自動化腳本。 Cumulus Linux 提供命令列選項,可在安裝過程中自動變更預設密碼。

"安裝新的 Cumulus Linux 鏡像"欲了解更多資訊。

範例 1. 步驟
Cumulus Linux 4.4.x 至 Cumulus Linux 5.4.0
  1. 將集群交換器連接到管理網路。

  2. 使用 ping 指令驗證與託管 Cumulus Linux 和 RCF 的伺服器的連線性。

  3. 顯示每個節點上連接到叢集交換器的叢集連接埠:

    network device-discovery show

  4. 檢查每個叢集連接埠的管理和運作狀態。

    1. 確認叢集所有連接埠均已啟動且狀態正常:

      network port show -role cluster

    2. 確認所有叢集介面(LIF)都位於主連接埠上:

      network interface show -role cluster

    3. 確認集群顯示兩個集群交換器的資訊:

      system cluster-switch show -is-monitoring-enabled-operational true

  5. 停用群集 LIF 的自動回滾功能。叢集 LIF 會故障轉移到夥伴叢集交換機,並在您對目標交換器執行升級程序時保留在該交換器上:

    network interface modify -vserver Cluster -lif * -auto-revert false

  6. 檢查目前 Cumulus Linux 版本和已連接的連接埠:

    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
    
    cumulus@cumulus: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))
    .
    .
  7. 下載 Cumulux Linux 5.4.0 鏡像:

    cumulus@cumulus: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.
  8. 重啟交換器:

    cumulus@cumulus:mgmt:~$ sudo reboot
  9. 更改密碼:

    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'
  10. 檢查 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
  11. 更改主機名稱:

    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
    .
    .
  12. 登出並重新登入交換機,即可在提示符號處看到更新後的交換器名稱:

    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:~$
  13. 設定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
  14. 建立一個新用戶並將該用戶加入到 `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:~$
  15. 新增其他使用者群組以供管理員使用者訪問 `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.x 至 Cumulus Linux 5.4.0
  1. 將集群交換器連接到管理網路。

  2. 使用 ping 指令驗證與託管 Cumulus Linux 和 RCF 的伺服器的連線性。

  3. 顯示每個節點上連接到叢集交換器的叢集連接埠:

    network device-discovery show

  4. 檢查每個叢集連接埠的管理和運作狀態。

    1. 確認叢集所有連接埠均已啟動且狀態正常:

      network port show -role cluster

    2. 確認所有叢集介面(LIF)都位於主連接埠上:

      network interface show -role cluster

    3. 確認集群顯示兩個集群交換器的資訊:

      system cluster-switch show -is-monitoring-enabled-operational true

  5. 停用群集 LIF 的自動回滾功能。叢集 LIF 會故障轉移到夥伴叢集交換機,並在您對目標交換器執行升級程序時保留在該交換器上:

    network interface modify -vserver Cluster -lif * -auto-revert false

  6. 檢查目前 Cumulus Linux 版本和已連接的連接埠:

    cumulus@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
    
    cumulus@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
  7. 下載 Cumulux Linux 5.4.0 鏡像:

    cumulus@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.
  8. 重啟交換器:

    cumulus@sw1:mgmt:~$ sudo reboot
  9. 更改密碼:

    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'
  10. 檢查 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
  11. 更改主機名稱:

    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
    .
    .
  12. 登出並重新登入交換機,即可在提示符號處看到更新後的交換器名稱:

    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:~$
  13. 設定IP位址:

    cumulus@sw1:mgmt:~$ nv unset interface eth0 ip address dhcp
    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
  14. 建立一個新用戶並將該用戶加入到 `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:~$
  15. 新增其他使用者群組以供管理員使用者訪問 `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.4.0 至 Cumulus Linux 5.11.0
  1. 將集群交換器連接到管理網路。

  2. 使用 ping 指令驗證與託管 Cumulus Linux 和 RCF 的伺服器的連線性。

  3. 顯示每個節點上連接到叢集交換器的叢集連接埠:

    network device-discovery show

  4. 檢查每個叢集連接埠的管理和運作狀態。

    1. 確認叢集所有連接埠均已啟動且狀態正常:

      network port show -role cluster

    2. 確認所有叢集介面(LIF)都位於主連接埠上:

      network interface show -role cluster

    3. 確認集群顯示兩個集群交換器的資訊:

      system cluster-switch show -is-monitoring-enabled-operational true

  5. 停用群集 LIF 的自動回滾功能。叢集 LIF 會故障轉移到夥伴叢集交換機,並在您對目標交換器執行升級程序時保留在該交換器上:

    network interface modify -vserver Cluster -lif * -auto-revert false

  6. 檢查目前 Cumulus Linux 版本和已連接的連接埠:

    cumulus@sw1:mgmt:~$ nv show system
                        operational          applied
    ------------------- -------------------- -----------------
    hostname            cumulus              cumulus
    build               Cumulus Linux 5.4.0
    uptime              6 days, 8:37:36
    timezone            Etc/UTC
    
    cumulus@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
  7. 下載 Cumulux Linux 5.11.0 鏡像:

    cumulus@sw1:mgmt:~$ sudo onie-install -a -i http://<ip-to-webserver>/path/to/cumulus-linux-5.11.0-mlx-amd64.bin
    [sudo] password for cumulus:
    Fetching installer: http://<ip-to-webserver>/path/to/cumulus-linux-5.11.0-mlx-amd64.bin
    Downloading URL: http://<ip-to-webserver>/path/to/cumulus-linux-5.11.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.
  8. 重啟交換器:

    cumulus@sw1:mgmt:~$ sudo reboot
  9. 更改密碼:

    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.11.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'
  10. 檢查 Cumulus Linux 版本: nv show system

    cumulus@cumulus:mgmt:~$ nv show system
    operational    applied
    -------------- ----------------
    hostname       cumulus cumulus
    build          Cumulus Linux 5.11.0
    uptime         14:07:08
    timezone       Etc/UTC
  11. 更改主機名稱:

    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
    .
    .
  12. 登出並重新登入交換機,即可在提示符號處看到更新後的交換器名稱:

    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.11.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:~$
  13. 設定IP位址:

    cumulus@sw1:mgmt:~$ nv unset interface eth0 ip address dhcp
    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
下一步是什麼?

升級 Cumulus Linux 版本後,您可以…"安裝或升級 RCF 腳本"