<Text id="2">ИНСТРУКЦИЯ ПО УСТАНОВКЕ</Text>

<Text id="70">Unix</Text> Эта часть написана для пользователей Unix (Пользователи Windows могут сразу перейти к части ).Для установки вам нужно будет выбрать между бинарным и исходным кодами. Бинарный код занимает около 50 Mb; исходный код требует 160МЬ для компиляции. <Text id="72">Бинарный код для Unix</Text> Бинарный код нуждается в Linux дистрибутиве, основанном на Intelх8б, который включает в себя ELF binary support. Ниже перечислены дистрибутивы, которые соответствуют этим требованиям: RedHat 5.1 SuSe Linux 6.1 Debian 2.1 Slackware 4.0 Более ранние версии этих дистрибутивов также должны работать. Вам потребуется сетевой сервер: мы рекомендуем Apache. Мы также настоятельно рекомендуем вам установить сетевой сервер до того, как вы установите Greenstone - это значительно облегчит процесс инсталляции. Если вы планируете создавать цифровые коллекции, то вам также понадобится Perl, если он еще не установлен на вашей системе. Во многих версиях Linux программа Perl устанавливается по умолчанию. В Приложении вы можете узнать, где и как приобрести Apache и Perl. <Text id="80">Исходный код для Unix</Text> Исходный код для Unix является таким же, как и для Windows. Он был скомпилирован и проверен на Linux, Solaris, Macintosh OS/X. Настроить этот код под другие версии Unix будет не сложно. Для компиляции исходного кода на Unix вам нужно иметь GCC, Gnu C++ compiler GDBM, Gnu database manager. Для запуска программы Greenstone вам также понадобится сетевой сервер и Perl, как было описано выше. <Text id="86">Установка Unix</Text> Для установки версии Unix с компакт-диска вставьте диск в дисковод иВведите следующие команды: <TableContent> <tr> <th width="126"> <CodeLine>mount /cdrom</CodeLine> </th> <th width="281"> <Text id="88"> (эта команда может отличатся от одной версии к другой; например на OS/X вы вводиггедиректорию /Volumes a затем в соответствующую поддиректорию для CD-ROM)</Text> </th> </tr> <tr> <th width="126"> <CodeLine>cd /cdrom</CodeLine> </th> <th width="281"> <Text id="89">change directory to the CD-ROM's top level</Text> </th> </tr> <tr> <th width="126"> <CodeLine>cd Unix</CodeLine> </th> <th width="281"> <Text id="90">Изменить директорию туда, где установлен инсталляционный скрипт Unix .</Text> </th> </tr> <tr> <th width="126"> <CodeLine>sh Install.sh</CodeLine> </th> <th width="281"> <Text id="91">Начать процесс инсталляции (буквенное сочетание необходимо так как во многих случаях вы не можете начать инсталляцию программ прямо с компакт-диска).</Text> </th> </tr> </TableContent> </Table> <Text id="92">Начать процесс инсталляции (буквеное сочетание необходимо так как во многих случаях вы не можете начать инсталляцию программ прямо с компакт-диска).</Text> <Text id="93">Последняя команда вызывает интерактивное диалоговое окно, в котором запрашивается информация, необходимая для установки Greenstone. В этом окне помещается детальный отчет о том, что происходит. Процесс установки начинается с того, что у вас запрашивается директория, в которую вы желаете установить программу. Первый файл, который помещается в эту директорию, - это файл "удалить" (uninstall), который очищает эту директорию от файлов незавершенной установки, в случае, если у вас возникнут проблемы или вы приостанавливаете установку. Следующий - шаг вы должны выбрать между бинарным и исходным кодами. Затем появляются вопросы о параметрах вашего WWW-браузера. Вам нужно иметь исправную cgi executable directory (обычно называется "cgi-bin" в системах Unix); вы можете создать новую либо использовать старую. Если вы создадите новую, то вам необходимо ввести эту информацию в конфигурационный файл сетевого сервера. В любом случае вам нужно будет ввести WWW-адрес директории cgi. Интерактивные окна проведут вас через весь инсталляционный процесс. Очень важно правильно вводить file permissions в определенных директориях, где у вас потребуют соответствующую информацию. И наконец у вас потребуют пароль. Для пользователя "администратор" введите "admin".</Text> <Text id="94">По умолчанию, Greenstone устанавливается в директории /usr/local/gsdl, если установку производит "корневой"(гоо1) пользователь, а в ином случае - в директорию ~/gsdl (где "~" является главной директорией пользователя).</Text> <Text id="95">Установка бинарного кода занимает несколько минут. Если вы устанавливаете исходный код, то инсталляционный скрипт будет компилировать его, что займет от 10 минут до часа, в зависимости от скорости вашего процессора.</Text> <Text id="96">Для удаления программы введите</Text> <CodeLine>cd ~/gsdl </CodeLine> <Text id="97"> или /user/local/gsdl, а "корневой" пользователь может ввести команду</Text> <CodeLine>sh Uninstall.sh</CodeLine> <Text id="98">В процессе установки помимо Демо-коллекции вы можете установить и другие коллекции. Демо-коллекция Greenstone устанавливается автоматически; сведения об остальных вы найдете в <CrossRef target="Chapter" ref="greenstone_collections"/> части.</Text> </Content> </Subsection> <Subsection id="unix_webserver_configuration"> <Title> <Text id="99">Настройка сетевого сервера Unix</Text> Если на вашем компьютере уже установлен сетевой сервер, то в его конфигурационный файл нужно будет внести некоторые изменения, для того чтобы он был совместим с Greenstone. В инсталляционном скрипте описано, как это надо сделать. Для вашего удобства этот инсталляционный скрипт записан в файле INSTALL RECORD в той же директории, в которую вы установили Greenstone Если у вас еще нет сетевого сервера, то его нужно будет установить. В Приложении есть информация об Apache. Затем вам нужно будет его настроить. В части описаны части WWW-сервера Apache, которые взаимосвязаны с Greenstone, и то, как их нужно изменить. Все сводится к тому, что вам нужно будет ввести полдюжины строк в его конфигурационный файл. Вам не обязательно быть корневым пользователем Unix для совершения описанного выше процесса инсталляции. Но когда дело доходит до настройки сетевого сервера Apache, тогда вам понадобятся привилегии корневого пользователя. Если вы желаете установить второй сервер Apache, то вы можете это сделать, даже если на вашем компьютере уже установлен один.

