Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

request system software add (Junos OS)

语法

语法(EX 系列交换机)

语法(TX Matrix 路由器)

语法(TX Matrix Plus 路由器)

语法(MX 系列路由器)

语法(QFX 系列)

语法(OCX 系列)

描述

在设备上安装软件包或套件。

我们建议您始终仅将软件映像下载到 /var/tmp。 在 EX 系列和QFX 系列交换机上,您必须使用 /var/tmp 目录。不支持其他目录。

升级到不同版本时Junos OS,通常对 validate 此命令使用 选项。选项 validate 根据设备当前配置检查候选软件,以确保它们兼容。(当要添加的软件包为不同版本时,验证是默认行为。)但是,在某些情况下,您无法按此方式验证运行的配置。其中一种情况是,使用基于 FreeBSD 6.1 Junos OS升级版 FreeBSD Junos OS升级至现有网络时。另一种情况是,使用升级版 FreeBSD Junos OS 的不同版本与最新版本的 FreeBSD 使用先前版本的 FreeBSD 不可用的系统调用更新时。

因此,在升级到 Junos 21.2R1 版本时,不能使用 选项,因为此版本在 FreeBSD 12 上运行;具有升级版 FreeBSD 的早期版本将运行 validate FreeBSD 10 或 11。

如果在无法使用直接验证版本之间升级,则需要在升级时在操作模式命令上指定 request system software add 以下版本之一:

  • 选项 — 此选项不会根据当前配置 no-validate 验证软件包。因此,升级系统后,当前配置可能失败。首次将系统升级为较新版本时,请选择此选项。

  • 选项— 此选项用于验证软件包,因为它与远程主机上的运行Junos OS validate-on-host 配置。请务必选择已升级到更新版本的软件的主机。

  • 选项 —(对于具有冗余 E 的系统),此选项通过将软件包与同一机箱中一个机箱中路由引擎 validate-on-routing-engine 的配置进行比较,以验证软件包。将另一个更新版本路由引擎,请选择此选项。

有关有效文件名和 URL 格式的信息,请参阅 在"命令"中指定文件名和 URL Junos OS CLI 格式

在输入 命令后执行的任何配置更改都将在系统重新启动并更新版本后 request system software add Junos OS。

从Junos OS版本17.2R1,PTX10008路由器不支持 request system software add 命令。从Junos OS版本17.4R1,PTX10016 路由器不支持 request system software add 命令。使用 request vmhost software add 命令而不是 PTX10008 和 PTX10016 路由器上的 命令,在Junos OS安装或升级 Junos OS request system software add 软件包或捆绑包。请参阅 request vmhost software add

在设备上路由引擎切换 (GRES) 后,必须执行统一不服务软件升级 (ISSU) 操作,以更新设备上运行的软件。启用 GRES 后,如果您尝试通过输入 命令执行软件升级,将显示一条错误消息,说明配置 GRES 时仅支持不工作 request system software add package-name 的软件升级。在这种情况下,您必须先卸下 GRES 配置,然后再尝试升级,或执行统一 ISSU。

从 Junos OS 15.1F3 版开始,该语句只会为带 request system software add RE-DUO-C2600-16G 的 PTX5000 路由器以及带 RE-S-1800X4-32G-S 的 MX240、MX480 和 MX960 路由器安装软件包。

从 Junos OS 15.1F5 开始,该语句只会为带 request system software add REMX2K-1800-32G-S 的 MX2010 和 MX2020 路由器安装访客操作系统的软件包。

在这些路由器上,要同时安装Junos和主机软件包,请使用 request vmhost software add 命令。

选项

package-name

软件包或套件的安装位置。

package-name Junos OS,可以是远程位置的 URL,也可以是本地数据包的路径名。但是Junos OS Evolved 不支持通过远程 iso 进行升级,因此"URL"将从电子邮件中的帮助字符串CLI。

例如:

  • /var/tmp/ package-name —对于正在从路由器或交换机本地目录安装的软件包或套件。

  • protocol :// hostname pathname / package-name /—对于要从远程位置下载和安装的软件包或套件。更换 protocol 为以下某一项:

    • ftp—文件传输协议。使用ftp:// hostname / pathname package-name /。要指定认证凭证,请使用 username ftp://<>:< password hostname >@ / pathname package-name 。要系统提示您输入密码,请 prompt 指定以更改密码。如果需要密码,并且未指定密码或 prompt ,将显示错误消息。

    • http—超文本传输协议。使用http:// / hostname pathname / package-name 。要指定认证凭证,请使用 username http://<>:< password hostname pathname >@ package-name /。如果需要密码且您省略了密码,系统会提示您输入。

    • scp—安全复制(不可用于有限版本)。使用scp:// / hostname pathname / package-name 。要指定认证凭证,请使用 username scp://<>:< password hostname >@ pathname / package-name

  • pathname协议中的 是位于远程系统上的用户主目录(而非根目录)的相对路径。

  • 请勿使用命令中的 scp协议从远程位置下载和安装软件包 request system software add 或套件。前一语句不适用于 QFabric 交换机。软件升级由不支持 scp 的管理进程 (mgd) 处理。 使用 命令将软件包或捆绑包从远程位置复制到硬盘上的 file copy /var/tmp目录:文件复制 scp:// source / package-name /var/tmp然后使用 命令安装软件包或捆绑 request system software add :request system software add /var/tmp/ package-name

