Конфигурационный файл поискового модуля
Директивы конфигурационного файла поискового модуля
Конфигурация поискового сервера состоит из директив и секций: QueryCache, SearchPageTemplate. Ни одна из секций не является обязательной.
| Директива |
Описание |
Значение |
|
IndexDir
|
Имя каталога с индексными файлами, подготовленными индексатором и используемыми для поиска. |
Значение по умолчанию: ./workindex. |
|
RequestThreads
|
Определяет максимальное количество одновременно выполняемых поисковых запросов.
Если уже выполняется определяемое данной директивой количество запросов, выполнение вновь поступивших запросов откладывается до тех пор, пока не будут выполнены текущие запросы.
|
Значение по умолчанию: 5. |
|
RequestQueueSize
|
Определяет максимальный размер очереди поисковых запросов, ожидающих начала выполнения.
В случае нулевого значения директивы максимальный размер очереди запросов бесконечен.
Если начала выполнения уже ожидает определяемое данной директивой количество запросов, на вновь поступившие запросы сервер отвечает "HTTP/ 1.0 503 Service Unavailable" и не выполняет их.
При максимальной загрузке системы уменьшение значения данной директивы приводит, с одной стороны, к сокращению времени выполнения запроса, за счет уменьшения времени ожидания в очереди, но с другой стороны, ведет к росту числа отказов.
|
Значение по умолчанию: 0. |
|
MorphFixList
|
Имя файла, содержащего правильное морфообразование отсутсвующих в словаре слов.
Если этот файл задан, то слова, указанные в нем (и их формы) будут участвовать в поиске как словоформы друг друга.
|
Значение по умолчанию: не задан. |
|
UserRelevanceLibrary
|
Указывает путь к библиотеке, в которой определена функция, позволящая выполнять произвольное ранжирование результатов поиска.
Ранжирование осуществляется посредством вычисления оценки документа на основании группировочных атрибутов и текстовой релевантности.
В поставку Я.Сервера включены примеры реализации функции в файле:
.\data\sources_sample\include\userrelevancesample.cpp и скомпилированная библиотека: .\data\sources_sample\userrelevancesample.so для Linux или .\data\sources_sample\userrelevancesample.dll для Windows.
|
|
|
DownloadMissingPassages
|
Указывает, следует ли для показа фрагментов во время поиска загружать документы, сохраненные тексты которых отсутствуют в архиве. |
Значение по умолчанию: no. |
|
SearchOver
|
Продолжение заголовка "Поиск по ..." страницы с результатами поиска во встроенном дизайне. |
Значение по умолчанию: серверу. |
Директивы секции SearchPageTemplate
Секция SearchPageTemplate предназначена для задания шаблона, в соответствии с которым сервер будет показывать страницу с результатами поиска. В случае отсутствия данной секции будет использован встроенный шаблон.
В секцию входят следующие директивы:
| Директива |
Описание |
Значение |
|
Method
|
Указывает язык программирования, на котором написан шаблон страницы.
Аргументы директивы описаны ниже.
Обязательная директива.
|
|
|
Module
|
Указывает путь к файлу, содержащему шаблон страницы.
Если указанный файл шаблона отсутствует или имеет неправильный формат, будет использован встроенный шаблон.
Обязательная директива.
|
|
|
Options
|
Используется для шаблонов на Perl и C++.
Для интерпретатора Perl позволяет задать дополнительные параметры командной строки, например, подключить какие-либо специфические библиотеки.
Для динамической библиотеки на C++ определяет строку инициализации, которую можно получить, вызвав IInitContext::GetCommandLine() в функции UserInit.
|
Значение по умолчанию: не задан |
Аргументы директивы Method
Описание директивы приведено выше.
| Аргумент |
Описание |
|
perl
|
Шаблон страницы написан на языке Perl.
Для использования этого аргумента на компьютере должен быть установлен Perl 5.8, который используется для интерпретации шаблона.
Пример такого шаблона приведен в файле report.phtml, включенного в поставку.
|
|
binary
|
Шаблон страницы представляет собой предварительно скомпилированную бинарную динамическую библиотеку, обычно написанную на C++.
Пример исходных кодов библиотеки содержится в каталоге sources_sample/report из комплекта поставки.
|
Директивы секции QueryCache
Секция QueryCache предназначена для описания политики кеширования результатов выполнения поисковых запросов.
По умолчанию, если данная секция отсутствует, поисковые запросы не кешируются, то есть каждое обращение к поисковому серверу сопровождается выполнением поиска по индексным файлам.
Если секция QueryCache имеется, результаты выполненных запросов временно сохраняются в специальном каталоге, и время на повторную обработку недавно выполненного запроса не тратится.
Необходимость кеширования определяется размером индексных файлов и интенсивностью запросов. При малой нагрузке в кешировании нет необходимости, что упрощает администрирование поискового сервера.
В секцию входят следующие директивы:
| Директива |
Описание |
Значение |
|
Dir
|
Каталог для размещения кешированных поисковых запросов. |
Значение по умолчанию: системный каталог для временных файлов. |
|
LifeTime
|
Время в минутах, в течение которого выполненный поисковый запрос хранится в кеше.
Если значение равно нулю, запросы будут храниться в кеше бесконечно долго.
|
Значение по умолчанию: 60. |