Описание процедуры установки ERP5 под Ubuntu, Debian и другие дистрибутивы Linux, основанные на Debian

^{in English}

Информация для любопытных: Почему существует Raskon ERP5 buildout, если есть официальный buildout?

Установка

Хотя многие пользователи более знакомы с графическим интерфейсом Synaptic (​UbuntuHelp:SynapticHowto), ниже для простоты описания и удобства ввода (Copy|Paste) будут приведены в основном терминальные команды. Их исполнение требует привилегированных прав, поэтому используется команда Sudo (​WikiPediaRu:Sudo), дающая возможность пользователям выполнять команды от имени root. Sudo попросит ввести Ваш пользовательский пароль после нажатия Enter.

Для установки ERP5 Вы можете воспользоваться одним из двух приведенных ниже вариантов

• Установка из пакета (​WikiPedia:'Software_package_(installation)')
• или Установка через buildout (​WikiPedia:Buildout).

В сущности между этими вариантами незначительная разница, так при установке из пакета buildout скачивается и затем запускается. Установка из пакета имеет следующие преимущества:

• установка через buildout не включает 'MariaDB' и 'Sphinxsearch'. Как следствие этого в установленной этим способом ERP5 не будет полнотекстового поиска.
• установка из пакета включает пакеты для 'MariaDB' and 'Sphinxsearch'( ​http://www.raskon.org/apt/build_logs). В результате в установленной ERP5 будет работать полнотекстовый поиск.
• для изоляции пользователя пакет создает пользователя "erp5"
• пакет создает все необходимые зависимости автоматически
• пакет содержит скрипт, который автоматически запускает ERP5 после перезапуска системы.

Установка Из Пакета

В дистрибутивах Debian и Debian-based, в том числе и в Ubuntu, используется утилита для установки, обновления и удаления пакетов, известная как APT (advanced packaging tool). APT дает возможность автоматически устанавливать все необходимые зависимости для конкретного пакета и обновлять его, сканируя APT репозитории.

1. Откройте терминальное окно Applications->Accessories->Terminal (​UbuntuHelp:UsingTheTerminal).
2. Затем добавьте ключ от репозитория в список доверенных APT ключей Вашей системы, скопировав и вставив в окно терминала следующую строку:

   wget -q https://www.raskon.org/apt/33C009CD.gpg -O- | sudo apt-key add -
   

3. Теперь добавьте сам репозиторий в список источников пакетов, используемых APT:

   echo deb http://erp5.raskon.org/apt `lsb_release --short --codename` main | sudo tee /etc/apt/sources.list.d/erp5.list
   

4. Обновите информацию о APT пакетах:
   • выполнив команду:

     sudo apt-get update
     

   • или в Synaptic (​UbuntuHelp:SynapticHowto)
5. Теперь вы можете установить ERP5 'нажав на ссылку' ​AptInstallation:erp5-buildout .
   • в качестве альтернативы, вы можете установить ERP5 через Synaptic, предварительно выполнив в нем поиск пакета erp5-buildout.
   • еще один способ установки ERP5 - в Applications->Add/Remove найти erp5-buildout и подтвердить его установку. Подробная информация о процедуре установки программ под Ubuntu находится в Community Ubuntu Documentation (​UbuntuHelp:InstallingSoftware).
6. Для создания в ERP5 отчетов в формате ODT (​WikiPediaRu:OpenDocument) должен быть установлен OOOD пакет, что можно сделать нажатием на ссылку ​AptInstallation:oood.
7. Переходите к Созданию новой ERP5 базы.

Установка через buildout

Хотя buildout был проверен на "чистом" Ubuntu 10.04 (Lucid Lynx) описанная процедура может быть использована для любого Debian-дистрибутива.

Убедитесь, что у вас установлены следующие пакеты:

• mercurial
• git
• subversion
• python-dev
• libssl-dev
• libxslt-dev
• libldap2-dev
• mysql
• mysql-client
• mysql-dev
• subversion
• psmisc
• build-essential
• procps

Для этого вы можете воспользоваться командой, которая установит все вышеперечисленные зависимости, если они не были у вас установлены до этого:

sudo apt-get install mercurial git subversion python-dev libssl-dev libxslt-dev mysql mysql-client mysql-dev libldap2-dev subversion psmisc build-essential procps

Создайте клон репозитория buildout:

hg clone http://www.raskon.org/hg/erp5-buildout

Сконфигурируйте buildout:

cd erp5-buildout
cp buildout.cfg.template buildout.cfg

Запустите buildout:

python -S bootstrap.py
bin/buildout

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

Если выполнение buildout остановится с сообщением об ошибке, велика вероятность, что некоторые зависимости все таки не установлены. Это связано с тем, что список зависимостей приведенный выше не совсем полный. Если это произошло, пожалуйста напишите на ​ERP5-users mailing list

После завершения выполнения предыдущей команды, запустите сервер:

bin/instance start

Укажите в навигации вашего браузера [host]:8080/manage и переходите к Созданию новой ERP5 базы.

Создание новой ERP5 базы

Создайте MySQL базу данных::

echo "CREATE DATABASE IF NOT EXISTS erp5 CHARACTER SET utf8;" ;
echo "GRANT ALL PRIVILEGES ON erp5.* TO erp5@localhost IDENTIFIED BY 'ERP5_PASSWORD' WITH GRANT OPTION;" ) | mysql -u root -p

В процессе выполнения вышеуказанных запросов необходимо будет ввести пароль root'а в MySQL.

После этого нужно загрузить Zope по ссылке: ​http://localhost:8080/ . Доступ к Zope Manager Interface, так называемому ZMI, можно получить через url : ​http://localhost:8080/manage_main , Zope попросит ввести имя пользователя (по умолчанию - admin) и пароль (по умолчанию - admin).