<Text id="103">Расположение Greenstone</Text> <Text id="104">Локальная библиотека (только для Windows)</Text> Если вы используете Локальную библиотеку, то просто запустите программу Greenstone кнопкой Пуск в меню. Это автоматически загружает программу, и на экране в окне вашего браузера появляется стартовая страница. С этой страницы также доступна Делю- коллекция. В диалоговом<*>кНе меню вы можете изменить ваш браузер, который используется по умолчанию. Нет никакой разницы, используете ли вы Internet Explorer или Netscape Navigator, за исключением того, что если у вас установлен Windows 2000, то мы рекомендуем использовать Internet Explorer. <Text id="106">Интернет-Библиотека (Windows и Unix)</Text> Если вы используете Интернет-библиотеку, то после завершения установки и настройки сетевого сервера, используйте следующий WWW-адрес для входа в вашу программу: http://localhost/gsdl/cgi-bin/library Демо-коллекция Greenstone также должна быть доступна с этой страницы. <Text id="110">Коллектор</Text> В стартовом окне Greenstone есть ссылка к коллектору (Collector). <Text id="112">Администрирование</Text> Там также есть ссылка к странице Администрирование. Пользователь "администратор" называется admin, который использует пароль, указанный в процессе Инсталляции. Администратор может добавлять новых пользователей и разрешает создание новых коллекций.

<Text id="114">Библиотечный интерфейс Greenstone (GLI)</Text> Библиотечный интерфейс Greenstone (GLI) – это инструмент для помощи Вам при создании цифровых библиотек с использованием Greenstone. Он предоставляет Вам доступ к функциональным возможностям создания коллекции и удобному в работе интерфейсу «пункт и щелчок». GLI инсталлируется автоматически во всех дистрибутивах Greenstone. Он помещен в поддиректории gli главной директории Greenstone (C:\Program Files\gsdl\gli по умолчанию). Обратите внимание на то, что он запускается в сочетании с Greenstone и не будет работать корректно, если не помещен в поддиректорию при инсталляции Greenstone. Если Вы загрузили один из дистрибутивов Greenstone, то требуемое должно иметь место. Чтобы использовать GLI, на Вашем компьютере должна иметься Java Runtime Environment (JRE). Если это не сделано, то при инсталляции Вам будет предложено установить версию, которая находится на CD-ROM. При использовании Unix Вы будете нуждаться также в том, чтобы был установлен Perl (для Windows Perl уже включен в программное обеспечение Greenstone). Пожалуйста, сообщите о любых проблемах, которые возникают у Вас при запуске или использовании Библиотечного интерфейса по адресу:greenstone@cs.waikato.ac.nz. <Text id="118">Запуск под Windows</Text> Чтобы запустить GLI под Windows, обратитесь к папке gli в Вашей инсталляции Greenstone, используя, например, Windows Explorer, и щелкните дважды на файле с названием gli.bat. Этот файл проверяет наличие Greenstone, JRE и Perl и запускает GLI. <Text id="120">Запуск под Unix</Text> Чтобы запустить GLI под Unix, измените на gli директорию в Вашей установке Greenstone, а затем запустите скрипт gli.sh. Этот скрипт проверяет наличие Greenstone, JRE и Perl на поисковом пути и запускает GLI. <Text id="122">Получение помощи</Text> GLI предоставляет обширные диалоговые средства помощи. Чтобы получить помощь, щелкните кнопкой Help в верхней правой части экрана. Это откроет текст раздела, который касается того, что Вы делаете – какая из панелей GLI в настоящее время работает. Вы можете щелкнуть по тексту помощи, чтобы изучить то, что Вам необходимо знать. Используйте это. <Text id="124">Компилирование GLI</Text> Если Вы запустили программу дистрибутива Greenstone, то Вы будете иметь исходную программу Java из GLI. Чтобы выполнить компилирование, Ваш компьютер должен иметь Java Development Kit. В приложении дается информация относительно того, как ее получить. Чтобы компилировать исходную программу, введите файлы makegli.bat ( Windows) или makegli.sh (Unix). После того, как компилирование завершено, Вы можете запустить GLI, как было описано выше.

<Text id="126">Проверка и возможные проблемы</Text> Для проверки и обзора Greenstone, просто начните с просмотра Демо-коллекции и других коллекций, которые вы установили. Нажимайте на все кнопки без опасения -вы ничего не повредите. Если задержать курсор мыши на каком-либо рисункелгошится сообщение, в котором написано то, что произойдет, если вы нажмете на него. Экспериментируйте! Для большей информации смотрите Руководство Пользователя. <Text id="128">возможные проблемы</Text>

