Installation

Install vineyard

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

pip3 install vineyard

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.

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

• parsec

and other packages to help us build the documentation, which can be easily installed using pip:

pip3 install libclang parsec black isort flake8 sphinx sphinx_rtd_theme breathe

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

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 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

Then you do a out-of-source build using CMake:

mkdir build
cd build
cmake ..
make -j$(nproc)
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 folder.

Install from source on various platforms

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

• Ubuntu

• MacOS

• CentOS

• Arch Linux

Build python wheels

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

python3 setup.py bdist_wheel