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

Merge pull request #803 from opensourcerouting/redhat-doc-fixes-master

Browse Source 
Redhat doc fixes for master branch
This commit is contained in:
Donald Sharp 2017-07-14 10:59:31 -04:00 committed by GitHub
commit 888efdbb5e
5 changed files with 135 additions and 111 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

81
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
@ -46,13 +52,14 @@ Install newer version of autoconf and automake (Package versions are too old)
sudo make install sudo make install
cd .. cd ..
Install `Python 2.7` in parallel to default 2.6 Install `Python 2.7` in parallel to default 2.6.
Make sure you've install EPEL (`epel-release` as above). Then install current Make sure you've install EPEL (`epel-release` as above). Then install current
`python2.7` and `pytest` `python27`, `python27-devel` 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 python27-devel
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
@ -74,17 +81,17 @@ 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
./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 \
@ -97,9 +104,13 @@ 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 \
--enable-eigrpd \
--enable-babeld \
--with-pkg-git-version \ --with-pkg-git-version \
--with-pkg-extra-version=-MyOwnFRRVersion --with-pkg-extra-version=-MyOwnFRRVersion
make make
make check PYTHON=/usr/bin/python2.7 make check PYTHON=/usr/bin/python2.7
sudo make install sudo make install
@ -114,11 +125,23 @@ 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 touch /etc/frr/eigrpd.conf
sudo touch /etc/frr/babeld.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
@ -131,28 +154,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)

82
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 python-devel
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,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
./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,9 +62,13 @@ 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 \
--enable-eigrpd \
--enable-babeld \
--with-pkg-git-version \ --with-pkg-git-version \
--with-pkg-extra-version=-MyOwnFRRVersion --with-pkg-extra-version=-MyOwnFRRVersion
make make
make check make check
sudo make install sudo make install
@ -78,11 +84,23 @@ 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 touch /etc/frr/eigrpd.conf
sudo touch /etc/frr/babeld.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 +112,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 ### Enable required frr at startup
sudo systemctl preset bgpd.service sudo systemctl enable frr
sudo systemctl preset ospf6d.service
sudo systemctl preset ripngd.service
sudo systemctl preset pimd.service
### Enable required daemons at startup ### Reboot or start FRR manually
Only enable zebra and the daemons which are needed for your setup sudo systemctl start frr
sudo systemctl enable zebra
sudo systemctl enable ospfd
sudo systemctl enable bgpd
[...] etc (as needed)

77
doc/Building_FRR_on_Fedora24.md
View File

@ -1,14 +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 c-ares-devel python3-devel json-c-devel pam-devel perl-XML-LibXML pytest bison flex \
c-ares-devel python3-devel
Get FRR, compile it and install it (from Git) Get FRR, compile it and install it (from Git)
--------------------------------------------- ---------------------------------------------
@ -27,17 +32,17 @@ 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
./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 \
@ -50,7 +55,11 @@ 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 \
--enable-eigrpd \
--enable-babeld \
--with-pkg-git-version \ --with-pkg-git-version \
--with-pkg-extra-version=-MyOwnFRRVersion --with-pkg-extra-version=-MyOwnFRRVersion
make make
@ -70,11 +79,22 @@ them if you are not building on a x86_64 architecture
sudo touch /etc/frr/pimd.conf sudo touch /etc/frr/pimd.conf
sudo touch /etc/frr/ldpd.conf sudo touch /etc/frr/ldpd.conf
sudo touch /etc/frr/nhrpd.conf sudo touch /etc/frr/nhrpd.conf
sudo touch /etc/frr/eigrpd.conf
sudo touch /etc/frr/babeld.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 (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
@ -94,41 +114,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 ### Enable required frr at startup
systemctl preset ospf6d.service sudo systemctl enable frr
systemctl preset ripngd.service
systemctl preset pimd.service
systemctl preset ldpd.service
### Enable required daemons at startup ### Reboot or start FRR manually
Only enable zebra and the daemons which are needed for your setup sudo systemctl start frr
systemctl enable zebra
systemctl enable ospfd
systemctl enable bgpd
[...] etc (as needed)

4
redhat/daemons
View File

@ -45,8 +45,10 @@ ripd=no
ripngd=no ripngd=no
isisd=no isisd=no
ldpd=no ldpd=no
pimd=no
nhrpd=no nhrpd=no
eigrpd=no eigrpd=no
babeld=no
# #
# Command line options for the daemons # Command line options for the daemons
# #
@ -58,6 +60,8 @@ ripd_options=("-A 127.0.0.1")
ripngd_options=("-A ::1") ripngd_options=("-A ::1")
isisd_options=("-A 127.0.0.1") isisd_options=("-A 127.0.0.1")
ldpd_options=("-A 127.0.0.1") ldpd_options=("-A 127.0.0.1")
pimd_options=("-A 127.0.0.1")
nhrpd_options=("-A 127.0.0.1") nhrpd_options=("-A 127.0.0.1")
eigrpd_options=("-A 127.0.0.1") eigrpd_options=("-A 127.0.0.1")
babeld_options=("-A 127.0.0.1")

2
redhat/frr.init
View File

@ -33,7 +33,7 @@ V_PATH=/var/run/frr
# Local Daemon selection may be done by using /etc/frr/daemons. # Local Daemon selection may be done by using /etc/frr/daemons.
# See /usr/share/doc/frr/README.Debian.gz for further information. # See /usr/share/doc/frr/README.Debian.gz for further information.
# Keep zebra first and do not list watchfrr! # Keep zebra first and do not list watchfrr!
DAEMONS="zebra bgpd ripd ripngd ospfd ospf6d isisd pimd ldpd nhrpd eigrpd" DAEMONS="zebra bgpd ripd ripngd ospfd ospf6d isisd pimd ldpd nhrpd eigrpd babeld"
MAX_INSTANCES=5 MAX_INSTANCES=5
RELOAD_SCRIPT=/usr/lib/frr/frr-reload.py RELOAD_SCRIPT=/usr/lib/frr/frr-reload.py