Установка

Объяснительная записка

С начала и на протяжении нескольких лет дистрибутив Eludia.pm поддерживался в формате CPAN-модуля. Однако с течением времени у такого подхода выявилось несколько серьёзных недостатков:

• задержка публикации примерно в сутки (нельзя использовать CPAN.pm для горячих обновлений на рабочих серверах);
• трудности с необщесистемной (локальной) установкой (например, в тех случаях, когда требуется законсервировать одно из приложений в комплекте с устаревающей версией ядра).

Кроме того, Eludia.pm содержит наборы иконок и прочих статических файлов для нескольких вариантов дизайна, а CPAN вовсе не предназначен для хранения таких материалов.

Так что сегодня Eludia.pm — это просто директория, упоминаемая в @INC:

• в параметрах запуска perl — ключом -I;
• в исходных текстах — прагмой lib.

В частности, в файле конфигурации приложения путь к ядру удобнее всего задавать следующим образом:

<perl>
 
 use lib '/path/to/core';

 ...

</perl>

Сейчас актуальные версии Eludia.pm доступны на github.

С чего начать

Прежде всего, убедитесь, что у Вас в системе установлен perl:

perl -v

версии не ниже 5.8. Если нет — установите или обновите.

Кроме того, обеспечьте наличие клиентского интерфейса к выбранной Вами СУБД и DBD-драйвера для неё. Под Windows рекомендуется использовать DBD::ODBC и, соответственно, ODBC-драйверы.

Директория ядра

Теперь настоятельно рекомендуем установить систему контроля версий git. Для Windows имеется отличная визуальная оболочна Tortoisegit, интегрированная с Windows Explorer.

Если вы поступите так, то достаточно будет создать пустую директорию и склонировать в неё

git://github.com/do-/eludia.git

Тогда у вас появится копия ядра Eludia.pm, которую в дальнейшем можно будет обновлять командой:

git pull origin master

Вы сможете легко модифицировать код ядра (например, вставляя отладочную печать). Возможно, Вы найдёте ошибку или реализуете новую функцию — тогда, если Вам будет не жаль поделиться своим усовершенствованием, Вы сможете послать нам свой patch письмом. Или вести собственную ветку, периодически подгружая свежие изменения из основного репозитория. Ничто не мешает поддерживать произвольное количество директорий-клонов для разных приложений: скажем, базовое ядро, экспериментальный вариант и какие-либо другие.

Если же Вы принципиально не пожелаете связываться с git, нет проблем — .zip или .tar.gz с актуальной версией всех файлов также доступны.

Команда поддержки

Предположим, Вы разместили ядро в некоторой директории. Теперь Вы можете воспользоваться интерактивными командами из модуля Eludia::Install. Вызываются они так:

perl -I директория ядра -MEludia::Install -e команда

Если директория ядра единственная (или одна из таких директорий явно будет использоваться чаще других) стоит облегчить себе жизнь путём малой механизации. Под Winows следует разместить где-нибудь в PATH файл с именем ins.bat следующего содержания:

perl -I директория ядра -MEludia::Install -e %1 %2 %3 %4 %5 %5 %6 %7 %8 %9

а под UNIX/Linux — прописать одноимённый синоним в .bashrc или разработать аналогичный скрипт на Вашем любимом *sh.

Прокачка модулей

Теперь установим модули, необходимые (или просто полезные) для работы Eludia.pm.

Если Ваша инсталляция perl подключена к CPAN (для большинства UNIX/Linux или Strawberry Perl под Windows), то отдайте команду

 ins cpan

Если же у Вас ActivePerl (в основном актуально для Windows, хотя возможны и другие платформы. В частности, это вариант по умолчанию для HP UX 11.3) — то

 ins ppm

На вопросы отвечайте утвердительно, предупреждения игнорируйте.

Описанную процедуру имеет смысл периодически повторять (во всяком случае, после обновления ядра): тогда у Вас будут свежие версии всех нужных модулей.

Создание директории приложения

Далее создадим экземпляр приложения: нового или существующего:

 ins create

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

• создание схемы БД и пользователя с необходимыми правами на неё;
• создание директории приложения;
  • git-клонирование файлов, требующих версионного контроля (в том числе .gitignore);
  • создание директорий, находящихся вне версионного контроля, в том числе conf;
    • создание конфигурационного файла conf/httpd.conf со всеми необходимыми параметрами.

Если Вы настраиваете копию приложения, возможно, после описанных действий имеет смысл скопировать данные в новую схему БД.

Остаётся настроить WEB-сервер.

Подключение WEB-сервера

Eludia.pm может использоваться совместно с несколькими WEB-серверами в различных конфигурациях. Их описания приведены в соответствующем разделе. Выбор конкретного решения определяется используемой платформой и требованиями совместимости со сторонним ПО для каждого отдельного проекта.

Для ОС UNIX/Linux на сегодня оптимальной представляется конфигурация с нулевым временем перезапуска, использующая "тяжёлый" Apache/mod perl для динамического содержимого и "лёгкий" nginx для статики.

Для ОС Windows, пожалуй, наиболее перспективным является использование стандартного IIS, куда Perl подключается при помощи ActiveState PerlEx.