Как установить Openbravo ERP на Debian Etch

Кратко: пошаговое практическое руководство по установке Openbravo ERP на Debian Etch с настройкой PostgreSQL, Sun JDK, Tomcat и Ant. Следуйте разделам подготовки, установки и проверки; в конце — контрольный список, сценарии устранения неполадок и рекомендации по безопасности.

Введение

Версия 1.0
Автор: Oliver Meyer

Этот документ описывает практическую установку Openbravo ERP (система управления предприятием) на Debian Etch. Openbravo — это открытое ERP‑решение для малого и среднего бизнеса с веб‑интерфейсом; включает закупки, склад, проекты, производство и финансы. Полный список возможностей смотрите на http://www.openbravo.com/product/product-features/.

Важно: это практическое руководство без гарантий. Вариантов установки много — ниже описан один из рабочих подходов.

Основные понятия

• Openbravo ERP — веб‑ориентированная ERP‑система для МСП.
• Debian Etch — релиз Debian GNU/Linux (в контексте этого руководства целевая ОС).
• PostgreSQL — СУБД, используемая Openbravo.
• Tomcat — контейнер сервлетов для запуска веб‑приложения.
• Sun Java JDK — необходимая JVM для Openbravo и сборки.

1 Подготовка

1.1 Репозиторий Debian Backports

Репозиторий backports понадобятся для установки пакета Sun JDK.

Откройте файл источников APT:

vi /etc/apt/sources.list

Добавьте строку:

# Debian Backports
deb http://www.backports.org/debian etch-backports main contrib non-free

Обновите индексы пакетов:

apt-get update

Импортируйте GPG‑ключ для backports:

apt-get install debian-backports-keyring

1.2 Необходимые пакеты

Ниже описаны пакеты и их базовая настройка. Все команды выполняйте под root или с sudo.

1.2.1 PostgreSQL

Установите PostgreSQL 8.2:

apt-get install postgresql-8.2

Изменим временно метод аутентификации, чтобы задать пароль администратора:

sed -i 's/ident sameuser$/trust/' /etc/postgresql/8.2/main/pg_hba.conf  
/etc/init.d/postgresql-8.2 restart

Откройте psql и задайте пароль для пользователя postgres (замените %new_PostgreSQL_admin_passowrd% на надёжный пароль):

psql -U postgres  
alter role postgres with password '%new_PostgreSQL_admin_passowrd%';  
\q

Верните метод аутентификации в md5 и перезагрузите конфиг:

sed -i 's/trust$/md5/' /etc/postgresql/8.2/main/pg_hba.conf  
/etc/init.d/postgresql-8.2 reload

Примечание: если у вас уже есть корпоративный экземпляр PostgreSQL, примените соответствующие настройки доступа и бэкапа.

1.2.2 Java JDK

Установите Sun JDK (пакет из backports):

apt-get install sun-java6-jdk

Сделайте JDK доступным в системе и задайте JAVA_HOME:

update-java-alternatives -s java-6-sun  
echo 'JAVA_HOME="/usr/lib/jvm/java-6-sun"' | tee -a /etc/environment

Выйдите из сессии и войдите снова, чтобы переменные окружения вступили в силу.

1.2.3 Apache Tomcat

Установите Tomcat 5.5 и служебные пакеты:

apt-get install tomcat5.5 tomcat5.5-admin tomcat5.5-webapps

Измените поведение демона Tomcat, удалите большой лог при необходимости и отключите режим безопасности init‑скрипта:

rm /var/log/tomcat5.5/catalina.out  
vi /etc/init.d/tomcat5.5

В файле замените:

TOMCAT5_SECURITY=yes

На:

TOMCAT5_SECURITY=no

Перезапустите Tomcat:

/etc/init.d/tomcat5.5 restart

Проверьте, что Tomcat слушает порт 8180 (по умолчанию в этом сценарии):

netstat -tap | grep java

Ожидаемая строка (пример):

tcp6 0 0 *:8180 *:* LISTEN 3571/java

Если нужно, задайте системные переменные Tomcat:

echo 'CATALINA_HOME="/usr/share/tomcat5.5"' | tee -a /etc/environment  
echo 'CATALINA_BASE="/var/lib/tomcat5.5"' | tee -a /etc/environment  
echo 'CATALINA_OPTS="-server -Xms384M -Xmx512M"' | tee -a /etc/environment

Снова выйдите и войдите, чтобы применить переменные.

1.2.4 Apache Ant

Ant обычно устанавливается как зависимость, но нужно задать ANT_HOME:

echo 'ANT_HOME="/usr/share/ant"' | tee -a /etc/environment

Выйдите и войдите снова для применения.

2 Установка Openbravo

2.1 Загрузка дистрибутива

Проверьте на SourceForge актуальную версию Openbravo: http://sourceforge.net/projects/openbravo/. На момент написания это был 2.35mp1.

Скачайте инсталлятор и сделайте его исполняемым:

cd /tmp/  
wget http://mesh.dl.sourceforge.net/sourceforge/openbravo/OpenbravoERP-2.35-MP1-linux-installer.bin  
chmod +x OpenbravoERP-2.35-MP1-linux-installer.bin

2.2 Запуск текстового установщика

Запустите инсталлятор в текстовом режиме:

./OpenbravoERP-2.35-MP1-linux-installer.bin

