F-Stack Installation (custom prefix)

f-stack.installation.md

F-Stack Installation

• Author: Weitian LI
• Date: 2020-07-16

Environment

• OS: CentOS 7.4.1708
• Kernel: 3.10.0-957.27.2.el7.x86_64
• F-Stack: master branch (v1.21 as of 2020-07-16)

Installation

0. Install requirements

   yum makecache fast
   yum -y install gcc meson
   yum -y install kernel-devel-$(uname -r)
   yum -y install numactl-devel
   

1. Get F-Stack

   git clone https://github.com/F-Stack/f-stack
   cd f-stack
   

2. Build and install DPDK

   cd dpdk
   make defconfig
   cd build
   make -j4
   make install prefix=/opt/f-stack/dpdk
   cp -R kmod /opt/f-stack/dpdk/
   cp ../usertools/*.py ../usertools/*.sh /opt/f-stack/dpdk/bin/
   

3. Install F-Stack

   sed -i -e 's#/usr/local#/opt/f-stack#g' -e 's#/etc/#/opt/f-stack/etc/#g' \
       lib/Makefile tools/Makefile
   sed -i -e 's|^\(DPDK_CFLAGS.*DRTE_COMPILE_TIME_CPUFLAGS.*\)|#\1|' \
       lib/Makefile tools/compat/Makefile tools/libnetgraph/Makefile
   mkdir /opt/f-stack/{bin,etc,include,lib}
   (cd /opt/f-stack/dpdk/include; ln -s dpdk/* .)
   

   export FF_DPDK=/opt/f-stack/dpdk
   (cd lib && make -j4 && make install)
   (cd tools && make -j4 && make install)
   

4. Install F-Stack Nginx

   export FF_PATH=/opt/f-stack
   cd app/nginx-1.16.1
   sed -i.bak 's|\(CFLAGS.*FF_PATH\)/lib|\1/include|' auto/make
   ./configure --prefix=/opt/f-stack/nginx --with-ff_module
   make -j4 && make install