<TableContent> <tr> <th width="140"> </th> <th width="161"> <Text id="129">Проблема</Text> </th> <th width="242"> <Text id="130">Попробуйте</Text> </th> </tr> <tr> <th width="140"> <Text id="131"> Локальная библиотека (только Windows) </Text> </th> <th width="161"> <Text id="132">Когда я запускаю программу, компьютер просит меня набрать номер интернет-провайдера.</Text> </th> <th width="242"> <Text id="133">Нажмите на кнопку Отмена.. Обычно этого достаточно, чтобы решить проблему.</Text> </th> </tr> <tr> <th width="140"> </th> <th width="161"> <Text id="134">Когда я запускаю Greenstone, компьютер продолжает запрашивать подключение к интернет-провайдеру </Text> </th> <th width="242"> <Text id="135">Выберите "Restricted version"(ограниченная версия) при запуске программы. Она работает лишь в Netscape.</Text> </th> </tr> <tr> <th width="140"> </th> <th width="161"> <Text id="136">Когда я пытаюсь попасть на страницу цифровой библиотеки, она не может </Text> </th> <th width="242"> <Text id="137">Проверьте ваши Интернет proxy - настройки Edit preferences в Netscape и Internet options (свойства обозревателя) в Explorer</Text> </th> </tr> <tr> <th width="140"> </th> <th width="161"> <Text id="138">Коллектор работает очень медленно!</Text> </th> <th width="242"> <Text id="139">Используете ли вы Netscape в Windows 2000? Если это так, то попробуйте использовать Internet Explorer в Windows 2000. У Windows 2000 существует какая- то несовместимость с Netscape.</Text> </th> </tr> <tr> <th width="140"> <Text id="142">Интернет-библиотека (Windows и Unix)</Text> </th> <th width="161"> <Text id="143">После запуска Apache, он автоматически закрывается.</Text> </th> <th width="242"> <Text id="144">Добавьте указание ServerName localhost в конфигурационный файл Apache (<CrossRef target="Section" ref="apache_web_server"/>).</Text> </th> </tr> <tr> <th width="140"> </th> <th width="161"> <Text id="145">Когда я пытаюсь попасть в цифровую библиотеку, изображается мусор - бинарный файл</Text> </th> <th width="242"> <Text id="146">Проверьте директиву ScriptAlias в конфигурационном файле Apache, удостоверьтесь, что она находится до директивы Alias (смотрите часть 4.2 и 4.3).</Text> </th> </tr> <tr> <th width="140"> </th> <th width="161"> <Text id="147">Я попадаю на стартовую страницу Greenstone(<CrossRef target="Figure" ref="your_greenstone_home_page"/>), но иконка Демо-коллекции не появляется.</Text> </th> <th width="242"> <Text id="148">Запустите программу library (в директории cgi-bin) из DOS для запуска отладки информации (debugging information) для обнаружения проблемы</Text> </th> </tr> <tr> <th width="140"> <Text id="149">Обе версии</Text> </th> <th width="161"> <Text id="150">Когда я пытаюсь попасть на страницу цифровой библиотеки, программа не может ее найти. </Text> </th> <th width="242"> <Text id="151">Попытайтесь использовать 127.0.0.1 вместо localhost . Это зарезервированный номер IP адреса и предназначен служить, как "loopback" для вашего компьютера.</Text> </th> </tr> <tr> <th width="140"> </th> <th width="161"> <Text id="152">Браузер не может найти main.cfg </Text> </th> <th width="242"> <Text id="153">Проверьте, существуют ли файлы Greenstone и доступны ли они для считывания. Если вы используете Интернет-библиотеку попробуйте запустить программу library с командной строки. Если она запустится, то проблема находится в file permissions (смотрите часть <CrossRef target="Section" ref="file_permissions"/>). Если нет, то переменная в gsdlhome конфигурационном файле gsdlsite.cfg наверняка настроена неправильно (смотрите Часть <CrossRef target="Section" ref="gsdlsite_configuration_file"/>)</Text> </th> </tr> <tr> <th width="140"> </th> <th width="161"> <Text id="154">Я имею неприятность, используя Коллектор</Text> </th> <th width="242"> <Text id="155">Прочтите Руководство Пользователя. Часть <CrossRef external="User" lang="ru" target="Chapter" ref="making_greenstone_collections"/></Text> </th> </tr> <tr> <th width="140"> </th> <th width="161"> <Text id="156">Я добавил нового пользователя, но она не может загрузиться.</Text> </th> <th width="242"> <Text id="157">Удостоверьтесь, что все, что находится в директории C:\Program Files\gsdl\etc, доступно для общего редактирования (часть <CrossRef target="Section" ref="file_permissions"/>)</Text> </th> </tr> </TableContent> </Table> </Content> </Subsection> </Content> </Section> <Section id="learn_more"> <Title> <Text id="158">Узнать больше</Text> Чтобы узнать больше о подробностях установки Гринстоун используйте Руководство разработчика цифровой библиотеки Гринстоун, включающее такие детали как - структура директорий и конфигурирование веб сайта созданного с помощью Гринстоун. <Text id="160">Коллекции Greenstone</Text> Несколько демонстрационных коллекций Greenstone включено в CD-ROM. Если Вы имеете доступ к Интернету, то много других коллекций может быть загружено с веб-сайта Новозеландского проекта цифровой библиотеки (nzdl.org) в предварительно построенном или не построенном виде. Демонстрационная коллекция Greenstone – это небольшая, доведенная до совершенства, субколлекция Гуманитарной библиотеки развития (HDL). Она иллюстрирует, какие большие возможности просмотра могут быть обеспечены, если доступны подходящие метаданные. Она включается автоматически при инсталляции программного обеспечения. Greenstone также идет с некоторыми хорошо документированными коллекциями, на страницах которых «О коллекции» описывается, как они построены. Они демонстрируют различные возможности Greenstone. Установленные диалоги опросят, хотите ли Вы включить их в инсталлируемую Вами программу Greenstone, укажут приблизительный объем на диске, необходимый для каждой коллекции.

<TableContent> <tr> <th width="123"> <Text id="164">demo</Text> </th> <th width="127"> <Text id="165">Демонстра-ционный пример Greenstone (7 Mб)</Text> </th> <th width="298"> <Text id="166">Небольшая субколлекция HDL. Если Вы клонируете эту коллекцию, то полный набор средств обслуживания появится только в том случае, если Ваши новые файлы сопровождаются соответствующей информацией о метаданных.</Text> </th> </tr> <tr> <th width="123"> <Text id="167">dls-e</Text> </th> <th width="127"> <Text id="168">Субколлекция Библиотеки развития (150 Мб)</Text> </th> <th width="298"> <Text id="169">Подобно демонстрационному примеру Greenstone, это - субколлекция HDL, но намного большего объема. Она содержит 250 публикаций - книг, сообщений и журналов - в различных областях развития человечества (полная коллекция HDL содержит 1230 публикаций). Она имеет ту же самую структуру, что и Демонстрационная коллекция Greenstone. Она довольно сложна. Поэтому, если Вы только начинаете работать, то лучше начать с просмотра некоторых других коллекций (например, демонстраций MSWord, PDF, архива Greenstone или коллекции простых изображений).</Text> </th> </tr> <tr> <th width="123"> <Text id="170">wrdpdf-e</Text> </th> <th width="127"> <Text id="171">Демонстрация MSWord и PDF (4 Мб)</Text> </th> <th width="298"> <Text id="172">Она содержит несколько документов в формате PDF, MSWord, RTF, PostScript, демонстрируя возможность построения коллекций из документов в различных форматах. Конфигурационный файл коллекции очень прост.</Text> </th> </tr> <tr> <th width="123"> <Text id="173">gsarch-e</Text> </th> <th width="127"> <Text id="174">Коллекция архивов Greenstone (5 Мб)</Text> </th> <th width="298"> <Text id="175">Коллекция сообщений электронной почты из архива списков адресатов Greenstone, использующая плагин Email, который анализирует файлы в форматах электронной почты. Конфигурационный файл коллекции очень прост.</Text> </th> </tr> <tr> <th width="123"> <Text id="176">сltbib-e</Text> </th> <th width="127"> <Text id="177">Библиографическая коллекция (7 Мб)</Text> </th> <th width="298"> <Text id="178">Эта коллекция включает приблизительно 4000 библиографических записей. Интерфейс поиска создан на основе бланка, который позволяет проводить поиск по полям записи. Это довольно сложный комплекс.</Text> </th> </tr> <tr> <th width="123"> <Text id="179">cltext-c</Text> </th> <th width="127"> <Text id="180">Приложение библиографии (1 Мб)</Text> </th> <th width="298"> <Text id="181">Это крошечная коллекция с библиографическими записями иллюстрирует средство «суперколлекции», которое проводит поиск в пересекающихся коллекциях. Она работает вместе с Библиографической коллекцией. Ее конфигурационный файл почти такой же.</Text> </th> </tr> <tr> <th width="123"> <Text id="182">MARC-e</Text> </th> <th width="127"> <Text id="183">Пример MARC (1 Мб)</Text> </th> <th width="298"> <Text id="184">Основанная на нескольких записях MARC из Библиотеки Конгресса, это простая коллекция, не позволяющая проведение поиска на основе заданной формы.</Text> </th> </tr> <tr> <th width="123"> <Text id="185">oai-e</Text> </th> <th width="127"> <Text id="186">Демонстраци-онная коллекция OAI (18 Мб)</Text> </th> <th width="298"> <Text id="187">Используя открытый архивный протокол и средства Импорта, она восстанавливает метаданные из архива и строит коллекцию из записей. В данном случае они являются изображениями, так что используются оба плагина OAI и Image.</Text> </th> </tr> <tr> <th width="123"> <Text id="188">image-e</Text> </th> <th width="127"> <Text id="189">Простая коллекция изображений (1 Мб)</Text> </th> <th width="298"> <Text id="190">Это очень основательная коллекция изображений не содержит никакого текста и никаких явных метаданных, что делает ее довольно нереалистичной. Конфигурационный файл является простым.</Text> </th> </tr> <tr> <th width="123"> <Text id="191">authen-e</Text> </th> <th width="127"> <Text id="192">Демонстрация форматирова-ния и аутентификации (8 Мб)</Text> </th> <th width="298"> <Text id="193">На том же самом материале, что и первоначальная демонстрационная коллекция Greenstone, она отличается двумя независимыми особенностями: форматирование нестандартных документов и управляемый доступ к документам после аутентификации пользователя.</Text> </th> </tr> <tr> <th width="123"> <Text id="194">garish</Text> </th> <th width="127"> <Text id="195">Резкая версия демонстрацион-ной коллекции (8 Мб)</Text> </th> <th width="298"> <Text id="196">Эта коллекция также содержит тот же самый материал, что и демонстрационный пример Greenstone. Ее вид был изменен, чтобы показать, как генерированные страницы могут быть изложены по-другому. Она реализована с использованием стандартного макро-файла, который предоставляется вместе с Greenstone.</Text> </th> </tr> <tr> <th width="123"> <Text id="197">isis-e</Text> </th> <th width="127"> <Text id="198">Пример CDS/ISIS (1 Мб)</Text> </th> <th width="298"> <Text id="199">Эта коллекция создана из базы данных CDS/ISIS, содержащей около 150 библиографических элементов. Для чтения стандартных для ISIS файлов .mst и .ftd и преобразования их в мета-данные Greenstone используется плагин ISISPlug.</Text> </th> </tr> </TableContent> </Table> </Content> </Chapter> <Chapter id="setting_up_webserver"> <Title> <Text id="200">Настройка сетевого сервера</Text> В этой части описан процесс настройки сетевого сервера для работы с Greenstone. Все то, что будет описано ниже, имеет отношение только к Интернет-библиотеке, и вы можете пропустить эту часть, если у вас установлена локальная библиотека. Мы будем рассматривать сетевой сервер Apache, который работает как в Windows, так и в Unix (смотрите Приложение для получения большей информации),Microsoft's Personal Web Server (Р\Л/8)(СетевЙ сервер Microsoft) и сетевой сервер Internet Information Services (US). PWS является стандартным сетевым продуктом Microsoft под Windows 95/98; US создан под Windows 2000 и Windows XP; Windows NT также может использовать этот сервер. Apache работает как с версией сетевой библиотеки для Windows, так и для Unix (но мы будем употреблять терминологию Windows); часть, касающаяся PWI/IIS, приведена только для пользователей Windows. После установки сетевого сервера необходимо установить сам Greenstone. Если в процессе установки будете нажимать кнопки, выбранные по умолчанию, то программа будет установлена в директорию C:\Program Files\gsdl вместе со всеми дополнительными файлами. Все сетевые серверы используют специальный URL адрес "localhost" для обозначения компьютера, на котором работает сетевой сервер. Таким образом, после того, как вы установите сетевой сервер, вы можете получить доступ к вашим HTML-документам, введя URL http://localhost в окне браузера. Если на вашем компьютере установлено название домена, то он используется вместо localhost для обозначения вашего компьютера в сети. Таким образом, для компьютера сервера New Zealand Digital Library адреса http://nzdl.org и http://locahost одинаковы. Если вы введете http://nzdl.org в вашем компьютере, вы соединитесь с сервером New Zealand Digital Library, в то время как если вы введете http://localhost, вы выйдете на ваш сетевой сервер.

