Update RPM building instructions

[mirror_frr.git] / redhat / README.rpm_build.md

diff --git a/redhat/README.rpm_build.md b/redhat/README.rpm_build.md
index 4513eda635afcdec262138d80c592d79e4b2fc2b..93a731d685e91d8f82437869f22a6a2f03b838c4 100644 (file)
--- a/redhat/README.rpm_build.md
+++ b/redhat/README.rpm_build.md
@@ -2,11 +2,16 @@ Building your own FRRouting RPM
 ======================================
 (Tested on CentOS 6, CentOS 7 and Fedora 24.)
 
-1. Install the following packages to build the RPMs:
+1. On CentOS 6 (which doesn't provide a bison/automake/autoconf of a recent enough version):
+    - Check out ../doc/developer/building-frr-for-centos6.rst for details on installing
+    a bison/automake/autoconf to support frr building.
 
-        yum install git autoconf automake libtool make gawk readline-devel \
-        texinfo dejagnu net-snmp-devel groff rpm-build net-snmp-devel \
-        libcap-devel texi2html bison flex
+    Newer automake/autoconf/bison is only needed to build the rpm and is
+    **not** needed to install the binary rpm package
+
+2. Install the build packages as documented in doc/developer/building-frr-for-xxxxx.rst and the following additional packages:
+
+        yum install rpm-build net-snmp-devel pam-devel libcap-devel
 
     Additionally, on systems with systemd (CentOS 7, Fedora)
 
@@ -14,25 +19,21 @@ Building your own FRRouting RPM
 
     (use `dnf install` on new Fedora instead of `yum install`)
 
-    **CentOS 6:** Please check doc/Building_FRR_on_CentOS6.md for details on
-    how to install required version of autoconf, automake and bison. The
-    versions in the common Repo are too old.
-
-2. Checkout FRR under a **unpriviledged** user account
+3. Checkout FRR under a **unpriviledged** user account
 
         git clone https://github.com/frrouting/frr.git frr
 
-3. Run Bootstrap and make distribution tar.gz
+4. Run Bootstrap and make distribution tar.gz
 
         cd frr
         ./bootstrap.sh
         ./configure --with-pkg-extra-version=-MyRPMVersion
-        make dist
+        make SPHINXBUILD=sphinx-build2.7 dist
             
     Note: configure parameters are not important for the RPM building - except the `with-pkg-extra-version` if you want to give the RPM a specific name to
     mark your own unoffical build
 
-4. Create RPM directory structure and populate with sources
+5. Create RPM directory structure and populate with sources
 
         mkdir rpmbuild
         mkdir rpmbuild/SOURCES
@@ -40,32 +41,37 @@ Building your own FRRouting RPM
         cp redhat/*.spec rpmbuild/SPECS/
         cp frr*.tar.gz rpmbuild/SOURCES/
 
-5. Edit rpm/SPECS/frr.spec with configuration as needed
+6. Edit rpm/SPECS/frr.spec with configuration as needed
     Look at the beginning of the file and adjust the following parameters to enable or disable features as required:
     
-        ################# frr configure options ####################
+        ############### FRRouting (FRR) configure options #################
         # with-feature options
-        %{!?with_snmp:         %global  with_snmp       1 }
-        %{!?with_tcp_zebra:    %global  with_tcp_zebra  0 }
-        %{!?with_pam:          %global  with_pam        1 }
-        %{!?with_ospfclient:   %global  with_ospfclient 1 }
-        %{!?with_ospfapi:      %global  with_ospfapi    1 }
-        %{!?with_irdp:         %global  with_irdp       1 }
-        %{!?with_rtadv:        %global  with_rtadv      1 }
-        %{!?with_ldpd:         %global  with_ldpd       0 }
-        %{!?with_shared:       %global  with_shared     1 }
-        %{!?with_multipath:    %global  with_multipath  64 }
-        %{!?frr_user:          %global  frr_user        frr }
-        %{!?vty_group:         %global  vty_group       frrvt }
-        %{!?with_fpm:          %global  with_fpm        0 }
-        %{!?with_watchfrr:     %global  with_watchfrr   1 }
-        %{!?with_bgp_vnc:      %global  with_bgp_vnc    0 }
-        %{!?with_pimd:         %global  with_pimd       1 }
-
-6. Build the RPM
+        %{!?with_pam:           %global  with_pam           0 }
+        %{!?with_ospfclient:    %global  with_ospfclient    1 }
+        %{!?with_ospfapi:       %global  with_ospfapi       1 }
+        %{!?with_irdp:          %global  with_irdp          1 }
+        %{!?with_rtadv:         %global  with_rtadv         1 }
+        %{!?with_ldpd:          %global  with_ldpd          1 }
+        %{!?with_nhrpd:         %global  with_nhrpd         1 }
+        %{!?with_eigrp:         %global  with_eigrpd        1 }
+        %{!?with_shared:        %global  with_shared        1 }
+        %{!?with_multipath:     %global  with_multipath     256 }
+        %{!?frr_user:           %global  frr_user           frr }
+        %{!?vty_group:          %global  vty_group          frrvty }
+        %{!?with_fpm:           %global  with_fpm           0 }
+        %{!?with_watchfrr:      %global  with_watchfrr      1 }
+        %{!?with_bgp_vnc:       %global  with_bgp_vnc       0 }
+        %{!?with_pimd:          %global  with_pimd          1 }
+        %{!?with_rpki:          %global  with_rpki          0 }
+
+7. Build the RPM
 
         rpmbuild --define "_topdir `pwd`/rpmbuild" -ba rpmbuild/SPECS/frr.spec
 
+   If building with RPKI, then download and install the additional RPKI
+   packages from
+        https://ci1.netdef.org/browse/RPKI-RTRLIB/latestSuccessful/artifact
+
 DONE.
 
 If all works correctly, then you should end up with the RPMs under