No description, website, or topics provided.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
sr_aarch64 [#205] Support for SimpleThreadAPI and the Golang wrappers that use it Nov 20, 2018
sr_armv7l [#205] Support for SimpleThreadAPI and the Golang wrappers that use it Nov 20, 2018
sr_i386 [V63005] Delete files that had updates in GT.M V6.3-005 but are not r… Jul 23, 2018
sr_linux [#205] Implement ydb_ci_t()/ydb_cip_t(), the SimpleThreadAPI equivale… Dec 14, 2018
sr_port [#397] Avoid SIG-11 in unw_mv_ent() due to NULL frame_pointer Dec 14, 2018
sr_port_cm [#205] Support for SimpleThreadAPI and the Golang wrappers that use it Nov 20, 2018
sr_unix [#205] List value of each enum exposed to user in libyottadb.h (relie… Dec 17, 2018
sr_unix_cm [#205] Support for SimpleThreadAPI and the Golang wrappers that use it Nov 20, 2018
sr_unix_gnp [StaticScan] sr_unix_gnp/cmj_getsockaddr.c : Fix warning about "tnd" … Sep 18, 2018
sr_unix_nsb Fix build issues on CYGWIN due to #include "rtnhdr.h" usages (should … Sep 11, 2018
sr_x86_64 [#205] Support for SimpleThreadAPI and the Golang wrappers that use it Nov 20, 2018
sr_x86_regs V6.3-001 May 24, 2017
.gitlab-ci.yml Fix docker grep commands to remove bad input Dec 6, 2018
CMakeLists.txt Revert "[#387] By default build without debug symbols; CMAKE_BUILD_TY… Dec 10, 2018
COPYING V6.0-000 x86 Nov 2, 2015
Dockerfile Add GitLab CI support Dec 6, 2018
LICENSE Refer to YottaDB software in LICENSE file Nov 29, 2018
README.md [#387] Move debug symbols into .dbg files Nov 26, 2018

README.md

YottaDB

All software in this package is part of YottaDB (https://yottadb.com) each file of which identifies its copyright holders. The software is made available to you under the terms of a license. Refer to the LICENSE file for details.

Homepage: https://gitlab.com/YottaDB/DB/YDB

Documentation: https://yottadb.com/resources/documentation/

YottaDB relies on CMake to generate the Makefiles to build binaries from source. The prerequisites are CMake (at least 2.8.5), GNU make (at least 3.81), Linux (x86_64), libraries and development files for libz, Unicode, OpenSSL and GPG. Ubuntu 16.04 LTS was used to test the builds for this distribution, with default versions of packages from the distribution repositories.

Install YottaDB

To quickly get started with running YottaDB, follow the instructions on our Get Started page.

Fulfill the prerequisites

Install development libraries

   Ubuntu Linux OR Raspbian Linux OR Beagleboard Debian
   sudo apt-get install cmake tcsh {libconfig,libelf,libgcrypt,libgpg-error,libgpgme11,libicu,libncurses,libssl,zlib1g}-dev binutils

   Arch Linux
   sudo pacman -S cmake tcsh {libconfig,libelf,libgcrypt,libgpg-error,gpgme,icu,ncurses,openssl,zlib} binutils

   CentOS Linux OR RedHat Linux
   sudo yum install git gcc cmake tcsh {libconfig,gpgme,libicu,libgpg-error,libgcrypt,ncurses,openssl,zlib,elfutils-libelf}-devel binutils

There may be other library dependencies or the packages may have different names. If CMake issues a NOTFOUND error, please see the FAQ below.

Building from source tarball

The YottaDB source tarball extracts to a directory with the version number in the name, e.g. yottadb_r123

 $ tar xzf yottadb_r123_src.tar.gz
 $ cd yottadb_r123_src

You should find this README, LICENSE, COPYING and CMakeLists.txt file and sr_* source directories.

Build the YottaDB binaries:

 $ mkdir build
 $ cd build

By default the script creates production (pro) builds of YottaDB. To create a debug (dbg) build of YottaDB supply the following parameter to cmake -D CMAKE_BUILD\_TYPE=Debug (Note: title case is important)

 $ cmake -D CMAKE_INSTALL_PREFIX:PATH=$PWD ../
 $ make -j `grep -c ^processor /proc/cpuinfo`
 $ make install
 $ cd yottadb_r123

Note that the make install done above does not create the final installed YottaDB. Instead, it stages YottaDB for distribution.

Cloning the repository for the latest updates

You may want to clone the YottaDB repository for access to the latest code.

   git clone git@gitlab.com:YottaDB/DB/YDB.git

To contribute or help with further development, fork the repository, clone your fork to a local copy and begin contributing!

Installing

Now you are ready to install YottaDB. The default installation path is /usr/local/lib/yottadb/r123 but can be controlled using the --installdir option. Run ./ydbinstall --help for a list of options.

 $ sudo ./ydbinstall
 $ cd - ; make clean

Packaging YottaDB

Create a tar file from the installed directory

Docker

Pre-requisites

A working Docker installation on the platform of choice.

NOTE: You must have at least docker 17.05 as multi-stage builds are used within the docker file

Image information

The docker image is built using the generic ydb script that gives the user some sane defaults to begin exploring YottaDB. This isn't meant for production usage.

The commands below assume that you want to remove the docker container after running the command, which means that if you don't mount a volume that contains your database and routines they will be lost. If you want the container to persist remove the --rm parameter from the docker command.

Volumes are also supported by mounting to the /data directory. If you want to mount the local directory ydb-data into the container to save your database and routines locally and use them in the container in the future, add the following command line parameter before the yottadb/yottadb argument:

-v `pwd`/ydb-data:/data

This creates a ydb-data directory in your current working directory. This can be deleted after the container is shutdown/removed if you want to remove all data created in the YottaDB container (such as your database and routines).

Pre-built images

Pre-built images are available on docker hub

Running a Pre-built image

docker run --rm -it yottadb/yottadb # you can add a specific version after a ":" if desired

Build Steps

  1. Build the image
    docker build -t yottadb/yottadb:latest .
    
  2. Run the created image
    docker run --rm -it yottadb/yottadb:latest
    

FAQ

  • The CMake build fails with the following message followed by one or more cases.

    CMake Error: The following variables are used in this project, but they are set to NOTFOUND. Please set them or make sure they are set and tested correctly in the CMake files
    

    This indicates that required libraries are not found. Please consult the list of libraries and check your distributions package manager.