На странице ZMI расположено раскрывающееся меню, где нужно выбрать "ERP5 Site" и нажать 'Add'. В появившемся окне нужно ввести несколько параметров::

erp5 erp5 ERP5_PASSWORD

После задания параметров, выберите "Create a new ERP5 Site instance". Процесс создания новой ERP5 базы может занять некоторое время.

Свершилось! ERP5 база доступна по ссылке ​http://localhost:8080/erp5 . Пора установить Бизнес Модули (Business Тemplates), которые определят функционал Вашей ERP5.

Изменение номера порта для ERP5

Этот раздел приведен для тех пользователей, у которых на порт 8080 уже установлено другое приложение.

1. Откройте терминальное окно Applications->Accessories->Terminal (​UbuntuHelp:UsingTheTerminal).
2. Скопируйте и вставьте в окно терминала следующую строку, предварительно заменив "YOUR_NEW_PORT_NUMBER" на желаемый номер.

   sudo sed -i -e 's/#http-address = 80/http-address =  YOUR_NEW_PORT_NUMBER/' /home/erp5/erp5-buildout/buildout.cfg
   

   Однако, если вы уже меняли порт для ERP5, то следует запустить нижеследующую команду, предварительно заменив "YOUR_PORT_NUMBER" на номер порта, на который уже установлена ERP5..

   sudo sed -i -e 's/http-address = YOUR_PORT_NUMBER/http-address =  YOUR_NEW_PORT_NUMBER/' /home/erp5/erp5-buildout/buildout.cfg
   

3. После выполнения предыдущих команд переустановите ERP5:

   sudo -H -u erp5 /home/erp5/erp5-buildout/bin/buildout -v -t 5
   

4. Теперь необходимо перезапустить ERP5 Buildout:

   sudo /etc/init.d/erp5-buildout restart
   

Установка Бизнес Модулей (Business Templates) из репозиториев

ERP5' Business Template (краткое название "bt5") - это часть программы, которая в других ERP системах обычно называется Модулем (​Enterprise_resource_planning#Modularity). Установка любого Business Template добавляет бизнес- или базовую функциональность в ERP5. К примеру erp5_base и erp5_core необходимы для получения базовой функциональности, а erp5_accounting, erp5_crm, erp5_budget позволяют использовать ERP5 для бухгалтерского учета, CRM и бюджетирования соотвественно. В ERP5 также присутствует понятие Module, но это совершенно иная сущность, чем обычный Модуль в ERP системе, что приводит к путанице. В ERP5 в Module хранятся схожие ERP5 документы, аналогично тому, как в Папках хранятся файлы на диске. Business Template может зависеть от других bt5, поэтому во время установки бизнес темплейтов появляются сообщения со списком bt5, которые должны были быть установлены ранее выбранного.

1. Откройте url ​http://localhost:8080/erp5 в web-браузере.
2. Выберите "Manage Business Templates" из "My favourites" меню в левом верхнем углу страницы.
3. Нажмите на иконку "Import / Export":

   

4. Для обновления информации в репозиториях: в поле "Select Exchange" выберите "Update Repositories Informations", в поле "Repositories" вы должны увидеть

   /home/erp5/erp5-buildout/erp5/products/ERP5/bootstrap/
   /home/erp5/erp5-buildout/erp5/bt5
   

5. Нажмите кнопку "Update Repository Information".
6. После обновления информации можно установить Бизнес Модули. Для этого выберите "Install Business Template from Repositories" в поле "Select Exchange". В появившемся списке Бизнес Модулей отметьте необходимые Вам галочкой и нажмите на кнопку "Install Business Templates from Repositories button" внизу экрана ... и проявите терпение.

Обновление ERP5 на новую версию

1. Откройте терминальное окно Applications->Accessories->Terminal (​UbuntuHelp:UsingTheTerminal).
2. Перейдите в ERP5 Buildout директорию

   cd /home/erp5/erp5-buildout
   

3. Загрузите изменения из удаленного репозитория в локальный. Команда, приведенная ниже найдет все изменения в репозитории

   sudo -u erp5 hg pull
   

4. Обновите рабочую директорию:

   sudo -u erp5 hg up
   

5. Для обновления исходников ERP5 запустите следующую команду:

   sudo -H -u erp5 bin/buildout -v -t 5
   

6. Если вы хотите обновить все содержимое ERP5 Buildout выполните:

   sudo -H -u erp5 bin/buildout install Erp5Fetch
   

7. Перезапустите ERP5 сервер:

   sudo /etc/init.d/erp5-buildout restart
   

Переход на новую версию Ubuntu (upgrade Ubuntu)

Если Вы полностью обновляете систему, например обновляете Ubuntu с версии 7.10 на 8.04, необходимо выполнить нижеследующие команды на новой версии ОС. Это необходимо, потому что встроенный update manager не сможет переключить ERP5 репозитории автоматически:

echo deb http://erp5.raskon.org/apt `lsb_release --short --codename` main | sudo tee /etc/apt/sources.list.d/erp5.list
sudo apt-get update 

Во время установки / обновления возникли ошибки?

1. Загляните на страницу с описанием возможных прблем Erp5troubleShootingRu.
2. Поищите аналогичный вопрос в email рассылке ​ERP5-users mailing list archive and ​ERP5-developers mailing list archive.
3. Если рекомендаций по исправлению ошибки нет, пожалуйста сообщите об этом на ​ERP5-users mailing list. Если вы решили проблему самостоятельно и хотите помочь другим, напишите в рассылку или на адрес bk@…

Изучите документацию

• ​http://www.erp5.org/HowTo
• ​http://en.wikibooks.org/wiki/ERP5_Handbook/Getting_Started

Исходный код

Исходники можно найти по url: ​Raskon.