Установка Apache OFBiz CRM на Debian 10

О чём эта инструкция

Эта статья объясняет, как установить Apache OFBiz — модульную Java-платформу для ERP/CRM — на сервер с Debian 10. Подойдёт для системных администраторов, DevOps-инженеров и разработчиков, которые хотят развернуть OFBiz для тестирования или эксплуатации.

Важно: инструкция ориентирована на Debian 10 и OpenJDK 8 (AdoptOpenJDK). Если вы используете другую версию Debian/Ubuntu или планируете production-развёртывание, обратите внимание на раздел «Альтернативные подходы» и «Безопасность и hardening».

Основные требования (Кратко)

• Сервер с Debian 10, доступ по root или sudo-пользователю.
• Подключение к интернету для загрузки пакетов и архива OFBiz.
• Минимум 2–4 ГБ оперативной памяти для тестовой среды, для production — больше.

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

Перед началом рекомендуется обновить пакеты и перезагрузить систему.

apt-get update -y
apt-get upgrade -y

После обновления перезагрузите сервер, чтобы применить обновления ядра и сервисов.

Установка Java (OpenJDK 8)

OFBiz требует JDK 8. В Debian 10 Java 8 по умолчанию может отсутствовать в репозиториях, потому мы используем репозиторий AdoptOpenJDK.

Установите необходимые утилиты:

apt-get install apt-transport-https ca-certificates wget dirmngr gnupg software-properties-common unzip -y

Добавьте GPG-ключ и репозиторий AdoptOpenJDK:

wget -qO - https://adoptopenjdk.jfrog.io/adoptopenjdk/api/gpg/key/public | apt-key add -
add-apt-repository --yes https://adoptopenjdk.jfrog.io/adoptopenjdk/deb/
apt-get update -y
apt-get install adoptopenjdk-8-hotspot -y

Проверьте установленную версию Java:

java -version

Ожидаемый вывод (пример):

openjdk version "1.8.0_232"
OpenJDK Runtime Environment (AdoptOpenJDK)(build 1.8.0_232-b09)
OpenJDK 64-Bit Server VM (AdoptOpenJDK)(build 25.232-b09, mixed mode)

Если Java установлена, можно переходить к загрузке OFBiz.

Загрузка и установка Apache OFBiz

Скачайте архив стабильной версии OFBiz с официального репозитория Apache:

wget https://archive.apache.org/dist/ofbiz/apache-ofbiz-16.11.05.zip

Распакуйте архив и перейдите в каталог проекта:

unzip apache-ofbiz-16.11.05.zip
cd apache-ofbiz-16.11.05

Соберите проект и загрузите дефолтные данные:

./gradlew cleanAll loadDefault

Ожидаемый результат сборки (пример):

BUILD SUCCESSFUL

Total time: 2 mins 55.503 secs

This build could be faster, please consider using the Gradle Daemon: https://docs.gradle.org/2.13/userguide/gradle_daemon.html

Запуск Apache OFBiz и загрузка демоданных

Вы можете дополнительно загрузить seed-данные и демо-данные:

./gradlew "ofbiz --load-data readers=seed"
./gradlew "ofbiz --load-data readers=seed,seed-initial,ext"

Запустите сервер OFBiz:

./gradlew ofbiz

По умолчанию OFBiz слушает на порту 8443 для HTTPS. Если порт уже занят, вы увидите ошибку — см. раздел «Устранение неполадок».

Доступ к интерфейсу

Откройте браузер и перейдите по адресу:

https://your-server-ip:8443/ordermgr/control/main

Введите учётные данные по умолчанию:

• Логин: admin
• Пароль: ofbiz

После успешного входа вы увидите панель управления OFBiz:

Дополнительные интерфейсы:

• eCommerce: https://your-server-ip:8443/ecommerce

• WebTools: https://your-server-ip:8443/webtools/

• Catalog Manager: https://your-server-ip:8443/catalog

Частые проблемы и их решения

• Порт 8443 занят: проверьте ss -tulpn | grep 8443, остановите конфликтующий сервис или измените порт в файлах конфигурации OFBiz.
• Ошибки Gradle/сборки: убедитесь, что у вас достаточно RAM и свободного диска; удалите .gradle и запустите ./gradlew cleanAll снова.
• Проблемы с Java-версией: проверьте java -version; OFBiz требует JDK 8.

Альтернативные подходы

1. Docker: быстрый способ изолировать среду и зависимости. Пример Dockerfile / docker-compose (упрощённый):

