日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

ONIEモードでCumulus Linuxをインストールする

10/03/2025 共同作成者

PDF

スイッチが ONIE モードで実行されているときに Cumulus Linux (CL) OS をインストールするには、次の手順に従ってください。

Cumulus Linux (CL) OSは、スイッチがONIEまたはCumulus Linuxを実行しているときにインストールできます（"Cumulusモードでインストール" ）。

タスク概要

ネットワークインストーライメージの自動検出を可能にする Open Network Install Environment (ONIE) を使用して Cumulus Linux をインストールできます。これにより、Cumulus Linux などのオペレーティングシステムを選択してスイッチを保護するシステムモデルが容易になります。 ONIE を使用して Cumulus Linux をインストールする最も簡単な方法は、ローカル HTTP 検出を使用することです。

ホストが IPv6 対応である場合は、Web サーバーが実行されていることを確認してください。ホストが IPv4 対応の場合は、Web サーバーに加えて DHCP も実行されていることを確認してください。

この手順では、管理者が ONIE で起動した後に Cumulus Linux をアップグレードする方法を示します。

例 1. 手順

キュムラス・リナックス 4.4.3

Cumulus Linux インストールファイルを Web サーバーのルートディレクトリにダウンロードします。このファイルの名前を次のように変更します: onie-installer 。
イーサネットケーブルを使用して、ホストをスイッチの管理イーサネットポートに接続します。
スイッチの電源を入れます。

スイッチは ONIE イメージインストーラをダウンロードして起動します。インストールが完了すると、ターミナルウィンドウに Cumulus Linux ログインプロンプトが表示されます。

Cumulus Linux がインストールされるたびに、ファイルシステム構造全体が消去され、再構築されます。
SN2100スイッチを再起動します。
```
cumulus@cumulus:mgmt:~$ sudo reboot
```
GNU GRUB 画面で Esc キーを押して通常のブートプロセスを中断し、ONIE を選択して Enter を押します。
次の画面で、*ONIE: OSのインストール*を選択します。
ONIE インストーラー検出プロセスが自動インストールの検索を実行します。プロセスを一時的に停止するには、Enter を押します。

検出プロセスが停止した場合:

ONIE:/ # onie-stop
discover: installer mode detected.
Stopping: discover...start-stop-daemon: warning: killing process 427:
No such process done.

ネットワーク上で DHCP サービスが実行されている場合は、IP アドレス、サブネットマスク、およびデフォルトゲートウェイが正しく割り当てられていることを確認します。

ifconfig eth0

ONIE:/ # ifconfig eth0
eth0   Link encap:Ethernet  HWaddr B8:CE:F6:19:1D:F6
       inet addr:10.233.204.71  Bcast:10.233.205.255  Mask:255.255.254.0
       inet6 addr: fe80::bace:f6ff:fe19:1df6/64 Scope:Link
       UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
       RX packets:21344 errors:0 dropped:2135 overruns:0 frame:0
       TX packets:3500 errors:0 dropped:0 overruns:0 carrier:0
       collisions:0 txqueuelen:1000
       RX bytes:6119398 (5.8 MiB)  TX bytes:472975 (461.8 KiB)
       Memory:dfc00000-dfc1ffff

ONIE:/ # route
Kernel IP routing table
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface

default         10.233.204.1    0.0.0.0         UG    0      0      0   eth0
10.233.204.0    *               255.255.254.0   U     0      0      0   eth0

IP アドレス指定スキームを手動で定義する場合は、次の手順を実行します。

ONIE:/ # ifconfig eth0 10.233.204.71 netmask 255.255.254.0
ONIE:/ # route add default gw 10.233.204.1

手順 9 を繰り返して、静的情報が正しく入力されていることを確認します。

Cumulus Linux をインストールします。

# onie-nos-install http://<web-server>/<path>/cumulus-linux-4.4.3-mlx-amd64.bin

ONIE:/ # route

  Kernel IP routing table

  ONIE:/ # onie-nos-install http://<web-server>/<path>/cumulus-linux-4.4.3-mlx-amd64.bin

  Stopping: discover... done.
  Info: Attempting http://10.60.132.97/x/eng/testbedN,svl/nic/files/cumulus-linux-4.4.3-mlx-amd64.bin ...
  Connecting to 10.60.132.97 (10.60.132.97:80)
  installer            100% |*|   552M  0:00:00 ETA
  ...
  ...

インストールが完了したら、スイッチにログインします。

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>

Cumulus Linux のバージョンを確認します。 net show version

cumulus@cumulus:mgmt:~$ net show version
NCLU_VERSION=1.0-cl4.4.3u4
DISTRIB_ID="Cumulus Linux"
DISTRIB_RELEASE=4.4.3
DISTRIB_DESCRIPTION="Cumulus Linux 4.4.3”

キュムラス Linux 5.x

Cumulus Linux インストールファイルを Web サーバーのルートディレクトリにダウンロードします。このファイルの名前を次のように変更します: onie-installer 。
イーサネットケーブルを使用して、ホストをスイッチの管理イーサネットポートに接続します。
スイッチの電源を入れます。

