proxmox-mirrors/mirror_frr
1
0
Fork 0
mirror of https://git.proxmox.com/git/mirror_frr synced 2025-07-26 23:23:35 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

doc: Update Building Doc for RedHat-style Distro's (CentOS / Fedora)

Browse Source 
Signed-off-by: Martin Winter <mwinter@opensourcerouting.org>
This commit is contained in:
Martin Winter 2017-07-11 18:37:02 -07:00
parent 619500fd7e
commit e3de326d6c
3 changed files with 121 additions and 112 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

75
doc/Building_FRR_on_CentOS6.md
View File

@ -1,6 +1,10 @@
Building FRR on CentOS 6 from Git Source Building FRR on CentOS 6 from Git Source
======================================== ========================================
(As an alternative to this installation, you may prefer to create a FRR
rpm package yourself and install that package instead. See instructions
in redhat/README.rpm_build.md on how to build a rpm package)
Instructions are tested with `CentOS 6.8` on `x86_64` platform Instructions are tested with `CentOS 6.8` on `x86_64` platform
CentOS 6 restrictions: CentOS 6 restrictions:
@ -16,13 +20,15 @@ Install required packages
Add packages: Add packages:
sudo yum install git autoconf automake libtool make gawk readline-devel \ sudo yum install git autoconf automake libtool make gawk \
texinfo net-snmp-devel groff pkgconfig json-c-devel pam-devel \ readline-devel texinfo net-snmp-devel groff pkgconfig \
flex c-ares-devel epel-release rpm-build libcap-devel texi2html json-c-devel pam-devel flex epel-release perl-XML-LibXML \
c-ares-devel
Install newer version of bison (CentOS 6 package source is too old) from Install newer version of bison (CentOS 6 package source is too old) from
CentOS 7 CentOS 7
sudo yum install rpm-build
curl -O http://vault.centos.org/7.0.1406/os/Source/SPackages/bison-2.7-4.el7.src.rpm curl -O http://vault.centos.org/7.0.1406/os/Source/SPackages/bison-2.7-4.el7.src.rpm
rpmbuild --rebuild ./bison-2.7-4.el7.src.rpm rpmbuild --rebuild ./bison-2.7-4.el7.src.rpm
sudo yum install ./rpmbuild/RPMS/x86_64/bison-2.7-4.el6.x86_64.rpm sudo yum install ./rpmbuild/RPMS/x86_64/bison-2.7-4.el6.x86_64.rpm
@ -48,12 +54,12 @@ Install newer version of autoconf and automake (Package versions are too old)
Install `Python 2.7` in parallel to default 2.6 (needed for `make check` to Install `Python 2.7` in parallel to default 2.6 (needed for `make check` to
run unittests). run unittests).
Make sure you've install EPEL (`epel-release` as above). Then install current Pick correct EPEL based on CentOS version used. Then install current `pytest`
`python2.7` and `pytest`
rpm -ivh https://centos6.iuscommunity.org/ius-release.rpm sudo rpm -ivh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
yum install python27 python27-devel python27-pip sudo rpm -ivh https://centos6.iuscommunity.org/ius-release.rpm
pip2.7 install pytest sudo yum install python27 python27-pip
sudo pip2.7 install pytest
Please note that `CentOS 6` needs to keep python pointing to version 2.6 Please note that `CentOS 6` needs to keep python pointing to version 2.6
for `yum` to keep working, so don't create a symlink for python2.7 to python for `yum` to keep working, so don't create a symlink for python2.7 to python
@ -75,17 +81,18 @@ any packages**
(You may prefer different options on configure statement. These are just (You may prefer different options on configure statement. These are just
an example.) an example.)
You may want to pay special attention to `/usr/lib64` paths and change
them if you are not building on a x86_64 architecture
git clone https://github.com/frrouting/frr.git frr git clone https://github.com/frrouting/frr.git frr
cd frr cd frr
git checkout stable/3.0
./bootstrap.sh ./bootstrap.sh
./configure \ ./configure \
--bindir=/usr/bin \
--sbindir=/usr/lib/frr \
--sysconfdir=/etc/frr \ --sysconfdir=/etc/frr \
--libdir=/usr/lib64/frr \ --libdir=/usr/lib/frr \
--libexecdir=/usr/lib64/frr \ --libexecdir=/usr/lib/frr \
--localstatedir=/var/run/frr \ --localstatedir=/var/run/frr \
--with-moduledir=/usr/lib/frr/modules \
--disable-pimd \ --disable-pimd \
--enable-snmp=agentx \ --enable-snmp=agentx \
--enable-multipath=64 \ --enable-multipath=64 \
@ -98,7 +105,9 @@ them if you are not building on a x86_64 architecture
--disable-exampledir \ --disable-exampledir \
--enable-watchfrr \ --enable-watchfrr \
--enable-tcp-zebra \ --enable-tcp-zebra \
--disable-ldpd \
--enable-fpm \ --enable-fpm \
--enable-nhrpd \
--with-pkg-git-version \ --with-pkg-git-version \
--with-pkg-extra-version=-MyOwnFRRVersion --with-pkg-extra-version=-MyOwnFRRVersion
make make
@ -115,11 +124,21 @@ them if you are not building on a x86_64 architecture
sudo touch /etc/frr/isisd.conf sudo touch /etc/frr/isisd.conf
sudo touch /etc/frr/ripd.conf sudo touch /etc/frr/ripd.conf
sudo touch /etc/frr/ripngd.conf sudo touch /etc/frr/ripngd.conf
sudo touch /etc/frr/nhrpd.conf
sudo chown -R frr:frr /etc/frr/ sudo chown -R frr:frr /etc/frr/
sudo touch /etc/frr/vtysh.conf sudo touch /etc/frr/vtysh.conf
sudo chown frr:frrvt /etc/frr/vtysh.conf sudo chown frr:frrvt /etc/frr/vtysh.conf
sudo chmod 640 /etc/frr/*.conf sudo chmod 640 /etc/frr/*.conf
### Install daemon config file
sudo install -p -m 644 redhat/daemons /etc/frr/
sudo chown frr:frr /etc/frr/daemons
### Edit /etc/frr/daemons as needed to select the required daemons
Look for the section with `watchfrr_enable=...` and `zebra=...` etc.
Enable the daemons as required by changing the value to `yes`
### Enable IP & IPv6 forwarding ### Enable IP & IPv6 forwarding
Edit `/etc/sysctl.conf` and set the following values (ignore the other Edit `/etc/sysctl.conf` and set the following values (ignore the other
@ -132,28 +151,16 @@ settings)
# Controls source route verification # Controls source route verification
net.ipv4.conf.default.rp_filter = 0 net.ipv4.conf.default.rp_filter = 0
**Reboot** or use `sysctl` to apply the same config to the running system Load the modifed sysctl's on the system:
sudo sysctl -p /etc/sysctl.d/90-routing-sysctl.conf
### Add init.d startup files ### Add init.d startup files
sudo cp redhat/bgpd.init /etc/init.d/bgpd sudo install -p -m 755 redhat/frr.init /etc/init.d/frr
sudo cp redhat/isisd.init /etc/init.d/isisd sudo chkconfig --add frr
sudo cp redhat/ospfd.init /etc/init.d/ospfd
sudo cp redhat/ospf6d.init /etc/init.d/ospf6d
sudo cp redhat/ripngd.init /etc/init.d/ripngd
sudo cp redhat/ripd.init /etc/init.d/ripd
sudo cp redhat/zebra.init /etc/init.d/zebra
sudo chkconfig --add zebra
sudo chkconfig --add ripd
sudo chkconfig --add ripngd
sudo chkconfig --add ospf6d
sudo chkconfig --add ospfd
sudo chkconfig --add bgpd
sudo chkconfig --add isisd
### Enable required daemons at startup ### Enable frr daemon at startup
Only enable zebra and the daemons which are needed for your setup sudo chkconfig frr on
sudo chkconfig zebra on ### Start FRR manually (or reboot)
sudo chkconfig ospfd on sudo /etc/init.d/frr start
sudo chkconfig bgpd on
[...] etc (as needed)

75
doc/Building_FRR_on_CentOS7.md
View File

@ -1,6 +1,10 @@
Building FRR on CentOS 7 from Git Source Building FRR on CentOS 7 from Git Source
======================================== ========================================
(As an alternative to this installation, you may prefer to create a FRR
rpm package yourself and install that package instead. See instructions
in redhat/README.rpm_build.md on how to build a rpm package)
CentOS 7 restrictions: CentOS 7 restrictions:
---------------------- ----------------------
@ -13,13 +17,10 @@ Install required packages
Add packages: Add packages:
sudo yum install git autoconf automake libtool make gawk readline-devel \ sudo yum install git autoconf automake libtool make gawk \
texinfo net-snmp-devel groff pkgconfig json-c-devel pam-devel \ readline-devel texinfo net-snmp-devel groff pkgconfig \
bison flex pytest c-ares-devel python-devel rpm-build json-c-devel pam-devel bison flex pytest c-ares-devel \
perl-XML-LibXML
To build from git (in difference to building from distribution tar.gz as created by `make dist`), the python development libraries are needed. (Make sure you've installed EPEL libraries as shown above for this to work)
yum install python34-devel
Get FRR, compile it and install it (from Git) Get FRR, compile it and install it (from Git)
--------------------------------------------- ---------------------------------------------
@ -38,17 +39,19 @@ any packages**
(You may prefer different options on configure statement. These are just (You may prefer different options on configure statement. These are just
an example.) an example.)
You may want to pay special attention to `/usr/lib64` paths and change
them if you are not building on a x86_64 architecture
git clone https://github.com/frrouting/frr.git frr git clone https://github.com/frrouting/frr.git frr
cd frr cd frr
git checkout stable/3.0
./bootstrap.sh ./bootstrap.sh
./configure \ ./configure \
--bindir=/usr/bin \
--sbindir=/usr/lib/frr \
--sysconfdir=/etc/frr \ --sysconfdir=/etc/frr \
--libdir=/usr/lib64/frr \ --libdir=/usr/lib/frr \
--libexecdir=/usr/lib64/frr \ --libexecdir=/usr/lib/frr \
--localstatedir=/var/run/frr \ --localstatedir=/var/run/frr \
--with-moduledir=/usr/lib/frr/modules \
--enable-pimd \
--enable-snmp=agentx \ --enable-snmp=agentx \
--enable-multipath=64 \ --enable-multipath=64 \
--enable-ospfclient=yes \ --enable-ospfclient=yes \
@ -60,7 +63,9 @@ them if you are not building on a x86_64 architecture
--disable-exampledir \ --disable-exampledir \
--enable-watchfrr \ --enable-watchfrr \
--enable-tcp-zebra \ --enable-tcp-zebra \
--disable-ldpd \
--enable-fpm \ --enable-fpm \
--enable-nhrpd \
--with-pkg-git-version \ --with-pkg-git-version \
--with-pkg-extra-version=-MyOwnFRRVersion --with-pkg-extra-version=-MyOwnFRRVersion
make make
@ -78,11 +83,21 @@ them if you are not building on a x86_64 architecture
sudo touch /etc/frr/ripd.conf sudo touch /etc/frr/ripd.conf
sudo touch /etc/frr/ripngd.conf sudo touch /etc/frr/ripngd.conf
sudo touch /etc/frr/pimd.conf sudo touch /etc/frr/pimd.conf
sudo touch /etc/frr/nhrpd.conf
sudo chown -R frr:frr /etc/frr/ sudo chown -R frr:frr /etc/frr/
sudo touch /etc/frr/vtysh.conf sudo touch /etc/frr/vtysh.conf
sudo chown frr:frrvt /etc/frr/vtysh.conf sudo chown frr:frrvt /etc/frr/vtysh.conf
sudo chmod 640 /etc/frr/*.conf sudo chmod 640 /etc/frr/*.conf
### Install daemon config file
sudo install -p -m 644 redhat/daemons /etc/frr/
sudo chown frr:frr /etc/frr/daemons
### Edit /etc/frr/daemons as needed to select the required daemons
Look for the section with `watchfrr_enable=...` and `zebra=...` etc.
Enable the daemons as required by changing the value to `yes`
### Enable IP & IPv6 forwarding ### Enable IP & IPv6 forwarding
Create a new file `/etc/sysctl.d/90-routing-sysctl.conf` with the Create a new file `/etc/sysctl.d/90-routing-sysctl.conf` with the
@ -94,33 +109,19 @@ following content:
net.ipv4.conf.all.forwarding=1 net.ipv4.conf.all.forwarding=1
net.ipv6.conf.all.forwarding=1 net.ipv6.conf.all.forwarding=1
**Reboot** or use `sysctl` to apply the same config to the running system Load the modifed sysctl's on the system:
### Install Service files sudo sysctl -p /etc/sysctl.d/90-routing-sysctl.conf
sudo install -p -m 644 redhat/zebra.service /usr/lib/systemd/system/zebra.service
sudo install -p -m 644 redhat/isisd.service /usr/lib/systemd/system/isisd.service ### Install frr Service and redhat init files
sudo install -p -m 644 redhat/ripd.service /usr/lib/systemd/system/ripd.service sudo install -p -m 644 redhat/frr.service /usr/lib/systemd/system/frr.service
sudo install -p -m 644 redhat/ospfd.service /usr/lib/systemd/system/ospfd.service sudo install -p -m 755 redhat/frr.init /usr/lib/frr/frr
sudo install -p -m 644 redhat/bgpd.service /usr/lib/systemd/system/bgpd.service
sudo install -p -m 644 redhat/ospf6d.service /usr/lib/systemd/system/ospf6d.service
sudo install -p -m 644 redhat/ripngd.service /usr/lib/systemd/system/ripngd.service
sudo install -p -m 644 redhat/pimd.service /usr/lib/systemd/system/pimd.service
sudo install -p -m 644 redhat/frr.sysconfig /etc/sysconfig/frr
sudo install -p -m 644 redhat/frr.logrotate /etc/logrotate.d/frr
### Register the systemd files ### Register the systemd files
sudo systemctl preset zebra.service sudo systemctl preset frr.service
sudo systemctl preset ripd.service
sudo systemctl preset ospfd.service
sudo systemctl preset bgpd.service
sudo systemctl preset ospf6d.service
sudo systemctl preset ripngd.service
sudo systemctl preset pimd.service
### Enable required daemons at startup ### Enable required frr at startup
Only enable zebra and the daemons which are needed for your setup sudo systemctl enable frr
sudo systemctl enable zebra ### Reboot or start FRR manually
sudo systemctl enable ospfd sudo systemctl start frr
sudo systemctl enable bgpd
[...] etc (as needed)

73
doc/Building_FRR_on_Fedora24.md
View File

@ -1,15 +1,19 @@
Building FRR on Fedora 24 from Git Source Building FRR on Fedora 24 from Git Source
========================================= =========================================
(As an alternative to this installation, you may prefer to create a FRR
rpm package yourself and install that package instead. See instructions
in redhat/README.rpm_build.md on how to build a rpm package)
Install required packages Install required packages
------------------------- -------------------------
Add packages: Add packages:
sudo dnf install git autoconf automake libtool make gawk \ sudo dnf install git autoconf automake libtool make gawk \
readline-devel texinfo net-snmp-devel groff pkgconfig \ readline-devel texinfo net-snmp-devel groff pkgconfig \
json-c-devel pam-devel perl-XML-LibXML c-ares-devel \ json-c-devel pam-devel bison flex pytest perl-XML-LibXML \
python3-devel c-ares-devel
Get FRR, compile it and install it (from Git) Get FRR, compile it and install it (from Git)
--------------------------------------------- ---------------------------------------------
@ -28,17 +32,18 @@ using any packages**
(You may prefer different options on configure statement. These are just (You may prefer different options on configure statement. These are just
an example.) an example.)
You may want to pay special attention to `/usr/lib64` paths and change
them if you are not building on a x86_64 architecture
git clone https://github.com/frrouting/frr.git frr git clone https://github.com/frrouting/frr.git frr
cd frr cd frr
git checkout stable/3.0
./bootstrap.sh ./bootstrap.sh
./configure \ ./configure \
--bindir=/usr/bin \
--sbindir=/usr/lib/frr \
--sysconfdir=/etc/frr \ --sysconfdir=/etc/frr \
--libdir=/usr/lib64/frr \ --libdir=/usr/lib/frr \
--libexecdir=/usr/lib64/frr \ --libexecdir=/usr/lib/frr \
--localstatedir=/var/run/frr \ --localstatedir=/var/run/frr \
--with-moduledir=/usr/lib/frr/modules \
--enable-pimd \ --enable-pimd \
--enable-snmp=agentx \ --enable-snmp=agentx \
--enable-multipath=64 \ --enable-multipath=64 \
@ -51,7 +56,9 @@ them if you are not building on a x86_64 architecture
--disable-exampledir \ --disable-exampledir \
--enable-watchfrr \ --enable-watchfrr \
--enable-tcp-zebra \ --enable-tcp-zebra \
--enable-ldpd \
--enable-fpm \ --enable-fpm \
--enable-nhrpd \
--with-pkg-git-version \ --with-pkg-git-version \
--with-pkg-extra-version=-MyOwnFRRVersion --with-pkg-extra-version=-MyOwnFRRVersion
make make
@ -76,6 +83,15 @@ them if you are not building on a x86_64 architecture
sudo chown frr:frrvt /etc/frr/vtysh.conf sudo chown frr:frrvt /etc/frr/vtysh.conf
sudo chmod 640 /etc/frr/*.conf sudo chmod 640 /etc/frr/*.conf
### Install daemon config file
sudo install -p -m 644 redhat/daemons /etc/frr/
sudo chown frr:frr /etc/frr/daemons
### Edit /etc/frr/daemons as needed to select the required daemons
Look for the section with `watchfrr_enable=...` and `zebra=...` etc.
Enable the daemons as required by changing the value to `yes`
### Enable IP & IPv6 forwarding (and MPLS) ### Enable IP & IPv6 forwarding (and MPLS)
Create a new file `/etc/sysctl.d/90-routing-sysctl.conf` with the Create a new file `/etc/sysctl.d/90-routing-sysctl.conf` with the
@ -95,41 +111,26 @@ to `net.mpls.conf.eth0.input=1`)
net.mpls.conf.eth2.input=1 net.mpls.conf.eth2.input=1
net.mpls.platform_labels=100000 net.mpls.platform_labels=100000
Load the modifed sysctl's on the system:
sudo sysctl -p /etc/sysctl.d/90-routing-sysctl.conf
Create a new file `/etc/modules-load.d/mpls.conf` with the following content: Create a new file `/etc/modules-load.d/mpls.conf` with the following content:
# Load MPLS Kernel Modules # Load MPLS Kernel Modules
mpls-router mpls-router
mpls-iptunnel mpls-iptunnel
**Reboot** or use `sysctl` to apply the same config to the running system And load the kernel modules on the running system:
### Install Service files sudo modprobe mpls-router mpls-iptunnel
install -p -m 644 redhat/zebra.service /usr/lib/systemd/system/zebra.service
install -p -m 644 redhat/isisd.service /usr/lib/systemd/system/isisd.service
install -p -m 644 redhat/ripd.service /usr/lib/systemd/system/ripd.service
install -p -m 644 redhat/ospfd.service /usr/lib/systemd/system/ospfd.service
install -p -m 644 redhat/bgpd.service /usr/lib/systemd/system/bgpd.service
install -p -m 644 redhat/ospf6d.service /usr/lib/systemd/system/ospf6d.service
install -p -m 644 redhat/ripngd.service /usr/lib/systemd/system/ripngd.service
install -p -m 644 redhat/pimd.service /usr/lib/systemd/system/pimd.service
install -p -m 644 redhat/ldpd.service /usr/lib/systemd/system/ldpd.service
install -p -m 644 redhat/frr.sysconfig /etc/sysconfig/frr
install -p -m 644 redhat/frr.logrotate /etc/logrotate.d/frr
### Register the systemd files ### Install frr Service and redhat init files
systemctl preset zebra.service sudo install -p -m 644 redhat/frr.service /usr/lib/systemd/system/frr.service
systemctl preset ripd.service sudo install -p -m 755 redhat/frr.init /usr/lib/frr/frr
systemctl preset ospfd.service
systemctl preset bgpd.service
systemctl preset ospf6d.service
systemctl preset ripngd.service
systemctl preset pimd.service
systemctl preset ldpd.service
### Enable required daemons at startup ### Enable required frr at startup
Only enable zebra and the daemons which are needed for your setup sudo systemctl enable frr
systemctl enable zebra ### Reboot or start FRR manually
systemctl enable ospfd sudo systemctl start frr
systemctl enable bgpd
[...] etc (as needed)