Установка и активация OneBridge
- Установка модуля выполнения
- Установка Дизайнера заданий
- Конфигурация OneBridge
- Активация OneBridge
- Установка ODBC
Установка модуля выполнения
Все описанные ниже действия должны производиться на устройстве с операционной системой Ubuntu (поддерживается верси Ubuntu 22.04.3 LTS), либо на виртуальной машине с ОС Ubuntu.
Персонализированнную ссылку на скачивание вашей версии продукта вы получите после подписания лицензионного договора.
Перед началом работы необходимо установить Wget — (GNU Wget) свободную консольную программу для загрузки файлов по сети.
Затем:
- Открыть командную строку и выполнить команды:
- для скачивания приложения OneBridge с сайта modernsolution.ru:
wget *ссылка на актуальную версию OneBridge*
- для установки скачанных файлов приложения OneBridge:
sudo apt install ./onebridge.deb -y
Вместе с файлами приложения OneBridge будут установлены зависимости из следующего списка: build-essential, linux-libc-dev, pkg-config, libssl-dev, libssl3, libgcc-s1, libc6.
После установки файлы OneBridge будут размещены в директории /opt/OneBridge/bin/.
- Перейти в вышеуказанную директорию с помощью команды
cd /opt/OneBridge/bin/. - Запустить приложение из директории
/opt/OneBridge/bin/, введя команду:./startup.sh
В случае успешной установки будет получен ответ: Startup.
При первом запуске будет запущен сценарий активации вашей копии продукта. Подробнее процесс описан в разделе Активация OneBridge. После активации нужно запустить приложение повторно.
Для подключения к модулю управления заданиями нужно открыть браузер на этой же операционной системе и ввести в поисковую строку локальный ip-адрес и порт подключения вот таким образом: 127.0.0.1:8000.
Откроется начальная страница приложения, с которой можно перейти на любую другую страницу из меню.
Список рекомендуемых браузеров: Google Chrome, Яндекс Браузер, Opera.
Установка Дизайнера заданий
Дизайнер поставляется в zip-архиве. Архив содержит папки "cash", "config", "projects", "templates" и файл запуска приложения client.exe.
Для запуска достаточно распаковать архив в предпочитаемую директорию файловой системы и запустить файл client.exe.
Все проекты, скачиваемые с сервера и создаваемые локально по умолчанию будут устанавливаться в папку "projects". Файлы в "templates" содержат параметры и описания компонентов и настройки соединений с базами данных. В "config" лежат файлы конфигурации Дизайнера. В "cash" могут создаваться временные файлы, используемые во время работы.
Конфигурация OneBridge
Параметры конфигурации системы указываются в файле config.toml в корневой папке проекта. Возможна настройка таких параметров как:
адрес подключения интерфейса, параметры авторизации, расположение файлов с логами запусков заданий и других. В таблицах ниже все настраиваемые в конфиге параметры описаны более подробно.
http
| Имя параметра | Описание параметра | Пример значения параметра |
|---|---|---|
| addr | bind address (адрес интерфейса + порт), приоритет отдаётся значению переменной окружения ONEBRIDGE_HTTP_BIND_ADDRESS | addr = "127.0.0.1:8000" |
| ui_path | путь к папке с ui | ui_path = "../ui/dist" |
resources
| Имя параметра | Описание параметра | Пример значения параметра |
|---|---|---|
| interval | интервал сбора статистики сервера (равен горизонтальному интервалу между точками на графиках во вкладке ресурсов) | interval = 5 |
execution
| Имя параметра | Описание параметра | Пример значения параметра |
|---|---|---|
| run_storage.sqlite | путь к файлу с информацией о запусках графов | path = "../data/sqlite-storage/execution_run.sqlite" |
| run_params_storage.sqlite | путь к хранилищу параметров запусков | path = "../data/sqlite-storage/execution_run_params.sqlite" |
| worker.embedded | путь к хранилищу журнала выполнения запусков | job_logs_path = "../data/job-logs" |
projects
| Имя параметра | Описание параметра | Пример значения параметра |
|---|---|---|
| fs.mounted | путь к проектам | path = "../projects" |
auth
| Имя параметра | Описание параметра | Пример значения параметра |
|---|---|---|
| path | путь к хранилищу пользователей | path = "../data/sqlite-storage/users_storage.sqlite" |
| exp_long | экспирация длинного токена (рт), в секундах | exp_long = 86400 |
| exp_short | экспирация короткого токена (ат), в секундах | exp_short = 86400 |
| at_secret | сид для генерации токена доступа | at_secret = "87ac0287d16540e3f9cb307327411ffb39bb4008" |
| rt_secret | сид для генерации токена обновления | rt_secret = "390aed9f00981f4a4c9ae2c1a5e4c115d56f6101" |
| api_tokens | спецтокен для доступа ко всем апи | api_tokens = ["test"] |
| ldap_dn | параметры для подключения к базе ldap | ldap_dn = "uid={},ou=onebridge,dc=example,dc=org" |
| ldap_addr | ip и порт ldap сервера | ldap_addr = "127.0.0.1:389" |
| auth_tries | количество попыток авторизации (после использования всех попыток, пользователь блокируется) | auth_tries = 5 |
Активация OneBridge
Активация позволяет убедиться, что ваша копия OneBridge не используется на нескольких устройствах и содержит заявленную версию продукта.
Чтобы активировать вашу копию OneBridge, нужно будет разместить ключ активации в папке ./data/license. Ключ активации представляет собой файл с расширением .lic, который можно получить от сотрудника поддержки OneBridge. Процедура активации однократная и выполняется только при первом запуске системы.
При первом запуске OneBridge создаст папку ./data/license и сгенерирует файл с вашим machine-id. Путь к файлу будет прописан в консоли. Этот файл нужно будет передать сотруднику поддержки СБАР. В ответ вы получите другой файл, который нужно будет положить в папку рядом с machine-id и повторно запустить установку. В случае успешной проверки указанных файлов OneBridge будет активирован и вы сможене использовать все его функции.
При необходимости активации на новом устройстве, нужно будет повторить процедуру обмена файлами при первом запуске системы на этом устройстве.
Установка ODBC
Для доступа к базам данных OneBridge позволяет использовать ODBC. Для работы с конкретной базой понадобится установить соответствующий драйвер.
Ниже приведён пример установки ODBC и драйверов к нему на Linux.
Установка unixodbc
apt install unixodbc-dev
Установка iodbc
apt install odbcinst
Конфигурация odbc
- Файл odbcinst.ini содержит информацию о драйверах доступных всем пользователям.
- Файл odbc.ini содержит информацию о DSN доступных для всех пользователей.
Пример содержимого odbcinst.ini:
[PostgreSQL]
Description = PostgreSQL driver for Linux & Win32
Driver = /usr/local/lib/libodbcpsql.so
Setup = /usr/local/lib/libodbcpsqlS.so
FileUsage = 1
Заголовок содержит имя драйвера, в последствии используемое в odbc.ini
Description - описание драйвера
Driver - путь к драйверу
Setup - путь к библиотеке, используемой для установки (важно для GUI)
Пример содержимого odbc.ini:
[PostgreSQL]
Description = Test to Postgres
Driver = PostgreSQL
Trace = Yes
TraceFile = sql.log
Database = nick
Servername = localhost
UserName =
Заголовок - имя DSN
Description - описание DSN
Driver - псевдоним драйвера из odbcinst.ini либо можно указать путь до драйвера
Установка драйверов
Установка драйвера для postgres
Установка драйвера firebird
Password =
Port = 5432
Protocol = 6.4
ReadOnly = No
RowVersioning = No
ShowSystemTables = No
ShowOidColumn = No
FakeOidIndex = No
ConnSettings =
Заголовок - имя DSN
Description - описание DSN
Driver - псевдоним драйвера из odbcinst.ini либо можно указать путь до драйвера
Установка драйверов
Установка драйвера для postgres:
apt-get install odbc-postgresql
Установка драйвера firebird:
apt-get install libfbclient2