Секция Server
Конфигурация поискового модуля задается в обязательной секции Server конфигурационного файла. Изменения в этой секции, а также изменения в числе секций Collection и их атрибутах распознаются только при старте сервиса.
Конфигурации индексатора и поискового сервера задаются в секции Collection конфигурационного файла сервиса. Изменения в этих секциях распознаются при каждом запуске индексирования или при каждом запуске поисковой сессии.
Секция Server состоит из директив IPAddress, Port, Host, Threads, QueueSize, WorkDir, ServerLog и подсекции Authorization. Ни одна из этих директив и подсекций не является обязательной.
Директивы секции Server
| Директива |
Описание |
Значение |
|
IPAddress
|
Устанавливает IP-адрес, на котором работает поисковый модуль. Значение должно соответствовать одному из допустимых IP-адресов компьютера. |
По умолчанию поисковый модуль работает на всех IP-адресах компьютера. |
|
Port
|
Устанавливает порт, на котором работает поисковый модуль. Поисковые HTTP-запросы необходимо будет посылать на этот порт. |
Значение по умолчанию:17000 |
|
Host
|
Устанавливает хост, на котором работает поисковый модуль. |
Значение по умолчанию: официальное имя хоста. Например, если используется локальный файл hosts, это будет первая запись после IP-адреса. |
|
Threads
|
Определяет максимальное количество одновременно выполняемых поисковых запросов. Если уже выполняется определяемое данной директивой количество запросов, выполнение вновь поступивших запросов откладывается до тех пор, пока не будут выполнены текущие запросы. |
Значение по умолчанию: 5 |
|
QueueSize
|
Определяет максимальный размер очереди поисковых запросов, ожидающих начала выполнения. В случае нулевого значения директивы максимальный размер очереди запросов бесконечен. Если начала выполнения уже ожидает определяемое данной директивой количество запросов, на вновь поступившие запросы сервер отвечает "HTTP/1.0 503 Service Unavailable" и не выполняет их. При максимальной загрузке системы уменьшение значения данной директивы приводит, с одной стороны, к сокращению времени выполнения запроса, за счет уменьшения времени ожидания в очереди, но с другой стороны, ведет к росту числа отказов. |
Значение по умолчанию: 0 |
|
WorkDir
|
Рабочий каталог поискового модуля. Должен быть указан абсолютный путь. Если в других директивах конфигурационного файла заданы относительные пути, они будут приведены к абсолютным относительно этого каталога. |
Значение по умолчанию: каталог, из которого запущена программа (Unix-системы) или каталог, в котором находится yandex-server.exe (Windows) |
|
ServerLog
|
Путь к файлу, в который будут выводиться сообщения поискового модуля, абсолютный или относительно WorkDir. |
Значение по умолчанию: yandex.log |
|
LoadLog
|
Путь к файлу, в который будут выводиться поисковые запросы пользователей, абсолютный или относительно WorkDir. |
Значение по умолчанию: не задан. |
Подсекция Authorization
Подсекция <Authorization> предназначена для задания параметров авторизации административного режима, предназначенного для управления веб-сервером. Авторизация проходит по схеме BASIC. В секцию входят следующие директивы:
Директивы секции Authorization
| Директива |
Описание |
|
UserName
|
Имя пользователя. |
|
UserPassword
|
Пароль пользователя. |
Если секция задана, доступ к странице административного режима возможен с любого компьютера сети.
При первом обращении к странице административного режима браузер покажет стандартное диалоговое окно авторизации, в котором следует ввести указанные в данной секции имя пользователя и пароль.
Если секция отсутствует, доступ к административному режиму будет возможен только с того компьютера, на котором установлен веб-сервер.
Пример
Ниже приведен пример секции конфигурационного файла, в которой заданы настройки веб-сервера.
Секция Collection
Каждой коллекции документов соответствует одна секция Collection, в которой определяются документы, входящие в коллекцию, настраиваются индексатор и поисковый сервер. Директивы и подсекции секции Collection рассмотрены в разделах Директивы конфигурационного файла индексатора и Настройка поискового модуля.
Атрибуты секции Collection
| Атрибут |
Описание |
Значение |
|
id
|
Определяет имя коллекции документов. Это имя считается именем индексатора и именем поискового сервера, соответствующих данной коллекции документов. Имя коллекции документов может быть произвольной текстовой строкой, за исключением строки "admin", которая используется в специальных HTTP-запросах, управляющих поисковым модулем, строки "images", которая зарезервирована для виртуального каталога с картинками и строки "hl", используемой для подсвеченных документов. Если коллекций документов более одной, то каждая секция Collection должна иметь атрибут id. |
|
|
file
|
Указывает имя дополнительного файла, в котором определяется коллекция документов. При наличии атрибута file тело секции должно быть пустым, в противном случае оно должно содержать директивы, требующиеся для настройки. Дополнительный файл должен содержать корректное определение коллекции, при этом атрибуты коллекции берутся из основного конфигурационного файла. Параметр необязательный. |
|
|
autostart
|
Позволяет опредилить порядок работы индексатора и поиска. |
- Yes – автоматически стартует поиск при запуске Я.Сервера.
- No – не стартует поиск при запуске Я.Сервера.
- Must – завершает работу Я.Сервера, если одина из коллекций не стартовала для поиска.
|
|
сlass
|
Позволяет указать тип коллекции. Используется только в том случае, если требуется выполнять индексацию и поиск в памяти. В этом случае, документы доступны для поиска с момента индексации, а при правильно организованном процессе - с момента поступления. Значение атрибута в этом случае должно быть равно memory. |
По умолчанию значение не задано. |
Пример
Примеры описания коллекций
# Секция с безымянной коллекцией документов.
<Collection>
# директивы секции Collection
# ...
</Collection>
# Секция с безымянной коллекцией документов.
# Все настройки задаются в файле news_collection.cfg.
<Collection file="news_collection.cfg">
</Collection>
# Секция с коллекцией документов news.
<Collection id="news">
# директивы секции Collection
# ...
</Collection>
<Collection autostart="yes">
# директивы секции Collection
# ...
</Collection>
<Collection class="memory">
# директивы секции Collection
# ...
</Collection>
Введение