Setarea DSpace
-
Upload
natalia-cheradi -
Category
Education
-
view
3.810 -
download
7
description
Transcript of Setarea DSpace
![Page 1: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/1.jpg)
III — Настройка DSpaceIII — Настройка DSpace
© 2011© 2011 Кузьма Кудим Кузьма Кудим
![Page 2: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/2.jpg)
1. Файлы настроек1. Файлы настроек
![Page 3: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/3.jpg)
Два расположенияДва расположения
[dspace-source]/dspace/config/dspace.cfgсчитается основным
[dspace]/config/dspace.cfgкопия предыдущего
![Page 4: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/4.jpg)
Применение измененийПрименение изменений
1. Редактируем [dspace-source]/dspace/config/*2. Применяем изменения
3. Копируем веб-приложение на сервер
5. Перезапускаем tomcat
cd [dspace-source]/dspacemvn packagecd target/dspace-1.7.0-build.dirant -Doverwrite=true update
cp -R [dspace]/webapps/* [tomcat]/webapps
![Page 5: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/5.jpg)
Формат файлов настроекФормат файлов настроек
Файл настроек содержит:пары свойство-значение
имеют вид 'имя.свойства = значение свойства'бывает не установлено или закомментировано
строки комментариевначинаются с символа '#'
пустые строки
![Page 6: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/6.jpg)
Формат файлов настроекФормат файлов настроек
Булевские значенияда/включить/разрешить — true
useProxies = trueнет/отключить/запретить — false
useProxies = false
Перенос длинных строкпробел + обратный слэш
filter.plugins = PDF Text Extractor, \ HTML Text Extractor, \ PowerPoint Text Extractor
![Page 7: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/7.jpg)
Формат файлов настроекФормат файлов настроек
Ссылки на другие свойства:
dspace.dir = /dspacedspace.history = ${dspace.dir}/history
![Page 8: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/8.jpg)
2. Основные настройки2. Основные настройки
![Page 9: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/9.jpg)
Необходимо знать заранееНеобходимо знать заранее
Адрес сервераlib.isofts.kiev.ua
Email администратора[email protected]
SMTP серверsmtp.isofts.kiev.ua
![Page 10: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/10.jpg)
Основные параметрыОсновные параметры
Корневая папка инсталляции
Короткое название сайта
Адрес сервера
dspace.dir = /opt/dspacedspace.dir = c:/dspace
dspace.name = ISS Library
dspace.hostname = lib.isofts.kiev.ua
![Page 11: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/11.jpg)
Основные параметрыОсновные параметры
Основной URL веб-приложения
Основной URL веб-интерфейса
Основной URL приложения OAI
dspace.baseUrl = http://lib.isofts.kiev.ua:8080
dspace.url = ${dspace.baseUrl}/xmlui
dspace.oai.url = ${dspace.baseUrl}/oai
![Page 12: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/12.jpg)
База данныхБаза данных
Какая СУБД используется
Имя пользователя
Пароль
db.name = postgresdb.name = oracle
db.username = dspace
db.password = dspace
![Page 13: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/13.jpg)
Почтовый серверПочтовый сервер
Адрес и порт SMTP сервера
Имя и пароль, если нужно
Отключить отправку писем? (true/false)
mail.server.username = kuzmamail.server.password = top!secret
mail.server = smtp.isofts.kiev.uamail.server.port = 25
mail.server.disabled = false
![Page 14: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/14.jpg)
Email адресаEmail адреса
Поле From: в письмах
Обратная связь
Администратор
mail.from.address = [email protected]
feedback.recipient = [email protected]
mail.admin = [email protected]
![Page 15: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/15.jpg)
Email адресаEmail адреса
Уведомления об ошибках
Уведомления о новых регистрациях
alert.recipient = [email protected]
registration.notify = [email protected]
![Page 16: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/16.jpg)
Шаблоны писемШаблоны писем
[dspace]/config/emailsкомментарии
#закомментированная строкапараметры
текст {0} текст {1} текстизменить контактные данные
![Page 17: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/17.jpg)
Язык для метаданныхЯзык для метаданных
Язык по умолчанию для ввода метаданныхdefault.language = uk_UA
![Page 18: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/18.jpg)
Хранилище файловХранилище файлов
Путь к хранилищу номер 0
Путь к хранилищу номер 1, 2, 3, ...
Номер хранилища для новых поступлений
assetstore.dir = ${dspace.dir}/assetstore
assetstore.dir.1 = /another/assetstore
assetstore.incoming = 1
![Page 19: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/19.jpg)
ЛогиЛоги
Файл настройки логов
Путь сохранения логовlog.init.config = ${dspace.dir}/config/log4j.properties
log.dir = ${dspace.dir}/log
![Page 20: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/20.jpg)
Поисковый индекс LuceneПоисковый индекс Lucene
Где хранить файлы индекса
Какой анализатор Lucene использовать
AND или OR в запросе
search.dir = ${dspace.dir}/search
search.analyzer = org.dspace.search.DSAnalyzer
search.analyzer = org.apache.lucene.analysis.ru.RussianAnalyzer
search.operator = OR
![Page 21: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/21.jpg)
Поисковый индекс LuceneПоисковый индекс Lucene
Количество индексируемых слов, не больше
Какие поля метаданных индексироватьsearch.index.[n] = [метка]:[поле метаданных]
search.maxfieldlength = 10000search.maxfieldlength = -1
search.index.1 = author:dc.contributor.*search.index.2 = author:dc.creator.*search.index.3 = title:dc.title.*...
![Page 22: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/22.jpg)
Handle-серверHandle-сервер
URL сервиса постоянных ссылок
Префикс постоянной ссылки
handle.canonical.prefix = http://hdl.handle.net/handle.canonical.prefix = ${dspace.url}/handle/
handle.prefix = 123456789
![Page 23: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/23.jpg)
Видимость скрытогоВидимость скрытого
Показывать (true) или нет (false) скрытые документы
в RSS
в OAI
в подписках
harvest.includerestricted.rss = true
harvest.includerestricted.oai = true
harvest.includerestricted.subscription = true
![Page 24: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/24.jpg)
ПроксиПрокси
Сервер
Порт
DSpace за прокси-сервером?
http.proxy.host = proxy.isofts.kiev.ua
http.proxy.port = 2048
useProxies = true
![Page 25: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/25.jpg)
*Суб-администраторы*Суб-администраторы
Разрешить или запретить администраторам отдельных разделов:
создавать/удалять подразделыуправлять
правиламиадминистраторамишаблонами. . .
![Page 26: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/26.jpg)
*Методы аутентификации*Методы аутентификации
Стек методов аутентификацииМетоды:
По паролюShibbolethСертификаты X.509По IP-адресуLDAPСобственный метод
![Page 27: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/27.jpg)
3. Эмбарго3. Эмбарго
![Page 28: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/28.jpg)
Свойства в dspace.cfgСвойства в dspace.cfg
Поле метаданных для сроков
Поле метаданных для окончания
Значение неограниченного эмбарго
embargo.field.terms = dc.embargo.terms
embargo.field.lift = dc.embargo.liftdate
embargo.terms.open = всегда
![Page 29: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/29.jpg)
Продолжение настройкиПродолжение настройки
1. Добавить в реестр метаданных новые поля2. В файле [dspace]/config/input-forms.xml
добавить поле ввода для embargo.field.terms3. Обновить DSpace4. Регулярно запускать проверку сроков[dspace]/bin/dspace embargo-lifter -l
![Page 30: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/30.jpg)
Изменения в input-forms.xmlИзменения в input-forms.xml
<field> <dc-schema>dc</dc-schema> <dc-element>embargo</dc-element> <dc-qualifier>terms</dc-qualifier> <repeatable>false</repeatable> <label>Дата эмбарго</label> <input-type>onebox</input-type> <hint>Если необходимо, введите дату истечения эмбарго в формате 'гггг-мм-дд' или 'всегда'.</hint> <required></required></field>
![Page 31: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/31.jpg)
4. Статистика4. Статистика
![Page 32: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/32.jpg)
НастройкаНастройка
dspace.cfgраздел SOLR Statistics
dstat.cfgдата началасписок полейи другие параметры статистики
![Page 33: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/33.jpg)
ИнициализацияИнициализация
Первый сбор статистики
Создание первого отчёта[dspace]/bin/dspace stat-initial
[dspace]/bin/dspace stat-report-initial
![Page 34: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/34.jpg)
Регулярное выполнениеРегулярное выполнение
Задания cron0 1 * * * [dspace]/bin/dspace stat-general0 1 * * * [dspace]/bin/dspace stat-monthly0 2 * * * [dspace]/bin/dspace stat-report-general0 2 * * * [dspace]/bin/dspace stat-report-monthly
![Page 35: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/35.jpg)
ПросмотрПросмотр
В административном интерфейсе:→Статистика
![Page 36: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/36.jpg)
Google AnaliticsGoogle Analitics
ПреимуществаУниверсальный и мощный инструментПодробная статистика всего сайта
УстановкаРегистрацияdspace.cfg:
xmlui.google.analytics.key=UA-XXXXXX-X
![Page 37: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/37.jpg)
5. Локализация XMLUI5. Локализация XMLUI
![Page 38: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/38.jpg)
Языки интерфейсаЯзыки интерфейса
dspace.cfg
соответствующие файлы переводовmessages.xml — основной (русский)messages_uk.xmlmessages_en.xml
xmlui.supported.locales = ru, uk, en
![Page 39: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/39.jpg)
Файлы переводовФайлы переводов
1. Создать каталог
2. Скопировать в него файл
и перевести его3. Дополнительные языки
[dspace-source]/dspace/modules/xmlui/src/main/webapp/i18n/
[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/ src/main/webapp/i18n/messages.xml
messages_de.xml, messages_uk.xml, ...
![Page 40: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/40.jpg)
ПроблемыПроблемы
Нет переключения кнопкамиНе всё переводится
ПисьмаНазвания/описания разделов/коллекций/документов
![Page 41: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/41.jpg)
6. XMLUI6. XMLUI
![Page 42: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/42.jpg)
РегистрацияРегистрация
Разрешить регистрацию?
Разрешить редактировать профиль?
Куда после входа?
xmlui.user.registration = true
xmlui.user.editmetadata = true
xmlui.user.loginredirect=/profile
![Page 43: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/43.jpg)
Текст на главнойТекст на главной
Шаблон в файле:
Не HTMLпример ссылки
Можно локализоватьпример фразы
[dspace-source]/dspace/config/news-xmlui.xml
<xref target="http://myuni.edu/">My University</xref>
<i18n:text>myuni.repo.intro</i18n:text>
![Page 44: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/44.jpg)
Статический контентСтатический контент
Куда положить?
Как ссылаться?
[dspace-source]/dspace/modules/xmlui/src/main/webapp/static/
<link href="./static/mystyle.css" rel="stylesheet" type="text/css"/>
<img src="./static/images/some-image.jpg" alt="Картинка"/>
![Page 45: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/45.jpg)
ТемыТемы
Установленные темы
в разделе <themes>
[dspace]/config/xmlui.xconf
<theme name="Theme 1" regex=".*" path="theme1/"/>
![Page 46: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/46.jpg)
Добавление новой темыДобавление новой темы
1. Скопируйте готовую тему из
в
2. Переименуйте каталог темы3. Модифицируйте файлы темы
в sitemap.xmap раздел <global-variables>
4. Добавьте строку в xmlui.conf5. Обновите DSpace
[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/ src/main/webbapp/themes/
[dspace-source]/dspace/modules/xmlui/src/main/webbapp/themes/
![Page 47: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/47.jpg)
7. Процесс внесения7. Процесс внесения
Open Archives Initiative — Protocol for Metadata HarvestingOpen Archives Initiative — Protocol for Metadata Harvesting
![Page 48: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/48.jpg)
Файл настроекФайл настроек
[dspace-source]/dspace/config/item-submission.xmlподробно откомментированXML форматпорядок внесения по умолчанию
Выбрать коллекцию -> Вопросы -> Описание -> Загрузка -> Проверка -> Лицензия -> Конец
можно изменить шаги или порядок<submission-definition>
для разных коллекций<submission-map>
![Page 49: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/49.jpg)
Формы вводаФормы ввода
[dspace-source]/dspace/config/input-forms.xmlколичество полей вводаих последовательность и размещениетекстовые надписисписки вариантов
![Page 50: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/50.jpg)
III — Настройка DSpaceIII — Настройка DSpace
© 2011© 2011 Кузьма Кудим Кузьма Кудим
![Page 51: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/51.jpg)
1. Файлы настроек1. Файлы настроек
![Page 52: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/52.jpg)
Два расположенияДва расположения
[dspace-source]/dspace/config/dspace.cfgсчитается основным
[dspace]/config/dspace.cfgкопия предыдущего
После установки DSpace все конфигурационные файлы можно найти в двух различных папках. Первая, которую повсюду обозначена как [dspace-source], это папка, где находятся исходные коды DSpace, полученная при распаковке архива. Вторая, обозначенная везде как [dspace], это место, в которое DSpace устанавливался из исходных кодов, именно эту папку DSpace использует во время работы.
Папка [dspace-source] счиается основной при внесении изменений.
![Page 53: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/53.jpg)
Применение измененийПрименение изменений
1. Редактируем [dspace-source]/dspace/config/*2. Применяем изменения
3. Копируем веб-приложение на сервер
5. Перезапускаем tomcat
cd [dspace-source]/dspacemvn packagecd target/dspace-1.7.0-build.dirant -Doverwrite=true update
cp -R [dspace]/webapps/* [tomcat]/webapps
Так как DSpace хранит настройки в двух местах (см. пред. слайд), а использует при работе только папку [dspace], то возникает соблазн изменять только файлы в папке [dspace]. Так делать не следует, иначе можно потерять свои изменения при обновлениях! Правильная последовательность действий такая: любые изменения вносятся в [dspace-source], после чего обновляется инсталляция DSpace.
Описанный способ пригоден для внесения любых изменений в DSpace.
![Page 54: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/54.jpg)
Формат файлов настроекФормат файлов настроек
Файл настроек содержит:пары свойство-значение
имеют вид 'имя.свойства = значение свойства'бывает не установлено или закомментировано
строки комментариевначинаются с символа '#'
пустые строки
![Page 55: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/55.jpg)
Формат файлов настроекФормат файлов настроек
Булевские значенияда/включить/разрешить — true
useProxies = trueнет/отключить/запретить — false
useProxies = false
Перенос длинных строкпробел + обратный слэш
filter.plugins = PDF Text Extractor, \ HTML Text Extractor, \ PowerPoint Text Extractor
Многие свойства могут иметь лишь два значения типа да/нет или включить/выключить. Для таких свойтств-флагов используются специальные значения true (правда) и false (ложь).
С целью улучшения читабельности для переноса слишком длинных строк вставьте пробел и обратный слэш (' \') непосредственно перед местом переноса.
![Page 56: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/56.jpg)
Формат файлов настроекФормат файлов настроек
Ссылки на другие свойства:
dspace.dir = /dspacedspace.history = ${dspace.dir}/history
Значение свойства может ссылаться на другие свойства как в примере.
![Page 57: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/57.jpg)
2. Основные настройки2. Основные настройки
Главный файл настроек DSpace — dspace.cfg.
![Page 58: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/58.jpg)
Необходимо знать заранееНеобходимо знать заранее
Адрес сервераlib.isofts.kiev.ua
Email администратора[email protected]
SMTP серверsmtp.isofts.kiev.ua
Прежде, чем приступать к установке, нужно как минимум знать следующие вещи:
- адрес сервера, на котором проводится установка;
- email первого администратора;- адрес SMTP сервера для отправки писем (при
регистрации, для рассылок, и т. п.).
![Page 59: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/59.jpg)
Основные параметрыОсновные параметры
Корневая папка инсталляции
Короткое название сайта
Адрес сервера
dspace.dir = /opt/dspacedspace.dir = c:/dspace
dspace.name = ISS Library
dspace.hostname = lib.isofts.kiev.ua
Короткое название сайта используется в веб-интерфейсе, в письмах и других местах (например, в OAI).
![Page 60: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/60.jpg)
Основные параметрыОсновные параметры
Основной URL веб-приложения
Основной URL веб-интерфейса
Основной URL приложения OAI
dspace.baseUrl = http://lib.isofts.kiev.ua:8080
dspace.url = ${dspace.baseUrl}/xmlui
dspace.oai.url = ${dspace.baseUrl}/oai
Свойство dspace.baseUrl задаёт URL, по которому доступно развёрнутое на сервере веб-приложение DSpace.
Свойство dspace.url задаёт URL, по которому доступен веб-интерфейс DSpace. Поскольку изначально DSpace состоит из нескольких приложений, то это значение обычно отличается от первого.
![Page 61: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/61.jpg)
База данныхБаза данных
Какая СУБД используется
Имя пользователя
Пароль
db.name = postgresdb.name = oracle
db.username = dspace
db.password = dspace
С помощью указанных параметров задаётся доступ к базе данных. Поддерживается две СУБД — Postgre и Oracle.
![Page 62: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/62.jpg)
Почтовый серверПочтовый сервер
Адрес и порт SMTP сервера
Имя и пароль, если нужно
Отключить отправку писем? (true/false)
mail.server.username = kuzmamail.server.password = top!secret
mail.server = smtp.isofts.kiev.uamail.server.port = 25
mail.server.disabled = false
Параметры SMTP сервера для отправки писем.Если требуется авторизация, укажите имя и
пароль.В отладочных целях отправку почты можно
отключить.
![Page 63: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/63.jpg)
Email адресаEmail адреса
Поле From: в письмах
Обратная связь
Администратор
mail.from.address = [email protected]
feedback.recipient = [email protected]
mail.admin = [email protected]
Здесь указываются основные адреса электронной почты.
Обратная связь (feedback) доступна по переходу по соответствующей ссылке в интерфейсе.
![Page 64: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/64.jpg)
Email адресаEmail адреса
Уведомления об ошибках
Уведомления о новых регистрациях
alert.recipient = [email protected]
registration.notify = [email protected]
Дополнительно можно указать адреса электронной почты для получения уведомлений об ошибках и получения уведомлений о регистрации новых пользователей.
![Page 65: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/65.jpg)
Шаблоны писемШаблоны писем
[dspace]/config/emailsкомментарии
#закомментированная строкапараметры
текст {0} текст {1} текстизменить контактные данные
В некоторых ситуациях DSpace автоматически рассылает письма пользователям. Например, для оповещения о новых пополнения или при смене пароля. Шаблоны всех таких писем хранятся в папке [dspace]/config/emails.
Каждый файл содержит закомментированные пояснения. Строки комментариев начинаются с символа '#' и не вставляются в текст письма.
В шаблонах писем также используются подстановочные параметры в виде числа в фигурных скобках: {0}, {1}, {2}, .... В письме вместо параметров подставляется нужный текст, какой именно — разъяснено в комментариях.
Встречающиеся в файлах контактные данные приведы лишь для примера, их следует отредактировать.
![Page 66: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/66.jpg)
Язык для метаданныхЯзык для метаданных
Язык по умолчанию для ввода метаданныхdefault.language = uk_UA
Свойство default.language используется, если язык не указан явно в файле input-forms.xml
![Page 67: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/67.jpg)
Хранилище файловХранилище файлов
Путь к хранилищу номер 0
Путь к хранилищу номер 1, 2, 3, ...
Номер хранилища для новых поступлений
assetstore.dir = ${dspace.dir}/assetstore
assetstore.dir.1 = /another/assetstore
assetstore.incoming = 1
Файлы не хранятся в базе данных вместе с метаданными, а сохраняются в папке на диске. Изначально используется хранилище под номером 0, путь к которому задаётся параметром assetstore.dir.
В последствии для размещения новых файлов в другую папку можно задать хранилище номер 1, 2, 3, ... с помощью свойства assetstore.dir.1 (с нужным номером вместо 1).
Свойство assetstore.incoming определяет какое именно хранилище используется для добавления новых фалов в настоящий момент.
![Page 68: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/68.jpg)
ЛогиЛоги
Файл настройки логов
Путь сохранения логовlog.init.config = ${dspace.dir}/config/log4j.properties
log.dir = ${dspace.dir}/log
![Page 69: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/69.jpg)
Поисковый индекс LuceneПоисковый индекс Lucene
Где хранить файлы индекса
Какой анализатор Lucene использовать
AND или OR в запросе
search.dir = ${dspace.dir}/search
search.analyzer = org.dspace.search.DSAnalyzer
search.analyzer = org.apache.lucene.analysis.ru.RussianAnalyzer
search.operator = OR
По умолчанию используется поисковый анализатор DSpace для английского языка. В свойстве search.analyzer можно указать другой анализатор.
Свойство search.operator указывает, должны ли все ключевые слова из запроса встречаться в документе (значение AND) или не обязательно все (значение OR).
Чтобы применить изменения настроек поискового индекса, нужно запустить
[dspace]/bin/dspace index-init
![Page 70: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/70.jpg)
Поисковый индекс LuceneПоисковый индекс Lucene
Количество индексируемых слов, не больше
Какие поля метаданных индексироватьsearch.index.[n] = [метка]:[поле метаданных]
search.maxfieldlength = 10000search.maxfieldlength = -1
search.index.1 = author:dc.contributor.*search.index.2 = author:dc.creator.*search.index.3 = title:dc.title.*...
Свойство search.maxfieldlength задаёт максимальное количество слов в поле метаданных, которое будет проиндексировано. Если предполагается выполнять полнотекстовый поиск по достаточно большим документам, это значение нужно увеличить. Значение -1 снимает ограничение.
В списке свойств вида search.index.[n] = [метка]:[поле метаданных]
перечислены поля метаданных, которые будут проиндексированы. Символ '*' означает любое окончание. Метка задаёт имя для поискового поля, несколько полей метаданных могут соответствовать одному поисковому полю (одинаковая метка). Изменение перечня не изменяет поисковый интерфейс.
![Page 71: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/71.jpg)
Handle-серверHandle-сервер
URL сервиса постоянных ссылок
Префикс постоянной ссылки
handle.canonical.prefix = http://hdl.handle.net/handle.canonical.prefix = ${dspace.url}/handle/
handle.prefix = 123456789
Сервис постоянных ссылок (handle service) используется для сохранения URL одним и тем же даже при перемещении ресурса на другой сервер. Это достигается введением дополнительного сервера постоянных ссылок (handle server). При ссылке на документ указывается ссылка на этот сервер, который перенаправляет запросы на фактический URL. Один из таких сервисов — hdl.handle.net (платный).
Свойство handle.canonical.prefix задаёт URL сервера постоянных ссылок. Чтобы не использовать эту возможность, можно указать свой сервер DSpace.
В свойстве handle.prefix указывается префикс, выданный службой постоянных ссылок. Если служба не используется, то любая строка.
![Page 72: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/72.jpg)
Видимость скрытогоВидимость скрытого
Показывать (true) или нет (false) скрытые документы
в RSS
в OAI
в подписках
harvest.includerestricted.rss = true
harvest.includerestricted.oai = true
harvest.includerestricted.subscription = true
Если для доступа к некоторым документам у анонимных пользователей нет права на чтение, то по умолчанию такие документы всё равно будут видны в RSS, OAI и подписках.
С помощью перечисленных свойств можно ограничить видимость скрытых документов. При этом для больших архивов может упасть производительность.
![Page 73: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/73.jpg)
ПроксиПрокси
Сервер
Порт
DSpace за прокси-сервером?
http.proxy.host = proxy.isofts.kiev.ua
http.proxy.port = 2048
useProxies = true
Свойство useProxies используется для ведения логов и для авторизации по IP-адресу, чтобы правильно определять IP-адрес из заголовков запросов HTTP.
![Page 74: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/74.jpg)
*Суб-администраторы*Суб-администраторы
Разрешить или запретить администраторам отдельных разделов:
создавать/удалять подразделыуправлять
правиламиадминистраторамишаблонами. . .
Кроме супер-администратора, можно создавать администраторов отдельных разделов/коллекций. По умолчанию этим администраторам назначаются права на совершение всех административных действий со всеми объектаи в своём разделе. Чтобы ограничить такое поведение, например запретить удаление подразделов, можно соответствующим свойствам поставить значение false.
![Page 75: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/75.jpg)
*Методы аутентификации*Методы аутентификации
Стек методов аутентификацииМетоды:
По паролюShibbolethСертификаты X.509По IP-адресуLDAPСобственный метод
Можно указать несколько методов аутентификации, тогда они будут применяться последовательно, пока один один из них не сработает.
По умолчанию действует единственный метод — аутентификация по паролю.
Существует поддержка и других методов.Возможно подключение своего метода.
![Page 76: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/76.jpg)
3. Эмбарго3. Эмбарго
Главный файл настроек DSpace — dspace.cfg.
![Page 77: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/77.jpg)
Свойства в dspace.cfgСвойства в dspace.cfg
Поле метаданных для сроков
Поле метаданных для окончания
Значение неограниченного эмбарго
embargo.field.terms = dc.embargo.terms
embargo.field.lift = dc.embargo.liftdate
embargo.terms.open = всегда
Чтобы установить эмбарго, изменить несколько свойств в файле dspace.cfg.
Выбирайте новые, несуществующие названия для полей метаданных, в которых будут храниться срок эмбарго и дата окончания.
Можно также выбрать слово, которое будет обозначать неограниченное эмбарго.
![Page 78: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/78.jpg)
Здесь приведен порядок действий по настройке эмбарго.
Новые поля, введённые на предыдущем слайде, посредством административного веб-интерфейса нужно добавить в реестр метаданных, иначе они останутся неизвестны системе.
Для отображения поля ввода для срока эмбарго необходимо изменить интерфейс в файле input-forms.xml как показано на следующем слайде.
После всех изменений не забудьте обновить DSpace как рассказано на слайде "Обновление настроек".
Необходимо регулярно выполнять проверку истечения сроков эмбарго с помощью указанной программы.
Продолжение настройкиПродолжение настройки
1. Добавить в реестр метаданных новые поля2. В файле [dspace]/config/input-forms.xml
добавить поле ввода для embargo.field.terms3. Обновить DSpace4. Регулярно запускать проверку сроков[dspace]/bin/dspace embargo-lifter -l
![Page 79: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/79.jpg)
Изменения в input-forms.xmlИзменения в input-forms.xml
<field> <dc-schema>dc</dc-schema> <dc-element>embargo</dc-element> <dc-qualifier>terms</dc-qualifier> <repeatable>false</repeatable> <label>Дата эмбарго</label> <input-type>onebox</input-type> <hint>Если необходимо, введите дату истечения эмбарго в формате 'гггг-мм-дд' или 'всегда'.</hint> <required></required></field>
Здесь приведены изменения в файле input-forms.xml для отображения в пользовательском интерфесе поля ввода для даты эмбарго.
![Page 80: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/80.jpg)
4. Статистика4. Статистика
Главный файл настроек DSpace — dspace.cfg.
![Page 81: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/81.jpg)
НастройкаНастройка
dspace.cfgраздел SOLR Statistics
dstat.cfgдата началасписок полейи другие параметры статистики
Настройка статистики производится в двух местах — в основном файле настроек dspace.cfg в разделе SOLR Statistics Configuration, и в файле настроек статистики dstat.cfg, который находится в том же каталоге.
![Page 82: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/82.jpg)
ИнициализацияИнициализация
Первый сбор статистики
Создание первого отчёта[dspace]/bin/dspace stat-initial
[dspace]/bin/dspace stat-report-initial
Подготовительный запуск системы сбора статистики.
![Page 83: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/83.jpg)
Регулярное выполнениеРегулярное выполнение
Задания cron0 1 * * * [dspace]/bin/dspace stat-general0 1 * * * [dspace]/bin/dspace stat-monthly0 2 * * * [dspace]/bin/dspace stat-report-general0 2 * * * [dspace]/bin/dspace stat-report-monthly
После инициализации программы обработки статистистики следует запускать регулярно. Как и при инициализации, первые две строки отвечают за анализ статистики, а вторые — за создание отчётов в html. Первая и третья строка анализирует статистику от стартовой даты, указанной в файле dstat.cfg. Вторая и четвёртая строка — это статистика с разбивкой по месяцам.
![Page 84: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/84.jpg)
ПросмотрПросмотр
В административном интерфейсе:→Статистика
Администратор может просматривать статистические отчёты в веб-интерфейсе.
![Page 85: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/85.jpg)
Google AnaliticsGoogle Analitics
ПреимуществаУниверсальный и мощный инструментПодробная статистика всего сайта
УстановкаРегистрацияdspace.cfg:
xmlui.google.analytics.key=UA-XXXXXX-X
Как и любой сайт, ваш архив можно подключить к Google Analitics — удобному и мощному средству отслеживания статистики.
Для подключения статистики от Google, необходимо зарегистрироваться.
Если вы используете интерфейс XMLUI, то подключение к Google Analitics обеспечивается простым изменением свойства в файле dspace.cfg. В противном случае код, предоставляемый Google, следует включить в шаблоны страниц там, где это необходимо.
![Page 86: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/86.jpg)
5. Локализация XMLUI5. Локализация XMLUI
Главный файл настроек DSpace — dspace.cfg.
![Page 87: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/87.jpg)
Языки интерфейсаЯзыки интерфейса
dspace.cfg
соответствующие файлы переводовmessages.xml — основной (русский)messages_uk.xmlmessages_en.xml
xmlui.supported.locales = ru, uk, en
В файле настроек dspace.cfg нужно перечислить двухбуквенные коды языков, которые будет поддерживать интерфейс вашего архива.
Для каждого языка должен существовать свой файл перевода.
![Page 88: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/88.jpg)
Файлы переводовФайлы переводов
1. Создать каталог
2. Скопировать в него файл
и перевести его3. Дополнительные языки
[dspace-source]/dspace/modules/xmlui/src/main/webapp/i18n/
[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/ src/main/webapp/i18n/messages.xml
messages_de.xml, messages_uk.xml, ...
В версии 1.7.0 переключение языков с помощью кнопок не поддерживается, ожидается в версии 1.8.0, но может быть установлено отдельно.
Сейчас XMLUI использует предпочтения пользователя, указанные в настройках браузера. Если для предпочтительного языка найден соответствующий файл messages_XX.xml (XX — двухбуквенный код языка), то используется этот перевод. Если не найден, то используется основной файл messages.xml.
Все файлы нужно сохранять в кодировке UTF-8.
![Page 89: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/89.jpg)
ПроблемыПроблемы
Нет переключения кнопкамиНе всё переводится
ПисьмаНазвания/описания разделов/коллекций/документов
Более привычная практика переключения языков — кнопки или ссылки вверху страницы — в DSpace пока что не реализована. В браузерах с разными языковыми настройками можно увидеть различный интерфейс, что тоже может быть неудобно, поскольку переключение языка происходит незаметно для пользователя.
К недостаткам также можно отнести, что переводятся только основные элементы интерфейса, но не данные, добавляемые в процессе работы архива.
![Page 90: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/90.jpg)
6. XMLUI6. XMLUI
Главный файл настроек DSpace — dspace.cfg.
![Page 91: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/91.jpg)
РегистрацияРегистрация
Разрешить регистрацию?
Разрешить редактировать профиль?
Куда после входа?
xmlui.user.registration = true
xmlui.user.editmetadata = true
xmlui.user.loginredirect=/profile
Можно запретить новым пользователям самостоятельно регистрироваться. В этом случае зарегистрировать новых пользователей сможет администратор.
Аналогично можно запретить пользователям изменять свой профиль.
Можно указать на какую именно страницу попадает пользователь после входа в систему.
![Page 92: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/92.jpg)
Текст на главнойТекст на главной
Шаблон в файле:
Не HTMLпример ссылки
Можно локализоватьпример фразы
[dspace-source]/dspace/config/news-xmlui.xml
<xref target="http://myuni.edu/">My University</xref>
<i18n:text>myuni.repo.intro</i18n:text>
Текст на домашней странице сайта можно менять в указанном файле.
Этот файл не HTML, а файл специального формата DRI, разработанного для XMLUI. Примеры использования этого формата можно найти повсюду в XMLUI. Подробное описание выходит за рамки настоящего изложения.
Файл можно адаптировать для того, чтобы работало переключение языков. Делается это способом, аналогичным другим частям интерфейса.
![Page 93: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/93.jpg)
Статический контентСтатический контент
Куда положить?
Как ссылаться?
[dspace-source]/dspace/modules/xmlui/src/main/webapp/static/
<link href="./static/mystyle.css" rel="stylesheet" type="text/css"/>
<img src="./static/images/some-image.jpg" alt="Картинка"/>
В XMLUI есть специальный каталог для статитического содержимого — файлов HTML, CSS, изображений.
Чтобы сослаться на эти объекты, формируйте ссылку как показано на слайде.
![Page 94: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/94.jpg)
ТемыТемы
Установленные темы
в разделе <themes>
[dspace]/config/xmlui.xconf
<theme name="Theme 1" regex=".*" path="theme1/"/>
XMLUI позволяет легко изменять стиль интерфейса благодаря т.н. темам. Установленные темы можно отредактировать в файле xmlui.conf в разделе <themes>. Для темы указывается имя, регулярное выражение для сопоставления с URL-ами, которые должны отображаться этой темой, а также путь, по которому расположены файлы темы.
Сопоставление с URL-ами служит для того, чтобы можно было разные части архива отображать разными темами.
![Page 95: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/95.jpg)
Добавление новой темыДобавление новой темы
1. Скопируйте готовую тему из
в
2. Переименуйте каталог темы3. Модифицируйте файлы темы
в sitemap.xmap раздел <global-variables>4. Добавьте строку в xmlui.conf5. Обновите DSpace
[dspace-source]/dspace-xmlui/dspace-xmlui-webapp/ src/main/webbapp/themes/
[dspace-source]/dspace/modules/xmlui/src/main/webbapp/themes/
Добавление новой темы заключается в копировании существующей темы или шаблона темы, который находится там же.
Изменяйте файлы темы по своему усмотрению и не забудьте применить изменения, обновив инсталяцию DSpace.
![Page 96: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/96.jpg)
7. Процесс внесения7. Процесс внесения
Open Archives Initiative — Protocol for Metadata HarvestingOpen Archives Initiative — Protocol for Metadata Harvesting
Главный файл настроек DSpace — dspace.cfg.
![Page 97: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/97.jpg)
Файл настроекФайл настроек
[dspace-source]/dspace/config/item-submission.xmlподробно откомментированXML форматпорядок внесения по умолчанию
Выбрать коллекцию -> Вопросы -> Описание -> Загрузка -> Проверка -> Лицензия -> Конец
можно изменить шаги или порядок<submission-definition>
для разных коллекций<submission-map>
![Page 98: Setarea DSpace](https://reader034.fdocument.pub/reader034/viewer/2022050801/549c52c8b479599b318b46f6/html5/thumbnails/98.jpg)
Формы вводаФормы ввода
[dspace-source]/dspace/config/input-forms.xmlколичество полей вводаих последовательность и размещениетекстовые надписисписки вариантов