FluffOS Docs

Appearance

build_v2017 ​

Environment ​

v2017 currently supports ubuntu 14.04+, centos 7+, CYGWIN 64.

Compilers: FluffOS uses C++11, which requires at least GCC 4.6+ or LLVM clang 3.0+.

Library: libevent 2.0+, additional libraries depends on the package selection.

jemalloc: use JEMALLOC is highly recommended in production. otherwise you may run into memory issue.

BUILD ​

To Build fluffOS v2017 (Autoconf & in tree build)

bash
    # 0. You need to install autoconf & automake!
    $ sudo apt install autoconf automake
   
    # 1. checkout git repo
    $ git clone https://github.com/fluffos/fluffos.git
    $ cd fluffos
    $ git checkout v2017 (or any specfic release tag)

    # 2. modify local_options file as need.
    $ cd src
    <edit local_options to you need>

    # 3. Build!
    $ ./build.FluffOS
    $ make

    # 4. find the built binary in src/driver and src/portbind

CentOS ​

The problem with CentOS is that most of the package is too old for FluffOS, you must upgrade them manually first.

Move to ubuntu or run an ubuntu based docker images is highly recommended.

bash
    # Install GCC 4.8 (or the latest one you like!)

    $ wget http://ftp.gnu.org/gnu/gcc/gcc-4.8.0/gcc-4.8.0.tar.bz2
    $ tar -jxvf  gcc-4.8.0.tar.bz2
    $ cd gcc-4.8.0
    $ ./contrib/download_prerequisites

    # Build GCC
    $ cd ..
    $ mkdir gcc-build-4.8.0
    $ cd gcc-build-4.8.0
    $../gcc-4.8.0/configure --enable-checking=release --enable-languages=c,c++ --disable-multilib
    $ make -j16 # (Will take an hour)
    $ make install

    # Verify now gcc is installed correctly.
    # "gcc -v" should output "gcc (GCC) 4.8.0"

    # NOTE:Manually install new version of libstdc++
    # you have to copy libstdc++.so.6 in your gcc4.8 build directory to /usr/lib64
    # override the existing file.

    # Install libevent2.0 manually

    $ wget https://github.com/downloads/libevent/libevent/libevent-2.0.21-stable.tar.gz
    $ tar zxvf libevent-2.0.21-stable.tar.gz
    $ cd libevent-2.0.21-stable
    $ ./configure –prefix=/usr
    $ make
    $ make install

CYGWIN32/CYGWIN64 ​

FluffOS v2017 is fully functional under CYGWIN32 and CYGWIN64.

bash
    # 1. Get CYGWIN setup file on http://www.cygwin.org , preferably x64 one.

    # 2. Make sure to install following packages, using apt-cyg
         (https://github.com/transcode-open/apt-cyg) is highly recommended. 

      - autoconf
      - automake
      - binutils (make sure to choose 2.28-3, there are still crashing bugs for latest version)
      - bison
      - gcc-core
      - gcc-g++
      - git
      - libcrypt-devel
      - libevent-devel
      - libiconv-devel
      - libpcre-devel
      - zlib-devel
      - libmysqlclient-devel

    # CYGWIN setup should take care of other dependencies for you

    # 3. Build FluffOS as if we are under normal linux!