Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


upgrade-groups (Junos Fusion)


Hierarchy Level


Create and name a satellite software upgrade group for a Junos Fusion, or specify an existing satellite software upgrade group to configure.

A satellite software upgrade group is a group of satellite devices that are designated to upgrade to the same satellite software version using the same satellite software package. One Junos Fusion can contain multiple software upgrade groups, and multiple software upgrade groups should be configured in most Junos Fusions to avoid network downtimes during satellite software installations.

The two most common methods of installing satellite software in a Junos Fusion—autoconverting a device into a satellite device when it is cabled into an aggregation device and manually converting a device that is cabled into an aggregation device into a satellite device—require a configured satellite software upgrade group.

Software upgrade groups are configured and managed from the aggregation device.

To associate a satellite software package with a satellite software upgrade group, use the request system software add package-name upgrade-group upgrade-group-name command.

This statement is entered on an aggregation device in a Junos Fusion. Software upgrade groups are configured and managed from the aggregation device.

The software upgrade group configurations must match exactly—including the same package-name and upgrade-group-name—in every Junos Fusion with dual aggregation devices to avoid satellite device downtime.

All satellite devices in a satellite device cluster are associated with a single satellite software upgrade group, which is automatically created when a satellite device cluster becomes part of a Junos Fusion. The satellite software upgrade group is named after the satellite device cluster name, and ensures that all satellite devices in the cluster run the same version of satellite software. See Understanding Software in a Junos Fusion Enterprise for additional information on software management for a satellite device cluster.


No satellite software upgrade groups are present, by default.

A satellite software upgrade group with the name of the satellite device cluster is created automatically when a satellite device cluster is created.



Specifies the user-defined name for the satellite software upgrade group.

The remaining statements are explained separately.

Required Privilege Level

admin—To view this statement in the configuration.

admin-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 14.2R3.

Statement introdcued in Junos OS Release 16.1R1 for Junos Fusion Enterprise.