Seminarul Internaţional „Implementarea tehnologiei IR (repozitorii instituţionale): Sistemul DSpace”, 14-15 aprilie 2011. Chişinău, Ambasada Regală a Norvegiei în România, Asociaţia Bibliotecarilor din Republica Moldova, Consorţiul REM, Programul EIFL-OA, Biblioteca Ştiinţifică a Academiei de Studii Economice din Moldova. Instructor: Kuzma KUDIM, Institutul Sisteme Software al Academiei de Ştiinţe din Kiev, Ucraina.

1. II — Установка
© 2011 Кузьма Кудим

2. 1. Подготовка к установке
Аппаратное и программное обеспечение

3. Аппаратное обеспечение
Любой современный сервер
объём жёсткого диска
все файлы x 2
объём оперативной памяти и скорость
процессора
зависит от количества пользователей

4. Программное обеспечение
Операционная система
Linux
Windows

5. Программное обеспечение
Java
SDK
Ant
Maven

6. Программное обеспечение
База данных
Postgre
postgresql.conf
listen_addresses = 'localhost'
pg_hba.conf
md5
Oracle

7. Программное обеспечение
Контейнер сервлетов
Tomcat
другие

8. 2. Основная установка

9. Два релиза
"Упрощённый"
dspace-1.7.0-release.zip
Модули заранее скомпилированы
Полный
dspace-1.7.0-src-release.zip
Включён весь исходный код

10. Основные каталоги
Исходный каталог
[dspace-source]
Установочный каталог
[dspace]
Каталог веб-приложений
[dspace]/webapps
[tomcat]/webapps

11. Установка
Создать пользователя
useradd -m dspace

12. Установка
Скачать DSpace
http://www.dspace.org/latest-release
dspace-1.7.0-src-release.zip
Распаковать
unzip dspace-1.7.0-src-release.zip

13. Установка
Создать базу данных
createuser -U postgres -S -R -d -P dspace
createdb -U dspace -E UNICODE dspace

14. Установка
Начальная настройка
[dspace-source]/dspace/config/dspace.cfg
• dspace.dir
• dspace.url
• dspace.hostname
• dspace.name
• db.username
• db.password
• mail.server
• mail.from.address, feedback.recipient, mail.admin,
alert.recipient, registration.notify
• handle.canonical.prefix

15. Установка
Создать каталог для установки
например, /opt/dspace
mkdir /opt/dspace
chown dspace:dspace /opt/dspace

16. Установка
Собрать DSpace
maven
cd [dspace-source]/dspace/
mvn package
ant
cd [dspace-source]/dspace/target/dspace-1.7.1-build.dir
ant fresh_install

