Как установить и настроить OrientDB на Ubuntu 16.04

Представляем инструкцию по установке и настройке документо- и графо-ориентированной СУБД OrientDB.

OrientDB - это система администрирования баз данных NoSQL с открытым исходным кодом, созданная на Java. Представляет собой многомодельную базу, также поддерживающую графы, документы, ключ/значения и объектные модели.      

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

Для корректного функционирования СУБД оптимальное количество оперативной памяти составляет 2GB, однако она будет работать и при 512Mb;

Система написана на Java, так что для установки и эксплуатации обязательна JRE.

Установка

В первую очередь нужно подключиться к виртуальному серверу по SSH и обновить локальную базу пакетов:

sudo apt-get update

Загрузите актуальную версию СУБД, используя утилиту wget (доступна на официальном сайте):

wget -O orientdb-community-2.2.20.tar.gz http://orientdb.com/download.php?file=orientdb-community-2.2.20.tar.gz&os=linux

Теперь разархивируйте загруженный архив (утилита tar):

tar -zxvf orientdb-community-2.2.20.tar.gz

Поместите загруженные файлы в директорию /opt, где обычно располагаются сторонние установленные пакеты:

sudo mv ~/orientdb-community-2.2.20 /opt/orientdb

OrientDB установлена!

Как настроить OrientDB для использования сокращенного объема RAM

По умолчанию демон OrientDB требует не менее 2 ГБ RAM и не будет работать при меньшем объеме. При неуспешном старте появится сообщение об ошибке:
 

В файлах настройки Вы можете отрегулировать значение специальных параметров, благодаря чему появится возможность эксплуатации виртуального сервера минимальной мощности (например 512 Mb RAM).

Используя текстовый редактор, например vi, откройте настроечный файл server.sh:

sudo nano /opt/orientdb/bin/server.sh

Воспользуйтесь поиском и найдите такой блок:

Xms и Xmx – это те параметры, которые нужно изменить. Они определяют начальный и максимальный пул распределения памяти для виртуальной машины Java. По умолчанию - на 2 ГБ.

Можно настроить новые значения, существенно ниже реального объема оперативной памяти. Для начала убедитесь, что на Xms выделено не менее 128 МБ, иначе OrientDB попросту не включится. Для примера мы установим минимальный и максимальный объем пула на 128 Mb и 256 Mb:

# ORIENTDB memory options, default to 2GB of heap.

if [ -z "$ORIENTDB_OPTS_MEMORY" ] ; then
ORIENTDB_OPTS_MEMORY="-Xms128m -Xmx256m"
fi

Сохраните изменения и закройте файл.

Запускаем OrientDB

Откройте каталог установки:

cd /opt/orientdb

Запустите сервер такой командой:

sudo bin/server.sh

Задайте пароль администратора root при первом запуске:

Root password [BLANK=auto generate it]: **********
Please confirm the root password: **********

Вот некоторые системные сообщение, сгенерированные при запуске сервера СУБД:

В них сообщается, что OrientDB включен в вашем актуальном терминале. Проконтролируйте, что сервер прослушивает необходимые порты.

Откройте второй терминал и подключитесь к тому же серверу по SSH, проведите сортировку портов:

sudo netstat -plunt | grep -i listen

Результат для примера:

Как подключиться к консоли

Консоль OrientDB - интерфейс командной строки для управления приложением. Для ее запуска наберите:

sudo /opt/orientdb/bin/console.sh

Появится следущее:

Теперь нужно подключиться к экземпляру сервера. Пароль запрашивается тот, что вы указали при первом запуске сервера на ранних этапах:

orientdb> connect remote:127.0.0.1 root <пароль>

При успешном подключении появится такое сообщение:

Чтобы войти, наберите exit:

orientdb {server=remote:127.0.0.1/}> exit

Настройка OrientDB как демона

Теперь OrientDB установлен, однако это всего лишь набор скриптов на сервере.

Комбинация клавиш CTRL+C позволит остановить работу OrientDB.

Теперь создайте пользователя системы, от имени которого будет работать СУБД. Для примера создадим пользователя orientdb, следующая команда дополнительно создаст группу orientdb:

sudo useradd -r orientdb -s /sbin/nologin

Созданному пользователю и группе передайте право владения на каталог OrientDB и на файлы:

sudo chown -R orientdb:orientdb /opt/orientdb

Запустите следующий файл для редактирования:

sudo vi /opt/orientdb/bin/orientdb.sh

Найдите такие параметры:

Сменит значения:

ORIENTDB_DIR="/opt/orientdb"
ORIENTDB_USER="orientdb"

Сохраните изменения и закройте файл.

Для предотвращения прочтения файла неавторизованными пользователями измените его разрешение конфигурации сервера:

sudo chmod 640 /opt/orientdb/config/orientdb-server-config.xml

Как настроить скрипты Systemd

Служба Systemd предназначена для запуска и остановка OrientDB. Скопируйте такой настроечный файл в каталог /etc/systemd/system:

sudo cp /opt/orientdb/bin/orientdb.service /etc/systemd/system

Откройте его для конфигурации:

sudo vi /etc/systemd/system/orientdb.service

Замените параметры User, Group и ExecStart следующим образом:

User=orientdb
Group=orientdb
ExecStart=/opt/orientdb/bin/server.sh

Выполните теперь такие команды для вступления изменений в силу:

sudo systemctl daemon-reload
sudo systemctl start orientdb

Разрешите запуск при загрузке:

sudo systemctl enable orientdb

Проверьте, в каком состоянии находится СУБД:

sudo systemctl status orientdb

Результат должен быть таким:

Подключение к OrientDB Studio

Внимание: откройте порт 2480 для подключения из браузера.

iptables -A INPUT -p tcp --dport 2480 -j ACCEPT
iptables-save

Для подключения к OrientDB Studio откройте в браузере следующий адрес:

http://<IP-адрес_сервера>:2480

Например:

http://111.111.111.111:2480

После загрузки страницы появится экран входа в систему, нужно ввести имя пользователя и пароль.

Рабочая область будет выглядеть примерно так:

Установка и настройка OrientDB закончена!