Celestica 开源网络
“
产品信息
规格
- 产品名称：SONiC
- 操作系统：SONiC NOS
- 安装方法：USB 闪存盘、网络
安装 - 用户界面：命令行界面（CLI）
- 版本：根据下载而变化
产品使用说明
1. 下载图片
从官方下载 SONiC NOS 镜像 web地点。
2. 使用 USB 拇指驱动器安装
将装有 SONiC NOS 映像的 USB 拇指驱动器插入
设备。按照屏幕上的说明安装映像。
3. 通过网络安装
将设备连接到网络并按照步骤操作
通过网络安装 SONiC NOS。
4. 登录用户名和密码
使用手册中提供的默认登录凭据
访问系统。
5. 基本配置及展示
根据需要配置管理和环回接口。使用
“show”命令显示系统信息。
6. 软件版本及升级
检查当前软件版本，如有必要请升级。
按照升级或降级版本的说明进行操作。
7. SONiC 安装程序
利用 SONiC 安装程序进行系统设置和
配置。
8.启动配置
View 并修改启动配置以定制系统
设置。
9。 故障排除
使用基本的故障排除命令，例如“show techsupport”，
'syslog' 和 'tcpdump' 来诊断问题。
常问问题
问：SONiC 的默认登录凭据是什么？
答：手册中提供的默认登录用户名为
“admin”，密码为“admin123”。
问：如何升级 SONiC 的软件版本？
答：要升级软件版本，请下载最新的镜像
来自官方 web网站并按照升级说明进行操作
请参阅手册中提供的。
“`
SONiC 用户手册
目录
SONiC 用户手册………………………………………………………………………………………………1 简介…………………………………………………………………………………………………………..2 快速入门…………………………………………………………………………………………………….4
下载图片………………………………………………………………………………………………4
使用 USB 拇指驱动器安装……………………………………………………………………4 通过网络安装………………………………………………………………………………4
SONiC NOS 全新安装………………………………………………………………………….4 安装 SONiC NOS 映像………………………………………………………………………………6
登录用户名和密码………………………………………………………………..8
默认登录……………………………………………………………………………………………………8 配置用户名和密码………………………………………………………………..9
基本配置及展示…………………………………………………………………………10
配置管理口和环回口…………………………………………………………10 软件版本及升级………………………………………………………………………………11
显示版本………………………………………………………………………………………….12 此版本中的可用功能…………………………………………………………………….13 升级或降级版本………………………………………………………………………….13
SONiC 安装程序………………………………………………………………………………..13
启动配置………………………………………………………………………………………….. 15
默认启动配置……………………………………………………………………………….15 修改配置………………………………………………………………………………………… 16
修改config_db.json…………………………………………………………………………… 16
故障排除……………………………………………………………………………………………… 17
基本故障排除命令………………………………………………………………..17
显示技术支持…………………………………………………………………………………….17 系统日志………………………………………………………………………………………………..18 tcpdump……………………………………………………………………………………………….18
i
联系方式…………………………………………………………………………………………19
ii
SONiC 用户手册
本参考文件提供了 SONiC 产品的重要法律免责声明和声明。
免责声明
版权所有 © 2024 Celestica。保留所有权利。“Celestica”是指 Celestica Inc. 及其子公司。如需更多信息，请访问我们的 web网站：www.Celestica.com。所有提及的商标、商品名、服务标记和徽标均属于其各自所有者。Celestica 可能会在不事先通知的情况下更新产品规格或信息，以增强可靠性、功能性或设计。尽管所提供的信息被认为是准确的，但对于其使用或任何侵犯专利或第三方权利的行为不承担任何责任。
1
介绍
SONiC 是基于 Linux 的开源网络操作系统，可在来自多个供应商的交换机和 ASIC（专用集成电路）上运行。SONiC 提供全套网络功能，如 BGP 和 RDMA，这些功能已在一些最大的云服务提供商的数据中心中得到生产强化。它为团队提供了创建所需网络解决方案的灵活性，同时利用大型生态系统和社区的集体力量。这些受支持的设备应加载 SONiC 软件，本用户指南介绍了在这些平台上使用 SONiC 的基本步骤。连接设备的控制台端口并使用 115200 波特率访问设备。按照快速入门指南以 ONIE 模式启动设备，并使用文档中指定的步骤安装 SONiC 软件并重新启动设备。在某些预装了 SONiC 软件的设备中，可以跳过此步骤。用户应使用默认用户名/密码“admin/YourPaSsWoRd”通过控制台端口登录设备。登录设备后，可以通过以下两种方法配置SONiC软件。
1. 命令行界面 2. config_db.json 用户可以使用以上所有方法，也可以选择其中一种方法进行配置并 view 设备的状态。本用户手册介绍了常用命令和相关配置/show examp有关如何使用 SONiC 设备的文件。请参阅上述文档以获取更多详细信息。
文档范围
本手册中的信息基于 SONiC 软件版本 202311。本用户手册提供了以下方面的一些见解：
1. 如何在支持的平台上加载 SONiC 映像。2. 如何使用默认用户名和密码登录，如何更改密码，如何
配置管理接口和Loopback地址配置。3.如何查看设备运行的软件版本，如何查看功能列表
如何升级到新软件版本等。4. 如何检查设备当前运行的默认启动配置，
如何将新配置加载到此设备，等等。5. 有关故障排除的基本信息以及详细故障排除指南的链接。请注意，本文档的某些部分可能重复了以下几个命令/段落：
2
其他配置文档（如命令参考、配置数据库手册、故障排除指南等）。详细信息请参阅相应文档。
3
快速入门
本节详细介绍了在支持的交换机上安装 SONiC 映像的步骤。
下载图片
每个 ASIC 供应商都有一个 SONiC 映像。您可以在此处下载 SONiC 映像。您也可以从源代码构建 SONiC，说明可在此处找到。一旦映像在本地计算机中可用，就可以通过使用 USB 拇指驱动器或通过网络安装映像，如以下小节所述。如果设备已预装 SONiC 映像，则可以在无需安装过程的情况下启动设备。
使用 USB 拇指驱动器安装
本节介绍如何将映像从 USB 拇指驱动器传输到设备并进行安装。
1. 将下载的 SONiC 图像复制到 USB 拇指驱动器上。 2. 从您的机器上移除 USB 驱动器并将其插入前面的 USB 端口（或
启用 ONIE 的设备后面板。 3. 打开设备电源，ONIE 将发现 onie-installer file 在 USB 驱动器的根目录上
并执行。以上信息取自https://opencomputeproject.github.io/onie/user-guide/index.html
通过网络安装
本节介绍如何将图像从远程服务器传输到设备并安装它。
全新安装 SONiC NOS
1. 通过串行控制台连接到交换机。 2. 对于 ARM 平台，使用 UBOOT 提示符下的运行 onie_bootcmd 来加载 ONIE。
4
3. （可选）某些交换机可能带有 NOS，因此您需要先卸载现有 NOS，然后再安装 SONiC。为此，只需启动 ONIE 并选择卸载操作系统即可。
GNU GRUB 版本 2.02~beta2+e4a1fe391
+————————————————————————-
—+
|*ONIE：安装
OS
|
| ONIE:
救援
|
| ONIE：卸载操作系统<—–选择此项
一
|
| ONIE：更新
奥妮
|
| ONIE：嵌入
奥妮
|
+——————————————————————————+
使用 ^ 和 v 键选择要突出显示的条目。按 Enter 启动所选操作系统，按“e”在启动前编辑命令，或按“c”进入命令行。
4. 将交换机重新启动到 ONIE 并选择安装操作系统。
GNU GRUB 版本 2.02~beta2+e4a1fe391
+————————————————————————-
—+
|*ONIE：安装操作系统<—–选择此项
一
|
| ONIE:
救援
|
| ONIE：卸载
OS
|
5
| ONIE：更新
奥妮
|
| ONIE：嵌入
奥妮
|
+——————————————————————————+
使用 ^ 和 v 键选择突出显示的条目。 按 Enter 键启动选定的操作系统，按“e”键在启动前编辑命令，或按“c”键进入命令行。
5. 分配 IP 地址。确保 eth0 已分配静态 IP 或通过 DHCP 获取。对于 ES1000 x86，请确保 eth2 已分配静态 IP 或通过 DHCP 获取。对于 ES1010/ES1050/EG1050，请确保 eth2 已分配静态 IP 或通过 DHCP 获取。使用 onie-stop 停止 ONIE 发现模式。
注意：ES1000 x86 和 ES1010/ES1050/EG1050 ONIE eth2 被视为管理接口。
6. 安装 SONiC。使用 scp / sftp / ftp / http 将图像传输到设备中。
ONIE:/# ifconfig eth0网络掩码ONIE:/#ip 路由添加默认ONIE:/#onie-nos-安装URL>
7. 安装成功后，设备将自动重启并使用 SONiC 启动。
安装 SONiC NOS 映像
1. 安装 NOS。使用 sonic-installer 命令安装 sonic-broadcom.bin。sonic-broadcom.bin file 应该已经转移到声波 file系统使用：
sudo sonic-installer安装sonic-broadcom.bin
6
注：或者，可以将图像放置在远程 http 服务器中，并在提供 http 后使用 sonic_installer 命令 file 位置。2. 检查镜像状态。使用以下命令检查镜像状态。
sudo sonic 安装程序列表
新安装的镜像应显示在“Next:”下，其中，Current：表示当前正在运行的镜像。Next：表示下一个启动镜像。Available：表示所有已安装的 SONiC 镜像。
3. 重启。安装完成后，重启系统，新的镜像应该会作为 NOS 安装选项之一出现（也是默认选项）。
sudo 重启
7
登录用户名和密码
本节介绍默认用户名和密码以及如何更改密码。
默认登录
默认情况下，所有 SONiC 设备都支持基于串行控制台的登录和基于 SSH 的登录。登录的默认凭据（如果在映像构建时未修改）是 admin/YourPaSsWoRd。如果使用 SSH 登录，用户可以在使用串行控制台配置管理接口 (eth0) IP 地址后登录到管理接口 (ethXNUMX) IP 地址。请参阅配置管理接口和环回接口部分以配置管理接口的 IP 地址。例如amp乐：
在控制台：Debian GNU/Linux 9 sonic ttyS1 sonic 登录：admin 密码：YourPaSsWoRd 可以通过连接到 SONiC IP user@debug:~$ ssh admin@sonic_ip_address（或 SONIC DNS 名称）从任何远程服务器通过 SSH 连接到 sonic admin@sonic 的密码：
默认情况下，登录后用户将进入默认提示符，可从中执行所有 show 命令。成功登录后，将显示 SONiC 每日欢迎信息。
8
配置用户名和密码
注意：登录前请等待系统显示“系统已准备就绪”。首次登录时，系统会提示用户更改密码。请输入符合密码策略要求的新密码。此密码不能与默认密码相同。默认情况下，ZTP 处于启用状态（对于 ES1000 ARM 平台，ZTP 默认处于禁用状态）。用户必须使用 sudo config ztp disable 禁用 ZTP（这大约需要 2 分钟）。使用 Click CLI 更新新密码。
配置用户修改管理员-密码
仅当保存配置时，新密码才会保存到启动配置中。要将运行配置保存到启动配置中，请使用以下 CLI 命令：sudo config save -y
9
基本配置与展示
SONiC 在单一真实来源（即我们称为 ConfigDB 的 redisDB 实例）中管理配置。应用程序订阅 ConfigDB 并相应地生成其运行配置。您可以在此处找到有关 ConfigDB 和架构设计的详细信息。SONiC 包含允许用户显示平台、收发器、L2、IP、BGP 状态等的命令。
命令参考
注意：所有配置命令都需要 root 权限才能执行，并且命令区分大小写。所有用户都可以执行 Show 命令，无需 root 权限。可以通过在所有配置命令前使用 sudo 关键字或使用 sudo -i 进入 root 提示符来获取 root 权限。
配置管理接口和环回接口
SONiC 中的管理接口 (eth0) 默认配置为使用 DHCP 客户端从 DHCP 服务器获取 IP 地址。将管理接口连接到 DHCP 服务器所连接的同一网络，并从 DHCP 服务器获取 IP 地址。可以使用 /sbin/ifconfig eth0 Linux 命令验证从 DHCP 服务器收到的 IP 地址。有几种替代方法可以为管理接口配置静态 IP 地址。
1. 使用 Click CLI。
admin@Celestica-DS1000:~$ 配置接口 ip 添加 eth0
2. 使用 config_db.json 并使用适当的值配置 MGMT_INTERFACE 键。有关详细信息，请参阅此处添加以下示例ample 配置 file （前任amp该文件包含一个文件名为：mgmt_ip.json（.le：mgmt_ip.json）的配置文件，并按如下方式加载。
{
10
“MGMT_INTERFACE|eth0|10.208.81.132/24”：{“值”：{“gwaddr”：“10.208.81.1”}
}
注意：如果接口 IP 地址和默认网关已经存在，用户应在加载上述配置之前将其删除。
用户可以使用 show running configuration all 命令检查已配置的 MGMT_INTERFACE，或者使用下面的 redis-cli 命令检查。
admin@Celestica-DS1000:~$ redis-cli -n 4 个键 “MGMT_INTERFACE*” 1) “MGMT_INTERFACE|eth0|10.208.81.132/24” admin@Celestica-DS1000:~$
删除密钥后，用户可以使用 config load mgmt_ip.json 命令加载新配置，然后执行 systemctl restart interface-config 使其生效。用户应使用 ifconfig Linux 命令或通过 click CLI show ip interface 验证配置的管理接口 IP 地址值。3. 配置 IP 地址后，可以使用 /sbin/ifconfig eth0 Linux 命令验证。用户可以从其管理网络通过 SSH 登录到此管理接口 IP 地址。例如amp乐：
admin@sonic:~$ /sbin/ifconfig eth0 eth0：flags=4163 mtu 1500 inet 10.11.11.13 网络掩码 255.255.255.0 广播 10.11.12.255
可以使用相同的方法配置Loopback接口地址。1.应使用/sbin/ifconfig lo Linux命令。或者，2.在config_db.json中添加键LOOPBACK_INTERFACE和值并加载。
软件版本与升级
11
本节介绍如何检查设备中运行的软件的当前版本、如何检查版本中可用的功能以及如何升级/降级到不同版本。
显示版本
显示版本
此命令显示当前正在运行的 SONiC 映像的软件组件版本。这包括 SONiC 映像版本以及 Docker 映像版本。此命令显示相关信息，如正在使用的 SONiC 和 Linux 内核版本，以及用于构建 SONiC 映像的提交 ID。
用法
显示版本
Example
root@Celestica-DS1000:~$ 显示版本
SONiC 软件版本：SONiC-OS-celestica_sonic_3.1.2-5-8f2ee6619 产品：Celestica DS1000 SONiC OS 版本：11 发行版：Debian 11.11 内核：5.10.0-23-2-amd64 构建提交：8f2ee6619 构建日期：16 年 19 月 00 日星期一 57:2024:10 UTC 构建者：autobuild@AZUHPSPXNUMX
平台：x86_64-cel_ds1000-r0 HwSKU：Celestica DS1000 ASIC：broadcom ASIC 数量：1 序列号：E1070F2B042525GD200121 型号：R3059-F9010-01 硬件修订版：4 启动时间：09:20:22 启动 3 天，31 分钟，2 个用户，1.93，1.97 日期：20 年 2024 月 09 日星期五 20:22:XNUMX
平均负载：1.80，
12
此版本中的可用功能
SONiC 路线图规划解释了每个软件版本中添加的各种功能。
升级或降级版本
SONiC 软件可以通过两种方法安装，一种是使用 ONIE 安装程序，另一种是使用 sonicinstaller 工具。ONIE 安装程序可以按照 QuickStartGuide 中的说明使用。sonic-installer 工具可以按照下面的说明使用。
SONiC 安装程序
这是 SONiC 软件的一部分，是一个命令行工具。如果设备已在运行 SONiC 软件，则可以使用此工具在分区中安装备用映像。此工具可以安装备用映像、列出可用映像并设置下一个重新启动映像。
sonic-installer 安装
此命令用于在备用映像分区上安装新映像。此命令需要可安装 SONiC 映像的路径或 URL 并安装图像。
注意：为避免在切换到最新版本的 SONiC 或其他版本时保留配置，请使用 sonic-installer install –skip_migration –skip-package-migration sonic-broadcom.bin
用法
sonic-installer 安装
Example
root@Celestica-DS1000:~$ sonic-installer 安装 sonic-broadcom.bin
sonic 安装程序列表
13
此命令显示有关当前已安装映像的信息。它显示已安装映像、当前正在运行的映像和下次重启时要加载的映像集的列表。
用法
sonic 安装程序列表
Example
root@Celestica-DS1000:~# sonic-installer 列表 当前：SONiC-OS-celestica_sonic_3.1.2-5-8f2ee6619 下一个：SONiC-OS-celestica_sonic_3.1.2-6-568c05804 可用：SONiC-OS-celestica_sonic_3.1.2-6-568c05804 SONiC-OS-celestica_sonic_3.1.2-5-8f2ee6619 root@Celestica-DS1000:~#
sonic-installer 设置默认值
此命令用于更改所有后续重启中默认加载的映像。
用法
sonic-installer 设置默认值
Example
root@Celestica-DS1000:~# sonic-installer 设置默认 SONiC-OScelestica_sonic_3.1.2-6-568c05804
sonic-installer 设置下次启动
此命令用于更改仅在下次重启时可加载的映像。请注意，下次重启后，它将在所有其他后续重启中恢复到当前映像。
用法
sonic-installer 设置下次启动
Example
14
root@Celestica-DS1000:~# sonic-installer 设置下次启动 SONiC-OScelestica_sonic_3.1.2-6-568c05804^C
sonic-installer 删除
此命令用于从磁盘中删除未使用的 SONiC 映像。请注意，不允许删除当前正在运行的映像。
用法
sonic-installer 删除
Example
root@Celestica-DS1000:~# sonic-installer 删除 SONiC-OScelestica_sonic_3.1.2-6-568c05804
返回到文档的开头或本节的开头。
启动配置
本节介绍如何检查设备当前运行的默认启动配置以及如何将新配置加载到该设备。
默认启动配置
用户可以使用 show running configuration 命令检查当前运行配置。如果用户在重启后没有进行任何配置更改，这将与默认启动配置相同。SONiC 设备在启动配置中包含 file /etc/sonic/config_db.json。重启时，将默认加载此配置。以下是 config_db.json 中默认配置的一些键。
1. 设备元数据 2. MAP_PFC_PRIORITY_TO_QUEUE 3. 队列 4. 端口
15
5. CRM 6. PORT_QOS_MAP 7. NTP_SERVER 8. BUFFER_QUEUE 9. WRED_PROFILE 10. TC_TO_PRIORITY_GROUP_MAP 11. BUFFER_PROFILE 12. 设备邻居 13. DSCP_TO_TC_MAP 14. TC_TO_QUEUE_MAP 15. 电缆长度 16. 调度程序 17. 缓冲区池
修改配置
修改config_db.json
用户可以直接编辑和修改 file /etc/sonic/config_db.json 或者执行 SCP 并复制此 file 来自远程服务器。用户可以执行 config reload 命令来加载此新配置，也可以简单地重新启动以使其生效。
16
故障排除
本节介绍一些常用的故障排除命令和方法。用户可以参考故障排除指南了解有关故障排除的更多详细信息。
基本故障排除命令
用户可以使用以下命令/功能： show techsupport 命令从设备收集信息。 Syslog 到 view 服务打印的系统日志。使用 ping、tcpdump 等 Linux 实用程序来检查连接和数据包跟踪。
显示技术支持
此命令收集有关设备状态的相关信息。信息种类繁多，包括系统日志条目、数据库状态、路由堆栈状态等。然后，它将信息压缩成一个档案 file. 此档案 file 可以发送给 SONiC 开发团队进行审查。结果存档 file 保存为 /var/dump/ _YYYYMMDD_HHMMSS.tar.gz 转储包含的一些详细信息如下：
接口详细信息平台详细信息Machine.conf Vlan 配置路由传感器、收发器详细信息Syslog Ip 配置 Bgp 详细信息设备配置（json/minigraph）
用法
显示技术支持
Example
17
admin@Celestica-DS1000:~$ 显示技术支持
系统日志
所有docker的系统日志和事件消息都通过syslog捕获并保存在/var/log/syslog中
控制台日志可以 view也可以使用 show logs 命令。此命令会在控制台中打印 syslog 中的信息。
show logs -f 将在控制台/ssh 会话中跟踪 syslog 的输出。
tcpdump
tcpdump 是一个在 sonic 命令行下运行的常见数据包分析器。它允许用户显示通过网络传输或接收的 TCP/IP 和其他数据包。例如amp例子：tcpdump -i Ethernet0
18
联系信息
Celestica 运营着一个客户服务门户网站。该网站提供自助支持资源（知识库、常见问题解答、常见修复、新固件）。我们的支持团队已连接到该支持门户网站，并可接收请求通知。该门户网站还会跟踪和收集客户反馈，以进一步改进我们的产品和服务。
客户可以在以下网址注册并请求支持（以及在知识库中搜索信息）：https://customersupport.celestica.com/csm 如果在使用客户门户时遇到任何问题或问题，请访问：https://www.celestica.com/contact-us。如有紧急问题，请随时致电您的负责客户经理。
19
文件/资源
 |
SONiC Celestica 开源网络 [pdf] 用户手册 Celestica、Celestica 开源网络、开源网络、网络 |
