ДОКУМЕНТАЦИЯ
Вся документация Сфера MDX Сервер доступна на русском языке
Установка Хранилища
Перед началом установки определите имя файла дистрибутива, например:
- Имя файла дистрибутива:
sphere-mdwh-storage_25.3.4.1_amd64.deb
Далее в инструкции это имя будет обозначаться как <имя_файла_дистрибутива>
.
Установка
Проверьте версию ядра Linux.
Убедитесь, что версия ядра не ниже 6.0. Для этого выполните команду:
uname -a
Обновите список пакетов операционной системы.
Для Debian/Ubuntu:
sudo apt update
Поместите файл дистрибутива в домашний каталог пользователя.
Например, скопируйте файл
<имя_файла_дистрибутива>
в папку~/
.Установите пакет с помощью dpkg.
sudo dpkg -i <имя_файла_дистрибутива>
Если возникнут ошибки зависимости, их можно исправить командой:
sudo apt install -f
Включите автозапуск службы.
sudo systemctl enable sphere-mdwh-storage-server
Запустите службу.
sudo systemctl start sphere-mdwh-storage-server
Проверьте статус службы.
sudo systemctl status sphere-mdwh-storage-server
В выводе должен быть фрагмент:
"Starting Sphere MDWH Storage Server (analytic DBMS for big data)"
Состояние службы должно быть active (running).
Подключение
Запустите клиентскую программу.
sphere-mdwh-storage-client
Проверьте версию службы.
select sphereVersion();
В выводе должен быть фрагмент с номером установленной версии.
Завершите работу клиента.
\q
Установка завершена. Теперь вы можете перейти к инструкции по использованию Колибри Сферы.
Установка Сервера
Перед началом установки необходимо получить deb пакет, который содержит в названии имя устанавливаемого приложения и его версию:
- Имя файла дистрибутива:
sphere-mdwh-server_version.deb
Далее в инструкции это имя будет обозначаться как <имя_файла_дистрибутива>
.
Для установки необходимо поместить deb пакет в любой каталог на целевом сервере.
Установка
Перейти в каталог с deb пакетом
cd /path/to/deb/package
Установить приложение
sudo dpkg -i <имя_файла_дистрибутива>
Проверить версию установленного пакета
dpkg –l | grep sphere-mdwh-server
В выводе должен быть фрагмент:
ii sphere-mdwh-server <версия_установленного_пакета>
В результате установки будут созданы каталоги:
/var/opt/sphere-mdwh-server/ - каталог с логами приложения
/opt/sphere-mdwh-server/ - корневой каталог приложения
/etc/opt/sphere-mdwh-server/ - каталог с конфигурационными файлами приложения
Конфигурация
Для настройки Sphere MDWH Server необходимо отредактировать конфигурационный файл
appsettings.json
в каталоге/etc/opt/sphere-mdwh-server/
sudo nano /etc/opt/sphere-mdwh-server/appsettings.json
Отредактировать блок
EndPoints
, указав, в качествеUrl
, IP адрес текущего сервера.В блок
Locations
добавить параметры подключения к источнику данных, указав корректную строку подключения к БД:"location-name": { "Engine": "PostgreSQL", "Connection": "Server=192.168.0.1;Port=5432;Database=db-name;User Id=postgres;Password=pass;CommandTimeout=7200;Timeout=1024", "Description": "description of the data source", "Credentials": { "Login": "user name", "Password": "user password" } }
Описание свойств конфигурации:
location-name – любое понятное имя для location
Engine – тип источника данных: PostgreSQL, ClickHouse и другие доступные
Connection – строка подключения к БД источника
Description – любое понятное описание location
Credentials – указываются логин и пароль пользователя для подключения к КС
Сохранить изменения в файле и закрыть.
Запустить Sphere MDWH Server и проверить его работу:
sudo systemctl start sphere-mdwh-server.service
sudo systemctl status sphere-mdwh-server.service
Состояние службы должно быть active (running).
При возникновении каких либо ошибок, можно посмотреть журнал:
journalctl -u sphere-mdwh-server.service -fn20
Использование Сводной Таблицы
Сфера MDX Клиент предоставляет удобное классическое приложение для работы и взаимодействия с OLAP кубами, которое позволяет построить сводную таблицу на основе выбранного куба, управлять ей и сохранять Вид таблицы в хранилище Колибри-Сферы, либо в виде файла на диск.