17. Установка
Развернуть веб-приложения
Скопировать
cp -R [dspace]/webapps/* [tomcat]/webapps
Или отдельное приложение
cp -R [dspace]/webapps/xmlui [tomcat]/webapps

18. Установка
Создать первого администратора
[dspace]/bin/dspace create-administrator

19. Установка
Перезапустить сервер
service tomcat7 restart
Открыть в браузере
http://dspace.isofts.kiev.ua:8080/xmlui

20. 3. Дополнительная установка

21. 80-й порт
Перенаправление с помощью:
Брандмауэра
--iptables -A INPUT -i eth0 -p tcp --dport 80 -j ACCEPT
--iptables -A INPUT -i eth0 -p tcp --dport 8080 -j ACCEPT
--iptables -A PREROUTING -t nat-i eth0 -p tcp --dport 80 -j REDIRECT --to-port 8080
HTTP-сервера
<VirtualHost *:80>
...
ServerName dspace.isofts.kiev.ua
ProxyPass / ajp://localhost:8009/
ProxyPassReverse / ajp://localhost:8009/
</VirtualHost>

22. Периодические задачи
Пользователь dspace
crontab -e
# Рассылать почту в 1:00 ежедневно
0 1 * * * [dspace]/bin/dspace sub-daily
# Запускать медиа-фильтр в 2:00 ежедневно
0 2 * * * [dspace]/bin/dspace filter-media
# Подсчёт статистики
0 3 * * * [dspace]/bin/dspace stat-general
Пользователь postgres stat-monthly
10 3 * * * [dspace]/bin/dspace
30 3 * * * [dspace]/bin/dspace stat-report-general
40 3 * * * [dspace]/bin/dspace stat-report-monthly

23. Периодические задачи
Пользователь postgres
crontab -e
# Очищать базу данных в 4:20 ежедневно
20 4 * * * vacuumdb --analyze dspace > /dev/null 2>&1

24. Handle-сервер
Отключить:
handle.canonical.prefix = ${dspace.url}/handle/

25. Проверка установки
Веб-сервер
Открыть страницу в браузере
База данных
Создать пользователя/раздел/коллекцию
Почтовый сервер
Отправить сообщение по обратной связи

26. II — Установка
© 2011 Кузьма Кудим
Всю установку можно проводить удалённо.
Например, на Linux установку несложно
провести в командной строке по протоколу SSH.

27. 1. Подготовка к установке
Аппаратное и программное обеспечение

28. Аппаратное обеспечение
Любой современный сервер
объём жёсткого диска
все файлы x 2
объём оперативной памяти и скорость
процессора
зависит от количества пользователей

29. Программное обеспечение
Операционная система
Linux
Windows

30. Программное обеспечение
Java
SDK
Ant
Maven
Для ant установить
ant-apache-regexp

31. Программное обеспечение
База данных
Postgre
postgresql.conf
listen_addresses = 'localhost'
pg_hba.conf
md5
Oracle
Устанавливаем и настраиваем PostgreSQL server.
При установке на Linux не забыть:
service postgresql initdb
chkconfig postgresql on
Графический клиент для администрирования
pgadmin3

32. Программное обеспечение
Контейнер сервлетов
Tomcat
другие
Установить переменную окружения
TOMCAT_USER=dspace, чтобы сервер
запускался от пользователя dspace и имел
доступ к файлам DSpace.

33. 2. Основная установка

34. Два релиза
"Упрощённый"
dspace-1.7.0-release.zip
Модули заранее скомпилированы
Полный
dspace-1.7.0-src-release.zip
Включён весь исходный код
DSpace распространяется в двух вариантах:
"упрощённом" и полном.
В упрощённом релизе отдельные модули
скомпилированы заранее, поэтому в случае
необходимости в их код нельзя внести
изменения, а значит настройку системы можно
осуществлять только через файлы
конфигурации. Однако в любой момент может
возникнуть необходимость внести изменения,
которые не отражены в файлах настроек.
Поэтому я рекомендую использовать полную
версию. Установка этого варианта не отличается
от установки упрощённого, а в случае
надобности исходный код всегда под рукой.

35. Основные каталоги
Исходный каталог
[dspace-source]
Установочный каталог
[dspace]
Каталог веб-приложений
[dspace]/webapps
[tomcat]/webapps
В DSpace используется три раздельных дерева
каталогов. Они определяются при установке, а
всюду в документации их можно найти по
сокращённым именам в квадратных скобках.
Подробного их устройства можно не знать,
однако нужно знать, что они есть и как они
называются.
1. Исходный каталог, куда распакован релиз.
2. Каталог, в который установлен DSpace, т. е.
откуда запускаются сценарии и считываются
файлы настроек.
3. Каталог веб-приложений, где расположены
скомпилированные модули системы. В
зависимости от настроек веб-сервера, может
находится либо в каталоге утановки, либо в
специальном каталоге веб-сервера.

36. Установка
Создать пользователя
useradd -m dspace
Прежде всего создадим пользователя dspace. От
имени этого пользователя также должен будет
запускаться веб-сервер.
Пользователя можно создать либо при установке
операционной системы, либо уже на
установленной системе, как это показано на
слайде.

37. Установка
Скачать DSpace
http://www.dspace.org/latest-release
dspace-1.7.0-src-release.zip
Распаковать
unzip dspace-1.7.0-src-release.zip
С сайта DSpace скачаем самый свежий релиз и
распакуем его.
Выбрана полная версия и тип архива zip.

38. Установка
Создать базу данных
createuser -U postgres -S -R -d -P dspace
createdb -U dspace -E UNICODE dspace
Ключи createuser:
-U имя от кого подключение
-S не суперпользователь
-R не создаст новых пользователей
-P задать пароль
dspace имя нового пользователя

39. Установка
Начальная настройка
[dspace-source]/dspace/config/dspace.cfg
• dspace.dir
• dspace.url
• dspace.hostname
• dspace.name
• db.username
• db.password
• mail.server
• mail.from.address, feedback.recipient, mail.admin,
alert.recipient, registration.notify
• handle.canonical.prefix
Значения некоторых свойств в файле настроек
нужно установить до начала установки.

40. Установка
Создать каталог для установки
например, /opt/dspace
mkdir /opt/dspace
chown dspace:dspace /opt/dspace
Каталог создаётся тем пользователем, у которого
есть на это права. Затем владельцем каталога
назначается пользователь dspace.

41. Установка
Собрать DSpace
maven
cd [dspace-source]/dspace/
mvn package
ant
cd [dspace-source]/dspace/target/dspace-1.7.1-build.dir
ant fresh_install
DSpace использует два инструмента для сборки
проектов на java: maven и ant. Связано это с
постепенным переходом от ant к maven.

42. Установка
Развернуть веб-приложения
Скопировать
cp -R [dspace]/webapps/* [tomcat]/webapps
Или отдельное приложение
cp -R [dspace]/webapps/xmlui [tomcat]/webapps
Веб-приложения, скомпилированные на
предыдущем этапе, нужно разместить на веб-
сервере. В Linux можно просто создать
символческую ссылку:
ln -s [dspace]/webapps/xmlui [tomcat]/webapps/xmlui
Можно сделать xmlui корневым каталогом:
ln -s [dspace]/webapps/xmlui [tomcat]/webapps/ROOT
Можно настроить server.xml так, чтобы сервер
сразу использовал нужное место:
... appBase="/opt/dspace/webapps" ...

43. Установка
Создать первого администратора
[dspace]/bin/dspace create-administrator
Первый администратор создаётся с помощью
консольного приложения.

44. Установка
Перезапустить сервер
service tomcat7 restart
Открыть в браузере
http://dspace.isofts.kiev.ua:8080/xmlui

45. 3. Дополнительная установка

46. 80-й порт
Перенаправление с помощью:
Брандмауэра
--iptables -A INPUT -i eth0 -p tcp --dport 80 -j ACCEPT
--iptables -A INPUT -i eth0 -p tcp --dport 8080 -j ACCEPT
--iptables -A PREROUTING -t nat-i eth0 -p tcp --dport 80 -j REDIRECT --to-port 8080
HTTP-сервера
<VirtualHost *:80>
...
ServerName dspace.isofts.kiev.ua
ProxyPass / ajp://localhost:8009/
ProxyPassReverse / ajp://localhost:8009/
</VirtualHost>
Tomcat по умолчанию работает на 8080-м порту.
Изменить это значение на стандартный для веб-
серверов 80-й порт можно несколькими путями.
Первый способ — создать перенаправление в
брандмауэре. Для iptables нужно открыть порты
80 и 8080, и создать перенаправление.
Второй способ — перенаправление с помощью
веб-сервера. Для Apache следует
отредактировать httpd.conf.

47. Периодические задачи
Пользователь dspace
crontab -e
# Рассылать почту в 1:00 ежедневно
0 1 * * * [dspace]/bin/dspace sub-daily
# Запускать медиа-фильтр в 2:00 ежедневно
0 2 * * * [dspace]/bin/dspace filter-media
# Подсчёт статистики
0 3 * * * [dspace]/bin/dspace stat-general
Пользователь postgres
10 3 * * * [dspace]/bin/dspace stat-monthly
30 3 * * * [dspace]/bin/dspace stat-report-general
40 3 * * * [dspace]/bin/dspace stat-report-monthly

48. Периодические задачи
Пользователь postgres
crontab -e
# Очищать базу данных в 4:20 ежедневно
20 4 * * * vacuumdb --analyze dspace > /dev/null 2>&1

49. Handle-сервер
Отключить:
handle.canonical.prefix = ${dspace.url}/handle/

50. Проверка установки
Веб-сервер
Открыть страницу в браузере
База данных
Создать пользователя/раздел/коллекцию
Почтовый сервер
Отправить сообщение по обратной связи