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 中不可用的系统调用。

因此,对于已经运行升级版 FreeBSD 版本的平台,在升级到 Junos OS 21.2R1 版时,您无法使用 validate 选项,因为此版本在 FreeBSD 12 版上运行;升级版 FreeBSD 的前一个版本运行 FreeBSD 10 版或 11 版。

对于 SRX300、SRX320、SRX340、SRX345 和 SRX380 设备,当您想要升级或降级为使用与当前运行的 FreeBSD 版本不同的 FreeBSD 版本时,必须使用 request system software add package-name partition no-copy no-validate reboot 命令升级或降级软件。FreeBSD 第 6 版和 FreeBSD 第 12 版使用不同的分区方案,因此必须指定命令上的附加选项。例如,Junos OS 23.2R1 版在 FreeBSD 第 12 版上运行,Junos OS 22.4R2 版本在 FreeBSD 第 6 版上运行。

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

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

  • 选项 validate-on-host — 此选项通过将软件包与远程 Junos OS 主机上运行的配置进行比较来验证软件包。请务必选择已升级到新版本软件的主机。

  • 选项 validate-on-routing-engine —(对于具有冗余 RE 的系统),此选项通过将软件包与相同机箱中路由引擎上的运行配置进行比较来验证软件包。如果已将另一个路由引擎升级到更新版本,请使用此选项。

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

当系统使用 Junos OS 的升级版本重新启动时,输入 request system software add 命令后执行的任何配置更改都将丢失。

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

在设备上启用平滑路由引擎切换 (GRES) 后,必须执行统一不中断服务软件升级 (ISSU) 操作,以更新设备上运行的软件。启用 GRES 后,如果尝试通过输入 request system software add package-name 命令来执行软件升级,将显示一条错误消息,指出仅在配置了 GRES 后才支持不中断服务的软件升级。在这种情况下,在尝试升级之前,必须移除 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

软件包或捆绑包的安装位置。

在 Junos OS 中, package-name 可以是远程位置的 URL,也可以是本地软件包的路径名称。但 Junos OS 演化版不支持远程 ISO 进行升级,因此将从 CLI 中的帮助字符串中移除“URL”。

例如:

  • /var/tmp/package-name- 从路由器或交换机上的本地目录安装的软件包或捆绑包。

  • protocol://hostname/pathname-package-name从远程位置下载和安装的软件包或捆绑包。替换为 protocol 以下内容之一:

    • ftp — 文件传输协议。 使用 ftp://hostname/pathname/package-name。要指定身份验证凭据,请使用 ftp://<username>:<password>@hostname/pathname/package-name。要让系统提示您输入密码,请指定 prompt 代替密码。如果需要密码,而您未指定密码,则 prompt显示错误消息。

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

    • scp — 安全副本(不限量版)。 使用 scp://hostname/pathnamepackage-name要指定身份验证凭据,请使用 scp://<username>:<password>@hostname/pathname/package-name

  • 协议 pathname 中的是远程系统上用户主目录的相对路径,而不是根目录。

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

best-effort-load

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

component all

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

delay-restart

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

device-alias alias-name

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

force

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

force-host

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

lcc number

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

根据 LCC 配置,替换为 number 以下值:

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

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

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

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

member member-id

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

partition

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

satellite slot-id

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

scc

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

sfc number

(仅限 TX Matrix Plus 路由器)(可选)在 TX Matrix Plus 路由器的路由引擎上安装软件包或捆绑包。替换为 number 0。

no-copy

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

no-validate

(可选)加载软件包或不同版本的捆绑包时,抑制选项的默认行为 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) 中的路由引擎上加载软件包或捆绑包。

reboot

(可选)添加软件包或捆绑包后,重新启动系统。在 QFabric 交换机上,除非重新启动已安装该软件的组件,才能完成软件安装。

set [package-name1package-name2]

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

  • 对于混合 EX4200 和 EX4500 虚拟机箱,请安装两个软件包(用于 EX4200 交换机的软件包,用于 EX4500 交换机的软件包版本),以升级 EX4200 和 EX4500 混合虚拟机箱中的所有成员交换机。

  • 如果是 M 系列、MX 系列和 T 系列路由器,请同时安装多个(两个或更多)软件包和软件附加包。该变量 package-name 可以是安装包列表(每个安装包之间都用空格隔开)或者指向目录的完整 URL 或包含安装软件包列表的 tar 文件。

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

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

unlink

(可选)在 M 系列、T 系列和 MX 系列路由器上,在成功完成升级后,使用取消链接选项从此目录中移除软件包。

upgrade-group [ all |upgrade-group-name]

(仅限 Junos Fusion)(使用自动转换或手动转换配置 Junos Fusion 需要)将卫星软件图像与卫星软件升级组相关联。当指定了 all 关键字时,卫星软件包使用 , upgrade-group-name或为 Junos Fusion 中的所有卫星软件升级组关联,则此卫星软件升级组与指定的卫星软件升级组相关联。

卫星软件升级组是 Junos Fusion 中的一组卫星设备,它们被指定使用相同的卫星软件包升级到同一卫星软件版本。看到 了解 Junos Fusion 提供商边缘的软件了解 Junos Fusion Enterprise 中的软件以及 管理 Junos Fusion 中的卫星软件升级组

upgrade-with-config

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

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

validate

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

要升级到 Junos OS 21.2R1 版,您不能使用选项 validate 。而是从以下选项中选择一项:

  • no-validate

  • validate-on-host

  • validate-on-routing-engine

validate选项仅适用于未graceful-switchover启用 (GRES) 的系统。要在具有 GRES 的系统上使用validate选项,请在安装期间禁用 GRES,或者使用命令 request system software in-service-upgrade (使用 GRES 时需要启用不间断活动路由 (NSR)。

validate-on-host hostname

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

validate-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 主路由引擎发出 request system software add package-name 命令时,连接到它的所有 T640 主路由引擎都会升级到相同版本的软件。如果对 TX Matrix 备份路由引擎发出相同的命令,则连接到它的所有 T640 备份路由引擎都会升级到相同版本的软件。

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

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

必需的权限级别

维护

输出字段

输入此命令时,您将获得有关请求状态的反馈。

示例输出

请求系统软件添加验证

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

请求系统软件添加无副本无验证重启

请求系统软件添加主机上的验证

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

请求系统软件添加全部组件(QFabric 系统)

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

请求系统软件添加无验证(SRX 系列防火墙)

请求系统软件添加(SRX 系列防火墙)

版本信息

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

best-effort-loadJunos OS 7.4 版中添加了一些选项。unlink

sfc 在适用于 TX Matrix Plus 路由器的 Junos OS 9.6 版中引入的选项。

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

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

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

device-aliassatelliteupgrade-groupversion Junos OS 14.2R3 版中引入的 Junos Fusion。

validate-on-host Junos validate-on-routing-engine OS 15.1F3 版中添加了适用于PTX5000路由器以及 MX240、MX480 和 MX960 路由器的选项。

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