В процессе установки несколько раз нажимайте Enter, чтобы просмотреть лицензию, и введите “yes” при согласии.

Рекомендуемые ответы на вопросы установщика (по умолчанию):

• Директория установки: /opt/OpenbravoERP — нажмите Enter.
• Директория вложений: /opt/OpenbravoERP/AppsOpenbravo/attach — Enter.
• Тип установки: Full (standard) — Enter.
• База данных: PostgreSQL — выберите.
• JAVA_HOME: /usr/lib/jvm/java-6-sun — Enter.
• ANT_HOME: /usr/share/ant — Enter.
• Tomcat: /var/lib/tomcat5.5 — Enter.
• Веб‑домен сервера: введите ваш домен (например server1.example.com).
• HTTP‑порт: 8180 — введите 8180.
• Context name: openbravo — Enter.
• Директория бинарников PostgreSQL: /usr/bin — введите /usr/bin.
• DB сервер: localhost — Enter.
• Порт PostgreSQL: 4532 — Enter.
• Имя базы данных: openbravo — Enter.
• Пароль администратора PostgreSQL: введите пароль, который вы задали ранее.
• Openbravo DB user: tad — Enter для имени пользователя по умолчанию.
• Пароль для пользователя tad: введите и подтвердите.
• В конце введите “y” для запуска установки — процесс займёт время.

Скрипт установит и настроит базу, развернёт приложение и выполнит первичную сборку.

2.3 Веб‑интерфейс

После завершения установки Openbravo доступен по адресу:

http://%servername%:8180/openbravo

Войдите под пользователем:

• Логин: Openbravo
• Пароль: openbravo

3 Ссылки и документация

• Debian: http://www.debian.org/
• Openbravo: http://www.openbravo.com/
• Openbravo user manual: http://wiki.openbravo.com/wiki/User_Manual_2.3

Контрольный список перед сдачей в эксплуатацию

• PostgreSQL настроен и защищён (md5, бэкапы).
• Sun JDK установлен и JAVA_HOME задан.
• Tomcat запущен и слушает нужный порт.
• ANT установлен и ANT_HOME задан.
• Openbravo успешно запустился и доступен по HTTP.
• Выполнено тестовое логирование в систему (вход/создание документа).

Что делать, если что‑то пошло не так

• Tomcat не стартует: проверьте /var/log/tomcat5.5/catalina.out и системный лог. Часто причина — нехватка памяти или конфликт портов.
• Ошибки сборки Openbravo (Ant): убедитесь, что JAVA_HOME и ANT_HOME корректны, и что в PATH доступен /usr/bin/java.
• Не удаётся подключиться к PostgreSQL: проверьте /etc/postgresql/8.2/main/pg_hba.conf и порт, используемый сервером.
• Проблемы с кодировкой/локалью: убедитесь, что база создана с поддержкой UTF‑8 при необходимости.

Важно: логируйте все изменения конфигурации и делайте резервные копии базы и каталога установки перед обновлениями.

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

• Установка из исходников: вместо bin‑инсталлятора можно собрать Openbravo из исходников — пригодится, если нужен контроль версий или кастомизация.
• Контейнеризация: на современных системах предпочтительнее запускать Openbravo в контейнере (Docker), чтобы изолировать зависимости.
• Другие версии ПО: если вы используете более новые релизы Debian, применяйте соответствующие версии PostgreSQL и Tomcat (совместимость проверить в документации Openbravo).

Безопасность и эксплуатация

• Изолируйте базу данных и веб‑сервер в отдельных хостах/сетях при продакшне.
• Настройте TLS/HTTPS (используйте обратный прокси Nginx или Apache httpd в SSL) — не оставляйте веб‑интерфейс по HTTP в публичной сети.
• Ограничьте доступ к порту PostgreSQL фаерволом.
• Настройте регулярные резервные копии базы данных и файлов приложений.

Совместимость и миграция

• Обратите внимание на версии PostgreSQL и Tomcat, поддерживаемые вашей версией Openbravo. Переход на более новые версии ОС/СУБД может потребовать выполнения миграционных сценариев Openbravo.

Роли и обязанности (коротко)

• Системный администратор: установка и поддержка ОС, Java, Tomcat, бэкапы.
• DBA: настройка PostgreSQL, резервное копирование, восстановление.
• Администратор приложения: конфигурация Openbravo, управление пользователями, обновления.

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

• Система успешно развёрнута и доступна по адресу приложения.
• Пользователь Openbravo может выполнить базовый рабочий сценарий (вход, создание документа).
• Резервное копирование настроено и протестировано на восстановление.

Глоссарий (в одну строку)

• JDK — Java Development Kit, реализация Java для запуска и сборки.
• Tomcat — контейнер сервлетов Apache Tomcat.
• Ant — инструмент сборки Java‑проектов.
• PostgreSQL — реляционная СУБД.

Резюме

Это практическое руководство даёт шаги для установки Openbravo ERP на Debian Etch: настройка backports, PostgreSQL, Sun JDK, Tomcat и Ant, запуск инсталлятора и первоначальная проверка веб‑интерфейса. Дополнительно приведён контрольный список, сценарии устранения неполадок и рекомендации по безопасности.

Примечание

Важно: перед внедрением в продуктив выполните тестовую установку и настройте резервное копирование. Обновления Openbravo и компонентов требуют планирования и тестирования.