version: '3'
services:
  ofbiz:
    image: openjdk:8-jdk
    volumes:
      - ./apache-ofbiz-16.11.05:/opt/ofbiz
    working_dir: /opt/ofbiz
    command: ./gradlew ofbiz
    ports:
      - "8443:8443"

2. Использовать пакетную сборку на CI (GitLab CI, Jenkins) и деплоить собранный WAR/JAR на отдельный JVM-хост.

3. Для production — внешняя база данных (PostgreSQL/MySQL) вместо встроенной Derby; см. документацию OFBiz для настройки datasource.

Безопасность и hardening

• Не используйте учётные данные по умолчанию в production. Немедленно смените пароль администратора.
• Разверните OFBiz за обратным прокси (nginx) с TLS terminate и настройками HSTS.
• Ограничьте доступ к административным URL по IP или через VPN.
• Периодически обновляйте Java и патчи безопасности системы.
• Для базы данных используйте сильные пароли и резервное копирование.

Контрольная чек-лист (роль-ориентировано)

• Системный администратор:
  • Обновил систему и установил Java 8.
  • Настроил автоматический запуск службы OFBiz (systemd unit).
  • Настроил брандмауэр (ufw/iptables) для ограничения доступа.
• DevOps/инженер по развёртыванию:
  • Настроил CI/CD для сборки OFBiz.
  • Подготовил конфигурацию для внешней БД.
  • Организовал мониторинг (CPU, RAM, JVM-графики).
• Разработчик:
  • Проверил работу WebTools и загрузку seed-данных.
  • Протестировал ключевые процессы заказов и каталога.

Мини‑методология развёртывания (шаги)

1. Подготовка: резервная копия, обновление системы.
2. Установка зависимостей: Java, unzip, wget.
3. Загрузка и сборка OFBiz: ./gradlew cleanAll loadDefault.
4. Тестовый запуск и верификация доступа.
5. Перевод в production: внешняя БД, TLS, мониторинг, бэкапы.

Критерии приёмки

• Сервис OFBiz стартует без ошибок и отображает BUILD SUCCESSFUL после сборки.
• Доступ к /ordermgr/control/main по HTTPS возвращает страницу логина.
• Пользователь admin входит с новым паролем (если сменён).
• Базовые сценарии (создание товара, создание заказа) выполняются успешно.

Пример runbook для инцидента: OFBiz не стартует

1. Проверить логи: runtime/logs/ofbiz.log и системный журнал.
2. Проверить занятые порты: ss -tulpn | grep 8443.
3. Убедиться в версии Java: java -version.
4. Попробовать запустить вручную в foreground: ./gradlew ofbiz --no-daemon и скопировать ошибку.
5. При проблемах с БД — проверить доступность сервера БД и креды.
6. При необходимости откатить к последней рабочей версии из бэкапа.

Небольшая диаграмма принятия решения (когда использовать Docker)

flowchart TD
  A[Нужен быстрый тест или изоляция?] -->|Да| B[Используйте Docker]
  A -->|Нет| C[Устанавливайте на хостную систему]
  B --> D[Монтируйте volume для данных]
  C --> E[Настройте systemd и бэкапы]

Короткий глоссарий (1 строка каждое)

• OFBiz: модульная ERP/CRM-платформа на Java от Apache.
• seed-данные: стартовый набор данных для демонстрации функциональности.
• Gradle: инструмент сборки проекта Java.
• AdoptOpenJDK: сборки OpenJDK от сообщества.

Тестовые сценарии (приёмка)

• Успешная загрузка страницы логина по HTTPS.
• Создание каталога и товара, отображение в eCommerce.
• Создание и выполнение простого заказа.

Заключение

Поздравляем — Apache OFBiz успешно установлен и запущен на Debian 10. Вы получили рабочее окружение с административной панелью, eCommerce-модулем и инструментами разработчика. Для production рекомендую настроить внешнюю базу данных, разместить OFBiz за обратным прокси и настроить мониторинг и резервное копирование. Если нужны примеры systemd unit, конфигурации nginx или сценарии миграции БД — напишите, и я предоставлю шаблоны.

Важно: обязательно смените учетные данные по умолчанию и защитите доступ к административным URL.

Примечания

• Команды в статье выполняйте под sudo или от root.
• Версии ПО со временем меняются; проверяйте официальную документацию OFBiz и AdoptOpenJDK для актуальных релизов.