# Установка и администрирование

# 1 УСТАНОВКА

# 1.1 Установка под Windows

Для установки NitrosBase под Windows достаточно запустить сетап файл nbsetup.exe

Требования к операционной системе

  • Windows Server 2016 и выше
  • Windows 10

Требования к аппаратному обеспечению

  • Количество ядер процессора — от 4;
  • Частота процессора — от 2.0 GHz;
  • Объем оперативной памяти — от 16 GB;
  • Объем свободного места на жестком диске (предпочтителен SSD) — от 128 GB.

Развертывание демонстрационной БД

Запустите терминал, перейдите в папку bin и выполните следующие команды:

  1. Создание демонстрационной базы данных sntest1:
    nbase sntest1 -c create -p 3020

  2. Заполнение базы тестовыми данными:
    nbase -p 3020 -q < ../samples.data/sntest1/prepare.sql

  3. Выполнение простого демонстрационного запроса:
    nbase -p 3020 -q "select name, lastname, age from person limit 10"

# 1.2 Установка под Linux

Для установки NitrosBase под Linux достаточно распаковать архив с дистрибутивом в любой каталог.

Требования к операционной системе

  • Linux x64
  • GNU library GLIBC 2.23 и выше

Требования к аппаратному обеспечению

  • Количество ядер процессора — от 4;
  • Частота процессора — от 2.0 GHz;
  • Объем оперативной памяти — от 16 GB;
  • Объем свободного места на жестком диске (предпочтителен SSD) — от 128 GB.

Развертывание демонстрационной БД

Запустите терминал, перейдите в папку bin и выполните следующие команды:

  1. Создание демонстрационной базы данных sntest1:
    ./nbase sntest1 -c create -p 3020

  2. Заполнение базы тестовыми данными:
    ./nbase -p 3020 -q < ../samples.data/sntest1/prepare.sql

  3. Выполнение простого демонстрационного запроса:
    ./nbase -p 3020 -q "select name, lastname, age from person limit 10"

# 2 АДМИНИСТРИРОВАНИЕ

Программа nbase позволяет администрировать базы данных NitrosBase.

Для работы в терминальном режиме можно использовать команды CLI (Command Line Interface).

Также nbase является веб сервером для удаленного администрирования с помощью стандартного веб браузера.

# 2.1 Интерфейс командной строки

Программа nbase предоставляет интерфейс командной строки для выполнения базовых задач по администрированию СУБД NitrosBase.

nbase [dbname] [options] 

OPTIONS:

--help   
 -h                  -- show this help 
   
--command=<command> 
 -c <command>  	     -- command:
                        create    - create new database and start server for it
                                    (dbname and port are required)
                        open      - start server for database specified
                                    (dbname and port are required)
                        close     - stop server of database specified
                                    (port is required)
                        backup    - backup database specified
                                    (port is required)
                        restore   - restore database specified
                                    (dbname, port and backuppath are required)
--port=<port>
 -p <port>     	     -- TCP port listened by server

--folder <path>      
 -f <path>           -- path to folder where database will be created
                        default is setuppath/data 
                        (c:/nitrosbaseuni/data for windows)

--query="sqlcommand"
 -q "sql command"    -- execute SQL query against database specified
                        (port is required);
                        if query is omitted, it will be red
                        from standard input

-b <path>            -- backup path

-t                   -- terminate nbase background process

Usage 2:
nbase a              -- start admin panel

# Примеры

# Создание и запуск базы данных

nbase sntest1 -c create -p 3020

По умолчанию база создается в папке setuppath/data (c:/nitrosbaseuni/data for windows). Для создания базы данных в другой папке можно использовать параметр -f

nbase sntest2 -f d:\tmp -c create -p 3021

# Запуск существующей базы данных

nbase sntest1 -c open -p 3020

# Остановка базы данных

nbase -c close -p 3020

# Выполнение SQL-запроса

nbase -p 3020 -q "select * from person limit 10"

# Выполнение SQL-запроса из файла

nbase -p 3020 -q < query.sql

# 2.2 WEB Интерфейс администратора

WEB Интерфейс администратора будет доступен в версии NitrosBase 2.2

NitrosBase Admin - это веб-приложение для управления СУБД NitrosBase. Оно поддерживает все функции, необходимые для работы с СУБД: от написания простых SQL-запросов до разработки сложных баз данных. NitrosBase Admin поддерживается операционными системами Windows и Linux.

Для запуска приложения под Windows необходимо перейти в меню Пуск, найти папку NitrosBase и внутри нее выбрать NitrosBase Аdmin. Веб-приложение NitrosBase Admin запускается в Web браузере.

Для запуска приложения под Linux выполните команду

nbase a 

Вы также можете запустить браузер и указать URL: 127.0.0.1:8000

В общем виде интерфейс программы представлен:

  • главным меню, расположенным вверху страницы;
  • левой панелью, содержащей дерево объектов управления (базы данных, таблицы, колонки, индексы): для примера в программе представлена тестовая база данных;
  • областью запросов, позволяющей создавать каждый запрос в отдельной вкладке;
  • областью данных, отображающей результаты запросов.

Для создания баз данных и выполнения операций над объектами базы данных предусмотрено контекстное меню, содержащее команды по созданию, изменению и удалению объектов базы данных. Все изменения, производимые в базе данных, отображаются в дереве объектов на левой панели.

Для работы с запросами в NitrosBase Admin создан отдельный раздел меню Query, позволяющий создавать, сохранять, открывать сохраненные запросы, запускать их выполнение и т.д.

Для удобства пользователя в разделе Help представлены информационные ресурсы, которые помогут в работе с данным приложением.

# 2.3 Структура каталогов

Распакованный дистрибутив содержит следующие каталоги:

  • bin — исполняемые файлы сервера и клиента СУБД, часть библиотек
  • data — папка, в которой создаются базы данных
  • include — заголовочные файлы C/C++
  • samples.c++ — примеры на языке С++
  • samples.java — примеры на языке Java
  • samples.data — данные для тестовой базы данных