Cumulus Networks Repositories - Organization and Support Levels

All packages that are included in the official Cumulus Linux distribution are available from Cumulus Networks repository servers. Depending upon the version of Cumulus Linux you are running, the repository is organized differently.

Cumulus Linux Repos for Versions 4.0.0 and Later

Cumulus Linux 4.0.0 and later distributions are organized into a single package source for each minor (4.y) release, the most recent of which is called latest.

Short NameContentsCodenameCumulus Linux Update Version*
latestAll packages in the Cumulus Linux image.
Optional additional packages.
New features and hardware platforms.
All previous security and maintenance updates.
CumulusLinux-4-latestMinor and maintenance updates to the most current version available (4.y.0 and 4.y.z)
latest minor releaseAll 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-latestMaintenance 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.zAll 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.zUpdates 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 NameContentsCodenameCumulus Linux Update Version*
mainlineAll packages in the Cumulus Linux image.
Optional additional packages.
New features and hardware platforms.
All previous security and maintenance updates.
CumulusLinux-3Minor update (3.y)
securitySecurity-related updates to any packages in mainline.CumulusLinux-3-security-updatesMaintenance update (3.y.z)
updatesBug fixes and updates to any packages in mainline that are not security related.CumulusLinux-3-updatesMaintenance update (3.y.z)
early accessPackages that are still undergoing development and should not be used in a production environment.CumulusLinux-3-early-accessPackages 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 Cumulus Networks Solutions Marketplace. 

CumulusLinux-3-marketplaceN/A

* For more information on Cumulus Linux versioning, please 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 can be described as follows:

  • cumulus: Contains packages maintained by Cumulus Networks.
  • 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, you simply follow Debian convention and use apt-get. You can find details in the Cumulus Linux user guide.

Additional Reading