ЦИФРОВАЯ БИБЛИОТЕКА GREENSTONE ИНСТРУКЦИЯ ПО УСТАНОВКЕ

Chapter 2 Процесс Инсталляции

Contents

Windows
Unix
Расположение Greenstone
Библиотечный интерфейс Greenstone (GLI)
Проверка и возможные проблемы
Узнать больше

Существуют разные версии Greenstone, созданные для Windows и Unix, и они доступны в двух формах: бинарная форма и исходный код. Для интерфейса программы используется Интернет-браузер: Netscape Navigator или Internet Explorer (версии 4.0 или выше в обоих случаях). Если на вашем компьютере еще не установлен Интернет-браузер, то на этом CD-ROM есть Windows - версия Netscape Navigator.

2.1 Windows

Если вы являетесь пользователем Unix, то вы можете пропустить эту часть и начать с части 2.2. Для пользователей Windows, желающих выполнить "обычную установку" (simple installation), надо знать, что весь программный пакет Greenstone займет около 40 Mb на жестком диске.

Если вы выберете другую форму установки, то вам нужно решить, устанавливать ли вам бинарный код или исходный код. Если сомневаетесь, то лучше выберите бинарный код. Процесс установки идентичен для обоихтипов. Ниже описаны опции, с которыми вы столкнетесь при выборе типа инсталляции.

После завершения инсталляции вы можете сразу же перейти к части 2.3.

Обычная инсталляция

Для установки версии программы под Windows вставьте CD-ROM в соответствующий дисковод (например D:). Если процесс инсталляции не начнется через 20 секунд, то нажмите на меню Пуск, выберите Выполнить и напишите D:\setup.exe где D: это дисковод для CD-ROM. В версии Windows 3.1, выберите Выполнить ИЗ Файлового менеджера И введите D:\Windows\win3.1\setup.exe.

Для простой установки выбирайте все условия, которые предлагаются по умолчанию, нажимая на кнопку Далее(Next) . Это все, что вам надо сделать! Greenstone будет установлен в директории C:\Program Files\gsdl.

После завершния установки для запуска системы нажмите на кнопку Пуск, выберитеМеню Программы, затем Greenstone Digital Library, запусгив программу. Для входа в Демо-коллекцию нажмите на соответствующую иконку в Главном меню Greenstone

Figure 2  Домашняя страница


Бинарные библиотеки под Windows

На CD-ROM две раздельные бинарные программы для Windows: Локальная Библиотека и Веб Библиотека. Инсталляция по умолчанию, описываемая свыше, выбирает версию Локальной Библиотеки. Мы настоятельно рекомендуем вам использовать эту версию. Веб Библиотека, которую намного сложнее установить, необходима только, если у вас уже существует веб сервер и хотите использовать его и для Гринстоун. Несмотря на своё скромное название, Локальная Библиотека пердлагает полую и самодостаточную возможность в обслуживании сети.

Локальная библиотека. С помощью Локальной библиотеки можно работать с готовыми коллекциями Greenstone в любой версии Windows. Демо-коллекция устанавливается автоматически. Вы также можете добавлять новые коллекции с компакт-диска (описанные в Части 3).

Локальная библиотека предназначена для работы на отдельных компьютерах или компьютерах, на которых еще не установлены сетевые серверы. Она содержит небольшой встроенный сервер, для того чтобы другие компьютеры, подключенные к той же сети, могли иметь доступ к библиотеке (но этот сервер имеет ограниченные возможности).

Программный пакет локальной библиотеки автоматически определяет наличие программы, отвечающей за сетевые возможности на вашем компьютере, и определяет, подключены ли вы к сети. Но возможны две проблемы с этой библиотекой:

  • Время от времени может совершаться незапланированный dial-up
  • Она может не работать из-за неправильной установки сетевого программного обеспечения.

Для избежания таких проблем диск содержит ограниченную версию Локальноый библиотеки, которую можно использовать вместо стандартной. Эта версия работает только в Netscape- При запуске библиотеки вы увидите иконку, позволяющую войти в эту версию. Предпочтительней использовать стандартную версию, не вызывающую этих проблем.

Интернет - библиотека (Web Library). С помощью этой библиотеки и при наличии сетевого сервера можноработать с готовыми коллекциями.Эта библиотека позволяет компьютеру с существующим сетевым сервером работать с готовыми Greenstone коллекциями. Как и в случае с локальной библиотекой, Демо-коллекция также будет установлена автоматически. Вы также можете установить и другие коллекции, находящиеся на CD-ROM, (смотрите Часть 3).

Отличие Интернет-библиотеки от Локальной состоит в том, что она предназначена для компьютеров, которые уже имеют программный пакет сетевого сервера.

