Просмотр исходного текста страницы Установка

{{RightTOC}}
== Объяснительная записка ==

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

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

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

Так что сегодня Eludia.pm — это просто директория, упоминаемая в @INC:
* в параметрах запуска perl — ключом '''-I''';
* в исходных текстах — прагмой [http://perldoc.perl.org/lib.html lib].

В частности, в [[Директории#conf/httpd.conf|файле конфигурации приложения]] путь к ядру удобнее всего задавать следующим образом:

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

Сейчас актуальные версии Eludia.pm доступны [http://github.com/do-/eludia на github].

== С чего начать ==

Прежде всего, убедитесь, что у Вас в системе установлен [http://www.cpan.org/ perl]:

 perl -v

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

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

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

Теперь настоятельно рекомендуем установить систему контроля версий [http://git-scm.com/ git]. Для Windows имеется отличная визуальная оболочна [http://code.google.com/p/tortoisegit/ Tortoisegit], интегрированная с Windows Explorer.

Если вы поступите так, то достаточно будет создать пустую директорию и [http://www.kernel.org/pub/software/scm/git/docs/git-clone.html склонировать] в неё

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

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

 [http://www.kernel.org/pub/software/scm/git/docs/git-pull.html git pull] origin master

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

Если же Вы принципиально не пожелаете связываться с git, нет проблем — [http://github.com/do-/eludia/zipball/master .zip] или [http://github.com/do-/eludia/tarball/master .tar.gz] с актуальной версией всех файлов также доступны.

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

Предположим, Вы разместили ядро в некоторой директории. Теперь Вы можете воспользоваться интерактивными командами из модуля [[:Категория:Интерактивные команды Eludia::Install|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#ins|синоним в .bashrc]] или разработать аналогичный скрипт на Вашем любимом [http://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D0%BD%D0%B0%D1%8F_%D0%BE%D0%B1%D0%BE%D0%BB%D0%BE%D1%87%D0%BA%D0%B0_UNIX *sh].

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

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

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

 [[#Команда поддержки | ins]] [[cpan]]

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

 [[#Команда поддержки | ins]] [[ppm]]

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

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

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

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

 [[#Команда поддержки | ins]] [[create]]

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

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

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

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

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

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

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

Для ОС Windows, пожалуй, наиболее перспективным является использование стандартного [[IIS]], куда Perl подключается при помощи ActiveState [http://docs.activestate.com/activeperl/5.10/PerlEx/Welcome.html PerlEx].

[[Категория:Администрирование]]