Установка Xapian в домашний каталог
Материал из DiPHOST.Ru wiki system
Schors (Обсуждение | вклад) |
Schors (Обсуждение | вклад) |
||
(16 промежуточных версий не показаны.) | |||
Строка 5: | Строка 5: | ||
[http://xapian.org Xapian] - библиотека поискового механизма с открытым исходным кодом, написанная на C++. Используется например для поиска по группам Google. Имеет интерфейсы к популярным языками программирования Python, Perl, Php, Tcl. Для встраивания поиска на сайт используется программа [http://xapian.org/docs/omega/overview.html Omega] | [http://xapian.org Xapian] - библиотека поискового механизма с открытым исходным кодом, написанная на C++. Используется например для поиска по группам Google. Имеет интерфейсы к популярным языками программирования Python, Perl, Php, Tcl. Для встраивания поиска на сайт используется программа [http://xapian.org/docs/omega/overview.html Omega] | ||
+ | Для установки релиза Xapian в домашний каталог на нашем хостинге, требуется скачать пакеты со страницы [http://xapian.org/download http://xapian.org/download] | ||
+ | * xapian-core: библиотека Xapian | ||
+ | * omega: Omega - библиотека индексации и CGI-интерфейс к ней | ||
+ | * xapian-bindings: интерфейсы к различным языкам программирования | ||
+ | * Search::Xapian: интерфейс к языку Perl | ||
+ | Установку следует делать через консоль [[AccessSSH|SSH]]. | ||
+ | {{warning|На нашем хостинге не предусмотрена работа с Xapian из PHP}} | ||
+ | ====Установка библиотеки Xapian==== | ||
+ | Требуется распаковать архив дистрибутива xapian-core и перейти в каталог с распакованным дистрибутивом. Для конфигурации установки, вызовите скрипт configure со следующими ключами: | ||
+ | |||
+ | ./configure --prefix=/home/{{hl|ваш_логин}} | ||
+ | |||
+ | Затем, нужно просто "собрать" и установить программу двумя командами: | ||
+ | |||
+ | gmake | ||
+ | gmake install | ||
+ | |||
+ | |||
+ | {{info|Утилита xapian-config, используемая в установках сопутствующих программ и библиотек, возможно поставится и не по пути /home/{{hl|ваш_логин}}/bin/xapian-config. Требуется проверить это. Но на момент написания инструкции он ставился именно туда}} | ||
+ | |||
+ | ====Установка интерфейса к Perl==== | ||
+ | Требуется распаковать архив дистрибутива Search::Xapian и перейти в каталог с распакованным дистрибутивом. Для конфигурации установки, вызовите следующую команду: | ||
+ | |||
+ | perl XAPIAN_CONFIG=/home/{{hl|ваш_логин}}/bin/xapian-config INSTALL_BASE=/home/{{hl|ваш_логин}} | ||
+ | |||
+ | Затем, как и в предыдущем случае, нужно просто "собрать" и установить программу двумя командами: | ||
+ | |||
+ | gmake | ||
+ | gmake install | ||
+ | |||
+ | |||
+ | =====Настройка консоли для работы с интерфейсом к Perl===== | ||
+ | |||
+ | Для того, чтобы интерпретатор Perl, вызванный из консоли, "видел" установленные локально библиотеки, добавьте в файл .profile следующие строки: | ||
+ | <source lang="sh"> | ||
+ | PERL5LIB=$HOME:$HOME/lib:$HOME/lib/perl5 | ||
+ | export PERL5LIB | ||
+ | </source> | ||
+ | |||
+ | Не забудьте "перелогиниться" после добавления, чтобы настройки применились. | ||
+ | Для проверки следует набрать в консоли: | ||
+ | perldoc Search::Xapian | ||
+ | |||
+ | Если всё сделано правильно, то на экран будет выведена страница документации модуля. | ||
+ | |||
+ | =====Настройка веб-сервера apache для работы с интерфейсом к Perl===== | ||
+ | |||
+ | В файл .htaccess в корневом каталоге сайта или в том каталоге, где будут cgi-скрипты, добавить строку: | ||
+ | SetEnv PERL5LIB /home/{{hl|ваш_логин}}:/home/{{hl|ваш_догин}}/lib:/home/{{hl|ваш_логин}}/lib/perl5 | ||
+ | |||
+ | |||
+ | ====Установка интерфейса к Python==== | ||
+ | Требуется распаковать архив дистрибутива xapian-bindings и перейти в каталог с распакованным дистрибутивом. Для конфигурации установки, вызовите следующую команду: | ||
+ | |||
+ | ./configure --prefix=/home/{{hl|ваш_логин}} --with-python XAPIAN_CONFIG=/home/{{hl|ваш_логин}}/bin/xapian-config \ | ||
+ | PYTHON_LIB=/home/{{hl|ваш_логин}}/lib/python2.5/site-packages/ | ||
+ | |||
+ | {{info|Путь PYTHON_LIB выбран нами в соответствии с нашими внутренними соглашениями. Однако, он может быть изменён по Вашему желанию}} | ||
+ | |||
+ | =====Настройка консоли для работы с интерфейсом к Python===== | ||
+ | Для того, чтобы интерпретатор Python, вызванный из консоли, "видел" установленные локально библиотеки, добавьте в файл .profile следующие строки: | ||
+ | <source lang="sh"> | ||
+ | PYTHONPATH=$HOME:$HOME/lib:$HOME/lib/python2.5:$HOME/lib/python2.5/site-packages | ||
+ | export PYTHONPATH | ||
+ | </source> | ||
+ | Собственно, в переменной PYTHONPATH должен оказаться путь, который был указан в переменной PYTHON_LIB в инструкции установки. | ||
+ | Не забудьте "перелогиниться" после добавления, чтобы настройки применились. | ||
+ | |||
+ | Для проверки следует войти в интерпретатор Python и набрать: | ||
+ | <source lang="py"> | ||
+ | import xapian | ||
+ | </source> | ||
+ | Если всё сделано верно, то интерпретатор не выдаст ошибки. | ||
+ | |||
+ | =====Настройка приложения WSGI для работы с интерфейсом к Python===== | ||
+ | |||
+ | Если путь PYTHON_LIB соответствовал /home/{{hl|ваш_логин}}/lib/python2.5/site-packages/ , то [[WSGI| WSGI ]] на хостинге уже настроен для работы с ним. В случае особенного пути, следует убедиться в том, что в файле [[SetupWSGI|webapp.wsgi]] содержится добавление этого пути в окружение: | ||
+ | |||
+ | <source lang="py"> | ||
+ | import sys | ||
+ | sys.path.insert(0, "path_to_my_python_modules") | ||
+ | </source> | ||
+ | |||
+ | ====Установка программы Omega==== | ||
+ | Требуется распаковать архив дистрибутива omega и перейти в каталог с распакованным дистрибутивом. Для конфигурации установки, вызовите скрипт configure со следующими ключами: | ||
+ | |||
+ | ./configure --prefix=/home/{{hl|ваш_логин}} XAPIAN_CONFIG=/home/{{hl|ваш_логин}}/bin/xapian-config | ||
+ | |||
+ | Затем, нужно просто "собрать" и установить программу двумя командами: | ||
+ | |||
+ | gmake | ||
+ | gmake install | ||
+ | |||
+ | {{info|CGI-интерфейс ставится в странное и не очевидное на наш взгляд место - /home/{{hl|ваш_логин}}/lib/xapian-omega/bin/omega . Возможно, с новыми релизами это будет не так - проверьте.}} | ||
[[Category:HowTo]] | [[Category:HowTo]] |
Текущая версия на 12:03, 9 мая 2010
Xapian - библиотека поискового механизма с открытым исходным кодом, написанная на C++. Используется например для поиска по группам Google. Имеет интерфейсы к популярным языками программирования Python, Perl, Php, Tcl. Для встраивания поиска на сайт используется программа Omega
Для установки релиза Xapian в домашний каталог на нашем хостинге, требуется скачать пакеты со страницы http://xapian.org/download
- xapian-core: библиотека Xapian
- omega: Omega - библиотека индексации и CGI-интерфейс к ней
- xapian-bindings: интерфейсы к различным языкам программирования
- Search::Xapian: интерфейс к языку Perl
Установку следует делать через консоль SSH.
Содержание |
Установка библиотеки Xapian
Требуется распаковать архив дистрибутива xapian-core и перейти в каталог с распакованным дистрибутивом. Для конфигурации установки, вызовите скрипт configure со следующими ключами:
./configure --prefix=/home/ваш_логин
Затем, нужно просто "собрать" и установить программу двумя командами:
gmake gmake install
Установка интерфейса к Perl
Требуется распаковать архив дистрибутива Search::Xapian и перейти в каталог с распакованным дистрибутивом. Для конфигурации установки, вызовите следующую команду:
perl XAPIAN_CONFIG=/home/ваш_логин/bin/xapian-config INSTALL_BASE=/home/ваш_логин
Затем, как и в предыдущем случае, нужно просто "собрать" и установить программу двумя командами:
gmake gmake install
Настройка консоли для работы с интерфейсом к Perl
Для того, чтобы интерпретатор Perl, вызванный из консоли, "видел" установленные локально библиотеки, добавьте в файл .profile следующие строки:
Process '/usr/local/bin/highlight --fragment --style=jedit --syntax='sh' --style-outfile='/home/dipwiki/tmp/highlight.css'' failed to start?
You need to specify a language like this: <source lang="html">...</source>
Supported languages for syntax highlighting:
(error loading support language list)Не забудьте "перелогиниться" после добавления, чтобы настройки применились. Для проверки следует набрать в консоли:
perldoc Search::Xapian
Если всё сделано правильно, то на экран будет выведена страница документации модуля.
Настройка веб-сервера apache для работы с интерфейсом к Perl
В файл .htaccess в корневом каталоге сайта или в том каталоге, где будут cgi-скрипты, добавить строку:
SetEnv PERL5LIB /home/ваш_логин:/home/ваш_догин/lib:/home/ваш_логин/lib/perl5
Установка интерфейса к Python
Требуется распаковать архив дистрибутива xapian-bindings и перейти в каталог с распакованным дистрибутивом. Для конфигурации установки, вызовите следующую команду:
./configure --prefix=/home/ваш_логин --with-python XAPIAN_CONFIG=/home/ваш_логин/bin/xapian-config \ PYTHON_LIB=/home/ваш_логин/lib/python2.5/site-packages/
ПРИМИТЕ К СВЕДЕНИЮ: Путь PYTHON_LIB выбран нами в соответствии с нашими внутренними соглашениями. Однако, он может быть изменён по Вашему желанию |
Настройка консоли для работы с интерфейсом к Python
Для того, чтобы интерпретатор Python, вызванный из консоли, "видел" установленные локально библиотеки, добавьте в файл .profile следующие строки:
Process '/usr/local/bin/highlight --fragment --style=jedit --syntax='sh' --style-outfile='/home/dipwiki/tmp/highlight.css'' failed to start?
You need to specify a language like this: <source lang="html">...</source>
Supported languages for syntax highlighting:
(error loading support language list)Собственно, в переменной PYTHONPATH должен оказаться путь, который был указан в переменной PYTHON_LIB в инструкции установки. Не забудьте "перелогиниться" после добавления, чтобы настройки применились.
Для проверки следует войти в интерпретатор Python и набрать:
Process '/usr/local/bin/highlight --fragment --style=jedit --syntax='py' --style-outfile='/home/dipwiki/tmp/highlight.css'' failed to start?
You need to specify a language like this: <source lang="html">...</source>
Supported languages for syntax highlighting:
(error loading support language list)Если всё сделано верно, то интерпретатор не выдаст ошибки.
Настройка приложения WSGI для работы с интерфейсом к Python
Если путь PYTHON_LIB соответствовал /home/ваш_логин/lib/python2.5/site-packages/ , то WSGI на хостинге уже настроен для работы с ним. В случае особенного пути, следует убедиться в том, что в файле webapp.wsgi содержится добавление этого пути в окружение:
Process '/usr/local/bin/highlight --fragment --style=jedit --syntax='py' --style-outfile='/home/dipwiki/tmp/highlight.css'' failed to start?
You need to specify a language like this: <source lang="html">...</source>
Supported languages for syntax highlighting:
(error loading support language list)Установка программы Omega
Требуется распаковать архив дистрибутива omega и перейти в каталог с распакованным дистрибутивом. Для конфигурации установки, вызовите скрипт configure со следующими ключами:
./configure --prefix=/home/ваш_логин XAPIAN_CONFIG=/home/ваш_логин/bin/xapian-config
Затем, нужно просто "собрать" и установить программу двумя командами:
gmake gmake install
ПРИМИТЕ К СВЕДЕНИЮ: CGI-интерфейс ставится в странное и не очевидное на наш взгляд место - /home/ваш_логин/lib/xapian-omega/bin/omega . Возможно, с новыми релизами это будет не так - проверьте. |