proxmox-mirrors/mirror_frr
1
0
Fork 0
mirror of https://git.proxmox.com/git/mirror_frr synced 2025-10-25 14:48:05 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
10c61d28bf
mirror_frr/debianpkg/README.deb_build.md
Martin Winter 94c0a91c7b debianpkg: Do not start package after installation 
- Remove auto-start from Ubuntu 12.04 Backport
- Update Doc to explain on how to enable startup

Signed-off-by: Martin Winter <mwinter@opensourcerouting.org>
2017-11-17 17:55:31 -08:00

3.2 KiB
Raw Blame History

Building your own FRRouting Debian Package

(Tested on Ubuntu 12.04, 14.04, 16.04 and Debian 8)

  1. Follow the package installation as outlined in doc/Building_on_XXXX.md (XXXX refers your OS Distribution) to install the required build packages

  2. Install the following additional packages:

     apt-get install realpath equivs groff fakeroot debhelper

  3. Checkout FRR under a unpriviledged user account

     git clone https://github.com/frrouting/frr.git frr

  4. Run Bootstrap and make distribution tar.gz

     cd frr
 ./bootstrap.sh
 ./configure --with-pkg-extra-version=-MyDebPkgVersion
 make dist

    Note: configure parameters are not important for the Debian Package building - except the with-pkg-extra-version if you want to give the Debian Package a specific name to mark your own unoffical build

  5. Edit debianpkg/rules and set the configuration as needed

    Look for section dh_auto_configure to modify the configure options as needed. Options might be different between main rules and backports/XXXX/debian/rules. Please adjust as needed on all files

  6. Create backports debian sources

    Move the debianpkg to debian and create the backports (Debian requires to not ship a debian directory inside the source directory to avoid build conflicts with the reserved debian subdirectory name during the build)

     mv debianpkg debian
 make -f debian/rules backports

    This will create a frr_*.orig.tar.gz with the source (same as dist tar), and multiple frr_*.debian.tar.xz and frr_*.dsc for the debian package source on each backport supported distribution

  7. Create a new directory to build the package and populate with package src

     mkdir frrpkg
 cd frrpkg
 tar xf ~/frr/frr_*.orig.tar.gz
 cd frr*
 . /etc/os-release
 tar xf ~/frr/frr_*${ID}${VERSION_ID}*.debian.tar.xz

  8. Build Debian Package Dependencies and install them as needed

     sudo mk-build-deps --install debian/control

  9. Build Debian Package

     debuild -b -uc -us

DONE.

If all works correctly, then you should end up with the Debian packages under frrpkg. If distributed, please make sure you distribute it together with the sources (frr_*.orig.tar.gz, frr_*.debian.tar.xz and frr_*.dsc)

Enabling daemons after installation of the package:

  1. Edit /etc/frr/daemons and enable required routing daemons (Zebra is probably needed for most deployments, so make sure to enable it.)

  2. Check your firewall / IPtables to make sure the routing protocols are allowed.

  3. Enable FRR at startup

    • On init.d based systems (Ubuntu 12.04)

        sudo update-rc.d frr defaults

    • On systemd based systems (Debian 8, Ubuntu 14.04, 16.04)

        sudo systemctl enable frr

  4. Start/Restart the daemons (or reboot)

    • On init.d based systems (Ubuntu 12.04)

        sudo invoke-rc.d frr start

    • on systemd based systems (Debian 8, Ubuntu 14.04, 16.04)

        sudo systemctl start frr

Configuration is stored in /etc/frr/*.conf files and daemon selection is stored in /etc/frr/daemons.