<Text id="205">Сетевой сервер Apache</Text> Обычно этот сервер установлен в C:\Program Files\Apache Group\Apache и настроен так, чтобы директория cgi-bin находилась в поддиректории \cgi-bin и корнем документа (document root) являлась поддиректория \htdocs. Настройки можно изменить путем редактирования конфигурационного файла C:\Program Files\Apache Group\conf\httpd.conf. Он является текстовым файлом и легко читаем. В зависимости от того, как на вашем компьютере настроено сетевое программное обеспечение, вам нужно будет добавить строку в конфигурационный файл Apache, httpd.conf: ServerName localhost Если эта строка не включена, то система попытается найти название вашего сервера. Тем не менее, в некоторых версиях Windows существуют ошибки, которые не позволяют системе определить его название. В этом случае после запуска Apache немедленно закроется. Появляется окно с сообщением об ошибке, но оно моментально исчезает, и вы скорее всего его не увидите вообще. <Text id="209">Настройка Greenstone директории cgi-bin</Text> С директории Cgi-bin сетевой сервер обращается с документами, как с выполняемыми программами (executable programs). Директива ScriptAlias используется для создания директории cgi-bin. Заметьте, что эта директива способна превратить любую директорию в cgi-исполнимую директорию -не обязательно, чтобы директория называлась cgi-bin! И наоборот, директория cgi-bin не является особенной до того момента, как к ней не применить ScriptAlias. После инсталляции Apache имеет директорию cgi-bin в C:\Program Files\Apache Group\Apache\cgi-bin. Это означает, что если ввести адрес URL http://localhost/cgi-bin/hello, то сетевой сервер попробует запустить файл, называющийся hello, из директории. Есть программа Greenstone, называемая libmry.exe, которую нужно запустить с помощью сетевого сервера; в свою очередь она считывает файл, называемый конфигурационный файл местоположения Greenstone, или " gsdlsite.cfg ", который должен находится в той же директории. Лучший способ, чтобы выполнить это, необходимо использовать директиву ScriptAlias для создания новой директории cgi-bin. Вот часть из конфигурационного файла Apache httpd.conf, которая добавляет C:\Program Files\gsdl\cgi-bin в качестве дополнительной cgi-bin директории: ScriptAlias /gsdl/cgi-bin/ "C:/Program Files/gsdl/cgi-bin/" <Directory C:/Program Files/gsdl/cgi-bin> Options None AllowOverride None </Directory> (Интересный факт состоит в том, что конфигурационный файл Apache использует / вместо стандартных для Windows \). Это означает, что любой URLадрес вроде http://localhost/gsdl/cgi-bin...будет находиться в директории C:\Program Files\gsdl\cgi-bin и запущен сетевым сервером. Например, при встрече с URL http://localhost/gsdl/cgi-bin/hello сетевой сервер попытается извлечь файл C:\Program Files\gsdl\cgi-bin\hello и запустить его. Тем не менее, URL http://localhost/cgi-bin/hello будет искать в обычной директории cgi-bin Apache файл C:\Program Files\Apache Group\Apache\cgi-bin\hello и пытаться запустить его, так же, как и прежде. <Text id="216">Корневая директория документа</Text> Корневая директория документа является корнем структуры вашей директории. После установки Apache создает корневой документ в C:\Program Files\Apache Group\Apache\htdocs. Это означает, что если в сетевой сервер ввести URL http://localhost/hello.html, то он попытается извлечь файл, называемый hello.html, из той директории. Несколько файлов в Greenstone должны быть считываемы с помощью сетевого сервера. Самый простой способ выполнить эту задачу это использовать директиву Alias, которая почти такая же, как ScriptAlias, за исключением того, что она работает с простыми WWW-страницами, а не со скриптами cgi. Введите эти строки в конфигурационный файл Apache после директивы ScriptAlias, что сделает C:\Program Files\gsdl дополнительным местом поиска документов. Alias /gsdl/ "C:/Program Files/gsdl/" <Directory C:/Program Files/gsdl> Options Indexes MultiViews FollowSymLinks AllowOverride None Order allow,deny Allow from all </Directory> Это означает, что любые URL, которые совпадают с первым аргументом Alias (gsdl), будут разыскиваться в роли файлов, которые соответствуют второму аргументу. Другими словами, URL видов http://localhost/gsdl...будут разыскиваться, как файлы из директории C:\Program Files\gsdl. Например, при встрече с URL http://localhost/gsdl/hello.html, сервер попытается извлечь файл C:\Program Files\gsdl\hello.html. Тем не менее, URL http://localhost/ hello.html ищет файл в простой htdocs директорииC:\Program Files\Apache Group\Apache\htdocs\hello.html также, как и прежде. Не забудьте добавить директиву Alias после директивы ScriptAlias. При указании Apache для alias /gsdl до того, как /gsdl/cgi-bin совпадет с URL / gsdl/cgi-bin/library, до директивы Alias нежели ScriptAlias, он будет распознан, как запрос к документу, чем для запуска программы. В итоге бинарный программный файл должен быть "выведен, показан" в окне Интернет-браузера вместо того, чтобы его запустить. <Text id="221">Безопасность</Text> Вы должны знать, что если Интернет-библиотека будет установлена так, как описано выше, то каждый сможет загружать любой файл из структуры директории gsdl. Это включает индексные файлы, исходные документы любой готовой коллекции, пользовательская база данных, используемые регистрационные файлы (logs) и т.д. Если данная информация важна, вы можете изменить настройки конфигурационного файла сервера для ужесточения безопасности. В конфигурационном файле сетевого сервера Apache введите следующие строки вместо вышепоказанных Alias /gsdl/ "C:/Program Files/gsdl/" <Directory "C:/Program Files/gsdl"> Order allow,deny Deny from all <FilesMatch "\.(gif|jpe?g|png|css|mov|mpeg|ps|pdf|doc|rtf|jar|class)$"> Order allow,deny Allow from all </FilesMatch> </Directory> Это означает, что только те файлы, чье разрешение совпадает с regular expression в строке FilesMatch, могут быть загружены.

