Installation#

Install vineyard#

Vineyard is distributed as a python package and can be easily installed with pip:

pip3 install vineyard

Install etcd#

Vineyard is based on etcd, please refer the doc to install it.

Install from source#

Vineyard is open source on Github: https://github.com/v6d-io/v6d. You can obtain the source code using git:

git clone https://github.com/v6d-io/v6d
cd v6d
git submodule update --init

Prepare dependencies#

Vineyard can be built and deployed on common Unix-like systems. Vineyard has been fully tests with C++ compilers that supports C++ 14.

Dependencies#

Vineyard requires the following software as dependencies to build and run:

  • apache-arrow >= 0.17.1

  • gflags

  • glog

  • boost

  • mpi, for the graph data structure module

  • gtest, for build test suites

If you want to build the vineyard server, the following additional libraries are needed:

  • protobuf

  • grpc

And the following python packages is required:

  • libclang

    Can be installed using pip

    pip3 install libclang
    

Install on Ubuntu (or Debian)#

Vineyard has been fully tested on Ubuntu 20.04. The dependencies can be installed by

apt-get install -y ca-certificates \
                   cmake \
                   doxygen \
                   libboost-all-dev \
                   libcurl4-openssl-dev \
                   libgflags-dev \
                   libgoogle-glog-dev \
                   libgrpc-dev \
                   libgrpc++-dev \
                   libmpich-dev \
                   libprotobuf-dev \
                   libssl-dev \
                   libunwind-dev \
                   libz-dev \
                   protobuf-compiler-grpc \
                   python3-pip \
                   wget

Then install the apache-arrow (see also https://arrow.apache.org/install):

wget https://apache.jfrog.io/artifactory/arrow/$(lsb_release --id --short | tr 'A-Z' 'a-z')/apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb \
    -O /tmp/apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
apt install -y -V /tmp/apache-arrow-apt-source-latest-$(lsb_release --codename --short).deb
apt update -y
apt install -y libarrow-dev

Dependencies on MacOS#

Vineyard has been tests on MacOS as well, the dependencies can be installed using brew:

brew install apache-arrow boost gflags glog grpc protobuf mpich openssl zlib autoconf

Install libgrape-lite#

libgrape-lite is a C++ library for parallel graph processing and is used as the basis of the distributed graph data structure implementation.

You need to install libgrape-lite properly before building vineyard if you need the graph module works,

git clone https://github.com/alibaba/libgrape-lite.git
cd libgrape-lite
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install

Or, you need to disable the graph module when building vineyard

cmake .. -DBUILD_VINEYARD_GRAPH=OFF

Building vineyard#

After the required dependencies being installed, you do a out-of-source build using CMake:

mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install  # optionally

You will see vineyard server binary under the bin directory, and static or shared linked libraries will be placed under the lib-shared folder.

Building python wheels#

After building the vineyard library successfully, you can package a install wheel distribution by

python3 setup.py bdist_wheel

Building the documentation#

Vineyard documentation is organized and generated by sphinx. There are other packages that help us build the documentation, which can be easily installed using pip:

pip3 install -r requirements.txt -r requirements-dev.txt

Once installed, you could go to the docs/ directory and build the documentation by

cd docs/  # skip if you are already there
make html

Building on various platforms#

Vineyard is continously tested on various platforms and you may find building and installation steps from our CI: