3.1.4. Настройка поискового сервера

Поисковый сервер называется ywsearch .

Примеры настройки сервера находятся в каталоге ysite , файлы ywsearch.cfg, ywsearch.cfg.virt .

Обязательные ключи:

1. Префикс индексируемых файлов: IndexingDirectory

Префикс, который надо отделить от имени файла, перед тем как делать из него URL. Как правило, должен совпадать с ключом IndexingDirectory, заданном при индексировании.

2. URL: AddPrefix

Префикс, который надо добавить к имени файла (после отделения ключа IndexingDirectory), чтобы сделать из него URL.

Пример:

 
IndexingDirectory : /usr/local/www/data/
AddPrefix : http://www.greatest.ru/ 

Остальные ключи:

3. Каталог временных файлов: TempDirectory Значение по умолчанию: search.temp

Каталог, в котором будут хранится служебные временные файлы поискового сервера (например, результаты запросов во внутреннем формате). Эти файлы используются, в частности, для разметки документов. Каталог следует регулярно чистить при помощи cron(8), удаляя из него старые файлы.

4. Имя файлов индекса: IndexName

Значение по умолчанию: workindex

Начало имен файлов индекса, используемых для поиска.

5. Каталог начала работы: WorkDirectory

Значение по умолчанию: текущий каталог

Указывает каталог, в который надо перейти перед началом работы. Чтобы не запутаться, очень полезно перейти в тот каталог, который был текущим при создании индекса.

6. Способ получения файлов: HostName

Состояние по умолчанию: не задан

Если этот ключ указан, то документы для подсветки будут не считываться из файлов, а запрашиваться с HTTP сервера с данным именем.

В общем случае считывание документов из файлов происходит быстрее, чем получение их с сервера. Этот ключ понадобится при настройке, если тексты, хранящиеся в файлах, не совпадают с теми, которые присылает HTTP сервер (например, используются так называемые Server-Side Includes).

Пример: HostName : www..ru

7. Автоматический перезапуск: FileNameWithPid

Состояние по умолчанию: не задан

Имя файла, в который сервер запишет свой pid. Нужен для автоматического перезапуска сервера (см. kill(1)). Если указан только ключ (без значения), то подразумевается ywsearch.pid .

8. Каталог картинок: PictureDirectory

Значение по умолчанию: http://www.comptek.ru/arcadia

Имя каталога, из которого будут браться картинки, вставляемые в отчет. Этот ключ имеет смысл установить, если Вы предполагаете использовать Яндекс-сайт для внутренних целей, в особенности, если Ваша локальная сеть не подключена к Internet. Примеры картинок поставляются вместе с системой. Переименовывать их нельзя.

9. Кодировка: Charset

Значение по умолчанию: 0 (MS Windows)

Кодировка, в которой Яндекс отдает документы Web-серверу. Документы, относящиеся к одному хосту, должны быть в одной и той же кодировке.

Значения:

• 0 --- MS Windows
• 1 --- KOI8-R
• 2 --- MS DOS
• 3 --- Mac OS
• 4 --- ISO-iso_8859-5

Одна из проблем «русскоязычного» Интернета - существование разных кодировок русских букв. Так, например, один и тот же документ может в кодировке Windows называться http://www..ru/hi.html, а в КОИ-8 - http://www..ru:8080/hi.html. Или, скажем, в КОИ-8 - http://www..ru/hi.html, а в Windows - http://win.www..ru/hi.html.

Для решения этой проблемы введено дополнительное ключевое слово VirtualHost, которое определяет виртуальный хост и позволяет вводить одновременно несколько ключей AddPrefix. Сервер выбирает нужный URL по правилам, заданным ключами ServerName, ServerPort, LocalPrefix и SwitchWord.

Таким образом, полное имя ключа будет складываться из трех частей:

VirtualHost . номера хоста (начиная с 1) . ключ

Пример:

 
VirtualHost.1.AddPrefix : http://www..ru/
VirtualHost.2.AddPrefix : http://win.www..ru/

10. Виртуальный хост: ServerName, ServerPort, LocalPrefix, SwitchWord

Виртуальный хост выбирается по правилам, заданным этими ключами. При запуске CGI-скрипта Web-сервер сообщает ему свое имя, номер порта и имя CGI-скрипта. Это может быть использовано для выбора варианта представления URL'я в получившемся документе. (см ключ AddPrefix ).

Пример:

 
VirtualHost.1.ServerName : www..ru
VirtualHost.1.AddPrefix : http://www..ru/
VirtualHost.2.ServerName : win.www..ru
VirtualHost.2.AddPrefix : http://win.www..ru/

Это значит следующее: если запрос пришел со страницы Web-сервера www..ru, URL'и в результате поиска будут начинаться с http://www..ru/, а если со страницы Web-сервера win.www..ru, то URL'и в результате поиска будут начинаться с http://win.www..ru/. Или:

 
VirtualHost.1.ServerPort : 80
VirtualHost.1.AddPrefix : http://www..ru/
VirtualHost.2.ServerPort : 8080
VirtualHost.2.AddPrefix : http://www..ru:8080/

Кроме того, если в форме запроса есть поле switch (это, конечно, должно быть скрытое поле), оно тоже может быть учтено при помощи ключа SwitchWord .

Пример:

 
VirtualHost.1.SwitchWord : Первый
VirtualHost.1.AddPrefix : http://www..ru/
VirtualHost.2.SwitchWord : Второй
VirtualHost.2.AddPrefix : http://www1..ru/

11. Префиксы CGI-скриптов: CgiSearchPrefix, CgiPagePrefix, CgiMarkupPrefix

Значения по умолчанию: /cgi-bin/yandsearch, /cgi-bin/yandpage, /cgi-bin/yandmarkup

Здесь надо указать префиксы URL'ей CGI-скриптов для выполнения запроса, показа другой страницы найденных документов и показа размеченного документа соответственно. Префиксы используются при составлении получающихся документов.

12. Работа с виртуальными хостами: AutoSearchInSubtree

Состояние по умолчанию: не задан

Этот ключ удобно задавать, если в конфигурации указано несколько виртуальных хостов. Тогда к строке запроса будет автоматически добавлена строка вида: "#subtree=_значение_ключа_ServerName_", что обеспечит независимый поиск по каждому хосту (поисковый сервер автоматически определит значение_ключа_ServerName_ по адресу, с которого он был вызван). Другой способ добиться этого же результата (гораздо более сложный) - описать каждый виртуальный хост, как поддерево.

Если поиск будет идти по разделу (которым в данном случая является хост), а по всем данным, то для тех документов, которые не принадлежат виртуальному хосту, обрабатывающему запрос, будет неправильно сформирован URL этих документов. Ключ задается без значения.

Пример:

 
AutoSearchInSubtree :
VirtualHost.1.ServerName : www.greatest.ru
VirtualHost.2.ServerName : win.www.greatest.ru

Следующие ключи могут быть определены для любого виртуального хоста:

IndexingDirectory, Extensions, ExcludeDirectory, FolderDirectory, HostName, ServerName, Charset

Если ключ для виртуального хоста не задан, ему присваивается значение по умолчанию: или общая установка (без ключевого слова VirtualHost), или значение сооответствующего ключа первого виртуального хоста VirtualHost.1._ключ_ .