SequoiaDB README

Добро пожаловать в SequoiaDB!

SequoiaDB — это распределённая документоориентированная база данных NoSQL.

Engine:

• sequoiadb — движок SequoiaDB;
• sdbstart — запуск движка SequoiaDB;
• sdbstop — остановка движка SequoiaDB;
• sdblist — список движков SequoiaDB;
• sdbfmp — процесс SequoiaDB в огороженном режиме.

Shell:

• sdb — клиент SequoiaDB;
• sdbbp — внутренний процесс клиента SequoiaDB.

Cluster Manager:

• sdbcm — менеджер кластера SequoiaDB;
• sdbcmart — запуск менеджера кластера SequoiaDB;
• sdbcmtop — остановка менеджера кластера SequoiaDB;
• sdbcmd — демон менеджера кластера SequoiaDB.

Tools:

• sdbdpsdump — дамп журнала SequoiaDB;
• sdbexprt — экспорт SequoiaDB;
• sdbimprt — импорт SequoiaDB;
• sdbinspt — проверка данных SequoiaDB;
• sdbrestore — восстановление SequoiaDB;
• sdbtop — ТОП SequoiaDB;
• sdbperfcol — сбор показателей производительности SequoiaDB;
• sdbwsart — запуск веб-службы SequoiaDB;
• sdbwstop — остановка веб-службы SequoiaDB;
• sequoiafs — файловая система SequoiaFS.

Drivers:

C Driver:

• libstaticsdbc.a;
• libsdbc.so.

C++ Driver:

• libstaticsdbcpp.a;
• libsdbcpp.so.

PHP Driver:

• libsdbphp-x.x.x.so.

JAVA Driver:

• sequoiadb-driver-x.x.x.jar.

Python Driver:

#if python2

• pysequoiadb-x.x.x-py2.tar.gz; #if python3
• pysequoiadb-x.x.x-py3.tar.gz.

.NET Driver:

• sequoiadb.dll.

Connectors:

Hadoop Connector:

• hadoop-connector.jar.

Hive Connector:

• hive-sequoiadb-apache.jar.

Storm Connector:

• storm-sequoiadb.jar.

Требования для сборки:

• Scons (2.3.0);
• ant (1.8.2);
• Python (2.7.3);
• PostgreSQL (9.3.4);
• Linux x86-64:
  • g++ (4.3.4),
  • gcc (4.3.4),
  • make (3.81),
  • kernel (3.0.13-0.27-default);
• Linux PPC64:
  • g++ (4.3.4),
  • gcc (4.3.4),
  • make (3.81),
  • kernel (3.0.13-0.27-ppc64);
• Windows:
  • Windows SDK 7.1 (путь установки должен быть C:\Program Files\Microsoft SDKs\Windows\v7.1 или C:\Program Files (x86)\Microsoft SDKs\Windows\v7.1).

Примечание: версия утилиты и ядра приведена только для рекомендации. Пользователи могут использовать другую версию, но могут столкнуться с проблемами несовместимости.

Сборка Engine:

Только Engine:

• scons --engine.

Клиент C/C++:

• scons --client.

Shell:

• scons --shell.

Инструменты:

• scons --tool.

Тестовый случай:

• scons --testcase.

FMP:

• scons --fmp.

Всё (кроме драйверов):

• scons --all.

Примечание: для отладочной сборки можно добавить опцию "--dd".

Сборка драйверов:

Клиент C/C++:

• cd sequoiadb;
• scons --client.

PHP Client:

• cd driver/php;
• scons --phpversion=5.4.6.

Примечание: исходный код PHP находится в каталоге thirdparty/php. Имя каталога должно быть "php-<версия>".

Python Client:

• cd driver/python;
• требуется пакет python-devel; #если python2
• apt install python-dev;
• scons; #если python3
• apt install python3-dev;
• scons --py3.

Java Client:

• cd driver/java;
• mvn clean package -Dmaven.test.skip=true.

.Net Client:

• cd driver/C#.Net;
• scons.

Сборка коннекторов:

Hadoop Connector:

• cd driver/java;
• mvn clean package -Dmaven.test.skip=true;
• cp -r target/sequoiadb-driver-x.x.x.jar sequoiadb.jar;
• cd driver/hadoop/hadoop-connector;
• ant -Dhadoop.version=2.2.

Hive Connector:

• cd driver/java;
• mvn clean package -Dmaven.test.skip=true;
• cp -r target/sequoiadb-driver-x.x.x.jar sequoiadb.jar;
• cd driver/hadoop/hive;
• ant.

Storm Connector:

• cd driver/storm. PostgreSQL FDW:

  cd driver/postgresql make local

  Make sure pg_config is in PATH

  make install

Требования к пакету RPM:

rpmbuild (4.8.0)
scons (2.3.0)
ant (1.8.2)
Python (2.7.3)
PostgreSQL (9.3.4)
Linux x86-64:
    g++ (4.3.4)
    gcc (4.3.4)
    make (3.81)
    kernel (3.0.13-0.27-default)

Пакет RPM:

# root permission is required
# for RHEL и CentOS только
python script/package.py
# RPM-пакет будет выведен в package/output/RPMS/

Запуск:

Для запуска SequoiaDB из командной строки используйте:

    $ ./sdbstart --help

Чтобы остановить SequoiaDB, используйте:

    $ ./sdbstop --help

Чтобы запустить менеджер кластера, используйте:

    $ ./sdbcmart --help

Чтобы остановить менеджер кластера, используйте:

    $ ./sdbcmtop --help

Чтобы работать в автономном режиме:

$ mkdir /sequoiadb/data
$ cd /sequoiadb/data
$ /opt/sequoiadb/bin/sdbstart -p 11810 --force
$ # запуск sequoiadb успешный
$ # запустите оболочку sequoiadb
$ /opt/sequoiadb/bin/sdb
> var db = new Sdb() ;
> db.help() ;

Для работы в кластерном режиме обратитесь к Информационному центру SequoiaDB.

Документация:

Домашняя страница SequoiaDB

Ограничения:

• SequoiaDB официально поддерживает сборку Linux для x86_64 и ppc64 на CentOS, Redhat, SUSE и Ubuntu.
• Сборка для Windows и 32-битная сборка предназначены только для тестирования.

Лицензия:

Большинство исходных файлов SequoiaDB доступны на условиях GNU Affero General Public License (AGPL). Подробности смотрите в отдельных файлах. Все исходные файлы для клиентов, драйверов и коннекторов выпущены под лицензией Apache v2.0.