Служба поиска документации позволяет находить, просматривать и выполнять поиск в зарегистрированных документах HTML с помощью Web-браузера. Эта служба представляет документы в виде иерархической структуры, в которой для перехода к нужному документу достаточно просто щелкнуть на соответствующем значке, и документ будет показан в открывшемся окне. Кроме того, вы можете выполнять поиск информации в одной книге, в нескольких книгах или во всей установленной библиотеке.
Служба поиска предоставляет два типа Графических пользовательских интерфейсов (GUI): глобальный GUI и GUI приложения. Глобальный GUI выдает список всех зарегистрированных с его помощью документов HTML, хранящихся на сервере поиска. В этом списке могут содержаться документы различных приложений. Для того чтобы открыть глобальную библиотеку приложений, введите команду docsearch или щелкните на значке Служба поиска, расположенном в панели Справка передней панели CDE.
GUI приложения запускается при щелчке на ссылке в меню или документе приложения. В появившемся окне будут показаны страницы библиотеки с электронной информацией, относящейся к этому приложению. Например, при щелчке на ссылке Поиск в меню Справка Web-администратора системы откроется окно, позволяющее выполнять поиск только в документах по Web-администратору системы.
Компоненты Службы поиска документации устанавливаются вместе с BOS (Базовой операционной системой). При необходимости настройте службу поиска после ее установки.
Примечание: Если вы заказали компьютер с заранее установленной операционной системой, то служба поиска может быть уже установлена и настроена изготовителем.
Если вы не знаете, установлена ли служба поиска документации в вашей системе, перейдите к разделу Тестирование службы поиска документации.
Для установки или настройки службы поиска перейдите к разделу Настройка Службы поиска документации.
Если вы не уверены, установлена ли в системе служба поиска, введите docsearch в командной строке.
Как следствие, возможны следующие варианты:
Полное и всестороннее тестирование службы поиска невозможно, пока не будет установлена и зарегистрирована вся необходимая документация. Операционная система и все приложения, использующие службу поиска, регистрируются автоматически во время установки документов. Для установки руководств по операционной системе перейдите к разделу Установка электронной документации. Проверьте правильность установки всей документации по приложениям. Затем заново протестируйте службу поиска.
Если в одном из окон показан список документов, попытайтесь открыть некоторые из них. Если вам удалось открыть документ и он отображается правильно, то служба поиска настроена верно. Если документы недоступны, то это означает, что документация не была установлена и зарегистрирована. Операционная система и все приложения, использующие службу поиска, регистрируются автоматически во время установки документов. Для установки руководств по операционной системе перейдите к разделу Установка электронной документации. Проверьте правильность установки всей документации по приложениям. Затем заново протестируйте службу поиска.
Компьютер может работать как в режиме сервера, так и в режиме клиента службы поиска документации. При поиске формы или документа HTML клиент отправляет запрос на Web-сервер документации. В ответ сервер передает требуемый объект. Хотя результаты выдаются пользователю компьютера-клиента, сам поиск выполняется на сервере.
На сервере документации должно быть установлено следующее программное обеспечение:
Если компьютер должен играть роль клиента, то на нем нужно установить программное обеспечение клиента службы поиска документации и Web-браузер.
На автономных компьютерах должно быть установлено программное обеспечение и сервера, и клиента. В этом случае при поиске документов клиент передает запросы на локальный сервер. Сетевой сервер документации тоже можно сделать автономным в том смысле, что можно запретить обслуживание удаленных пользователей.
Если вы работаете с системой X-Windows, поддерживающей графический пользовательский интерфейс, то Службу поиска документации можно установить и настроить как с помощью Помощника по настройке, так и вручную. Настоятельно рекомендуется использовать первый способ, так как Помощник по настройке автоматически выполняет некоторые действия и значительно упрощает процесс установки.
Инструкции по применению Помощника по настройке приведены в разделе Установка и настройка Службы поиска документации с помощью Помощника по настройке.
Инструкции по выполнению установки и настройки вручную приведены в разделе Установка и настройка Службы поиска документации вручную.
Помощник по настройке упрощает настройку системы в качестве сервера документации или в качестве клиента, получающего документы с удаленного сервера.
Примечание: Перед тем, как установить и зарегистрировать документы в Службе поиска документации, вы должны установить Web-сервер HTTP. Помощник по настройке может автоматически установить пакет Lite NetQuestion или IBM HTTP Server. Оба этих программных продукта поставляются вместе с операционной системой.Если вы хотите использовать другой Web-сервер, то его необходимо установить и настроить перед тем, как запускать Помощник по настройке. Кроме того, выясните путь к домашнему каталогу Web-сервера с документами HTML, а также к каталогу CGI-BIN.
Устанавливать программное обеспечение Web-сервера не требуется, если вы настраиваете компьютер в качестве клиента, получающего документы с удаленного сервера.
Для запуска Помощника по настройке войдите в систему как пользователь root и введите команду configassist:
В появившемся окне Помощника по настройке нажмите кнопку Далее. Выберите пункт Настроить электронную документацию и поиск. Для установки и настройки службы поиска выполните инструкции Помощника по настройке.
По окончании выполните процедуру из раздела 3 для добавления языковой поддержки.
В данном разделе описывается установка и настройка Службы поиска документации с помощью Инструмента управления системой.
В разделах Установка сервера и Установка клиента описаны процедуры установки сервера и клиента.
Эта процедура позволяет настроить компьютер в качестве сервера, на котором будет установлена электронная документация. Сервер может быть как сетевым (обслуживающим удаленных клиентов), так и автономным (обслуживающим только локальных пользователей).
Для настройки сервера службы поиска документации выполните следующие действия:
В системе должен быть установлен Web-сервер. Это может быть любой Web-сервер, поддерживающий программы CGI (Common Gateway Interface). Web-сервер Lite NetQuestion автоматически устанавливается вместе с Базовой операционной системой, однако он недоступен для удаленных пользователей.
Для обслуживания как локальных, так и удаленных пользователей вы можете установить IBM HTTP Server с компакт-диска, поставляемого вместе с AIX 5.1. Или, вы можете установить другой Web-сервер.
Для того чтобы узнать, какое программное обеспечение уже установлено в системе, введите smit list_installed в командной строке.
Должен быть установлен Web-браузер, поддерживающий просмотр форм. (Браузер Netscape поставляется на компакт-диске AIX 5.1 Netscape Products.)
За исключением случая, когда вы применяете автоматически устанавливаемый сервер Lite NetQuestion, вы должны настроить Web-сервер для правильной работы в системе. Инструкции по настройке и запуску программного обеспечения Web-сервера приведены в его документации. Запишите полные имена каталогов, с которых сервер начинает поиск документов HTML и программ CGI. Полные имена каталогов не потребуются, если вы установили в каталоге по умолчанию один из следующих Web-серверов:
Другие Web-серверы могут не создавать автоматически каталоги HTML и CGI. В таких случаях их нужно создавать вручную.
Предоставьте локальным и удаленным пользователям права доступа к Web-серверу, что позволит им работать с сервером поиска документации.
Сервер поиска документации может обслуживать документы, написанные на языке, отличном от основного языка компьютера. Для этого нужно установить соответствующие наборы файлов языковой поддержки.
Допустим, что при установке базовой операционной системы в качестве основного был выбран английский язык, но вы хотите, чтобы пользователи могли выполнять поиск документов на английском и русском языках. Сообщения на английском языке будут установлены автоматически, поскольку это основной язык системы. Таким образом, вручную нужно установить только поддержку русского языка.
Существует два способа установки языковой поддержки для службы поиска:
Для того чтобы полностью установить или обновить локаль, введите smit mle_add_lang в командной строке. Дополнительная информация приведена в электронной справке.
Для установки каталога сообщений для службы поиска с помощью Web-администратора системы выполните следующие действия:
Обязательно установите Общие сообщения. Если в системе установлен рабочий стол, то установите также Сообщения CDE. Допустим, на сервере в качестве основного языка применяется английский, и вам нужно, чтобы пользователи могли выполнять поиск документов на английском и русском языках. Каталоги сообщений на английском языке будут установлены автоматически. Вручную придется установить только файлы сообщений на русском языке.
Наборы файлов сообщений не входят в комплект установки Службы поиска документации, а включены в пакеты сообщений BOS (bos.msg.локаль, где локаль=выбранный язык) и называются:
Для установки каталога сообщений для службы поиска с помощью SMIT выполните следующие действия:
Наборы файлов сообщений не входят в комплект установки Службы поиска документации, а включены в пакеты сообщений BOS (bos.msg.локаль, где локаль=выбранный язык) и называются:
В поле Устройство/Каталог для программного обеспечения появившегося окна диалога укажите каталог, в котором должны быть установлены наборы файлов, или нажмите кнопку Список и выберите каталог из списка.
Для настройки службы поиска документации с помощью Web-администратора системы выполните следующие действия:
имя_браузера -u http://www.w3.org
В поле Браузер должна быть следующая команда:
имя_браузера -u
Заметьте, что сам URL в поле Браузер не указывается.
Примечание: Для многих браузеров, включая Netscape, флаги не нужны.
Примечание: Если вы установили какой-либо из указанных Web-серверов в нестандартном каталоге или изменили каталоги CGI-BIN и HTML, выбранные по умолчанию, то нажмите кнопку Другой.
Для настройки службы поиска документации с помощью SMIT выполните следующие действия:
имя_браузера флаг http://www.ibm.com/servers/aix/library
Примечание: Для многих браузеров, включая Netscape, флаги не нужны.
Примечание: Если вы установили какой-либо из указанных Web-серверов в нестандартном каталоге или изменили каталоги CGI-BIN и HTML, выбранные по умолчанию, то нажмите кнопку Другой.
В этом окне вы также можете задать нестандартный (отличный от 80) номер порта Web-сервера. Если вы не знаете номер порта, оставьте порт 80. Однако для Web-сервера Lite NetQuestion нужно задать порт 49213.
Теперь вы можете пользоваться функцией поиска документации на данном сервере. Пользователям, которые вошли в систему сервера до завершения настройки, функция поиска станет доступна после повторного входа в систему.
Для того чтобы документ можно было найти с помощью службы поиска, для него нужно создать индекс и зарегистрировать этот индекс в службе поиска. В некоторых приложениях, в частности в Web-администраторе системы, документы поставляются в подготовленном виде в составе установочного пакета. При установке таких пакетов индексы регистрируются автоматически. Для всей документации по операционной системе индексы регистрируются во время установки.
Кроме того, вы можете создать индексы для собственных документов HTML и зарегистрировать их в службе поиска. Тогда вы сможете выполнять в них поиск так же, как и в других документах. Информация о создании и регистрации индексов приведена в книге AIX 5L Version 5.1 General Programming Concepts: Writing and Debugging Programs.
Эта процедура позволяет настроить компьютер в качестве клиента удаленного сервера службы поиска документации. При работе со службой поиска клиент отправляет запросы на удаленный сервер поиска документации, который обрабатывает их и возвращает результаты Web-браузеру клиента.
Примечание: Поиск поддерживается не для всех языков.
Для настройки клиента службы поиска выполните следующие действия:
Сначала просмотрите список уже установленного программного обеспечения, введя smit list_installed в командной строке. Если вы еще не установили следующее программное обеспечение на клиенте, то сделайте это сейчас:
Примечание: Для всех дополнительных языков должна быть установлена поддержка локали в BOS (языковая среда). Если локаль устанавливается после Службы поиска документации, то наборы сообщений службы для этого языка устанавливаются автоматически. Однако если локаль была установлена до Службы поиска (например, при обновлении версии операционной системы), то набор сообщений для этого языка нужно установить вручную.
Инструкции по добавлению языковой поддержки см. в процедуре Установка сервера, шаг 3.
Для настройки службы поиска документации с помощью Web-администратора системы выполните следующие действия:
имя_браузера -u http://www.w3.org
В поле Браузер должна быть следующая команда:
имя_браузера -u
Заметьте, что сам URL в поле Браузер не указывается.
Примечание: Для многих браузеров, включая Netscape, флаги не нужны.
Для настройки службы поиска документации с помощью SMIT выполните следующие действия:
имя_браузера флаг http://www.ibm.com/servers/aix/library
Примечание: Для многих браузеров, включая Netscape, флаги не нужны.
Кроме того, нужно задать порт удаленного Web-сервера, если это нестандартный порт (отличный от 80).
Теперь вы можете пользоваться функцией поиска документации на данном клиенте. Пользователям, которые вошли в систему клиента до завершения настройки, функция поиска станет доступна после повторного входа в систему.