This documentation is for an older version of the software. If you are using the current version of Cumulus Linux, this content may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Cumulus Linux 3.2 User Guide

Introducing Cumulus Linux

Cumulus Linux is the networking industry’s first full-featured Linux operating system. The Debian Jessie-based, networking-focused distribution runs on hardware produced by a broad partner ecosystem, ensuring unmatched customer choice regarding silicon, optics, cables, and systems.

This user guide provides in-depth documentation covering installing Cumulus Linux, system configuration and management, network solutions, and monitoring and troubleshooting recommendations. In addition, the quick start guide provides an end-to-end setup process to get you started with Cumulus Linux.

This documentation is current as of May 1, 2017 for version 3.2.1. Please visit the Cumulus Networks Web site for the most up to date documentation.

Read the release notes for new features and known issues in this release.

What’s New in Cumulus Linux 3.2.1

Cumulus Linux 3.2.1 adds these new features and platforms, including:

  • Network Command Line Utility: We’ve improved the syntax so it’s even easier for network operators to configure Cumulus Linux with NCLU.
  • Platform Independent Multicast (PIM): We’ve improved multicast latency on Mellanox switches.
  • Explicit Congestion Notification (ECN): We’ve expanded support for ECN to Tomahawk switches.
  • New 100G platform: Early access support for the Edge-Core AS7412-32X, which uses the Mellanox Spectrum ASIC.

For further information regarding these new features, and for information regarding bug fixes and known issues present in this release, refer to the product release notes.

Open Source Contributions

Cumulus Networks has forked various software projects, like CFEngine, Netdev and some Puppet Labs packages in order to implement various Cumulus Linux features. The forked code resides in the Cumulus Networks GitHub repository.

Cumulus Networks developed and released as open source some new applications as well.

The list of open source projects is on the open source software page.

Hardware Compatibility List

You can find the most up to date hardware compatibility list (HCL) here. Use the HCL to confirm that your switch model is supported by Cumulus Networks. The HCL is updated regularly, listing products by port configuration, manufacturer, and SKU part number.