📂
Установка как служба
Bpium/Bpium S3/Bpium BPM - распространяется как исполняемый файл в разных форматах для разных операционных систем (Windows, Linux, Mac OS X). Приложение само является веб-сервером для себя. Дополнительные веб-сервера не требуются, но могут использоваться для проксирования запросов или как балансировщики в схемах с несколькими серверами.
Bpium
Bpium S3
Bpium BPM
Windows:
bpium.exe
— сервер приложенияbpium-setup.exe
— скрипт развертывания/обновления структуры базы данныхconfig-example.env
— пример файла с настройками работы сервераbpium-server-install-service.bat
— скрипт для создания службы Windowsbpium-server-uninstall-service.bat
— скрипт для удаления службы Windowsnssm.exe
— вспомогательная программа для создания службы Windows
Linux:
bpium
— сервер приложенияbpium-setup
— скрипт развертывания/обновления структуры базы данныхconfig-example.env
— пример файла с настройками работы сервера
Windows:
bpium-s3.exe
— сервер локального файлового хранилищаconfig-example.env
— пример файла с настройками работы сервераbpium-s3-install-service.bat
— скрипт для создания службы Windowsbpium-s3-uninstall-service.bat
— скрипт для удаления службы Windowsnssm.exe
— программа для создания службы Windows
Linux:
bpium-s3
— сервер локального файлового хранил ищаconfig-example.env
— пример файла с настройками работы сервера
Windows:
bpium-bpm.exe
— сервер исполнения бизнес-процессовconfig-example.env
— пример файла с настройками работы сервераbpium-bpm-install-service.bat
— скрипт для создания службы Windowsbpium-bpm-uninstall-service.bat
— скрипт для удаления службы Windowsnssm.exe
— программа для создания службы Windows
Linux:
bpium-bpm
— сервер исполнения бизнес-процессовconfig-example.env
— пример файла с настройками работы сервера
Bpium может работать как по IP-адресу, так и по доменному имени. Настройка домена для Bpium не имеет индивидуальных особенностей, поэтому не входит в эту инструкцию.
Bpium
Bpium S3
Bpium может работать на защищенном канале связи (HTTPS). Для этого сервер приложения должен быть доступен из интернета, иметь доменное имя и SSL-сертификат Class 1 или более высокий.
Для работы мультидоменной версии Bpium требуется wildcard-сертификат Class 2 или более высокий.
Локальный сервер хранилища Bpium S3 также может работать на защищенном канале связи (HTTPS). Для этого он также должен быть доступен из интернета, иметь доменное имя и SSL-сертификат Class 1 или более высокий.
Не используйте самоподписные сертификаты, они не будут приняты сервером. Для создания сертификата мы рекомендуем сервис letsencrypt.org (сертификаты Class 1 — бесплатные).
Bpium
Bpium BPM
Bpoum S3
Postgre SQL
Redis
Входящие подключения к серверу:
- по порту, на котором работает Bpium (по умолчанию: 80 для HTTP, 443 для HTTPS)
Исходящие подключения от сервера:
- на адрес сервера баз данных (по умолчанию 5432)
- на адрес сервера с приложением Bpium BPM (порт по умолчанию: 2030)
- на адрес сервера с локальным хранилищем Bpium S3 (порт по умолчанию: 2020)
- на адрес сервера с внешним хранилищем S3, если используется внешнее
- на адрес *.bpium.ru по портам 80 и 443 (для системы лицензирования и обновления)
Для сервера c приложением Bpium BPM.
Входящие подключения к серверу:
Bpium → Bpium BPM
с адреса сервера с приложением Bpium по порту, на котором работает Bpium BPM (по умолчанию 2020)
Исходящие подключения от сервера:
Bpium BPM → Bpium
на адрес сервера с приложением Bpium (порт по умолчанию: 80 / 443 для HTTPS)Bpium BPM → Bpium S3
на адрес сервера с локальным хранилищем Bpium S3 (порт по умолчанию: 2020)Bpium BPM → внешний S3
на адрес сервера с внешним хранилищем S3, если используется внешнееBpium BPM → внешний мир
если в сценарии вы используете компоненты Веб-запрос, то на адреса и порты, используемые в запросахBpium BPM → внешний мир
если в сценарии вы используете компоненты SQL-запрос, то на адреса и порты, используемые в запросах
Для сервера c локальным файловым хранилищем Bpium S3.
Входящие подключения к серверу:
- со всех внешних и внутренних адресов по порту, на котором работает Bpium S3 (по умолчанию 2020)
Исходящие подключения от сервера:
- на все адреса по установленным соединениям
Для сервера c базой данных Postgre SQL.
Входящие подключения к серверу:
Bpium → Postgre SQL
с адреса сервера с приложением Bpium по порту, на котором работает Postgre SQL (по умолчанию 5432)Bpium BPM → Postgre SQL
если в сценарии вы используете компоненты SQL-запрос, для подключения к базе данных, то с адреса сервера с приложением Bpium BPM
Исходящие подключения от сервера:
- на все адреса по установленным соединениям
Для сервера с операционным хранилищем Redis.
Входящие подключения к серверу:
Bpium BPM → Redis
с адреса сервера с приложением Bpium BPM на порт Redis (по умолчанию 6379)
Исходящие подключения от сервера:
- на все адреса по установленным соединениям
Bpium для хранения использует базу данных PostgreSQL.
- Версия не ранее 9.4 (желательно не ранее 9.6, допустимы 10+, 11+, 12+, 13+, 14+, 15+)
- Сервер PostgreSQL установлен на том же компьютере, что и Bpium, или на компьютере в пределах локальной сети (если на удаленном сервере, то будут большие задержки)
- Сервер PostgreSQL должен работать как служба (в Windows)
- Требуется самостоятельная настройка резервирования и бэкапирования базы данных
Скриншоты процесса стандартной установки PostgreSQL версии 15.2 представлены ниже:




В следующем шаге установки необходимо задать пароль для суперюзера (postgres).
Важно! Запомните данный пароль, он понадобится в будущем для работы с базами данных.

В следующих шагах нужно указать порт (по умолчанию: 5432) и выбрать локаль.
Важно! Необходимо выбрать локаль "Russian, Russia" (
--locale=ru_RU)
, иначе не будет поддержки кириллицы.

В следующих шагах нужно просто нажимать Next и дождаться окончания установки.



Когда установка завершится нажмите кнопку "Finish"

Также для старта системы понадобится заранее созданная пустая база данных. Для её создания запустите программу pgAdmin (она устанавливается совместно с PostgreSQL). Создать пустую базу данных можно по инструкции из скриншотов ниже.
При первом запуске pgAdmin необходимо создать мастер-пароль. Придумайте и введите пароль, нажмите "ОК".
Важно! Запомните данный пароль, так как он будет запрашиваться в дальнейшем при каждом входе в pgAdmin.

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

Далее создаем пустую базу данных:


Готово! Пустая база создана. Вместо пустой базы данных может использоваться скопированная из облака база данных компании.
При первом запуске Бипиум создает в базе служебные данные: раздел «Система» и служебные каталоги. Если вместо пустой базы использовать базу с данными из облачной версии Бипиума, то Бипиум при первом запуске создаст служебные данные в ней. В ней будут и служебные данные для работы коробочной версии и пользовательские данные, созданные в облаке.
Подробнее: Перенос базы из облака
Bpium BPM для хранения данных и распределения нагрузки использует хранилище Redis.
Требования:
- Версия: последняя
- Redis должен работать как служба (в Windows)
- Требуется самостоятельная настройка параметров аутентификации (опционально)
Для стандартной установки Redis скачайте msi-пакет по ссылке выше и запустите его. Шаги установки указаны ниже:







После окончания установки проверьте, что Redis в службах запущен и установлен Автоматический тип запуска. Для этого нажмите Win+R, наберите services.msc и нажмите ОК. В списке служб найдите Redis и проверьте состояние.


Распакуйте архив
- Файл должен лежать в папке и подпапках без русских символов
- Пользователю операционной системы, от имени которого запускается приложение, должны быть даны права создавать файлы в папке Bpium

- Настройте конфигурационный файл config.env. Пример файла config.env с минимально необходимыми параметрами для запуска системы указан ниже (в данном примере config.env файл единый для всех трех приложений системы). Описание параметров.

- Запустите файл
bpium-setup.exe
(под Windows) иbpium-setup
(под Linux), он создаст в базе данных нужную структуру

- 1.Зарегистрируйте bpium как службу/демон, чтобы он запускался при старте системы.
Windows
Linux (через supervisor)
Linux (через systemd)
- 1.Запустите файл
bpium-server-install-service.bat
, он зарегистрирует Bpium как службу Windows и запустит её. Имя службы: Bpium Server.
Файл bpium-server-install-service.bat запустить от имени администратора (правой кнопкой мыши по имени файла и выбрать «Запустить от имени администратора»).
- 1.Вы можете использовать любой пакет для обертывания приложения в демон. Мы рекомендуем использовать supervisor. Установка пакета:sudo apt-get install supervisor -ysudo /etc/init.d/supervisor restart
- 2.В папке с Bpium создайте файл скрипта командой touch bpium-start.sh
- 3.В любом удобном редакторе напишите в файле скрипт:cd /path/to/bpium/folder./bpium
- 4.Дайте файлу права на исполнение:sudo chmod +x ./bpium-start.sh
- 5.Создайте конфигурационный файл демона
«/etc/supervisor/conf.d/bpium.conf»
:[program:bpium]command=/path/to/bpium-start.shstdout_logfile=/var/log/bpium-server-out.logstderr_logfile=/var/log/bpium-server-error.logautostart=trueautorestart=truestartsecs=10numprocs=1 - 6.Примените установленные настройки supervisor:supervisorctl rereadsupervisorctl update
- 7.Запустите службу:supervisorctl start bpium
- 1.В папке с Bpium создайте файл скрипта командойtouch bpium-start.sh
- 2.В любом удобном редакторе напишите в файле скрипт:#!/bin/bashcd /path/to/bpium./bpium
- 3.Дайте файлу права на исполнение:sudo chmod +x bpium-start.sh
- 4.Создайте конфигурационный файл демона«/etc/systemd/system/bpium.service»:[Unit]Description=bpium-startAfter=multi-user.targetAfter=bpium-bpm.serviceRequires=bpium-bpm.service[Service]Type=idleWorkingDirectory=/path/to/bpiumExecStart=/path/to/bpium/bpium-start.sh[Install]WantedBy=multi-user.target
- 5.Перезапустите демон systemd:systemctl daemon-reload
- 6.И включите службу:systemctl enable bpium.service

После установки проверьте, что служба Bpium запущена и Тип запуска "Автоматически".

Хранилище, в процессе работы, может заниматься много места, поэтому лучше всего выносить его на другой диск или СХД. Для удобства рекомендуется сделать символическую ссылку на директорию, где будет находится хранилище.
Windows
Linux
mklink /D назначение цель
/D
– указывает, что ссылка будет на директорию
назначение
– место, где будет размещена ссылка, пример: c:\bpium\storage
цель
– директория на которую ссылается ссылка, пример: d:\s3
ln - s назначение цель
-s
- указывает, что создаем символическую ссылку
назначение
– место, где будет размещена ссылка, пример: /opt/bpium/storage
цель
– директория на которую ссылается ссылка, пример: /mnt/volume1/s3/
- 1.Распакуйте архив
- Файл должен лежать в папке и подпапках без русских символов
- Пользователю, от имени которого запуск ается приложение, должны быть даны права создавать файлы в папке Bpium
- 2.
- 3.Зарегистрируйте bpium-s3 как службу/демон, чтобы он запускался при старте системы
Windows
Linux (через supervisor)
Linux (через systemd)
- 1.Запустите файл
bpium-s3-install-service.bat
, он зарегистрирует Bpium S3 как службу Windows и запустит её. Имя службы: bpium-s3.
Файл bpium-s3-install-service.bat запустить от имени администратора (правой кнопкой мыши по имени файла и выбрать «Запустить от имени администратора»).
- 1.Установка пакета:sudo apt-get install supervisorsudo /etc/init.d/supervisor restart
- 2.В папке с Bpium создайте файл скрипта командой
touch bpium-s3-start.sh
- 3.В любом удобном редакторе напишите в файле скрипт:#!/bin/bashcd /path/to/bpium/folder./bpium-s3
- 4.Дайте файлу права на исполнение:sudo chmod +x ./bpium-s3-start.sh
- 5.Создайте конфигурационный файл демона
«/etc/supervisor/conf.d/bpium-s3.conf»
:[program:bpium-s3]command=/path/to/bpium-s3stdout_logfile=/var/log/bpium-s3-out.logstderr_logfile=/var/log/bpium-s3-error.logautostart=trueautorestart=truestartsecs=10numprocs=1 - 6.Примените установленные настройки supervisor:supervisorctl rereadsupervisorctl update
- 7.Запустите службу:supervisorctl start bpium-s3
- 1.В папке с Bpium создайте файл скрипта командой
touch bpium-start.sh
- 2.В любом удобном редакторе напишите в файле скрипт:#!/bin/bashcd /path/to/bpium./bpium-s3
- 3.Дайте файлу пра ва на исполнение:sudo chmod +x bpium-s3-start.sh
- 4.Создайте конфигурационный файл демона
«/etc/systemd/system/bpium-s3.service»
:[Unit]Description=bpium-s3-startAfter=multi-user.targetAfter=redis-server.serviceRequires=redis-server.service[Service]Type=idleWorkingDirectory=/opt/bpium1.2.0ExecStart=/path/to/bpium/bpium-s3-start.sh[Install]WantedBy=multi-user.target - 5.Перезапустите демон systemd:systemctl daemon-reload
- 6.И включите службу:systemctl enable bpium-s3.service


- 1.Установите Redis
- 2.Распакуйте архив
- Файл должен лежать в папке и подпапках без русских символов
- Пользователю, от имени которого запускается приложение, должны быть даны права создавать файлы в папке Bpium
- 3.
- 4.Зарегистрируйте bpium-bpm как с лужбу/демон, чтобы он запускался при старте системы
Windows
Linux (через supervisor)
Linux (через systemd)
- 1.Запустите файл
bpium-bpm-install-service.bat,
он зарегистрирует Bpium BPM как службу Windows и запустит её. Имя службы: bpium-bpm.
Файл bpium-bpm-install-service.bat запустить от имени администратора (правой кнопкой мыши по имени файла и выбрать «Запустить от имени администратора»).
- 1.Установка пакета:sudo apt-get install supervisorsudo /etc/init.d/supervisor restart
- 2.В папке с Bpium создайте файл скрипта командой
touch bpium-bpm-start.sh
- 3.В любом удобном редакторе напишите в файле скрипт:#!/bin/bashcd /path/to/bpium/folder./bpium-bpm
- 4.Дайте файлу права на исполнение:sudo chmod +x ./bpium-bpm-start.sh
- 5.Создайте конфигурационный файл демона
«/etc/supervizor/conf.d/bpium-bpm.conf»
:[program:bpium-bpm]command=/path/to/bpium-bpmstdout_logfile=/var/log/bpium-bpm-out.logstderr_logfile=/var/log/bpium-bpm-error.logautostart=trueautorestart=truestartsecs=10numprocs=1 - 6.Примените установленные настройки supervisor:supervisorctl rereadsupervisorctl update
- 7.Запустите службу:supervisorctl start bpium bpm
- 1.В папке с Bpium создайте файл скрипта командой
touch bpium-bpm-start.sh
- 2.В любом удобном редакторе напишите в файле скрипт:#!/bin/bashcd /path/to/bpium./bpium-bpm
- 3.Дайте файлу права на исполнение:sudo chmod +x bpium-bpm-start.sh
- 4.Создайте конфигурационный файл демона
«/etc/systemd/system/bpium-bpm.service»
:[Unit]Description=bpium-bpm-startAfter=multi-user.targetAfter=bpium-s3.serviceRequires=bpium-s3.service[Service]Type=idleWorkingDirectory=/path/to/bpiumExecStart=/path/to/bpium/bpium-bpm-start.sh[Install]WantedBy=multi-user.target - 5.Перезапустите демон systemd:systemctl daemon-reload
- 6.И включите службу:systemctl enable bpium-bpm.service


Установка завершена, можно попробовать зайти в Bpium. Для этого откройте браузер и в адресной строке наберите адрес хоста, который указали для Bpium-Server'а в файле config.env

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

Bpium работает. Теперь можете создавать свою систему.