Для запуска Интернет-библиотеки вам необходим:

  • Программный пакет сетевого сервера. Для этого можно использовать Apache (смотрите Приложение 7)
  • Коллектор. Этот компонент включен как в Локальную, так и в Интернет-библиотеку и позволяет вам создавать коллекции из документов вашему усмотрению. (В Windows 3.1/3.11 Коллектор не работает).

Настройка сетевого сервера Windows (Только для версии Интернет-библиотеки)

Преимуществом Локальной библиотеки является то, что ее можно запустить сразу же после установки, и она не нуждается в какой-либо настройке. В случае с Интернет-библиотекой вам предстоит настроить ваш сетевой сервер. Если на вашем компьютере сетевой сервер уже установлен, то вам нужно ввести небольшие изменения в его конфигурационный файл для работы с Greenstone.

Специальный инсталляционный скрипт Apache говорит о том, что именно надо сделать-смотрите часть 4.2 инструкции по настройке сетевых серверов PWS, MS. Вам, возможно, понадобится помощь системного администратора для настройки существующего сервера.

Если у вас еще нет сетевого сервера, то вам его нужно установить (смотрите в Приложении 7 информацию об Apache). Затем вам нужно будет его правильно настроить. В 4 части дано детальное описание того, как отдельные части веб-сервера влияют на Greenstone и как нужно их изменить. Все это сводится к тому, что нужно будет ввести около шести строк в конфигурационный файл.

Исходный код для Windows

Исходный код Greenstone занимает 50 Mb пространства, но для того чтобы его скомпилировать вам потребуется около 90Mb. Для компиляции вам необходим:

  • The Microsoft Visual C++ compiler (на данный момент мы решаем небольшие проблемы по поводу компиляции Greenstone с помощью разныхь портов GNU GCC.)

(Вам не нужен GDBM, СУБД Gnu database manager, так как он включен впрограммный пакет Greenstone).

Маловероятно, что вы сможете скомпилировать программу в Windows 3.1/3.11.

Если вы перекомпилируете Greenstone и используете эту версию для создания CD-ROM, вы должны запомнить, что код, созданный с помощью последнихВерсий НTPP/ C++ compiler, не работает в Windows 3.1/3.11, тогда как надругих более новых версиях (95,98,Me,N7,2000) он работает. Если вы хотите,чтобы перекомпилированная версия работала на более ранних версияхWindows, то вам нужно будет использовать другую версию компилятора.Более того, Greenstone использует STL, C++ standard templatelibrary(стандартная шаблонная библиотека), И ХОТЯ некоторые КОМПИЛЯТОРЫсодержат STL, эта версия не будет работать нормально. Поэтому дляперекомпиляции Greenstone, чтобы он работал на ранних версиях Windows,вам нужен:

  • The Microsoft Visual C++ compiler, Версия 4.0 или 4.2
  • Внешнюю версию STL, C++ STL входит в программное обеспечение Greenstone специально для работы с этими версиями компиляторов.

Нужно заметить, что при выборе установки исходного кода в процессе установки Greenstone, код не будет компилироваться автоматически. Инструкции, связанные с компиляцией Greenstone, смотрите в документе lnstall.txt, который находится в директории (C:\Program Files\gsdl по умолчанию).

2.2 Unix

Эта часть написана для пользователей Unix (Пользователи Windows могут сразу перейти к части 2.3).Для установки вам нужно будет выбрать между бинарным и исходным кодами. Бинарный код занимает около 50 Mb; исходный код требует 160МЬ для компиляции.

Бинарный код для Unix

Бинарный код нуждается в Linux дистрибутиве, основанном на Intelх8б, который включает в себя ELF binary support. Ниже перечислены дистрибутивы, которые соответствуют этим требованиям:

  • RedHat 5.1
  • SuSe Linux 6.1
  • Debian 2.1
  • Slackware 4.0

Более ранние версии этих дистрибутивов также должны работать.

Вам потребуется сетевой сервер: мы рекомендуем Apache. Мы также настоятельно рекомендуем вам установить сетевой сервер до того, как вы установите Greenstone - это значительно облегчит процесс инсталляции. Если вы планируете создавать цифровые коллекции, то вам также понадобится Perl, если он еще не установлен на вашей системе. Во многих версиях Linux программа Perl устанавливается по умолчанию. В Приложении 7 вы можете узнать, где и как приобрести Apache и Perl.

Исходный код для Unix

Исходный код для Unix является таким же, как и для Windows. Он был скомпилирован и проверен на Linux, Solaris, Macintosh OS/X. Настроить этот код под другие версии Unix будет не сложно.

Для компиляции исходного кода на Unix вам нужно иметь

  • GCC, Gnu C++ compiler
  • GDBM, Gnu database manager.

Для запуска программы Greenstone вам также понадобится сетевой сервер и Perl, как было описано выше.

Установка Unix

