Building librocksdb

Instructions for building rocksdb prior to creating a Zuar Runner Debian package. Assumes that the Zuar Runner repo is located in ~/mitto and the rocksdb repo is located in ~/rocksdb.

On the build machine, get and build rocksdb.

$ cd ~
$ ROCKSDB_VER=v6.17.3
$ git clone -b ${ROCKSDB_VER} --depth 1 https://github.com/facebook/rocksdb.git
$ cd rocksdb \

# If PORTABLE isn't set, one runs the risk of creating a library with
# instructions using CPU features that may not be present in the
# target systems.
$ PORTABLE=1 make shared_lib

# Not necessary to build, but necessary to actually run Zuar Runner
$ sudo make INSTALL_PATH=/usr install-shared

The above will create the following files/links:

$ cd ~
$ ls -ltr rocksdb/librocksdb*
-rwxr-xr-x 1 khe khe 169760472 Mar 18 08:58 rocksdb/librocksdb.so.6.17.3*
lrwxrwxrwx 1 khe khe        20 Mar 18 08:58 rocksdb/librocksdb.so.6.17 -> librocksdb.so.6.17.3*
lrwxrwxrwx 1 khe khe        20 Mar 18 08:58 rocksdb/librocksdb.so.6 -> librocksdb.so.6.17.3*
lrwxrwxrwx 1 khe khe        20 Mar 18 08:58 rocksdb/librocksdb.so -> librocksdb.so.6.17.3*

The .so file and related links are included in the Zuar Runner Debian package when it is built. Their exact location and path must be correct for packaging and package installation to work.

Zuar Runner

Update Zuar Runner

1. mitto/DEBIAN/Makefile

2. Possibly mitto/DEBIAN/debian/postinst

Build Zuar Runner Debian Package

Once rocksdb is built, Zuar Runner can be built.

$ cd ~/mitto
$ make all       # will eventually 'make DEBIAN'

CircleCI Repo

If the version of rocksdb has changed, the following must be updated:

1. Dockerfile in circleci repo.

Build and push a new Docker image to CircleCI.