尽力服务负载

(可选)激活部分负载,将解析错误视为警告而非错误。

组件全部

(仅 QFabric 系统)(可选)在所有 QFabric 组件上安装软件包。

延迟重启

(可选)安装软件包或捆绑包,但是不要重新启动软件进程。

设备别名 alias-name

(Junos Fusion)(可选)使用卫星设备的别名,将卫星软件包安装到指定的卫星设备上。

(可选)强制添加软件包或捆绑包(忽略警告)。

强制主机

(可选)强制在主机设备上添加主机软件包或捆绑包(忽略警告QFX5100)。

Lcc number

(仅 TX Matrix 路由器和 TX Matrix Plus 路由器)(可选)在基于 TX Matrix 路由器的路由矩阵中,在连接到 TX Matrix 路由器的路由T640路由器上安装软件包或套件。在基于 TX Matrix Plus 路由器的路由矩阵中,在连接到 TX Matrix Plus 路由器的路由器上安装软件包或套件。

根据 number 不同配置,将替换为线卡机箱值:

  • 0 到 3,当T640路由器连接到路由矩阵中的 TX Matrix 路由器时。

  • 0 到 3,当T1600路由器连接到路由矩阵中的 TX Matrix Plus 路由器时。

  • 0 到 7 时,T1600路由器连接到路由矩阵中具有 3D SIBS 的 TX Matrix Plus 路由器。

  • 0、2、4 或 6,当T4000路由器连接到路由矩阵中具有 3D SIBS 的 TX Matrix Plus 路由器时。

成员 member-id

(仅 MX 系列路由器)(可选)在指定的成员上安装虚拟机箱包。将 member-id 替换为值 0 或 1。

分区

(QFX3500交换机)(可选)在安装之前对介质进行格式化和重新分区。

卫星 slot-id

(Junos Fusion)(可选)使用卫星设备 FPC 插槽标识符,将卫星软件包安装到指定的卫星设备上。

Scc

(仅 TX Matrix 路由器)(可选)在 TX Matrix 路由器(路由引擎卡机箱)的机箱上安装软件包或套件。

证监会 number

(仅 TX Matrix Plus 路由器)(可选)在 TX Matrix Plus 路由器的路由引擎安装软件包或套件。更换 number 为 0。

无副本

(可选)安装软件包或捆绑包,但不保存软件包或捆绑文件的副本。

无验证

(可选)加载软件包或捆绑包以不同版本时,抑制选项的默认 validate 行为。

要升级Junos OS版本 21.2R1,不能使用 validate 选项。相反,请选择以下选项之一:

  • no-validate

  • validate-on-host

  • validate-on-routing-engine

无法加载来自未识别提供商的软件包。要向提供商授权, provider-id 请包含 层级 [edit system extensions provider] 的 语句。

re0 |re1

(可选)在支持双路由引擎或冗余路由引擎的路由器或交换机上,在插槽 0 (re0) 或插槽 1 (re1) 的 路由引擎 或 路由引擎 上加载软件包或捆绑包。

重新 启动

(可选)添加软件包或捆绑包后,重新启动系统。在 QFabric 交换机上,软件安装将无法完成,直到您重新启动安装该软件的组件。

设置 [ package-name1 package-name2 ]

(仅EX4200 EX4500 虚拟机箱路由器、M Series、MX 系列和T Series路由器)(可选)同时安装多个软件包:

  • 对于 EX4200 和 EX4500 虚拟机箱 混合的情况下,安装两个软件包(一个 EX4200 交换机的软件包和一个 EX4500 交换机的相同版本)以升级混合 EX4200 和 EX4500 虚拟机箱 中的EX4500 虚拟机箱。

  • 对于多M Series MX 系列T Series路由器,请同时安装多个(两个或多个)软件包和软件附加包。该变量可以是安装包列表(每个被空白分隔)或包含安装包列表的目录或 tar 文件 package-name 的完整 URL。

在每种情况下,都可以是安装包列表(每个被一个空格分隔)或包含安装包列表的目录或 tar 文件 installation-package 的完整 URL。

使用 命令通过安装 SDK的附加SDK以及核心附加包来 request system software add set 保留任何Junos OS配置。

不链路

(可选)在 M Series、T Series 和 MX 系列路由器上,使用 unlink 选项在成功升级完成后从此目录中卸下软件包。

升级组 [ 所有| upgrade-group-name ]

(Junos Fusion)(需要使用自动Junos Fusion或手动转换来配置网络资源)将卫星软件映像与卫星软件升级组关联。指定所有关键字时,卫星软件包使用 、 或 与 Junos Fusion 中所有卫星软件升级组相关联的指定卫星 upgrade-group-name 软件升级组。

卫星软件升级组是一组位于Junos Fusion中的卫星设备,指定为使用同一卫星软件包升级到同一卫星软件版本。请参阅 、 无链路标题无链路标题无链路标题