<Text id="225">Сетевые серверы PWS, MS</Text> Хотя ни PWS ни MS по умолчанию не установлены в системах Windows, их можно легко установить, пользуясь меню панели управления "Удалить/ Добавить программы". Если их нет на компакт-диске, то их можно загрузить с сайта Microsoft (www.mircosoft.com) Процесс инсталяции для обеих программ одинаков. Запустите Personal Web Manager и совершите следующие действия: Выберите Advanced (расширенный) для вывода окна Advanced Options (Расширенные возможности). Выберите Ноте(Начало) и нажмите АсИ(Добавить). Заполните поля следующим образом: В поле директория: C:\Program Files\gsdl В поле Alias : gsdl В поле Access permissions (разрешенный доступ): Read (чтение) В поле Application permissions: None Нажмите OK С этими установками файлы Greenstone будут доступны для сервера. Вернитесь в Advanced Options, выберите^/ и кликните Add Заполните следующие поля: Directory field:.C:\Program Files\gsdl\cgi-bin Alias field: cgi-bin Access permissions: None Application permissions: Execute Нажмите OK После этого программа Greenstone library.exe to be executed by the Webserver. Введите адрес URL http://localhost/gsdl/cgi-bin/library.exe Примечание: вам нужно дописывать расширение .ехе при использовании PWS, MS.

<Text id="245">Настройка сайта</Text> Для полноценного функционирования Greenstone необходимо настроить обеспечение доступа для нескольких файлов. Вдобавок существует конфигурационный файл, связанный с каждым местоположением Greenstone. В процессе установки создается базовый конфигурационный файл, основывающийся на ваших настройках во время этой процедуры; тем не менее, содержимое этого файла можно редактировать для оптимизации

<Text id="247">Файлы обеспечения</Text> Пользователи Windows 95/98 могут пропустить эту часть, так как эти версии не распознают владельцев файлов. В Windows NT, 2000, Unix cgi скрипты не могут работать в качестве нормальных пользователей, так как пользователей нельзя идентифицировать через WWW. Вместо этого cgi script работает как пользователь, который запустил сетевой сервер ( в Windows), или как частный пользователь (в Unix часто называемый nobody (никто)). В связи с этим все файлы и директории в C:\Program Files\gsdl должны быть доступны для всеобщего чтения (или, по крайней мере, доступны для чтения пользователям cgi-script, таким как "nobody"). Для проверки того, правильно ли установлены файлы обеспечения, запустите программу library.exe из командной строки. Если файлы находятся в нужном месте, но обеспечения доступа установлены неправильно, программа запустится с командной строки, когда ';ы запустите её - но не с браузера, т.е. когда nobody попытается запустить её. Для работы внешних пользователей через браузер необходимо, чтобы все директории Greenstone были общедоступны для считывания. Директория C:\Program Files\gsdl\etc и всё её содержимое также должны быть доступны для общегоизменения зяимсм.Эта директория, в которую библиотечная программа записывает все используемые логи, ошибки и инициализационные логи и различные базы данных пользователей. Но если вы всё же желаете ограничить доступ многих к возможности изменения, вы можете разрешить доступ только к initout.txt, key.db, users.db, history.db, usage.txt для внесения изменений eg [-пользователям. Если файлы обеспечении установлены неправильно для C:\Program Files\gsdl\etc, вы заметите, что функция идентификации и search history не работают и что программа не создает usage log (usage.txt).