スイッチは ONIE イメージインストーラをダウンロードして起動します。インストールが完了すると、ターミナルウィンドウに Cumulus Linux ログインプロンプトが表示されます。

Cumulus Linux がインストールされるたびに、ファイルシステム構造全体が消去され、再構築されます。

SN2100スイッチを再起動します。

cumulus@cumulus:mgmt:~$ sudo reboot
.
.
GNU GRUB version 2.06-3
+-------------------------------------------------------------------------+
| Cumulus-Linux GNU/Linux                                                 |
| Advanced options for Cumulus-Linux GNU/Linux                            |
| ONIE                                                                    |
|                                                                         |
|                                                                         |
|                                                                         |
|                                                                         |
|                                                                         |
|                                                                         |
|                                                                         |
|                                                                         |
+-------------------------------------------------------------------------+

GNU GRUB 画面で Esc キーを押して通常のブートプロセスを中断し、ONIE を選択して Enter キーを押します。

.
.
Loading ONIE ...

GNU GRUB version 2.02
+-------------------------------------------------------------------------+
| ONIE: Install OS                                                        |
| ONIE: Rescue                                                            |
| ONIE: Uninstall OS                                                      |
| ONIE: Update ONIE                                                       |
| ONIE: Embed ONIE                                                        |
|                                                                         |
|                                                                         |
|                                                                         |
|                                                                         |
|                                                                         |
+-------------------------------------------------------------------------+

ONIEを選択します: OSをインストールします。

ONIE インストーラー検出プロセスが自動インストールの検索を実行します。プロセスを一時的に停止するには、Enter を押します。

検出プロセスが停止した場合:

ONIE:/ # onie-stop
discover: installer mode detected.
Stopping: discover...start-stop-daemon: warning: killing process 427:
No such process done.

IP アドレス、サブネットマスク、およびデフォルトゲートウェイを構成します。

ifconfig eth0

ONIE:/ # ifconfig eth0
eth0   Link encap:Ethernet  HWaddr B8:CE:F6:19:1D:F6
       inet addr:10.233.204.71  Bcast:10.233.205.255  Mask:255.255.254.0
       inet6 addr: fe80::bace:f6ff:fe19:1df6/64 Scope:Link
       UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
       RX packets:21344 errors:0 dropped:2135 overruns:0 frame:0
       TX packets:3500 errors:0 dropped:0 overruns:0 carrier:0
       collisions:0 txqueuelen:1000
       RX bytes:6119398 (5.8 MiB)  TX bytes:472975 (461.8 KiB)
       Memory:dfc00000-dfc1ffff
ONIE:/ #
ONIE:/ # ifconfig eth0 10.228.140.27 netmask 255.255.248.0
ONIE:/ # ifconfig eth0
eth0   Link encap:Ethernet HWaddr B8:CE:F6:5E:05:E6
       inet addr:10.228.140.27 Bcast:10.228.143.255 Mask:255.255.248.0
       inet6 addr: fd20:8b1e:b255:822b:bace:f6ff:fe5e:5e6/64 Scope:Global
       inet6 addr: fe80::bace:f6ff:fe5e:5e6/64 Scope:Link
       UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
       RX packets:18813 errors:0 dropped:1418 overruns:0 frame:0
       TX packets:491 errors:0 dropped:0 overruns:0 carrier:0
       collisions:0 txqueuelen:1000
       RX bytes:1339596 (1.2 MiB) TX bytes:49379 (48.2 KiB)
       Memory:dfc00000-dfc1ffff
ONIE:/ # route add default gw 10.228.136.1
ONIE:/ # route
Kernel IP routing table
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface

default         10.228.136.1    0.0.0.0         UG    0      0      0   eth0
10.228.136.1    *               255.255.248.0   U     0      0      0   eth0

Cumulus Linux 5.4 をインストールします。

# onie-nos-install http://<web-server>/<path>/cumulus-linux-5.4-mlx-amd64.bin

ONIE:/ # route

  Kernel IP routing table

  ONIE:/ # onie-nos-install http://<web-server>/<path>/cumulus-linux-5.4-mlx-amd64.bin

  Stopping: discover... done.
  Info: Attempting http://10.60.132.97/x/eng/testbedN,svl/nic/files/cumulus-linux-5.4-mlx-amd64.bin ...
  Connecting to 10.60.132.97 (10.60.132.97:80)
  installer            100% |*|   552M  0:00:00 ETA
  ...
  ...

インストールが完了したら、スイッチにログインします。

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>

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, 13:37:36     system uptime
timezone            Etc/UTC              system time zone

新しいユーザーを作成し、このユーザーを `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:~$

管理者ユーザーがアクセスするための追加のユーザーグループを追加する `nv`コマンド:
```
cumulus@cumulus:mgmt:~$ sudo adduser admin nvshow
     [sudo] password for cumulus:
     Adding user `admin' to group `nvshow' ...
     Adding user admin to group nvshow
     Done.
```
見る "NVIDIAユーザーアカウント"詳細についてはこちらをご覧ください。

次の手順

"参照構成ファイル（RCF）スクリプトをインストールする" 。

ONIEモードでCumulus Linuxをインストールする

Creating your file...