Return to README.rpm_build.md CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / quagga / redhat

Annotation of embedaddon/quagga/redhat/README.rpm_build.md, revision 1.1

1.1     ! misho       1: Building your own Quagga RPM
        !             2: ============================
        !             3: (Tested on CentOS 6, CentOS 7 and Fedora 22.)
        !             4: 
        !             5: 1. Install the following packages to build the RPMs:
        !             6: 
        !             7:                yum install git autoconf automake libtool make gawk readline-devel \
        !             8:                texinfo dejagnu net-snmp-devel groff rpm-build net-snmp-devel \
        !             9:                libcap-devel texi2html
        !            10: 
        !            11:        (use `dnf install` on new Fedora instead of `yum install        `)
        !            12:        
        !            13: 2. Checkout Quagga under a **unpriviledged** user account
        !            14: 
        !            15:                git clone git://git.savannah.nongnu.org/quagga.git quagga
        !            16: 
        !            17: 3. Run Bootstrap and make distribution tar.gz
        !            18: 
        !            19:                cd quagga
        !            20:                ./bootstrap.sh
        !            21:                ./configure --with-pkg-extra-version=-MyRPMVersion
        !            22:                make dist
        !            23:                        
        !            24:        Note: configure parameters are not important for the RPM building - except the
        !            25:        `with-pkg-extra-version` if you want to give the RPM a specific name to
        !            26:        mark your own unoffical build
        !            27: 
        !            28: 4. Create RPM directory structure and populate with sources
        !            29: 
        !            30:                mkdir rpmbuild
        !            31:                mkdir rpmbuild/SOURCES
        !            32:                mkdir rpmbuild/SPECS
        !            33:                cp redhat/*.spec rpmbuild/SPECS/
        !            34:                cp quagga*.tar.gz rpmbuild/SOURCES/
        !            35: 
        !            36: 5. Edit rpm/SPECS/quagga.spec with configuration as needed
        !            37:        Look at the beginning of the file and adjust the following parameters to enable
        !            38:        or disable features as required:
        !            39:        
        !            40:                ################# Quagga configure options ####################
        !            41:                # with-feature options
        !            42:         %{!?with_snmp:         %global  with_snmp       1 }
        !            43:         %{!?with_vtysh:        %global  with_vtysh      1 }
        !            44:         %{!?with_ospf_te:      %global  with_ospf_te    1 }
        !            45:                %{!?with_opaque_lsa:   %global  with_opaque_lsa 1 }
        !            46:                %{!?with_tcp_zebra:        %global  with_tcp_zebra  0 }
        !            47:                %{!?with_vtysh:        %global  with_vtysh      1 }
        !            48:                %{!?with_pam:          %global  with_pam        1 }
        !            49:         %{!?with_ospfclient:   %global  with_ospfclient 1 }
        !            50:                %{!?with_ospfapi:      %global  with_ospfapi    1 }
        !            51:                %{!?with_irdp:         %global  with_irdp       1 }
        !            52:                %{!?with_rtadv:        %global  with_rtadv      1 }
        !            53:                %{!?with_isisd:        %global  with_isisd      1 }
        !            54:                %{!?with_pimd:         %global  with_pimd       1 }
        !            55:                %{!?with_shared:       %global  with_shared     1 }
        !            56:                %{!?with_multipath:    %global  with_multipath  64 }
        !            57:                %{!?quagga_user:       %global  quagga_user     quagga }
        !            58:                %{!?vty_group:         %global  vty_group       quaggavt }
        !            59:                %{!?with_fpm:          %global  with_fpm        0 }
        !            60:                %{!?with_watchquagga:  %global  with_watchquagga 1 }
        !            61: 
        !            62: 6. Build the RPM
        !            63: 
        !            64:                rpmbuild --define "_topdir `pwd`/rpmbuild" -ba rpmbuild/SPECS/quagga.spec
        !            65: 
        !            66: DONE.
        !            67: 
        !            68: If all works correctly, then you should end up with the RPMs under `rpmbuild/RPMS`
        !            69: and the Source RPM under `rpmbuild/SRPMS`
        !            70: 
        !            71: 
        !            72: Enabling daemons after installation of the package:
        !            73: ---------------------------------------------------
        !            74: 
        !            75: ### init.d based systems (ie CentOS 6):
        !            76: 
        !            77: 1. Enable the daemons as needed to run after boot (Zebra is mandatory)
        !            78:        
        !            79:                chkconfig zebra on
        !            80:                chkconfig ospfd on
        !            81:                chkconfig ospf6d on
        !            82:                chkconfig bgpd on
        !            83:                ... etc
        !            84: 
        !            85: 2. If you want to run `watchquagga`, then configure `/etc/sysconfig/quagga` 
        !            86:    and uncomment the line with the daemons for `watchquagga` to monitor,
        !            87:    then enable watchquagga
        !            88: 
        !            89:                chkconfig watchquagga on
        !            90: 
        !            91: 3. Check your firewall / IPtables to make sure the routing protocols are
        !            92: allowed.
        !            93:                
        !            94: 4. Start the daemons (or reboot)
        !            95: 
        !            96:                service zebra start
        !            97:                service bgpd start
        !            98:                service ospfd start
        !            99:                ... etc
        !           100:                        
        !           101: Configuration is stored in `/etc/quagga/*.conf` files.
        !           102: 
        !           103: 
        !           104: ### systemd based systems (ie CentOS 7, Fedora 22)
        !           105: 
        !           106: 1. Enable the daemons as needed to run after boot (Zebra is mandatory)
        !           107:        
        !           108:                systemctl enable zebra
        !           109:                systemctl enable ospfd
        !           110:                systemctl enable ospf6d
        !           111:                systemctl enable bgpd
        !           112:                ... etc
        !           113: 
        !           114:        Note: There is no watchquagga on systemd based systems. Systemd contains
        !           115:        the functionality of monitoring and restarting daemons.
        !           116: 
        !           117: 2. Check your firewall / IPtables to make sure the routing protocols are
        !           118: allowed.
        !           119:                
        !           120: 3. Start the daemons (or reboot)
        !           121: 
        !           122:                systemctl start zebra
        !           123:                systemctl start bgpd
        !           124:                systemctl start ospfd
        !           125:                ... etc
        !           126:                        
        !           127: Configuration is stored in `/etc/quagga/*.conf` files.
        !           128: