📂Установка как служба

Состав дистрибутива

Bpium/Bpium S3/Bpium BPM - распространяется как исполняемый файл в разных форматах для разных операционных систем (Windows, Linux, Mac OS X). Приложение само является веб-сервером для себя. Дополнительные веб-сервера не требуются, но могут использоваться для проксирования запросов или как балансировщики в схемах с несколькими серверами.

Windows:

bpium.exe — сервер приложения
bpium-setup.exe — скрипт развертывания/обновления структуры базы данных
config-example.env — пример файла с настройками работы сервера
bpium-server-install-service.bat — скрипт для создания службы Windows
bpium-server-uninstall-service.bat — скрипт для удаления службы Windows
nssm.exe — вспомогательная программа для создания службы Windows

Linux:

bpium — сервер приложения
bpium-setup — скрипт развертывания/обновления структуры базы данных
config-example.env — пример файла с настройками работы сервера

Windows:

bpium-s3.exe — сервер локального файлового хранилища
config-example.env — пример файла с настройками работы сервера
bpium-s3-install-service.bat — скрипт для создания службы Windows
bpium-s3-uninstall-service.bat — скрипт для удаления службы Windows
nssm.exe — программа для создания службы Windows

Linux:

bpium-s3 — сервер локального файлового хранилища
config-example.env — пример файла с настройками работы сервера

Windows:

bpium-bpm.exe — сервер исполнения бизнес-процессов
config-example.env — пример файла с настройками работы сервера
bpium-bpm-install-service.bat — скрипт для создания службы Windows
bpium-bpm-uninstall-service.bat — скрипт для удаления службы Windows
nssm.exe — программа для создания службы Windows

Linux:

bpium-bpm — сервер исполнения бизнес-процессов
config-example.env — пример файла с настройками работы сервера

Подготовка сервера

Доменное имя

Bpium может работать как по IP-адресу, так и по доменному имени. Настройка домена для Bpium не имеет индивидуальных особенностей, поэтому не входит в эту инструкцию.

SSL-сертификаты

Сервер приложения Bpium

Bpium может работать на защищенном канале связи (HTTPS). Для этого сервер приложения должен быть доступен из интернета, иметь доменное имя и SSL-сертификат Class 1 или более высокий. Для работы мультидоменной версии Bpium требуется wildcard-сертификат Class 2 или более высокий.

Фаервол

Для сервера c приложением Bpium

Входящие подключения к серверу:

по порту, на котором работает 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 базой данных Postgre SQL.

Входящие подключения к серверу:

Bpium → Postgre SQL с адреса сервера с приложением Bpium по порту, на котором работает Postgre SQL (по умолчанию 5432)
Bpium BPM → Postgre SQL
если в сценарии вы используете компоненты SQL-запрос, для подключения к базе данных, то с адреса сервера с приложением Bpium BPM

Исходящие подключения от сервера:

на все адреса по установленным соединениям

Для сервера с операционным хранилищем Redis.

Входящие подключения к серверу:

Bpium BPM → Redis с адреса сервера с приложением Bpium BPM на порт Redis (по умолчанию 6379)

Исходящие подключения от сервера:

на все адреса по установленным соединениям

Установка и настройка зависимостей

Установка PostgreSQL

Bpium для хранения использует базу данных PostgreSQL.

Требования:

Версия не ранее 9.4 (желательно не ранее 9.6, допустимы 10+, 11+, 12+, 13+, 14+ )

Версии PostgreSQL 15+ на текущий момент не поддерживаются.

Сервер PostgreSQL установлен на том же компьютере, что и Bpium, или на компьютере в пределах локальной сети (если на удаленном сервере, то будут большие задержки)
Сервер PostgreSQL должен работать как служба (в Windows)
Требуется самостоятельная настройка резервирования и бэкапирования базы данных

Скриншоты процесса стандартной установки PostgreSQL версии 15.2 представлены ниже:

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

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

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

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

Также для старта системы понадобится заранее созданная пустая база данных. Для её создания запустите программу pgAdmin (она устанавливается совместно с PostgreSQL). Создать пустую базу данных можно по инструкции из скриншотов ниже.

При первом запуске pgAdmin необходимо создать мастер-пароль. Придумайте и введите пароль, нажмите "ОК". Важно! Запомните данный пароль, так как он будет запрашиваться в дальнейшем при каждом входе в pgAdmin.

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

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

Готово! Пустая база создана. Вместо пустой базы данных может использоваться скопированная из облака база данных компании.

Копирование данных из базы в облаке

При первом запуске Бипиум создает в базе служебные данные: раздел «Система» и служебные каталоги. Если вместо пустой базы использовать базу с данными из облачной версии Бипиума, то Бипиум при первом запуске создаст служебные данные в ней. В ней будут и служебные данные для работы коробочной версии и пользовательские данные, созданные в облаке. Подробнее: Перенос базы из облака

Установка Redis

Bpium BPM для хранения данных и распределения нагрузки использует хранилище Redis.

Требования:

Версия: последняя
Redis должен работать как служба (в Windows)
Требуется самостоятельная настройка параметров аутентификации (опционально)

Ссылка сборки для Windows: https://github.com/MicrosoftArchive/redis/releases

Для стандартной установки Redis скачайте msi-пакет по ссылке выше и запустите его. Шаги установки указаны ниже:

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

Установка Bpium

Распакуйте архив

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

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

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

Зарегистрируйте bpium как службу/демон, чтобы он запускался при старте системы.

Запустите файл bpium-server-install-service.bat, он зарегистрирует Bpium как службу Windows и запустит её. Имя службы: Bpium Server.

Файл bpium-server-install-service.bat запустить от имени администратора (правой кнопкой мыши по имени файла и выбрать «Запустить от имени администратора»).

Вы можете использовать любой пакет для обертывания приложения в демон. Мы рекомендуем использовать supervisor. Установка пакета:
```
sudo apt-get install supervisor -y
sudo /etc/init.d/supervisor restart
```
В папке с Bpium создайте файл скрипта командой touch bpium-start.sh
В любом удобном редакторе напишите в файле скрипт:
```
cd /path/to/bpium/folder
./bpium
```
Дайте файлу права на исполнение:
```
sudo chmod +x ./bpium-start.sh
```

Создайте конфигурационный файл демона «/etc/supervisor/conf.d/bpium.conf»:

[program:bpium]
command=/path/to/bpium-start.sh
stdout_logfile=/var/log/bpium-server-out.log
stderr_logfile=/var/log/bpium-server-error.log
autostart=true
autorestart=true
startsecs=10
numprocs=1

Примените установленные настройки supervisor:
```
supervisorctl reread
supervisorctl update
```
Запустите службу:
```
supervisorctl start bpium
```

В папке с Bpium создайте файл скрипта командой
```
touch bpium-start.sh
```
В любом удобном редакторе напишите в файле скрипт:
```
 #!/bin/bash
 cd /path/to/bpium
 ./bpium
```
Дайте файлу права на исполнение:
```
sudo chmod +x bpium-start.sh
```

Создайте конфигурационный файл демона«/etc/systemd/system/bpium.service»:

[Unit]
Description=bpium-start
After=multi-user.target
After=bpium-bpm.service
Requires=bpium-bpm.service
[Service]
Type=idle
WorkingDirectory=/path/to/bpium
ExecStart=/path/to/bpium/bpium-start.sh
[Install]
WantedBy=multi-user.target

Перезапустите демон systemd:
```
systemctl daemon-reload
```
И включите службу:
```
systemctl enable bpium.service
```

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

Установка Bpium S3

Хранилище, в процессе работы, может заниматься много места, поэтому лучше всего выносить его на другой диск или СХД. Для удобства рекомендуется сделать символическую ссылку на директорию, где будет находится хранилище.

mklink /D назначение цель /D – указывает, что ссылка будет на директорию назначение – место, где будет размещена ссылка, пример: c:\bpium\storage цель – директория на которую ссылается ссылка, пример: d:\s3

ln - s назначение цель -s - указывает, что создаем символическую ссылку назначение– место, где будет размещена ссылка, пример: /opt/bpium/storage цель – директория на которую ссылается ссылка, пример: /mnt/volume1/s3/

Распакуйте архив
- Файл должен лежать в папке и подпапках без русских символов
- Пользователю, от имени которого запускается приложение, должны быть даны права создавать файлы в папке Bpium
Настройте конфигурационный файл config.env Описание параметров.
Зарегистрируйте bpium-s3 как службу/демон, чтобы он запускался при старте системы

Запустите файл bpium-s3-install-service.bat, он зарегистрирует Bpium S3 как службу Windows и запустит её. Имя службы: bpium-s3.

Файл bpium-s3-install-service.bat запустить от имени администратора (правой кнопкой мыши по имени файла и выбрать «Запустить от имени администратора»).

Установка пакета:

sudo apt-get install supervisor
sudo /etc/init.d/supervisor restart

В папке с Bpium создайте файл скрипта командой touch bpium-s3-start.sh
В любом удобном редакторе напишите в файле скрипт:
```
#!/bin/bash
 cd /path/to/bpium/folder
 ./bpium-s3
```
Дайте файлу права на исполнение:
```
sudo chmod +x ./bpium-s3-start.sh
```

Создайте конфигурационный файл демона «/etc/supervisor/conf.d/bpium-s3.conf»:

[program:bpium-s3]
command=/path/to/bpium-s3
stdout_logfile=/var/log/bpium-s3-out.log
stderr_logfile=/var/log/bpium-s3-error.log
autostart=true
autorestart=true
startsecs=10
numprocs=1

Примените установленные настройки supervisor:
```
supervisorctl reread
supervisorctl update
```
Запустите службу:
```
supervisorctl start bpium-s3
```

В папке с Bpium создайте файл скрипта командой touch bpium-start.sh
В любом удобном редакторе напишите в файле скрипт:
```
#!/bin/bash
 cd /path/to/bpium
 ./bpium-s3
```
Дайте файлу права на исполнение:
```
sudo chmod +x bpium-s3-start.sh
```

Создайте конфигурационный файл демона«/etc/systemd/system/bpium-s3.service»:

[Unit]
Description=bpium-s3-start
After=multi-user.target
After=redis-server.service
Requires=redis-server.service
[Service]
Type=idle
WorkingDirectory=/opt/bpium1.2.0
ExecStart=/path/to/bpium/bpium-s3-start.sh
[Install]
WantedBy=multi-user.target

Перезапустите демон systemd:
```
systemctl daemon-reload
```
И включите службу:
```
systemctl enable bpium-s3.service
```

Установка Bpium BPM

Установите Redis
Распакуйте архив
- Файл должен лежать в папке и подпапках без русских символов
- Пользователю, от имени которого запускается приложение, должны быть даны права создавать файлы в папке Bpium
Настройте конфигурационный файл config.env Описание параметров.
Зарегистрируйте bpium-bpm как службу/демон, чтобы он запускался при старте системы

Запустите файл bpium-bpm-install-service.bat, он зарегистрирует Bpium BPM как службу Windows и запустит её. Имя службы: bpium-bpm.

Файл bpium-bpm-install-service.bat запустить от имени администратора (правой кнопкой мыши по имени файла и выбрать «Запустить от имени администратора»).

Установка пакета:

sudo apt-get install supervisor
sudo /etc/init.d/supervisor restart

В папке с Bpium создайте файл скрипта командой touch bpium-bpm-start.sh
В любом удобном редакторе напишите в файле скрипт:
```
#!/bin/bash
cd /path/to/bpium/folder
./bpium-bpm
```
Дайте файлу права на исполнение:
```
sudo chmod +x ./bpium-bpm-start.sh
```

Создайте конфигурационный файл демона «/etc/supervizor/conf.d/bpium-bpm.conf»:

[program:bpium-bpm]
command=/path/to/bpium-bpm
stdout_logfile=/var/log/bpium-bpm-out.log
stderr_logfile=/var/log/bpium-bpm-error.log
autostart=true
autorestart=true
startsecs=10
numprocs=1

Примените установленные настройки supervisor:
```
supervisorctl reread
supervisorctl update
```
Запустите службу:
```
supervisorctl start bpium bpm
```

В папке с Bpium создайте файл скрипта командой touch bpium-bpm-start.sh
В любом удобном редакторе напишите в файле скрипт:
```
#!/bin/bash
cd /path/to/bpium
./bpium-bpm
```
Дайте файлу права на исполнение:
```
sudo chmod +x bpium-bpm-start.sh
```

Создайте конфигурационный файл демона«/etc/systemd/system/bpium-bpm.service»:

[Unit]
Description=bpium-bpm-start
After=multi-user.target
After=bpium-s3.service
Requires=bpium-s3.service
[Service]
Type=idle
WorkingDirectory=/path/to/bpium
ExecStart=/path/to/bpium/bpium-bpm-start.sh
[Install]
WantedBy=multi-user.target

Перезапустите демон systemd:
```
systemctl daemon-reload
```
И включите службу:
```
systemctl enable bpium-bpm.service
```

Проверка системы

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

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

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

PreviousТребования NextУстановка через Docker

Last updated 11 months ago

Состав дистрибутива

Подготовка сервера

Доменное имя

SSL-сертификаты

Сервер приложения Bpium

Локальное хранилище Bpium S3

Фаервол

Для сервера c приложением Bpium

Установка и настройка зависимостей

Установка PostgreSQL

Требования:

Копирование данных из базы в облаке

Установка Redis

Установка Bpium

Установка Bpium S3

Установка Bpium BPM

Проверка системы