<Text id="252">Конфигурационный файл gsdlsite.cfg</Text> В процессе установки создается базовый конфигурационный файл, основывающийся на ваших настройках во время этой процедуры. Это файл C:\Program Files\gsdl\cgi-bin\gsdlsite.cfg и вот его содержимое: # Site configuration file for Greenstone. # Lines begining with # are comments. # This file should be placed in the same directory as your library # executable file. it should be edited to suit your site. # points to the GSDLHOME directory gsdlhome “C:/Program Files/gsdl” # this is the http address of GSDLHOME # if your webservers DocumentRoot is set to $GSDLHOME # then httpprefix can be commented out httpprefix /gsdl # this is the http address of the directory which # contains the images for the interface. httpimg /gsdl/images # should contain the http address of this cgi script. This # is not needed if the http server sets the environment variable # SCRIPT_NAME #gwcgi /cgi-bin/library # maxrequests is the most requests a fastcgi process # will serve before it exits. This can be set to a # low figure (like 1) while debugging and then set # to a high figure (like 10000) when everything is # working well. #maxrequests 10000 Вы можете настроить все конфигурации путем редактирования этого файла, хотя скорее всего вам это не понадобится. Строка gsdlhome указывает на директорию C:\Program Files\gsdl httpprefix является WWW-адресом директории, в которую установлен Greenstone. Прежде мы описывали, как создать alias так, чтобы поиск Интернет-адресов типаhttp://localhost/gsdl/... осуществлялся в директории C:\Program Files\gsdl. Введение строки httpprefix /gsdl в конфигурационный файл gsdlsite устанавливает те же самые условия для програмного обеспечения Greenstone. httpimg является Интернет-адресом директории C:\Program Files\gsdl\images, который содержит все изображения форматов gif, используемых в интерфейсе. В любой стандартной инсталляции Greenstone это всегда будет httpprefix/images, и строку в файле выше можно не изменять. gwcgi является Интернет-адресом библиотечной программы cgi. Эта строка не нужна большинству серверов (включая Apache), и её нужно оставить в начальном виде. maxrequests используется версиями Greenstone, которые скомпилированы с использованием опции "fast-cgi". Стандартный бинарный дистрибутив не включает эту опцию, так как не все сетевые серверы поддерживают эту опцию. Fastcgi ускоряет выполнение cgi за счет содержания main executable в памяти между invocations программы, и отсутствия потребности в постоянной загрузке с диска каждый раз, когда запрашивается веб-страница. Trade off является объем используемой памяти, который может увеличиваться со все большим концом.

<Text id="260">Настройка базовой страницы</Text> Наверняка первым делом после того, как вы установите и наладите Greenstone, вы захотите настроить базовую страницу Greenstone. Файл, который отвечает за эту страницу называется home.dm и находится в поддиректории macros в директории, куда был установлен Greenstone (При установке по умолчанию это C:\Program Files\gsdl). Этот файл является пустым текстовым файлом, который вы можете отредактировать для создания новой базовой страницы. Мы рекомендуем создать новый файл, например, yourhome.dm вместо изменения home.dm. Он будет похож на home.dm, но будет использовать "package home". Эта часть, которая отвечает за всю работу немного по-другому. При создании отдельной базовой страницы нужно соединить её с цифровой библиотекой. Решение, которое предлагает Greenstone, сотоит в использовании "макросов"(макроэлементы, макрокоманды).Поэтому начальная базовая страница имеет расширение ".dm", а не ".html". Файл macro больше нежели простой HTML. Но не беспокойтесь: макро-файл содержит простой HTML и несколько дополнений, описанных ниже. Макроязык является мощным средством, и только малая его часть описана ниже - смотрите Руководство разработчика для большей информации.

<Text id="263">Пример</Text>

<Text id="264">Рисунок 3 Ваша собственная домашняя страница</Text> На рисунке показан пример созданной базовой страницы библиотеки. Каждая из ссылок "click here" (нажмите) приведет вас к соответствующим средствам Greenstone. Эта страница была создана файлом yourhome.dm, показанным на Рисунке .