升级-with-config

(可选)安装一个或多个配置文件。

使用此选项指定的配置文件必须具有扩展 名 .text.xml, 并且具有指定的扩展名。使用扩展 .txt 将不起作用。

验证

(可选)以当前配置验证软件包或捆绑包,作为添加软件包或套件的先决条件。这是要添加的软件包或捆绑包不同时的默认行为。

要升级Junos OS版本 21.2R1,不能使用 validate 选项。相反,请选择以下选项之一:

  • no-validate

  • validate-on-host

  • validate-on-routing-engine

选项 validate 仅在未启用 graceful-switchoverGRES)的系统上有效。要使用 GRES 在系统上使用 选项,可以在安装期间禁用 GRES,或使用 命令安装 ,这就需要在使用 GRES 时启用不间断活动路由 validate request system software in-service-upgrade (NSR)。

验证主机上 hostname

(可选)将软件包与远程主机上运行的配置进行比较,以Junos OS文件包。指定主机, hostname 以远程主机名替换。您可以选择提供将用来登录远程主机的用户名,方法为 指定主机名 user@hostname

验证-on-routing-engine routing-engine

(可选)将软件包与同一机箱上的机箱上运行Junos OS 路由引擎进行比较。指定一个路由引擎, routing-engine 用路由引擎名称替代。

其他信息

在升级路由器或交换机上的软件之前,如果系统已知稳定,请发出 命令以将软件(包括配置)备份到 request system snapshot /altroot /altconfig 文件系统。升级路由器或交换机上的软件并成功安装并运行新包或捆绑包后,请再次发出 命令,将新软件备份到 request system snapshot /altroot /altconfig 文件系统。

命令 request system snapshot 目前不受 QFabric 系统支持。此外,不能在 QFabric 系统中添加或安装多个程序包。

运行命令后,不能返回软件的前一个版本,因为软件的运行副本和备份 request system snapshot 副本相同。

如果您同时升级多个软件包,请最后删除操作系统包 jkernel。最后添加操作系统软件包 jkernel,第一个,以及路由软件包 jroute。如果一次升级所有软件包,请删除并按以下顺序添加:

默认情况下,当您在 TX Matrix 主路由引擎路由引擎时,T640的主路由引擎将升级至相同 request system software add package-name 软件版本。如果在 TX Matrix 备份引擎路由引擎相同的命令,连接到T640的所有备份路由引擎均将升级为相同版本的软件。

同样,当您在 TX Matrix Plus 主 路由引擎 上发出 命令时,连接到它的所有 T1600 或 T4000 主路由引擎均将升级至相同软件版本 request system software add package-name 。如果在 TX Matrix Plus 备份引擎上发出相同命令路由引擎,连接到该路由器的所有 T1600 或 T4000 备份路由引擎均将升级至相同软件版本。

在添加了一个或多个自定义 YANG 数据模型的设备中安装软件之前,请从活动配置中备份和移除对应于自定义 YANG 数据模型的配置数据。有关详细信息,请参阅 在软件升级或降级期间管理 YANG 软件包和配置

所需的权限级别

维护

输出字段

输入此命令后,系统会提供有关请求状态的反馈。

示例输出

请求系统软件添加验证

请求系统软件 add /var/tmp/ no-validate

request system software add-no-copy no-validate reboot

请求系统软件添加 validate-on-host

请求系统软件添加(混合EX4200 EX4500 虚拟机箱)

request system software add component all (QFabric Systems)

请求系统软件添加升级组 (Junos Fusion)

请求系统软件添加 no-validate(SRX 系列设备)

请求系统软件添加(SRX 系列设备)

发布信息

在 7.4 Junos OS之前引入的命令。

best-effort-load 以及 unlink 7.4 Junos OS中添加的选项。

sfc 选项(Junos OS TX Matrix Plus 路由器的 9.6 版中引入)。

set [package-name1package-name2] 选项(在 Junos OS 11.1 版中为 EX 系列交换机添加。在 Junos OS 路由器的 M Series、MX 系列和路由器的 T Series 12.2 中添加。

在 EX 系列交换机上,选项允许您仅将两个软件包安装到混合电源和 set [package-name1package-name2] EX4200 EX4500 虚拟机箱。而在 M Series、MX 系列和 T Series 路由器上,选项允许您同时安装多个软件包和 set [package-name1package-name2package-name3] 软件附加包。

upgrade-with-config和选项Junos OS 12.3 版中为 M Series 路由器、MX 系列路由器和 T Series 路由器、EX 系列以太网交换机和 QFX 系列 设备添加的选项。 upgrade-with-config-format format

device-alias、、 satellite upgrade-groupversion 中引入Junos OS选项14.2R3 Junos Fusion。

validate-on-host 和选项。 Junos OS路由器15.1F3路由器PTX5000路由器MX240、MX480路由器MX960 validate-on-routing-engine 选项。

upgrade-with-config-format format 选项,在 Junos OS 16.1 版中删除,适用于 M Series 路由器、MX 系列路由器和 T Series 路由器、EX 系列以太网交换机和 QFX 系列 设备。