Forge Home

cumulus_license

installs a Cumulus Linux license

1,893 downloads

1,893 latest version

4.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 1.1.1 (latest)
released Apr 7th 2020
This version is compatible with:
  • CumulusLinux

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'c2devel-cumulus_license', '1.1.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add c2devel-cumulus_license
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install c2devel-cumulus_license --version 1.1.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

c2devel/cumulus_license — version 1.1.1 Apr 7th 2020

This is a fork of Cumulus Network repo (http://github.com/cumulusNetworks/cumulus-cl-license-puppet).

Actual puppet forge page: https://forge.puppet.com/c2devel/cumulus_license

Feel free to send patches to http://github.com/c2devel/cumulus-cl-license-puppet/

cumulus_license

Table of Contents

Overview

This module installs a Cumulus Linux license.

Module Description

Installs a Cumulus Linux license file on a Cumulus Linux switch.

If a license is already installed, the module will not attempt to overwrite the existing license. You can overwrite the license with the force parameter. Using the force parameter will remove the idempotent behaviour of the module, so use force mode with caution.

When installing a license on a switch, use a non-EULA license. To confirm if you have a non-EULA license, run cl-license -i <license path> and confirm that it does not prompt you for a EULA.

Version 1.0.x of the module will work with 2.5.2 and lower. Version 1.1.x and higher will work with 2.5.3 and higher

For more details, read the Cumulus Linux User Guide and search for "License". Also review the Cumulus Linux Licensing Knowledge Base

Setup

What cumulus_license affects

This module uses the Cumulus Linux cl-license command to manage the license.

To activate a license for the first time, the switchd service must be restarted.

NOTE: Restarting the switchd daemon is disruptive.

Usage

Install a license file if one is not already installed:

node default {
   cumulus_license { 'example':
         src => 'http://example.com/cumulus.lic',
      notify => Service['switchd']
    }
}

Reference

###cl_license

Parameters

src: This is the URL to the license file location. It can be a local path like /root/new.lic or a http or https URL. It does not support a puppet:/// url.

force: Installs the license even though one exists on the switch.

Limitations

This module only works on Cumulus Linux.

This module does not overwrite an existing license. Use the force keyword to perform a license renewal.

puppet resource cumulus_license doesn't work. This feature will be implemented in a later version.

Development

  1. Fork it.
  2. Create your feature branch (git checkout -b my-new-feature).
  3. Commit your changes (git commit -am 'Add some feature').
  4. Push to the branch (git push origin my-new-feature).
  5. Create new Pull Request.

Cumulus icon

Cumulus Linux

Cumulus Linux is a software distribution that runs on top of industry standard networking hardware. It enables the latest Linux applications and automation tools on networking gear while delivering new levels of innovation and flexibility to the data center.

For further details, please see cumulusnetworks.com.