Для установки версии Unix с компакт-диска вставьте диск в дисковод иВведите следующие команды:

mount /cdrom

 (эта команда может отличатся от одной версии к другой; например на OS/X вы вводиггедиректорию /Volumes  a затем в соответствующую поддиректорию для CD-ROM)

cd /cdrom

изменить директорию на высший уровень CD-ROM

cd Unix

Изменить директорию туда, где установлен 
инсталляционный скрипт Unix .

sh Install.sh

Начать процесс инсталляции (буквенное сочетание необходимо так как во многих случаях вы не можете начать инсталляцию программ прямо с компакт-диска).


Начать процесс инсталляции (буквеное сочетание необходимо так как во многих случаях вы не можете начать инсталляцию программ прямо с компакт-диска).

Последняя команда вызывает интерактивное диалоговое окно, в котором запрашивается информация, необходимая для установки Greenstone. В этом окне помещается детальный отчет о том, что происходит. Процесс установки начинается с того, что у вас запрашивается директория, в которую вы желаете установить программу. Первый файл, который помещается в эту директорию, - это файл "удалить" (uninstall), который очищает эту директорию от файлов незавершенной установки, в случае, если у вас возникнут проблемы или вы приостанавливаете установку. Следующий - шаг вы должны выбрать между бинарным и исходным кодами. Затем появляются вопросы о параметрах вашего WWW-браузера. Вам нужно иметь исправную cgi executable directory (обычно называется "cgi-bin" в системах Unix); вы можете создать новую либо использовать старую. Если вы создадите новую, то вам необходимо ввести эту информацию в конфигурационный файл сетевого сервера. В любом случае вам нужно будет ввести WWW-адрес директории cgi. Интерактивные окна проведут вас через весь инсталляционный процесс. Очень важно правильно вводить file permissions в определенных директориях, где у вас потребуют соответствующую информацию. И наконец у вас потребуют пароль. Для пользователя "администратор" введите "admin".

По умолчанию, Greenstone устанавливается в директории /usr/local/gsdl, если установку производит "корневой"(гоо1) пользователь, а в ином случае - в директорию ~/gsdl (где "~" является главной директорией пользователя).

Установка бинарного кода занимает несколько минут. Если вы устанавливаете исходный код, то инсталляционный скрипт будет компилировать его, что займет от 10 минут до часа, в зависимости от скорости вашего процессора.

Для удаления программы введите

cd ~/gsdl

или /user/local/gsdl, а "корневой" пользователь может ввести команду

sh Uninstall.sh

В процессе установки помимо Демо-коллекции вы можете установить и другие коллекции. Демо-коллекция Greenstone устанавливается автоматически; сведения об остальных вы найдете в 3 части.

Настройка сетевого сервера Unix

Если на вашем компьютере уже установлен сетевой сервер, то в его конфигурационный файл нужно будет внести некоторые изменения, для того чтобы он был совместим с Greenstone. В инсталляционном скрипте описано, как это надо сделать. Для вашего удобства этот инсталляционный скрипт записан в файле INSTALL RECORD в той же директории, в которую вы установили Greenstone

Если у вас еще нет сетевого сервера, то его нужно будет установить. В Приложении 7 есть информация об Apache. Затем вам нужно будет его настроить. В 4 части описаны части WWW-сервера Apache, которые взаимосвязаны с Greenstone, и то, как их нужно изменить. Все сводится к тому, что вам нужно будет ввести полдюжины строк в его конфигурационный файл.

Вам не обязательно быть корневым пользователем Unix для совершения описанного выше процесса инсталляции. Но когда дело доходит до настройки сетевого сервера Apache, тогда вам понадобятся привилегии корневого пользователя. Если вы желаете установить второй сервер Apache, то вы можете это сделать, даже если на вашем компьютере уже установлен один.

2.3 Расположение Greenstone

Локальная библиотека (только для Windows)

Если вы используете Локальную библиотеку, то просто запустите программу Greenstone кнопкой Пуск в меню. Это автоматически загружает программу, и на экране в окне вашего браузера появляется стартовая страница. С этой страницы также доступна Делю-коллекция. В диалоговом<*>кНе меню вы можете изменить ваш браузер, который используется по умолчанию. Нет никакой разницы, используете ли вы Internet Explorer или Netscape Navigator, за исключением того, что если у вас установлен Windows 2000, то мы рекомендуем использовать Internet Explorer.

Интернет-Библиотека (Windows и Unix)

Если вы используете Интернет-библиотеку, то после завершения установки и настройки сетевого сервера, используйте следующий WWW-адрес для входа в вашу программу:

http://localhost/gsdl/cgi-bin/library

Демо-коллекция Greenstone также должна быть доступна с этой страницы.

Коллектор

В стартовом окне Greenstone есть ссылка к коллектору (Collector).

