ifupdown2

Linux Interface Network Manager

• Free software: GNU General Public License v2

Installation

As of today (early june 2018), the preferred method to install ifupdown2, is by building the source code (as it will always install the most recent stable release). See Installing latest stable release from sources chapter.

Installing latest stable release from sources

The sources for ifupdown2 can be downloaded from the Github repo.

You can either clone the public repository:

$ git clone git://github.com/CumulusNetworks/ifupdown2

Or download the tarball:

$ curl  -OL https://github.com/CumulusNetworks/ifupdown2/tarball/master

Once you have a copy of the source, you should build a deb-package and install it

$ cd ifupdown2 && git checkout master && make deb

The generated deb should be in the root directory (../ifupdown2_1.2.1_all.deb)

$ dpkg -i ../ifupdown2_1.2.1_all.deb

We don't recommend using setup.py install directly, as it's still missing systemd/init.d scripts. This capability should be added in the near future.

You might need to manually download dependencies. Mandatory dependencies:

$ apt-get install build-essential devscripts dh-systemd fakeroot python-all python-docutils iproute2 python-ipaddr python-setuptools

To build the deb file successfully, the following additional packages are required:

$ apt-get install dh-python python3-all python3-setuptools python3-docutils

Suggested dependencies:

$ apt-get install ethtool bridge-utils python-gvgen python-mako

Contributing

Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.

You can contribute in many ways:

Types of Contributions

Report Bugs

Report bugs at https://github.com/CumulusNetworks/ifupdown2/issues.

If you are reporting a bug, please include:

• Your operating system name and version (uname -a).
• Any details about your setup that might be helpful in troubleshooting.
• Content of configuration files such as /etc/network/interfaces
• Detailed steps to reproduce the bug.
• Debug output of the ifupdown2 command (see --debug option)

Write Documentation

ifupdown2 could always use more documentation, whether as part of the official ifupdown2 docs, in docstrings, or even on the web in blog posts, articles, and such.

Submit Feedback

The best way to send feedback is to file an issue at https://github.com/CumulusNetworks/ifupdown2/issues.

If you are proposing a feature:

• Explain in detail how it would work.
• Keep the scope as narrow as possible, to make it easier to implement.

Credits

Development Lead

• Roopa Prabhu <[email protected]>
• Julien Fortin <[email protected]>

Contributors

• Nikhil Gajendrakumar <[email protected]>
• Maximilian Wilhelm <[email protected]>
• Sven Auhagen <[email protected]>
• skorpy <[email protected]>
• Alexandre Derumier <[email protected]>
• Sam Tannous <[email protected]>
• Wilson Kok <[email protected]>
• John Berezovik <[email protected]>
• Daniel Walton <[email protected]>
• Anuradha Karuppiah <[email protected]>
• Balakrishnan Raman <[email protected]>
• Scott Emery <[email protected]>
• Dave Olson <[email protected]>
• David Ahern <[email protected]>
• Jonathan Toppins <>
• Nolan Leake <[email protected]>
• Sergey Sudakovich <[email protected]>
• Andy Gospodarek <>
• Satish Ashok <[email protected]>
• Scott Laffer <[email protected]>
• Vidya Sagar Ravipati <[email protected]>
• Marek Grzybowski <[email protected]>
• Gaudenz Steinlin <[email protected]>
• Nigel Kukard <[email protected]>
• Jeffrey <[email protected]>
• kokel <[email protected]>

Why not you too? :)

History

See changelog here: https://github.com/CumulusNetworks/ifupdown2/blob/master/debian/changelog

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.