<Text id="266">yourhome.dm, использованный для создания Рисунка <CrossRef target="Figure" ref="your_own_greenstone_home_page"/></Text> Вы можете использовать Рисунок как основу для создания ваших базовых страниц в Greenstone. В этом файле все сводится к тому, чтобы определить макрос, называемый content (содержимое). Вы можете добавить текст, также любые форматные команды HTML, для помещения всего необходимого вам на эту страницу Текс т, который вы вводите, это простой HTML; если вы желаете, можно добавить гиперссылки и использовать другие возможности, предоставляемые HTML. Для соединения вашей новой базовой страницы с другими страницами библиотеки вам необходимо использовать определенное "указание". В языке макрос ими являются те слова, которые с двух сторон обозначены специальными знаками .Вы можете их увидеть на Рисунке . Например, _httppagehome_ возвращает на базовую страницу, httppagehelp_ приводит к странице Справки и т.д. В некоторых случаях вам нужно будет указать название коллекции. Например, httpquery_&c=demo настраивает страницу поиска на Демо-коллекцию; для других коллекций вы должны будете заменить demo на соответствующее название коллекции. Макроопределение, называемое _content_, является простым HTML Любой стандартный код HTML может быть заменен макроопределениями. Однако, такие символы, как '{', '}', 'V, и '_' нужно выделять с помощью backslash, чтобы избежать их перереработки макро языковой интерпретатор. Заметьте, что макроопределение _content_ не содержит никаких заголовков и footer. Если вы желаете изменить заголовки или footer вашей базовой страницы, необходимо обозначить макросы header_ и/или Jooter_, добавив их в файл yourhome.dm в виде: _macroname_ { ... } Например, протяженный зеленый рисунок, находящийся в левой части страницы, обозначен в макросе _header_, и при удалении содержимого этого макроса рисунок уберется.

<Text id="272"> Что нужно сделать, чтобы всё заработало</Text> Для того чтобы ваш файл yourhome.dm начал работать, вы должны указать его в главном конфигурационном файле main.cfg, так как программа считывет макрофайлы, указанные в нем. Таким образом, чтобы программа начала использовать базовую страницу, созданную вами вместо начальной, вы должны поместить yourhome.dm в директорию macros на Рисунке . Затем в конфигурационном файле main.cfg замените home.dm на yourhome.dm в списке макрос файлов, которые должны загружаться при запуске программы.

<Text id="275">Переадресация URL к Greenstone</Text> Для адресов к программе cgi вы можете создать более удобную переадресовку(более короткая и сжатая форма). Например, адрес URL http://nzdl.org (сокращеная форма http://nzdl.org/index.html) переадресовывается на адрес http://nzdl.org/cgi-bin/library. Сетевой сервер Apache выполняет это с помощью директивы Redirect. Как и другие директивы, она находится в C:\Program Files\Apache Group\Apache\conf\httpd.conf. Для переадресации URL http://www.yourserver.com На http:// www.yourserver.com/cgi-bin/library введите это в конфигурационный файл httpd.conf: Redirect /index.html http://www.yourserver.com/cgi-bin/library Таким образом вы получите прямой доступ к библиотеке через адрес http://www.yourserver.com . Если вы хотите, чтобы адрес http:// www.yourserver .com/greenstone приводил вас к http://www.yourserver.com/ cgi-bin/library введите в конфигурационном файле: Redirect /greenstone http://www.yourserver.com/cgi-bin/library Если у вашего сервера нет доменного имени (как www.yourserver.com выше), просто замените название www.yourserver.com на localhost в строках, указанных выше. Это приведет к такому же результату. Вместо того, чтобы помещать директивы переадресации в файл http.conf, вы также можете поместить их в файл .htaccess, находящийся в корневой директории вашего сервера. При внесении изменений в файл .htaccess они вступят в силу немедленно, тогда как для начала работы с измененным файлом httpd.conf нужно перезапустить Apache. Во- вторых, часто в системе Unix вам нужно быть "корневым" пользователем для изменения httpd.conf, в то время как любые пользователи могут изменить .htaccess.

<Text id="280">Приложение Необходимое программное обеспечение</Text> Here is how to obtain the software packages mentioned above.

<Text id="282">Сетевой сервер Apache</Text> Для работы с любой версией Greenstone, за исключением Локальной Библиотеки, вам необходим сетевой сервер. Большинство цифровых библиотек, в особенности объемные, уже содержат в себе встроенные серверы. С сайта Www.apache.org можно быстро и бесплатно загрузить сетевой сервер Apache.

<Text id="284">Perl</Text> Для построения коллекций Greenstone использует язык программирования Perl. Версия Greenstone, предназначенная для Windows, уже включает в себя Perl. Большинство систем Unix также имеют Perl, но если он не установлен, то вы можете бесплатно загрузить исходный и бинарный код этой программы для разных версий Unix с сайта www.perl.com. Вам необходима версия Perl 5.0 или выше.

<Text id="286">GCC</Text> Версия Greenstone для Unix компилируется с помощью Gnu C++ compiler (GCC). Greenstone часто использует стандартную шаблонную библиотеку C++ (мы обнаружили, что она не работает со старыми версиями GCC; пожалуйста, сообщите нам, если у вас с этим возникнут проблемы). Заметьте, что эта версия Greenstone не компилируется в GCC 3.0.

<Text id="288">GDBM</Text> Все версии Greenstone используют Gnu Database Manager, GDBM. Она распространяется вместе со всеми версиями Greenstone под Windows и устанавливается автоматически во время процесса установки. Большинство версий Linux уже имеют GDBM, поэтому он не включен в диск для Greenstone под Linux. Но если вам необходим GDBM, то вы можете его загрузить с сайта Www.gnu.org.

<Text id="290">Java Runtime Environment</Text> Чтобы использовать Библиотечный интерфейс Greenstone, Вам необходима подходящая версия JRE. Если Вы еще не располагаете ею, подходящая версия включена в CD-ROM. Вы можете загрузить последнюю версию с сайтаhttp://java.sun.com/j2se/downloads.html. Необходима версия 1.4.0 или выше.

<Text id="292">Компилятор Java</Text> Для компилирования исходной программы Библиотечного интерфейса Greenstone Вы должны сначала установить Java Development Kit. Вы можете загрузить J2SE c cайтаhttp://java.sun.com/j2se/downloads.html. Требуется версия 1.4.0 или выше.