Администрирование

Там также есть ссылка к странице Администрирование. Пользователь "администратор" называется admin, который использует пароль, указанный в процессе Инсталляции. Администратор может добавлять новых пользователей и разрешает создание новых коллекций.

2.4 Библиотечный интерфейс Greenstone (GLI)

Библиотечный интерфейс 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.

Запуск под Windows

Чтобы запустить GLI под Windows, обратитесь к папке gli в Вашей инсталляции Greenstone, используя, например, Windows Explorer, и щелкните дважды на файле с названием gli.bat. Этот файл проверяет наличие Greenstone, JRE и Perl и запускает GLI.

Запуск под Unix

Чтобы запустить GLI под Unix, измените на gli директорию в Вашей установке Greenstone, а затем запустите скрипт gli.sh. Этот скрипт проверяет наличие Greenstone, JRE и Perl на поисковом пути и запускает GLI.

Получение помощи

GLI предоставляет обширные диалоговые средства помощи. Чтобы получить помощь, щелкните кнопкой Help в верхней правой части экрана. Это откроет текст раздела, который касается того, что Вы делаете – какая из панелей GLI в настоящее время работает. Вы можете щелкнуть по тексту помощи, чтобы изучить то, что Вам необходимо знать. Используйте это.

Компилирование GLI

Если Вы запустили программу дистрибутива Greenstone, то Вы будете иметь исходную программу Java из GLI. Чтобы выполнить компилирование, Ваш компьютер должен иметь Java Development Kit. В приложении 7 дается информация относительно того, как ее получить. Чтобы компилировать исходную программу, введите файлы makegli.bat ( Windows) или makegli.sh (Unix). После того, как компилирование завершено, Вы можете запустить GLI, как было описано выше.

2.5 Проверка и возможные проблемы

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

возможные проблемы

 

Проблема

Попробуйте

Локальная библиотека (только Windows)

Когда я запускаю программу, компьютер просит меня набрать номер интернет-провайдера.

Нажмите на кнопку Отмена.. Обычно этого достаточно, чтобы решить проблему.

 

Когда я запускаю Greenstone, компьютер продолжает запрашивать подключение к интернет-провайдеру

Выберите "Restricted version"(ограниченная версия) при запуске программы. Она работает лишь в Netscape.

 

Когда я пытаюсь попасть на страницу цифровой библиотеки, она не может

Проверьте ваши Интернет proxy - настройки Edit preferences в Netscape и Internet options (свойства обозревателя) в Explorer

 

Коллектор работает очень медленно!

Используете ли вы Netscape в Windows 2000? Если это так, то попробуйте использовать Internet Explorer в Windows 2000. У Windows 2000 существует какая- то несовместимость с Netscape.

Интернет-библиотека (Windows и Unix)

После запуска Apache, он автоматически закрывается.

Добавьте указание ServerName localhost в конфигурационный файл Apache (4.1).

 

Когда я пытаюсь попасть в цифровую библиотеку, изображается мусор - бинарный файл

Проверьте директиву ScriptAlias в конфигурационном файле Apache, удостоверьтесь, что она находится до директивы Alias (смотрите часть 4.2 и 4.3).

 

Я попадаю на стартовую страницу Greenstone(2), но иконка Демо-коллекции не появляется.

Запустите программу library (в директории cgi-bin) из DOS для запуска отладки информации (debugging information) для обнаружения проблемы

Обе версии

Когда я пытаюсь попасть на страницу цифровой библиотеки, программа не может ее найти.

Попытайтесь использовать 127.0.0.1 вместо localhost . Это зарезервированный номер IP адреса и предназначен служить, как "loopback" для вашего компьютера.

 

Браузер не может найти main.cfg

Проверьте, существуют ли файлы Greenstone и доступны ли они для считывания. Если вы используете Интернет-библиотеку попробуйте запустить программу library с командной строки. Если она запустится, то проблема находится в file permissions (смотрите часть 5.1). Если нет, то переменная в gsdlhome конфигурационном файле gsdlsite.cfg наверняка настроена неправильно (смотрите Часть 5.2)

 

Я имею неприятность, используя Коллектор

Прочтите Руководство Пользователя. Часть

 

Я добавил нового пользователя, но она не может загрузиться.

Удостоверьтесь, что все, что находится в директории C:\Program Files\gsdl\etc, доступно для общего редактирования (часть 5.1)


2.6 Узнать больше

Чтобы узнать больше о подробностях установки Гринстоун используйте Руководство разработчика цифровой библиотеки Гринстоун, включающее такие детали как - структура директорий и конфигурирование веб сайта созданного с помощью Гринстоун.


Copyright © 2002 2003 2004 2005 2006 2007 by the New Zealand Digital Library Project at the University of Waikato, New Zealand.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled “GNU Free Documentation License.”