Cumulus Networks Repositories - Organization and Support Levels

All packages included in the official Cumulus Linux distribution are available from NVIDIA repository servers. The organization of the repository differs depending upon the version of Cumulus Linux you are running.

Cumulus Linux Repos for Versions 4.0.0 and Later

Cumulus Linux 4.0.0 and later distributions come in a single package source for each minor (4.y) release, with the most recent repo called latest.

Short Name Contents Codename Cumulus Linux Update Version*
latest All packages in the Cumulus Linux image.
Optional additional packages.
New features and hardware platforms.
All previous security and maintenance updates.
CumulusLinux-4-latest Minor and maintenance updates to the most current version available (4.y.0 and 4.y.z)
latest minor release All packages in the Cumulus Linux image for that minor release.
Optional additional packages in that minor release.
New features and hardware platforms for that minor release.
All previous security and maintenance updates for that minor release.
CumulusLinux-4.y-latest Maintenance updates to the most current version in the 4.y release branch (for example, 4.0.0, 4.0.1, 4.0.2)
4.y.z All packages in the Cumulus Linux image for that specific version.
Optional additional packages in that specific version.
New features and hardware platforms for that specific version.
All previous security and maintenance updates for that specific version.
CumulusLinux-4.y.z Updates only to the specified version (for example, CumulusLinux-4.0.1 would update the switch only to version 4.0.1 and no later.

The latest source is enabled by default. In addition to packages in the Cumulus Linux image, the default configuration provides access to additional packages such as iperf or git, as well as Cumulus-provided updates for all these packages.

Security fixes and early access features also go into the latest source.

If you want to change to a more specific distribution (from latest to latest minor release or a specific version), you need to manually edit the /etc/apt/sources.listfile for both the distribution and the source distribution (deb and deb-src).

You can install Debian packages and Debian source packages from upstream by uncommenting the corresponding lines in /etc/apt/sources.list:

cumulus@switch:~$ cat /etc/apt/sources.list
# Cumulus Linux package repository
deb      http://apt.cumulusnetworks.com/repo CumulusLinux-4-latest cumulus upstream netq
deb-src  http://apt.cumulusnetworks.com/repo CumulusLinux-4-latest cumulus upstream netq

# Debian 10 Buster main package repositories
# Uncomment these if you want to install upstream Debian packages
# that are not mirrored in the Cumulus Linux repositories.
# Packages installed this way may cause problems, and are not
# officially supported by Cumulus Networks, Inc.
#deb     http://deb.debian.org/debian buster main
#deb     http://deb.debian.org/debian buster-updates main
#deb     http://security.debian.org buster/updates main
#deb     http://deb.debian.org/debian buster-backports main

# Debian 10 Buster main package source repositories
# Only need to uncomment these if you want to install
# upstream Debian source packages
#deb-src http://deb.debian.org/debian buster main
#deb-src http://deb.debian.org/debian buster-updates main
#deb-src http://security.debian.org buster/updates main
#deb-src http://deb.debian.org/debian buster-backports main

Cumulus Linux Versions 3.y.z Repos

Cumulus Linux 3 (including versions 3.0.0 through the latest 3.7.z release) distributions are organized into the following package sources:

Short Name Contents Codename Cumulus Linux Update Version*
mainline All packages in the Cumulus Linux image.
Optional additional packages.
New features and hardware platforms.
All previous security and maintenance updates.
CumulusLinux-3 Minor update (3.y)
security Security-related updates to any packages in mainline. CumulusLinux-3-security-updates Maintenance update (3.y.z)
updates Bug fixes and updates to any packages in mainline that are not security related. CumulusLinux-3-updates Maintenance update (3.y.z)
early access Packages that are still undergoing development; do not use them in a production environment. CumulusLinux-3-early-access Packages updated asynchronously from updates.
marketplace**

Optional third party packages, (for example, Puppet from Puppet Labs).
Community-contributed packages.

Not affiliated with or related to the NVIDIA Solutions Marketplace. 

CumulusLinux-3-marketplace N/A

* For more information on Cumulus Linux versioning, refer to Cumulus Linux Release Versioning and Support Policy.

** In development. Does not contain packages as of the Cumulus Linux 3.0 initial release.

The mainline, security and updates sources are enabled by default. In addition to packages in the Cumulus Linux image, the default configuration provides access to additional packages such as iperf or git, as well as Cumulus-provided updates for all these packages.

To maintain access to the latest Cumulus Linux updates, keep the updates source enabled.

If you’re an early adopter or are testing out new features that are not yet in Cumulus Linux mainline, you can enable the early-access source.

You can enable non-default sources by uncommenting the corresponding lines in /etc/apt/sources.list:

cumulus@switch:~$ cat /etc/apt/sources.list

deb     http://repo3.cumulusnetworks.com/repo CumulusLinux-3 cumulus upstream
deb-src http://repo3.cumulusnetworks.com/repo CumulusLinux-3 cumulus upstream

deb     http://repo3.cumulusnetworks.com/repo CumulusLinux-3-security-updates cumulus upstream
deb-src http://repo3.cumulusnetworks.com/repo CumulusLinux-3-security-updates cumulus upstream

deb     http://repo3.cumulusnetworks.com/repo CumulusLinux-3-updates cumulus upstream
deb-src http://repo3.cumulusnetworks.com/repo CumulusLinux-3-updates cumulus upstream

#deb     http://repo3.cumulusnetworks.com/repo CumulusLinux-3-early-access cumulus
#deb-src http://repo3.cumulusnetworks.com/repo CumulusLinux-3-early-access cumulus

# Currently under construction
#deb     http://community.cumulusnetworks.com/repo CumulusLinux-3-marketplace commercial community

The contents of each repository component in sources.list are as follows:

  • cumulus: Contains packages maintained by NVIDIA.
  • upstream: Contains unmodified packages from an upstream community.
  • commercial: Contains packages from third party vendors.
  • community: Contains community-contributed packages.

Cumulus Linux Versions 1.5.z and 2.y.z Repos

Cumulus Linux distributions for versions 1.5.z and 2.y.z are organized into the following components:

  • main: This contains all the packages that are in the Cumulus Linux image, including packages from Debian and other sources.
  • addons: This contains additional packages that are not in the image (for example, Puppet from Puppet Labs).
  • updates: This contains updates to any of the packages in main that are not security related.
  • security-updates: This contains updates to any of the packages in main that are security related.
  • testing: This contains packages that are still undergoing development.

You can select which repositories you want to draw from using apt by uncommenting the appropriate repos in /etc/apt/sources.list:

cumulus@switch:~$ cat /etc/apt/sources.list
#  The Cumulus Package Repository.
#
#  Only packages from this repository are supported
#
#

deb http://repo.cumulusnetworks.com CumulusLinux-2.5 main addons updates
deb http://repo.cumulusnetworks.com CumulusLinux-2.5 security-updates

# Uncomment the next line to get access to the testing component
# deb http://repo.cumulusnetworks.com CumulusLinux-2.5 testing

# Uncomment the next line to get access to the Cumulus community repository
# deb http://repo.cumulusnetworks.com/community/ CumulusLinux-Community-2.5  main addons updates

Accessing the Repository

To access packages from the repository server, just follow Debian convention and use apt-get. You can find details in the Cumulus Linux user guide.

Additional Reading