Wiki ТНТУ - Внесок користувача [uk]

Налаштування Postfix та Gmail для Koha

2023-11-01T18:05:46Z

Dubyk:

<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br />
Ласкаво просимо!</b>

Налаштування Postfix+Gmail для відправки повідомлень з Koha.

Перевірено на Linux Debian 6,7.

= Встановлення Postfix і допоміжних пакунків =

Вхід у консоль адміністратора

sudo su

Встановлення пакунку поштового сервера postfix:

apt-get install postfix

Виберіть варіант без автоматичного налаштування (no configuration) на екрані повідомлення установки.

[[Image:postfix_install_config_screen.png|1000px|center]]

Встановіть також наступні пакунки

apt-get install libsasl2-2 libsasl2-modules ca-certificates

= Налаштування Postfix для Gmail =

== Файли конфіґурації ==

Скопіюйте файл конфігурації

cp /usr/share/postfix/main.cf.debian /etc/postfix/main.cf

Відкрийте наступний файл

mc -e /etc/postfix/main.cf

та додайте кілька рядків в кінці файлу

relayhost = [smtp.gmail.com]:587
smtp_sasl_auth_enable = yes
smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
smtp_sasl_security_options = noanonymous
smtp_tls_CAfile = /etc/postfix/cacert.pem
#smtp_use_tls = yes
smtp_tls_security_level = verify

Створіть новий файл

mc -e /etc/postfix/sasl_passwd

щоб зберегти логін та пароль Gmail

[smtp.gmail.com]:587 vashaposhta@gmail.com:vashparol

Змініть дозвіл на наступне файл

chmod 400 /etc/postfix/sasl_passwd

Переведення /etc/postfix/sasl_passwd у Postfix-таблиці.

postmap /etc/postfix/sasl_passwd

Створіть /etc/aliases.db

postalias hash:/etc/aliases

Створіть /etc/postfix/cacert.pem

cat /etc/ssl/certs/Equifax_Secure_CA.pem >> /etc/postfix/cacert.pem

Перезапуск Postfix.

/etc/init.d/postfix restart

== Перевірка роботи пошти з командного рядка ==

apt-get install mailutils

echo "test email" | mail -s "Test email" poshta@ukr.net

Якщо не налаштований доступ до менш безпечних додатків у профілі пошти, прийде лист про спробу входу в обліковий запис.
Знайдіть у ньому посилання щодо „доступу до менш безпечних додатків“, перейдіть і включіть „Доступ до менш безпечних додатків“.

Перейдіть у пошту poshta@ukr.net і переконайтесь, що лист прийшов.

=Увімкнення надсилань електронною поштою в Koha =

== Налаштування Koha ==
Перевірте наступні налаштування в Koha щоб задіяти повідомлення електронною поштою:

Koha > Керування > Категорії відвідувачів > '''Необхідність сповіщення про прострочення''' > Так

[[Image:Overdue_notice_required.png|1000px|center]]

Koha > Керування > Параметри системи > Відвідувачі > '''EnhancedMessagingPreferences''' > Дозволяти

[[Image:EnhancedMessagingPreferences.png|1000px|center]]

Koha > Інструменти > '''Вмикачі сповіщень/станів прострочень'''

[[Image:overduerules.png|600px|center]]

== Періодичні завдання з надсилання ==

Увімкнення надсилань електронною поштою -

для '''Koha встановленої з джерела'''

su koha3admin
crontab -e

# m h dom mon dow command
# Обробка повідомлень у черзі (надсилання, позначення успішно надісланих)
15 * * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/cronjobs/process_message_queue.pl

для '''Koha встановленої з пакунка'''

koha-email-enable library

Детальніше: http://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#E-mail

= Перевірки =

* Знаходимо книги, додаємо у возик, заходимо у „Возик“ та вибираємо „Надіслати“, вводимо e-mail й коментар і надсилаємо. Перевіряємо отримання.

= Питання =

Чи потрібно запускати /usr/share/koha/lib /usr/share/koha/bin/cronjobs/overdue_notices.pl -t
?

= Посилання =
* [http://kohageek.pbworks.com/w/page/58731341/Configure%20gmail%20with%20postfix%20to%20send%20notices%20from%20Koha Configure gmail with postfix to send notices from Koha]
* [http://eureka.ykyuen.info/2011/02/05/postfix-relay-via-gmail/ Postfix – Relay via Gmail]
* [http://www.postfix.org/postconf.5.html#smtp_use_tls smtp_use_tls]
* [http://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#E-mail Commands_provided_by_the_Debian_packages#E-mail]

[[Категорія:АБІС Koha]]
[[Категорія:Бібліотека]]

Коротка інструкція для адміністратора АБІС Koha

2023-11-01T18:05:39Z

Dubyk:

<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br />
Ласкаво просимо!</b>

= Встановлення та адміністрування ОС Debian GNU/Linux =
== Вибір ОС Debian GNU/Linux ==

[[Image:Debian_Linux.png|150px|right]]
Для АБІС Koha найбільш придатною на даний момент є операційна система Debian GNU/Linux.

Тут і перевірена часом стабільність і той факт, що більшість розробників працює з нею.

Поки тільки для цієї системи є всі необхідні perl-модулі в офіційному репозитарії.

Також розробники Koha вже досить давно готують пакунок з АБІС Koha для репозиторію Debian, що дозволить встановлювати систему з „одного кліку“.

== Налаштування Debian для АБІС Koha ==
=== Попередні налаштування ===
==== Локаль з UTF-8 ====
Перевірка локалі:
sudo locale
в результаті повинно фігурувати „UTF-8“ (en.UTF-8, uk_UA.UTF-8 і т.п.), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо UTF-8 не присутнє, тоді потрібно встановити локаль

sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

==== Користувач для Koha ====
Додаємо користувача

(нижче замість „АдміністраторСістеміKoha“ вводимо своє)

sudo adduser АдміністраторСистемиKoha

Іноді група автоматично не створюється — тоді потрібно ще

sudo addgroup АдміністраторСистемиKoha
sudo adduser АдміністраторСистемиKoha АдміністраторСистемиKoha

Командою „sudo visudo“ відкриваємо для редагування файл привілеїв адміністратора (/etc/sudoers) і даємо їх користувачеві АдміністраторСистемиKoha, додавши в кінці файлу рядок

АдміністраторСистемиKoha ALL = (ALL) ALL

Після додавання клавіатурній командою Ctrl-O зберігаємо файл (/etc/sudoers) і через Ctrl-X виходимо.

=== Встановлення та налаштування додаткових пакунків ===

Встановленні безпосередньо ПЗ Koha передує встановлення усіх необхідних пакунків й модулів, від яких залежить Koha.

==== Встановлення пакунків з репозитаріїв ====

===== Веб-сервер, БД MySQL і додаткові пакунки =====

Однією командою

sudo apt-get install \
at \
apache2 \
cvs \
git \
git-core \
make \
gcc \
daemon \
perlmagick \
mysql-server \
phpmyadmin

*при встановленні сервера MySQL вказуємо пароль адміністратора (користувач „root“), далі „ПарольАдмінаMySQL“;
*для „phpmyadmin“ вибрати лише „apache2“;
*при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку.

===== Перловські модулі =====

Однією командою

sudo apt-get install \
libcgi-session-perl \
libclass-factory-util-perl \
libdata-ical-perl \
libdate-calc-perl \
libdate-ical-perl \
libdate-manip-perl \
libdatetime-format-mail-perl \
libdatetime-format-strptime-perl \
libdatetime-format-w3cdtf-perl \
libdatetime-locale-perl \
libdatetime-perl \
libdatetime-timezone-perl \
libdbd-mysql-perl \
libdbi-perl \
libemail-date-perl \
libgd-barcode-perl \
libhtml-scrubber-perl \
libimage-magick-perl \
libjson-perl \
liblingua-ispell-perl \
liblingua-stem-perl \
liblist-moreutils-perl \
liblist-moreutils-perl \
liblocale-gettext-perl \
liblocale-po-perl \
libmail-sendmail-perl \
libmime-lite-perl \
libnet-ldap-perl \
libpdf-api2-perl \
libpoe-perl \
libtext-charwidth-perl \
libtext-csv-perl \
libtext-iconv-perl \
libtext-wrapi18n-perl \
libtimedate-perl \
libtime-duration-perl \
libtime-format-perl \
libunix-syslog-perl \
libxml-dom-perl \
libxml-dumper-perl \
libxml-libxml-perl \
libxml-libxslt-perl \
libxml-namespacesupport-perl \
libxml-parser-perl \
libxml-perl \
libxml-regexp-perl \
libxml-sax-writer-perl \
libxml-simple-perl \
libxml-xslt-perl \
libyaml-syck-perl \
libbiblio-endnotestyle-perl \
libcgi-session-serialize-yaml-perl \
libhtml-template-pro-perl \
libmarc-charset-perl \
libmarc-crosswalk-dublincore-perl \
libmarc-xml-perl \
libmarc-record-perl \
libnet-z3950-zoom-perl \
libpdf-reuse-perl \
libpdf-reuse-barcode-perl \
libschedule-at-perl \
libxml-rss-perl \
libyaml-perl \
libalgorithm-checkdigits-perl \
libhttp-oai-perl \
libsms-send-perl \
libtemplate-perl \
libmemoize-memcached-perl \
libbusiness-isbn-perl \
libdbd-sqlite2-perl \
libuniversal-require-perl \
libtext-csv-encoded-perl \
libpdf-api2-simple-perl \
libpdf-table-perl \
libnet-server-perl \
libnumber-format-perl \
liblocale-currency-format-perl \
liblingua-stem-snowball-perl \
libgraphics-magick-perl \
libauthen-cas-client-perl

===== Zebra та Yaz =====

Однією командою

sudo apt-get install \
idzebra-2.0-common \
idzebra-2.0-doc \
idzebra-2.0 \
idzebra-2.0-utils \
libidzebra-2.0-dev \
libidzebra-2.0-0 \
libidzebra-2.0-mod-alvis \
libidzebra-2.0-mod-grs-marc \
libidzebra-2.0-mod-grs-regx \
libidzebra-2.0-mod-grs-xml \
libidzebra-2.0-mod-text \
libidzebra-2.0-modules \
yaz \
yaz-doc \
libyaz4 \
libyaz4-dev

===== Інші пакунки =====

Однією командою

sudo apt-get install \
gettext \
libgcrypt11-dev \
libgcrypt11 \
libgd2-noxpm-dev \
libmysqlclient-dev \
libxml2-dev \
libxml2 \
libxml2-utils \
libxslt1.1 \
libxslt1-dev \
memcached \
libapache2-mod-perl2

===== Пакунки з гілок Дебіен „unstable“ або „testing“ =====

1) Створюємо файл /etc/apt/apt.conf і додаємо наступне

# Зробити „squeeze“ дистрибутивом за умовчанням
APT::Default-Release "squeeze";

2) Створюємо файл /etc/apt/preferences і додаємо наступне (щоб у стабільній гілці „squeeze“ був вищий пріоритет)

Package: *
Pin: release a=squeeze
Pin-Priority: 900

Package: *
Pin: release a=unstable
Pin-Priority: 90

3) У файл /etc/apt/sources.list додаємо наступне джерело

# Джерело пакунків з гілки Дебіен „unstable“
deb http://http.us.debian.org/debian unstable main contrib non-free

4) Встановлення пакунків з гілки «unstable“

sudo apt-get update
sudo apt-cache policy libcgi-session-driver-memcached-perl
sudo apt-get -t unstable install libcgi-session-driver-memcached-perl

==== Налаштування пакунків ====
===== Apache =====

1) Модулі

Включаємо модуль Rewrite

sudo a2enmod rewrite

а також модулі Expires та Deflate

sudo a2enmod expires
sudo a2enmod deflate

2) Правимо /etc/apache2/conf.d/charset

AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

3) Перезапуск Apache

sudo /etc/init.d/apache2 restart

===== MySQL =====

1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL

Якщо пароль не вибрано при встановленні MySQL, тоді змінити можна так

sudo dpkg-reconfigure mysql-server-5.1

2) Для підтримки UTF-8 в MySQL у файлі /etc/mysql/my.cnf (наприкінці) повинно бути наступне

[client]
default-character-set=utf8
[mysqld_safe]
default-character-set=utf8
[mysql]
default-character-set=utf8
[mysqld]
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'
default-character-set=utf8
character-set-server=utf8
collation-server=utf8_unicode_ci
character_set_client=utf8
default-collation=utf8_unicode_ci
skip-character-set-client-handshake

3) Перезапускаємо сервер MySQL

sudo /etc/init.d/mysql restart

4) Переконуємося, що зміни внесені, виконавши

sudo mysql -uroot -pПарольАдмінаMySQL
show variables;
quit

== Встановлення Koha ==

Вхід від користувача АдміністраторСистемиKoha. Переходимо у середовище користувача АдміністраторСистемиKoha (вводимо пароль користувача АдміністраторСистемиKoha):

su АдміністраторСистемиKoha
cd ~ /

=== Отримання Koha ===

1) Для отримання останньої стабільної Koha — звантажуємо її з http://download.koha-community.org

mkdir ~/koha; wget -O ~/koha/koha-latest.tar.gz http://download.koha-community.org/koha-latest.tar.gz

2) Розпакування архіву

cd ~/koha; tar -xzf koha-latest.tar.gz

=== Створення БД для Koha у MySQL ===

Створюємо базу даних Koha3 та привілеї користувачів для неї:

sudo mysqladmin -uroot -pПарольАдмінаMySQL create Koha3
sudo mysql -uroot -pПарольАдмінаMySQL

У середовищі mysql виконати наступні

grant all on Koha3.* to 'КористувачБДKoha3'@'localhost' identified by 'ПарольКористувачаБДKoha3'; \
flush privileges;
exit

=== Перевірка аналізатора SAX Parser ===

У теці Koha виконати

perl ~/koha/koha.local/misc/sax_parser_print.pl

Ви повинні побачити щось то таке

XML::LibXML::SAX::Parser=HASH(0x81fe220)

Якщо ж є PurePerl або Expat, тоді необхідно редагувати файл /etc/perl/XML/SAX/ParserDetails.ini (запис про XML::LibXML::SAX::Parser повинен бути найнижче).

=== Перевірка чи встановлені усі необхідні пакунки ===

Команда

perl ~/koha/koha.local/koha_perl_deps.pl -c -u -m

видає список відсутніх модулів та модулів, які необхідно оновити.

Вам необхідно знайти й встановити ці модулі (ймовірно, що список буде порожнім, оскільки усі необхідні пакунки повинні згадуватися у цьому керівництві вище).

Відсутні і модулі нових версій шукайте у гілці Debian „unstable“ і «testing» або ж у CPAN (Perl-модулі з CPAN встановлюються командою наприклад „sudo cpan HTTP::OAI“).

=== Запуск інсталятора ===

Запускаємо встановлювач (у наступній команді вказуємо свої дані)

cd ~/koha/koha.local/

INSTALL_BASE=/usr/share/koha3 \
KOHA_USER=АдміністраторСистемиKoha \
KOHA_GROUP=АдміністраторСистемиKoha \
DB_NAME=Koha3 \
DB_USER=КористувачБДKoha3 \
DB_PASS=ПарольКористувачаБДKoha3 \
ZEBRA_MARC_FORMAT=unimarc \
ZEBRA_USER=КористувачZebra \
ZEBRA_PASS=ПарольКористувачаZebra \
INSTALL_PAZPAR2=yes \
USE_MEMCACHED=yes \
perl Makefile.PL

Відповідаємо на питання:

=== Відповіді на питання ===

By default, Koha can be installed in one of three ways:
standard: Install files in conformance with the Filesystem Hierarchy Standard (FHS). This is the default mode and should be used when installing a production Koha system. On Unix systems, root access is needed to complete a standard installation.
single: Install files under a single directory. This option is useful for installing Koha without root access, e.g., on a web host that allows CGI scripts and MySQL databases but requires the user to keep all files under the user's HOME directory.
dev: Create a set of symbolic links and configuration files to allow Koha to run directly from the source distribution. This mode is useful for developers who want to run Koha from a git clone.
Installation mode (dev, single, standard) [standard]
Please specify the directory under which most Koha files will be installed.
Note that if you are planning in installing more than one instance of Koha, you may want to modify the last component of the directory path, which will be used as the package name in the FHS layout.
Base installation directory (default from environment) [/usr/share/koha3]
Since you are using the 'standard' install mode, you should run 'make install' as root. However, it is recommended that a non-root user (on Unix and Linux platforms) have ownership of Koha's files, including the Zebra indexes if applicable.
Please specify a user account. This user account does not need to exist right now, but it needs to exist before you run 'make install'. Please note that for security reasons, this user should not be the same as the user account Apache runs under.
User account (default from environment) [АдминистраторСистемиKoha]
Please specify the group that should own Koha's files. As above, this group need not exist right now, but should be created before you run 'make install'.
Group (default from environment) [АдминистраторСистемиKoha]
Please specify which database engine you will use to store data in Koha. The choices are MySQL and PostgreSQL; please note that at the moment PostgreSQL support is highly experimental.
DBMS to use (Pg, mysql) [mysql]
Please specify the name or address of your database server. Note that the database does not have to exist at this point, it can be created after running 'make install' and before you try using Koha for the first time.
Database server [localhost]
Please specify the port used to connect to the DMBS [3306]
Please specify the name of the database to be used by Koha (default from environment) [Koha3]
Please specify the user that owns the database to be used by Koha (default from environment) [ПользовательБДKoha3]
Please specify the password of the user that owns the database to be used by Koha (default from environment) [ПарольПользователяБДKoha3]
Koha can use the Zebra search engine for high-performance searching of bibliographic and authority records. If you have installed the Zebra software and would like to use it, please answer 'yes' to the following question. Otherwise, Koha will default to using its internal search engine.
Please note that if you choose *NOT* to install Zebra, koha-conf.xml will still contain some references to Zebra settings. Those references will be ignored by Koha.
Install the Zebra configuration files? (no, yes) [yes]
Found 'zebrasrv' and 'zebraidx' in /usr/bin.
Since you've chosen to use Zebra with Koha, you must specify the primary MARC format of the records to be indexed by Zebra.
Koha provides Zebra configuration files for MARC 21 and UNIMARC.
MARC format for Zebra indexing (marc21, normarc, unimarc) (default from environment) [unimarc]
Koha supplies Zebra configuration files tuned for searching either English (en) or French (fr) MARC records.
Primary language for Zebra indexing (en, fr, nb) [en]
Koha can use one of two different indexing modes for the MARC authorities records:
grs1 - uses the Zebra GRS-1 filter, available for legacy support dom - uses the DOM XML filter; offers improved functionality.
Authorities indexing mode (dom, grs1) [dom]
Please specify Zebra database user (default from environment) [ПользовательZebra]
Please specify the Zebra database password (default from environment) [ПарольПользователяZebra]
Since you've chosen to use Zebra, you can enable the SRU/ Z39.50 Server if you so choose, but you must specify a few configuration options for it.
Please note that if you choose *NOT* to configure SRU, koha-conf.xml will still contain some references to SRU settings. Those references will be ignored by Koha.
Install the SRU configuration files? (no, yes) [yes]
SRU Database host? [localhost]
SRU port for bibliographic data? [9998]
SRU port for authority data? [9999]
Since you've chosen to use Zebra, you can also choose to install PazPar2, which is a metasearch tool. With PazPar2, Koha can perform on-the-fly merging of bibliographic records during searching, allowing for FRBRization of the results list.
Install the PazPar2 configuration files? (default from environment) [yes]
Zebra bibliographic server host? [localhost]
Zebra bibliographic port for PazPar2 to use? [11001]
PazPar2 host? [localhost]
PazPar2 port? [11002]
Use memcached and memoize to cache the results of some function calls? This provides a signficant performance improvement. You will need a Memcached server running. (no, yes) [no] yes
Memcached server address? [127.0.0.1:11211]
Memcached namespace? [KOHA]
Would you like to run the database-dependent test suite? (no, yes) [no]

До слова, якщо Ви помилитесь, або побачите наприкінці що ще не усі залежності задоволені, тоді можете поправити файл Makefile.PL, внісши у нього відповіді.

Після завершення опитування Koha виводить список усіх параметрів.

=== Компіляція та встановлення Koha ===

make

(тут не повинно бути помилок або застережень)

make test

Тут з’являються результати тестування — більшість мають проходити успішно (ок), у результаті ми повинні отримати — „Result: PASS“.

І саме встановлення:

sudo make install

=== Змінні оточення і доналаштування Apache ===

Від встановлювача було прохання додати наступне до змінних оточення, тому додаємо в /etc/environment два рядки

export KOHA_CONF=/etc/koha3/koha-conf.xml
export PERL5LIB=/usr/share/koha3/lib

=== Віртуальні хости Apache ===

1) Підключаємо у Apache2 конфіґурацію для Koha

sudo ln -s /etc/koha3/koha-httpd.conf /etc/apache2/sites-available/Koha3
sudo a2ensite Koha3

2) Додаємо порти у /etc/apache2/ports.conf

Listen 80
Listen 8888

Увага: іноді порт 80 може бути зайнятий на даному IP/домені — тоді тут і нижче тимчасово замінити порт 80 на 8008.

3) Також правимо порти у файлі /etc/koha3/koha-httpd.conf приблизно так

<VirtualHost *: 80>
...
ServerName koha: 80
...
<VirtualHost *: 8888>
...
ServerName koha: 8888

4) Перезапускаємо веб-сервер Apache 2

sudo /etc/init.d/apache2 restart

=== Сервер Zebra ===

Для підтримки автозапуску сервера Zebra виконуємо наступні команди

sudo ln -s /usr/share/koha3/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
sudo update-rc.d koha-zebra-daemon defaults
sudo /usr/share/koha3/bin/koha-zebra-ctl.sh start

=== Підтримка кирилиці рушієм пошуку Zebra ===

Необхідно додати кириличні символи у файл

/etc/koha3/zebradb/etc/word-phrase-utf.chr

а конкретніше - виправити на наступні:

lowercase {0-9}{a-z}æäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі
uppercase {0-9}{A-Z}ÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ

Без цієї зміни пошук або не працюватиме або даватиме некоректні результати.

=== Налаштування переіндексації за розкладом (cron) ===

Додаємо за допомогою команди

sudo crontab -e -u АдміністраторСистемиKoha

наступне завдання (коригуємо дані відповідно раніше зазначених в встановлювачі)

# Завдання cron для koha3
1 * * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib/usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -a -b -z 2>&1 > /dev/null

Увага: також слід перевірити виконання цього завдання і з консолі для впевненості, що воно буде виконаються коректно:

sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib/usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -a -b -z -v

Якщо будуть такі помилки:

10: 29: 41-11 / 08 zebraidx (29193) [warn] zebra_lock_create fail fname = / var / lock / koha3 / zebradb / biblios / norm..LCK [No such file or directory]
10: 29: 41-11 / 08 zebraidx (29193) [warn] zebra_lock_create fail fname = / var / lock / koha3 / zebradb / biblios / shadow..LCK [No such file or directory]

тоді

cd /var/lock/koha3/
mkdir zebradb
chmod ugoa+r+w+x zebradb
cd zebradb /
mkdir biblios
chmod ugoa+r+w+x biblios

=== Інші періодичні завдання (cron) ===

1) „Хмари“ міток і класифікації (для класифікацій необхідно правити build_browser_and_cloud.pl та opac-browser.tmpl)

# Завдання cron для koha3 (приклад для УДК (3 ділення) і Unimarc)
0 0 * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib/usr/share/koha3/bin/cronjobs/build_browser_and_cloud.pl -b -f 675a -t 606 -c -m 3

=== Запуск веб-інсталятора ===

У веб-браузері вводимо адресу нашого сервера

http://localhost:8888?language=uk-UA

(повинен з’явиться запит на вхід у систему і подальшого встановлення)

Поки не продовжуємо, оскільки у джерельних кодах не доступні локалізовані шаблони для інших мов окрім англійської. Шаблони для української, російської і т.д. необхідно згенерувати.

=== Створення локалізованих шаблонів ===

Переходимо у теку сценаріїв локалізації Koha

cd /usr/share/koha3/misc/translator

й запускаємо створення локалізованих шаблонів для кожної мови

sudo env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install uk-UA
sudo env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install ru-RU

... і для інших потрібних мов (окрім „en“)

=== Підготовка локалізованих sql-таблиць (в роботі) ===

Актуальні локалізовані SQL-таблиці (у [https://www.dropbox.com/referrals/NTE4MzAyOTY5?src=global9 DrobBox] Сергія Дубика) '''українською''' знаходяться за адресою:

https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0

Звантажуємо звідси найновішу версію теки '''uk-UA''' та замінюємо нею відповідну теку у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''.

Примітка: локалізація SQL-таблиць російською '''ru-RU''' доступна лише для версії 3.4.х.

Після цього необхідно перезавантажити сервер (веб-встановлювач чомусь інакше не бачить інші мови окрім англійської).

=== Кроки веб-інсталятора ===

Далі продовжуємо у веб-браузері

http://localhost:8888?language=uk-UA

Реєструємося (згадуємо логін АдміністраторСистемиKoha та пароль ПарольАдміністраторСистемиKoha)

Крок 1.

*Вибір мови: uk-UA
*Перевірка встановлених залежностей (пакунки)

Крок 2.

*Вивід налаштувань БД
*Перевірка існування БД Koha3 та привілеїв доступу користувача АдміністраторСистемиKoha

Крок 3.
*Підготовка таблиць
*Створення таблиць
*Підготовка базового налаштування
*Вибір стандарту МАРК-записів: Unimarc
*Вибір sql-таблиць для імпорту — вибрати усе

Продовжуємо …

*Імпорт sql-таблиць

Дивимося чи немає помилок імпорту sql-таблиць.

Встановлення завершено.

== Оновлення безпеки ==
=== ОС GNU/Linux Debian ===

Для можливості встановлення оновлень безпеки у /etc/apt/sources.list повинен бути рядок

deb http://security.debian.org/ squeeze/updates main contrib non-free

Встановлення оновлень виконується командами

sudo apt-get update
sudo apt-get upgrade

Системному адміністратору бажано підписатися на список розсилання „Debian Security Announce“:

http://lists.debian.org/debian-security-announce/

і проводити поновлення якщо у розсиланні згадуються встановлені у системі пакунки.

=== Koha ===

У останні час команда розробників Koha випускає нову „мінорну“ (третя цифра) версію раз на місяць і приблизно раз на півроку/рік „мажорну“ (друга цифра). У мінорних версіях як правило значних нововведень немає але часто усуваються якісь недоліки або проблеми з безпекою.

За новинами про Koha легко стежити через сервіс Nabble:

http://koha.1045719.n5.nabble.com/Koha-f3047917.subapps.html

(тут зібрано більшість списків розсилань про Koha).

Перед оновленням обов’язково потрібно зробити резервні копії БД й каталогів з налаштуваннями, perl-сценаріями й веб-шаблонами Koha.
Також бажано налаштувати періодичне повне або часткове резервування сервера з АБІС Koha на інший сервер або мережеве сховище.

Детальні інструкції по оновленню можна знайти або за адресою

http://wikitntu.org.ua/%D0%9E%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha,_%D0%B2%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BE%D1%97_%D0%B7_%D0%B4%D0%B6%D0%B5%D1%80%D0%B5%D0%BB%D0%B0

або на сайті АБІС Koha (http://koha-community.org).

'''Застереження''': оновлення Koha розраховане на „чисте“ некастомізоване (щодо сценаріїв, шаблонів, типової структури БД) встановлення Koha. Як правило, усі локальні зміни у БД, perl-сценаріях та веб-шаблонах після поновлення '''пропадають'''. Тому після поновлення потрібно відновити (і адаптувати до нової версії) усі локальні зміни а також детально перевірити зачеплювану ними функціональність.

= Консольні інструменти АБІС Koha =
== Теки та файли АБІС Koha ==

Тут наведені теки для одного конкретного встановлення Koha (В інших встановленнях теки будуть трохи відрізнятися).

*'''/etc/koha3/'''
— файли Налаштування Koha, віртуальні хости для Apache, файли Налаштування рушія Zebra

*'''/usr/share/koha3/'''
— основний каталог АБІС Koha, містить

*'''/usr/share/koha3/bin/'''
— консольні утиліти (для пошукової індексації, міграції, перевірок й т. П.), Як правило, для часозатратних операцій

*'''/usr/share/koha3/doc/release_notes/'''
— зібрання приміток про всі версії Koha

*'''/usr/share/koha3/intranet/cgi-bin/'''
— Perl-сценарії всіх модулів бібліотечного інтерфейсу (БІ)

*'''/usr/share/koha3/intranet/htdocs/intranet-tmpl/prog/'''
— локалізовані веб-шаблони модулів бібліотечного інтерфейсу

*'''/usr/share/koha3/opac/cgi-bin/'''
— Perl-сценарії електронного каталогу (ЕК)

*'''/usr/share/koha3/opac/htdocs/intranet-tmpl/prog/'''
— локалізовані веб-шаблони електронного каталогу

*'''/usr/share/koha3/lib/C4/'''
— загальні perl-модулі

*'''/usr/share/koha3/man/man3/'''
— документація у man-форматі для perl-модулів, модулів БІ/ЕК

*'''/usr/share/koha3/misc/translator/'''
— інструменти локалізації а також файли перекладів (з http://translate.koha-community.org/)

*'''/usr/share/koha3/misc/koha-install-log'''
— файл журналу встановлення (використовується при оновленні)

*'''/var/log/koha3/'''
— системні журнали Koha

*'''/var/lib/mysql/Koha3'''
— файли БД MySQL „Koha3“ з даними (задля бекапів)

*'''/var/lib/koha3/zebradb/'''
*'''/var/lock/koha3/zebradb/'''
— файли БД Zebra

== Періодичні завдання ==

Різноманітні періодичні завдання у вигляді perl-сценаріїв зібрані у теці '''/usr/share/koha3/bin/cronjobs''':

*'''crontab.example''' —
приклад переліку періодичних завдань;

*holds/'''build_holds_queue.pl''', holds/'''cancel_expired_holds.pl''' —
робота з чергою резервувань та застарілими резервуваннями;

*rss/'''rss.pl''' і додаткові файли —
періодична підготовка RSS-каналів згідно шаблонів;

*stats/'''monthly_circulation_statistics.pl''', stats/'''monthly_new_items_statistics.pl''', stats/'''monthly_new_patron_statistics.pl''' —
підготовка місячної статистики у CSV-форматі щодо обігу, нових надходжень та відвідувачів;

*'''MARC21_parse_test.pl''' —
періодичний аналіз і можливе виправлення xml-полів biblioitems.marcxml;

*'''advance_notices.pl''' —
підготовка оповіщень про повернення і розміщення їх у чергу;

*'''backup.sh''' —
приклад сценарію архівування БД;

*'''build_browser_and_cloud.pl''' —
сценарій для створення хмари користувацьких міток та класифікаційного дерева;

*'''cart_to_shelf.pl''' —
сценарій для автоматичної зміни розташування „CART“ на звичайне (для даного екземпляра) поличне розташування;

*'''check-url.pl''' —
перевірка URL-посилань у бібліографічних записах;

*'''cleanup_database.pl''' —
очистка таблиць sessions та zebraqueue (повністю чи лише старі записи);

*'''cloud-kw.pl''', '''cloud-sample.conf''' —
створення хмари ключових слів на підставі покажчика Zebra (Налаштування у файлах * .conf);

*'''create_koc_db.pl''' —
створення файлу БД для інструменту офлайнової книговидачі;

*'''fines.pl''' —
сценарій нарахувань пені;

*'''gather_print_notices.pl''' —
виведення усіх очікуючих повідомлень у файл;

*'''j2a.pl''' —
змінює тип користувача з „J“ на „A“ при досягненні 18-річчя;

*'''longoverdue.pl''' —
сценарій встановлення статусів втрати для давно прострочених книг й нарахування штрафів;

*'''notifyMailsOp.pl''' —
повідомлення електронною поштою;

*'''overdue_notices.pl''' —
підготовка повідомлень щодо прострочених примірників;

*'''printoverdues.sh''' —
сценарій перетворення html » pdf файлів та роздруківки їх;

*'''process_message_queue.pl''' —
сценарій обробки черги повідомлень;

*'''runreport.pl''' —
сценарій виконання підготовлених звітів;

*'''serialsUpdate.pl''' —
сценарій поновлення підписки на серіальні видання;

*'''services_throttle.pl''' —
потрібно для скидання дроселя послуг xisbn;

*'''smsoverdues.pl''' —
сценарій передачі відвідувачам SMS-повідомлень щодо пені чи прострочок;

*'''zebraqueue_start.pl''' —
сценарій для запуску служби Zebra;

== Консольні утиліти ==

Деякі завдання в АБІС Koha виконуються консольними утилітами. Їх можна знайти у наступних теках:

/usr/share/koha3/bin
/usr/share/koha3/misc/translator

Нище перераховані існуючі утиліти:
(тека /usr/share/koha3/bin)

*'''admin/koha-preferences''' — робота з системними змінними (встановлення, зміна, вивід, завантаження/вивантаження);

*'''cronjobs'''/ — періодичні завдання (описано вище);

*'''interface_customization'''/ — вихідні файли koha3-staff-client-logo. * і koha3-opac-button-background. *;

*'''load_testing'''/ — тести на швидкодію, регресії і т.п. для обігу та веб-служб (сценарії '''benchmark_circulation.pl''' та '''benchmark_webservices.pl''');

*'''maintenance'''/ —

'''MARC21_utf8_flag_fix.pl''' — виправлення значення позиції 9 маркера для MARC21 — UTF8,

'''UNIMARC_fix_collectiontitle.pl''' — перевірка biblioitems.collectiontitle,

'''UNIMARC_sync_date_created_with_marc_biblio.pl''' — datecreated-> 099c і timestamp-> 099d,

'''fix_accountlines_date.pl''' — виправлення дати для пені,

'''sync_items_in_marc_bib.pl''' — заміна екземплярних даних в МАРК-полях на дані з таблиці items;

*'''migration_tools'''/ — сценарії використовувані при міграції даних, для створення/оновлення пошукового покажчика і т.п.,

'''22_to_30/''' — набір сценаріїв для поновлення Koha серії 2.2.х до 3.0,

'''build6xx.pl''' — перестворення заданого тезауруса (авторитетного файлу) на підставі даних Біб-запису,

'''buildCOUNTRY.pl''' — сценарій перестворення списку країн (COUNTRY) з існуючих країн в Біб-записах,

'''buildEDITORS.pl''' — сценарій перестворення списку EDITORS (для полігонів 210c і 225a),

'''buildLANG.pl''' — сценарій перестворення списку мов (LANG) з існуючих мов в Біб-записах,

'''bulkauthimport.pl''' — сценарій імпорту файлів авторитетних записів формату MARCXML або ISO2709,

'''bulkmarcimport.pl''' — сценарій імпорту файлів бібліографічних записів формату MARCXML або ISO2709,

'''fix_onloan.pl''' — оновлення статусу "на видачі" для екземплярів,

'''merge_authority.pl''' — утиліта для об'єднання двох авторитетних записів,

'''rebuild_nozebra.pl''' — основний сценарій створення пошукових покажчиків для режиму NoZebra,

'''rebuild_zebra.pl''' — основний сценарій створення пошукових покажчиків для режиму Zebra,

'''remove_unused_authorities.pl''' — вилучення авторитетних записів, які не прив'язані до Біб-записів,

'''upgradeitems.pl''' — оновлення екземплярних записів у Біб-записі (для поля 995, Unimarc);

*'''spellcheck_suggest/make_spellcheck_suggest.pl''' — початкова реалізація перевірки правопису (Marc21);

*'''batchCompareMARCvsFrameworks.pl''' — сценарій порівнює файл iso2709 і МАРК-структуру в Koha і повертає дані про використовувані/невикористовувані підполя;

*'''batchDeleteUnusedSubfields.pl''' — вилучення невикористовуваних МАРК-полів (не представлених в МАРК структурах);

*'''batchImportMARCWithBiblionumbers.pl''' — імпорт ISO2709-файлу, для записів якого вже існують відповідні №№ biblio.biblionumber (MARC21);

*'''batchRebuildBiblioTables.pl''' — перебудова НЕ-MARC БД з MARC-значень (напр., при зміні відображення Koha-MARC);

*'''batchRepairMissingBiblionumbers.pl''' — пошук і виправлення відсутніх значень полів biblionumber/biblioitemnumber;

*'''batchupdateISBNs.pl''' — пакетне вилучення знаку „-“ в значеннях ISBN;

*'''check_sysprefs.pl''' — перевірка на відсутні системні змінні;

*'''commit_biblios_file.pl''' — сценарій для імпорту заготовлених раніше записів (за допомогою stage_biblios_file.pl або інструменту „Заготівля МАРК-записів для імпорту“);

*'''exportauth.pl''' — експорт авторитетних файлів у файл ISO2709;

*'''koha-pazpar2-ctl.sh''' — сценарій служби PAZPAR2 для init.d;

*'''koha-zebra-ctl.sh''' — сценарій служби ZEBRA для init.d;

*'''koha-zebraqueue-ctl.sh''' — сценарій служби ZEBRAQUEUE для init.d;

*'''kohalib.pl''' — сценарій встановлення шляху до модулів C4;

*'''link_bibs_to_authorities.pl''' — сценарій для приєднання до заголовків Біб-запису відповідних авторитетних записів;

*'''perlmodule_ls.pl''' — вивід використовуваних модулів;

*'''perlmodule_rm.pl''' — вилучення perl-модуля;

*'''sax_parser_print.pl''' — перевірка поточного SAX-аналізатора (повинен бути XML::LibXML::SAX::Parser);

*'''sax_parser_test.pl''' — перевірка виводу XML::SAX;

*'''stage_biblios_file.pl''' — завантаження файлу Біб-записів у сховище (для подальшого імпорту за допомогою commit_biblios_file.pl або інструменту „Управління заготовленими МАРК-записами“);

*'''zebraqueue_daemon.pl''' — служба для стеження за чергою Zebra і оновленні Zebra якщо потрібно.
(тека /usr/share/koha3/misc/translator)

*'''translate'''
— утиліта для ведення перекладів в Koha, приклади використання

translate '''create''' fr-FR — створення po-файлів з шаблонів для мови fr-FR,

translate '''update''' fr-FR — оновлення існуючих po-файлів з теки шаблонів,

translate '''install''' fr-FR — внесення перекладу з po-файлів в шаблони і описи системних параметрів для мови fr-FR,

translate -p install fr-FR — внесення перекладу лише для описів системних параметрів,

translate install — внесення перекладів в шаблони для усіх існуючих мов (використовуючи усі po-файли в теці /usr/share/koha3/misc/translator/po).

== Оновлення перекладів ==

Переклад інтерфейсу АБІС Koha ведеться на сайті http://translate.koha-community.org. Наприклад, для української мови та для версії 3.16.х файли розділ перекладу знаходиться тут: http://translate.koha-community.org/uk/316/.

Про сценарії для перекладу вже згадувалося у розділах „Створення локалізованих шаблонів“ і попередньому.

Для спрощення оновлення перекладів Сергієм Дубиком написано кілька сценаріїв, які можна знайти у теці '''koha_localization_scripts_3.2.X_with_custom''':

*'''0_DOWNLOAD_po_from_Koha_32_web.sh''' — викачує потрібні po-файли (для обраних мов і версії);
*'''1_BACKUP_work_templates.sh''' — архівує локалізовані теки (для обраних мов);
*'''2_UNION_with_CUSTOM.sh''' — об’єднує офіційні po-файли з локальними (у локальних po-файлах розміщується локалізація локальної кастомізації);
*'''3_INSTALL_po_to_work_TEMPLATEs.sh''' — копіювання результуючих po-файлів у теку misc/translator/po та оновлення перекладу тек з локалізованими шаблонами інтерфейсу (для обраних мов);
*'''all_32.sh''' — виконує дії № 0,2,3 за раз.
(сценарії виконуються у оточенні користувача АдміністраторСистемиKoha)

Локальні po-файли мають назву подібно uk-UA-i-opac-t-prog-v-3006000-custom.po.

== Створення архівних копій ==
Архівну копію БД бажано робити щодня і копіювати на інший комп’ютер. Приклад сценарію бекапу згадувався в періодичних завданнях (backup.sh). Також є сценарій архівування Сергія Дубика:

'''koha_backup_scripts/EXPORT_all_DB_data_and_structure.sh'''

Дані сценарії потрібно доопрацювати під свої потреби і бажано доповнити варіантом бекапу всієї системи.

== Приклад локальних змін встановлення АБІС Koha ==

Від базового локальне встановлення АБІС Koha може відрізнятися
*налаштуваннями системних змінних;
*набором початкових даних;
*структурою БД;
*змінами в виконуваний код;
*змінами в шаблонах користувацького інтерфейсу.

Початкові дані та змінені системні змінні опустимо, оскільки їх перерахування виходять за межі короткої інструкції для адміністратора.

=== Латки ===

У бібліотечному інтерфейсі було накладено 2 латки для додавання кириличного алфавіту при пошуку відвідувача:

*intranet/cgi-bin/members/'''member.pl''':

149 my @letters = map { {letter => $_} } (.
150 'А','Б','В','Г','Д','Е','Ё','Ж','З','И','Й','К','Л','М','Н','О','П','Р','С','Т','У','Ф','Х','Ц','Ч','Ш','Щ','Ъ','Ы','Ь','Э','Ю','Я',
151 'І','Ї','Є','Ґ','Ў',
152 'A' .. 'Z');

*intranet/cgi-bin/members/'''members-home.pl''':

82 my @letters = map { {letter => $_} } (
83 'А','Б','В','Г','Д','Е','Ё','Ж','З','И','Й','К','Л','М','Н','О','П','Р','С','Т','У','Ф','Х','Ц','Ч','Ш','Щ','Ъ','Ы','Ь','Э','Ю','Я',
84 'І','Ї','Є','Ґ','Ў',
85 'A' .. 'Z');

Також частково змінювався файл періодичної підготовки хмари теґів та ієрархії за класифікацією:

*bin/cronjobs/'''build_browser_and_cloud.pl'''

=== Дизайн ===
Тут будуть вказані лише файли, яких торкнулися зміни. Змінювався дизайн електронного каталогу для реалізації помітного інтерфейсу для двох підрозділів. Зміни вносилися у каталог opac/htdocs/opac-tmpl/prog/en/ і потім розмножувалися на інші локалізовані каталоги шляхом оновлення перекладів (згадувалося вище).

Отже, були змінені наступні файли:

*css/opac.css
*додано css/opac_school.css
*додано css/opac_university.css
*includes/doc-head-close.inc
*includes/masthead.inc
*включає/opac-bottom.inc
*modules/opac-account.tmpl
*modules/opac-auth.tmpl
*modules/opac-browser.tmpl
*modules/opac-main.tmpl
*modules/opac-passwd.tmpl
*modules/opac-readingrecord.tmpl
*modules/opac-пошук-history.tmpl
*modules/opac-shelves.tmpl
*modules/opac-suggestions.tmpl
*modules/opac-tags.tmpl
*modules/opac-user.tmpl
*modules/opac-userupdate.tmpl

= Налаштування АБІС Koha у веб-інтерфейсі =
== Загальні зауваження ==
== Управління ==
В цьому модулі здійснюються основні налаштування АБІС Koha для конкретної бібліотеки.

Бажано початкове налаштування робити в такому порядку, в якому наводиться опис етапів налаштування. Внесення змін у цьому модулі треба проводити з великою обережністю, особливо після внесення даних.

<p align="right">''Основні параметри''</p>

'''Бібліотеки, підрозділи та групи'''

Визначення бібліотек, підрозділів і груп. Тут визначаються як самі бібліотеки (у випадку незалежних підрозділів) так і внутрішні підрозділи, які беруть участь у книговидачі (чит-зали, абонемент) або бібліотечних переміщеннях (віддалені фондосховища).

Тут є можливість:

1) Додати нову бібліотеку/підрозділ, присвоїти їм властивості пошукової або домашньої, також додати IP-адреси (якщо включено AutoLocation).

2) Редагувати/вилучати бібліотеку.

3) Додавати групи „пошукова область“ та „властивості“.

'''Типи одиниць'''

Визначення типів одиниць, використовуваних при пошуку і правила обороту. Кожен тип одиниці може мати графічне позначення, опис, прапорець дозволу/заборони книговидачі, суму плати за прокат.

'''Авторитетні значення'''

Визначення категорій списків та авторитетних значень для них. Доступні такі списки: Asort1, Asort2, BOR_NOTES, Bsort1, Bsort2, CCODE, COUNTRY, DAMAGED, HINGS_AS, HINGS_C, HINGS_PF, HINGS_RD, HINGS_UT, LANG, LOC, LOST, MANUAL_INV, NOT_LOAN, OPAC_SUG, QUALIF, RESTRICTED, STACK, SUGGEST, SUPPRESS, WITHDRAWN, YES_NO, rusmarc856. Більшість з цих списків системні і використовуються в різних аспектах Koha. Можна створювати свої переліки і присвоювати деяким підполям у МАРК-структурі тощо.

<p align="right">''Відвідувачі та обіг''</p>

'''Категорії відвідувачів'''

Визначення категорій відвідувачів. Використовуються наступні категорії відвідувачів:

*'''Відвідувачі, які знаходяться вдома''',
*'''Відвідувач''',
*'''Студент''',
*'''Неповнолітній''',
*'''Дитина''',
*'''Юнак''',
*'''Бібліотека''',
*'''Міжбібліотечний обмін''',
*'''Школа''',
*'''Викладач''',
*'''Рада''',
*'''Персонал бібліотеки'''.

Відвідувачі можуть бути як індивідуальними, так і колективними. Для категорії відвідувача присвоюється термін реєстрації в бібліотеці, необхідний вік, верхня планка віку, плата за реєстрацію, необхідність оповіщення при простроченнях і плата за резервування якщо є.

'''Міста і селища'''

Визначення міст і селищ, в яких живуть Ваші відвідувачі. Може використовуватися для статистики.

'''Типи доріг'''

Визначення типів доріг (вулиця, проспект, шлях, тощо). Тип доріг відображаються як авторитетні значення при додаванні/редагуванні відвідувачів і може використовуватися для географічної статистики.

'''Види атрибутів відвідувачів'''

Визначення розширених атрибутів (ідентифікаторів і статистичних категорій) для записів відвідувачів. Тут визначаються можливі додаткові поля опису відвідувачів. Доступні наступні:

*'''Клас, група''',
*'''Науковий ступінь''',
*'''Освітньо-кваліфікаційний рівень''',
*'''Підрозділ, відділення''',
*'''Освіта''',
*'''Навчальний заклад''',
*'''Етнічна належність''',
*'''Зауваження щодо етнічної приналежності''',
*'''Факультет''',
*'''Батько, ПІБ''',
*'''Батько, електронна пошта''',
*'''Батько, телефон''',
*'''Ідентифікатор LDAP''',
*'''Мати, ПІБ''',
*'''Мати, електронна пошта''',
*'''Мати, телефон''',
*'''Національність''',
*'''Коли виданий паспорт''',
*'''Серія і номер паспорта''',
*'''Де видано паспорт''',
*'''По батькові''',
*'''Професія''',
*'''Показувати штрих-код на зведеному екрані списків примірників''',
*'''Наукове звання''',
*'''Посада'''.

Легко додаються і інші поля, які можуть бути повторюваними, паролем унікальним ідентифікатором, відображатися в ЕК і вибиратися з авторитетного списку.

'''Правила обороту і штрафи'''

Визначення правил обігу та випадків стягнення штрафів для поєднань бібліотек, категорій відвідувачів і типів одиниць. Дуже гнучке налаштування правил обігу, яке враховує підрозділ бібліотеки, категорію відвідувача та тип одиниці.

'''Обмеження бібліотечних переміщень'''

Обмеження можливості переміщення примірників між бібліотеками для зазначених відправляючої бібліотеки, отримуючої бібліотеки та типу примірника, який переміщується. Ці правила вступить в силу, лише якщо параметр „UseBranchTransferLimits“ встановлено в положення ВКЛ.

'''Попередження при обороті примірників'''

Визначення правил показу повідомлень для видачі та повернення поєднань бібліотек, категорій відвідувачів і типів одиниць.

<p align="right">''Каталог''</p>

'''Бібліографічна МАРК-структура'''

Створення і управління бібліографічними структурами, які визначають характеристики Ваших МАРК-записів (визначення полів й підполів) а також шаблони для МАРК-редактора. Гнучкий інструмент для детального налаштування шаблонів введення МАРК-записів. Доступний повний набір полів/підполів MARC21. Для кожного поля/підполя зазначаються видимість, доступність, обов’язковість, повторюваність, можливість вибору із списку, прив’язки до авторитетних джерел, додатків та багато іншого. Доступні наступні:

*'''Структура за умовчанням''',
*'''Аудіоматеріали на касетах, CD''',
*'''Відеоматеріали (DVD, VHS)''',
*'''Книги (монографічні видання)''',
*'''Комплекти, набори змішаних матеріалів''',
*'''Моделі''',
*'''Переплетення (видавниче, розповсюджувальне, власницький конволют)''',
*'''Продовжувані (серіальні) видання''',
*'''Структура швидкого додавання''',
*'''Електронні ресурси (диски, веб, файли, …)'''.

'''Відображення БД Koha у МАРК'''

Визначення відображення між транзакційною базою даних (SQL) Koha та бібліографічними МАРК-записами. Зауважте, що відображення також позначається за допомогою бібліографічної МАРК-структури. Цей інструмент є по суті лише ярликом для прискорення зв’язування. Як правило, після внесення даних вже не повинно змінюватися.

'''Відображення ключових слів у МАРК'''

Визначення відображення між ключовими словами і МАРК-полями, ці ключові слова використовуються для пошуку даних, незалежно від структури.

'''Перевірка бібліографічної МАРК-структури'''

Перевірка МАРК-структури. Якщо Ви зміните Вашу бібліографічну МАРК-структуру, то бажано, щоб Ви використовували цей інструмент для перевірки помилок у Ваших визначеннях. Використовується при первинному налаштуванні.

'''Типи авторитетних джерел'''

Створюйте і керуйте структурами авторитетних джерел, які визначають характеристики Ваших МАРК-записів (визначення полів і підполів). Тут визначаються шаблони для авторитетних файлів. Доступні наступні:

*'''За умовчанням''',
*'''Хронологічне поняття''',
*'''Найменування колективу або юрисдикції''',
*'''Термін жанру/форми''',
*'''Географічна назва''',
*'''Найменування заходу'''
*'''Ім’я особи''',
*'''Тематичний термін''',
*'''Уніфікований заголовок'''.

'''Джерела класифікації'''

Визначення джерел класифікації (наприклад, схеми шифру зберігання), використовувані у Ваших зібраннях. Також визначення правил заповнення, які будуть використовуватися для сортування шифрів зберігання.

'''Правила відповідності записів'''

Управління правилами автоматичного співставлення МАРК записів при імпорті записів. Потрібно лише для міграції.

<p align="right">''Параметри надходжень''</p>

'''Грошові одиниці та обмінні курси'''

Установка грошових одиниць і обмінних курсів, необхідних для надходжень.

'''Кошториси'''

Встановлення Ваших кошторисів

'''Кошти'''

Розподіл коштів в рамках Вашого кошторису

<p align="right">''Додаткові параметри''</p>

'''Цільові сервери для клієнта Z39.50'''

Визначення серверів для запиту МАРК-даних за допомогою вбудованого клієнта Z39.50. Використовуються при каталогізації з використанням Z39.50. Інші сервери можна знайти за адресою http://irspy.indexdata.com/.

== Параметри системи ==

Параметри системи використовуються для детального налаштування усіх модулів АБІС Koha. Деякі параметри (напр. marcflavour) не повинні змінюватися після початкового налаштування, більшість інших можна. Багато параметрів включають/виключають додаткові можливості, вид інтерфейсу, поведінку і багато іншого у АБІС Koha. Параметри для зручності розбиті на наступні групи:

*'''Надходження'''
*'''Управління'''
*'''Авторитетні джерела'''
*'''Каталогізація'''
*'''Обіг'''
*'''Створювачі'''
*'''Розширений вміст'''
*'''Інтернаціоналізація/локалізація'''
*'''Місцеве використання'''
*'''Протоколи'''
*'''Електронний каталог'''
*'''Відвідувачі'''
*'''Пошуки'''
*'''Серіальні видання'''
*'''Клієнт для бібліотекарів'''
*'''Веб-сервіси'''

Розглянемо детальніше (описи наведені частково, з перерахування подано лише значення за умовчанням (виділено курсивом)).

=== Параметри групи „Надходження“ ===

Друк
*'''OrderPdfFormat'''
Правила
*'''AcqCreateItem'''
*'''CurrencyFormat''' — показувати грошові значення в наступному форматі: ''360 000, 00''
*'''gist''' — податкова ставка за замовчуванням дорівнює: ''0.20''

=== Параметри групи „Управління“ ===
Автентифікація через CAS
*'''casAuthentication'''
*'''casLogout'''
*'''casServerUrl'''
Параметри входу
*'''AutoLocation''' — ''не вимагати'' щоб персонал бібліотеки входив в систему з комп’ютера, IP-адреса якого належить діапазону IP-адрес його бібліотеки (якщо зазначено).
*'''IndependantBranches''' — ''не перешкоджати'' персоналу бібліотеки (крім супербібліотекарів) змінювати об’єкти (резервування, екземпляри, відвідувачі тощо), що належать іншим бібліотекам.
*'''insecure'''
*'''SessionStorage'''
*'''timeout''' — автоматичний вихід користувачів після ''12000000'' мілісекунд бездіяльності.

Параметри інтерфейсу

*'''DebugLevel'''
*'''delimiter''' — відокремлювати стовпці в експортованому звіті через ''крапки з комами ;'' за умовчанням.
*'''KohaAdminEmailAddress''' — використовувати ''root@localhost'' в якості адреси електронної пошти адміністратора АБІС Koha. (Це типова адреса для відправника електронної пошти, хоча у кожного окремого підрозділу є і своя електронна пошта, — цей використовується, коли трапляється внутрішня помилка.)
*'''noItemTypeImages'''
*'''virtualshelves''' — ''дозволити'' працівникам бібліотеки та відвідувачам створювати і переглядати збережені списки книг.

=== Параметри групи „Авторитетні джерела“ ===
*'''BiblioAddsAuthorities''' — при редагуванні записів ''заборонити'' також автоматично створювати, при необхідності, нові авторитетні записи, замість того, щоб посилатися на вже існуючі авторитетні джерела.
*'''dontmerge''' — ''не виконувати'' автоматичне оновлення пов’язаних бібліотечних записів при зміні авторитетної запису. Якщо ця опція вимкнена, будь ласка, зверніться до адміністратора задіяти періодичне завдання „merge_authorities.pl“ в „cronjob“.

=== Параметри групи „Каталогізація“ ===
Інтерфейс

*'''advancedMARCeditor''' — ''показувати'' описи полів і підполів у МАРК-редакторі.
*'''DefaultClassificationSource''' — використовувати ''УДК'' як джерело класифікації за умовчанням.

Наклейки на корінці

*'''SpineLabelAutoPrint'''
*'''SpineLabelFormat'''
*'''SpineLabelShowPrintOnBibDetails'''

Відображення

*'''authoritysep''' — відокремлювати кілька авторів, серій або тематик з допомогою „''--''“.
*'''hide_marc''' —
*'''IntranetBiblioDefaultView''' — за умовчанням, відображати бібліографічний запис у ''звичайній формі''.
*'''ISBD''' — шаблон картки ISBD (набір рядків типу „''#686|<br/> ББК |{686a }|''“).
*'''LabelMARCView'''
*'''OpacSuppression'''
*'''URLLinkText'''

Структура запису

*'''autoBarcode''' — штрих-коди ''формуються послідовно'' (1,2,3)
*'''item-level_itypes'''
*'''itemcallnumber''' — відображати MARC-підполя ''942hv'' у шифр зберігання примірника. (Інформація може включати кілька підполів, які можуть використовуватися: наприклад, при 680ab будуть використовуватися підполя „a“ і „b“ з 680). Приклади:

Дьюї: 676a(Unimarc) / (082ab або 092ab)(Marc21);

УДК: 675a(Unimarc);

КБК: 680ab(Unimarc) / (050ab або 090ab)(Marc21);

ББК та ін.: 686abс(Unimarc);

з экземплярного запису: 852gkl(Unimarc) / 852hi(Marc21)

*'''marcflavour''' — тлумачити і зберігати MARC-запис у ''UNIMARC''-форматі.
*'''MARCOrgCode''' — введіть [http://www.loc.gov/marc/organizations/orgshome.html MARC-код організації] ____, який буде використовуватися за умовчанням в нових MARC-записах (залиште порожнім якщо код невідомий).
*'''NewItemsDefaultLocation''' — коли створюються екземпляри, надавати їм тимчасове розташування _____ (повинно бути кодом розташування, або порожнім якщо не використовується).
*'''z3950NormalizeAuthor'''
*'''z3950AuthorAuthFields'''

=== Параметри групи „Обіг“ ===

Інтерфейс

*'''AllowAllMessageDeletion'''
*'''CircAutocompl'''
*'''DisplayClearScreenButton'''
*'''FilterBeforeOverdueReport'''
*'''itemBarcodeInputFilter'''
*'''numReturnedItemsToShow''' — показувати ''20'' останніх повернутих примірників на екрані повернень.
*'''previousIssuesDefaultSortOrder'''
*'''soundon''' — ''дозволити'' обігові звуки при видачі і повернені в інтерфейсі бібліотекарів. Підтримується поки не усіма браузерами.
*'''SpecifyDueDate''' — ''дозволити'' бібліотечному персоналу вказувати дату повернення (очікування) при оформленні видачі.
*'''todaysIssuesDefaultSortOrder'''
*'''UseTablesortForCirc'''

Правила видачі

*'''AllowNotForLoanOverride'''
*'''AllowRenewalLimitOverride'''
*'''AutomaticItemReturn''' — здійснювати автоматичне переміщення примірників до їх вихідного підрозділу при їх поверненні.
*'''ceilingDueDate'''
*'''CircControl'''
*'''globalDueDate'''
*'''HomeOrHoldingBranch'''
*'''HomeOrHoldingBranchReturn'''
*'''InProcessingToShelvingCart'''
*'''IssuingInProcess'''
*'''maxoutstanding'''
*'''noissuescharge'''
*'''OverdueNoticeBcc'''
*'''OverduesBlockCirc''' — ''не блокувати'' видачу відвідувачу, який має прострочені несплати
*'''PrintNoticesMaxLines'''
*'''RenewalPeriodBase'''
*'''ReturnBeforeExpiry'''
*'''ReturnToShelvingCart'''
*'''TransfersMaxDaysWarning'''
*'''UseBranchTransferLimits''', '''BranchTransferLimitsType''' — не дотримуватися обмежень на переміщення між підрозділами, заснованих на ''шифрі зібрання''
*'''useDaysMode''' — розраховувати дату повернення (очікування) використовуючи ''календар, щоб пропустити усі дні, коли бібліотека закрита''.

Правила резервування

*'''AllowHoldDateInFuture'''
*'''AllowHoldPolicyOverride'''
*'''AllowHoldsOnDamagedItems'''
*'''AllowOnShelfHolds'''
*'''canreservefromotherbranches''' — ''дозволити'' користувачам з однієї бібліотеки розміщувати резервування на примірники з іншої бібліотеки
*'''DisplayMultiPlaceHold'''
*'''emailLibrarianWhenHoldIsPlaced'''
*'''maxreserves''' — відвідувачі можуть мати лише ''50'' бронювань за один раз.
*'''OPACAllowHoldDateInFuture'''
*'''ReservesControlBranch'''
*'''ReservesMaxPickUpDelay'''
*'''ReservesNeedReturns'''
*'''StaticHoldsQueueWeight''', '''RandomizeHoldsQueueWeight''' — виконувати резервування з бібліотек ______ (коди підрозділів, через кому, якщо порожньо, то використовуються усі бібліотеки) в даному порядку.

Правила штрафів

*'''finesCalendar''' — розрахунок штрафів ґрунтується на кількості прострочених днів ''виключаючи дні, коли бібліотека закрита''.
*'''finesMode''' — ''підраховувати (але тільки для висилання адміністратору)'' штрафи (для випадку коли виконується періодичне завдання ''misc/cronjobs/fines.pl'').

Самообслуговування

*'''AutoSelfCheckAllowed'''
*'''AutoSelfCheckID'''
*'''AutoSelfCheckPass'''
*'''ShowPatronImageInWebBasedSelfCheck'''
*'''WebBasedSelfCheck''' — не задіяти веб-орієнтовану систему самообслуговування (доступна за адресою: ''/cgi-bin/koha/sco/sco-main.pl'').

=== Параметри групи „Створювачі“ ===

Картки відвідувачів
*'''ImageLimit''' — обмежити кількість зображень створювача (карток клієнтів), що зберігається у базі даних до ''5'' зображень.

=== Параметри групи „Розширений вміст“ ===

Усі

*'''FRBRizeEditions'''
*'''OPACFRBRizeEditions''' — ''не показувати'' інші видання одиниці у електронному каталозі.

Amazon.com

*'''AmazonAssocTag'''
*'''AmazonCoverImages'''
*'''AmazonEnabled'''
*'''AmazonLocale'''
*'''AmazonReviews'''
*'''AmazonSimilarItems'''
*'''AWSAccessKeyID''' — доступ до вмісту Amazon, використовуючи ключ доступу ________ (безкоштовно, посилання: http://aws.amazon.com).
*'''AWSPrivateKey''' — доступ до вмісту Amazon (крім обкладинок книг) з використанням приватного ключа ________ (безкоштовно, посилання: http://aws.amazon.com).
*'''OPACAmazonCoverImages'''
*'''OPACAmazonEnabled'''
*'''OPACAmazonReviews'''
*'''OPACAmazonSimilarItems'''

Babeltheque.com

*'''Babeltheque''' — ''не включати'' інформацію (на кшталт відгуків і цитат) з Babelthèque.com на сторінці подробиць про запис в електронному каталозі.

Baker & Taylor (btol.com)

*'''BakerTaylorBookstoreURL'''
*'''BakerTaylorEnabled'''
*'''BakerTaylorUsername''', '''BakerTaylorPassword''' — мати доступ до „Бейкер & Тейлор“, використовуючи ім'я користувача ___ і пароль ____.

Google.com

*'''GoogleJackets''' — ''не додавати'' обкладинки з „Книги Google“ в результати пошуку та на сторінці подробиць запису в електронному каталозі.

LibraryThing.com

*'''LibraryThingForLibrariesEnabled'''
*'''LibraryThingForLibrariesID''' — мати доступ до „Library Thing для бібліотек“, використовуючи ідентифікатор клієнта _____ .
*'''LibraryThingForLibrariesTabbedView'''
*'''ThingISBN'''

OCLC.org

*'''OCLCAffiliateID''' — „ідентифікатор партнера Онлайнового комп’ютерного бібліотечного центру (OCLC)“ ________ для доступу до сервісу xISBN. Зверніть увагу, що, якщо Ви підписалися на даний „OCLC партнерський ID“, Ви обмежені до 1000 запитів в день.
*'''XISBN'''
*'''XISBNDailyLimit'''

Syndetics.com

*'''SyndeticsAuthorNotes'''
*'''SyndeticsAwards'''
*'''SyndeticsClientCode''' — використовувати код клієнта ___ для доступу до Syndetics.
*'''SyndeticsCoverImages'''
*'''SyndeticsCoverImageSize'''
*'''SyndeticsEditions'''
*'''SyndeticsEnabled'''
*'''SyndeticsExcerpt'''
*'''SyndeticsReviews'''
*'''SyndeticsSeries'''
*'''SyndeticsSummary'''
*'''SyndeticsTOC'''

Користувацькі мітки

*'''TagsEnabled''' — ''дозволити'' відвідувачам та працівникам бібліотеки ставити мітки на біб-записах.
*'''TagsExternalDictionary'''
*'''TagsInputOnDetail'''
*'''TagsInputOnList'''
*'''TagsModeration'''
*'''TagsShowOnDetail'''
*'''TagsShowOnList'''

=== Параметри групи „Інтернаціоналізація/локалізація“ ===
*'''dateformat''' — формат дати згідно шаблону ''дд/мм/рррр''.
*'''language''' — задіяти наступні мови в бібліотечному інтерфейсу: ''English(en) Українська(uk-UA) Російська(ru-RU)''
*'''opaclanguages''' — задіяти наступні мови для ЕК: ''English(en) Українська(uk-UA) Російська(ru-RU)''
*'''opaclanguagesdisplay''' — ''дозволити'' відвідувачам змінювати мову, якою вони бачать інтерфейс ЕК.

=== Параметри групи „Місцеве використання“ ===
*'''AllFinesNeedOverride'''
*'''AllowFineOverride'''
*'''AllowPurchaseSuggestionBranchChoice'''
*'''AllowSelfCheckReturns'''
*'''AlternateHoldingsField'''
*'''AlternateHoldingsSeparator'''
*'''AnonymousPatron''' — використовувати системний номер користувача ____ для анонімного відвідувача (для анонімних пропозицій про придбання та історії читання).
*'''AuthoritiesLog'''
*'''COinSinOPACResults'''
*'''Display856uAsImage'''
*'''displayFacetCount'''
*'''FacetLabelTruncationLength'''
*'''FineNotifyAtCheckin'''
*'''FrameworksLoaded'''
*'''IntranetFavicon''' — використовувати зображення за адресою ________ на значок favicon для бібліотечного інтерфейсу (повинно бути повним URL-адресом, що починається з http://).
*'''maxItemsInSearchResults'''
*'''maxRecordsForFacets'''
*'''numSearchRSSResults'''
*'''OPACAllowUserToChooseBranch'''
*'''OpacCloud'''
*'''OPACDisplay856uAsImage'''
*'''OpacFavicon''' — використовувати зображення за адресою ________ на значок favicon для електронного каталогу (повинно бути повним URL-адресоми, що починаються з http://).
*'''OpacHiddenItems'''
*'''OPACMySummaryHTML''' — включити колонку „Посилання“ на вкладці „моя зведення“ (доступна, коли користувач увійшов в електронний каталог) з наступним HTML-кодом (залиште порожнім для відключення): ___________________
*'''OPACNoResultsFound''' — показувати HTML-код при відсутності результату пошуку в електронному каталозі: __________
*'''OpacPrivacy''' — ''заборонити'' відвідувачам самостійно вибирати параметри конфіденційності для їх історії читання. Це також вимагає задіяти „opacreadinghistory“ та „AnonymousPatron“
*'''OpacPublic''' — ''дозволити'' бути відкритим електронному каталогу на АБІС Koha. Приватний електронний каталог вимагає аутентифікації перед доступом до електронного каталогу.
*'''printcirculationslips'''
*'''SelfCheckHelpMessage'''
*'''SelfCheckTimeout'''
*'''ShelfBrowserUsesCcode'''
*'''ShelfBrowserUsesHomeBranch'''
*'''ShelfBrowserUsesLocation'''
*'''ShowReviewer'''
*'''StaffAuthorisedValueImages'''
*'''TraceCompleteSubfields'''
*'''TraceSubjectSubdivisions'''
*'''UseAuthoritiesForTracings'''
*'''UseControlNumber'''
*'''Version'''
*'''WaitingNotifyAtCheckin'''

=== Параметри групи „Протоколи“ ===
*'''BorrowersLog''' — ''записувати'' в журнал зміни в записах відвідувачів.
*'''CataloguingLog''' — ''не реєструвати'' будь-які зміни щодо бібліографічних або примірникових записів. Оскільки це відбувається також при кожній видачі або повернення книги, не рекомендується задіяти цей параметр.
*'''FinesLog''' — ''записувати'' в журнал коли прострочені штрафи стягуються або автоматично прощені.
*'''IssueLog''' — ''записувати'' в журнал коли примірники видаються.
*'''LetterLog''' — ''записувати'' в журнал коли відправляється автоматичне повідомлення з претензією.
*'''ReturnLog''' — ''записувати'' в журнал при поверненні примірників.
*'''SubscriptionLog''' — ''записувати'' в журнал коли серіальні видання додаються, видаляються або змінюються.

=== Параметри групи „Електронний каталог“ ===

Зовнішній вигляд

*'''AuthorisedValueImages'''
*'''BiblioDefaultView''' — за умовчанням, показувати бібліотечні запису в ''простій формі''.
*'''DisplayOPACiconsXSLT'''
*'''hidelostitems'''
*'''LibraryName''' — показувати __________ в якості назви бібліотеки в електронному каталозі.
*'''OpacAddMastheadLibraryPulldown'''
*'''OPACBaseURL''' — ЕК розташовується за адресою http://_______________ (це необхідно коректно заповнити для правильної роботи RSS, unAPI та пошукових додатків)
*'''opaccolorstylesheet'''
*'''opaccredits''' — включити наступний HTML-код в нижній частині усіх сторінок в електронному каталозі: _____________
*'''OPACDisplayRequestPriority''' — ''не показувати'' відвідувачам рівень пріоритету їх бронювань в ЕК.
*'''opacheader''' — включити наступний HTML-код в заголовку усіх сторінок в ЕК: ________________
*'''OpacHighlightedWords'''
*'''opaclayoutstylesheet'''
*'''OpacMaintenance'''
*'''OpacMainUserBlock'''
*'''OpacNav'''
*'''OPACSearchForTitleIn'''
*'''OPACShowCheckoutName'''
*'''opacsmallimage'''
*'''opacstylesheet'''
*'''opacthemes''' — використовувати тему ''prog'' для ЕК.
*'''OPACURLOpenInNewWindow'''
*'''OPACUserCSS'''
*'''opacuserjs'''
*'''OPACXSLTDetailsDisplay''' — показувати сторінки з відомостями про примірники у електронному каталозі в ''нормальному вигляді''.
*'''OPACXSLTResultsDisplay''' — показувати бібліографічні записи на сторінці результатів пошуку ЕК в ''нормальному вигляді''.

Можливості

*'''OpacAuthorities'''
*'''opacbookbag'''
*'''OpacBrowser'''
*'''OPACFinesTab'''
*'''OpacPasswordChange'''
*'''OPACPatronDetails'''
*'''opacreadinghistory'''
*'''OPACShelfBrowser'''
*'''OpacTopissue'''
*'''opacuserlogin'''
*'''RequestOnOpac'''
*'''reviewson'''
*'''suggestion'''

Правила

*'''AnonSuggestions'''
*'''OPACFineNoRenewals'''
*'''OPACItemHolds'''
*'''OpacRenewalAllowed'''
*'''OPACViewOthersSuggestions''' — ''не показувати'' пропозиції про придбання від інших відвідувачів у електронному каталозі.
*'''SearchMyLibraryFirst''' — ''не обмежувати'' результати пошуків бібліотекою, в якій зареєстрований відвідувач.
*'''singleBranchMode'''

Приватність

*'''EnableOpacSearchHistory''' — ''зберігати'' історію пошуків відвідувача в електронному каталозі.

=== Параметри групи „Відвідувачі“ ===

*'''AddPatronLists'''
*'''AutoEmailOpacUser'''
*'''AutoEmailPrimaryAddress'''
*'''autoMemberNum'''
*'''BorrowerMandatoryField''' — наступні стовпці бази даних мають бути заповнені при реєстрації відвідувача: ''surname|cardnumber'' (відокремлювати стовпці за допомогою знаку „|“)
*'''borrowerRelationship'''
*'''BorrowersTitles'''
*'''checkdigit'''
*'''EnhancedMessagingPreferences''' — ''заборонити'' відвідувачам вибирати, які вони отримують повідомлення і коли вони їх отримують. Зверніть увагу, що це стосується тільки певних видів повідомлень.
*'''ExtendedPatronAttributes'''
*'''intranetreadinghistory'''
*'''MaxFine'''
*'''memberofinstitution'''
*'''minPasswordLength''' — паролі входу в Koha для персоналу та відвідувачів повинні складатися з не менше ''3'' символів.
*'''NotifyBorrowerDeparture'''
*'''patronimages'''
*'''PatronsPerPage'''
*'''SMSSendDriver''' — використовувати драйвер „''SMS::Send::_______''“ для відсилання SMS-повідомлень.
*'''uppercasesurnames'''

=== Параметри групи „Пошуки“ ===

Можливості

*'''NoZebra'''
*'''NoZebraIndexes'''
*'''OpacGroupResults'''
*'''QueryAutoTruncate'''
*'''QueryFuzzy'''
*'''QueryRemoveStopwords'''
*'''QueryStemming'''
*'''QueryWeightFields'''
*'''TraceCompleteSubfields'''
*'''TraceSubjectSubdivisions'''

Відображення результатів

*'''defaultSortField'''
*'''defaultSortOrder'''
*'''displayFacetCount'''
*'''FacetLabelTruncationLength'''
*'''maxItemsInSearchResults'''
*'''maxRecordsForFacets'''
*'''numSearchResults'''
*'''OPACdefaultSortField'''
*'''OPACdefaultSortOrder'''
*'''OPACItemsResultsDisplay'''
*'''OPACnumSearchResults'''

Пошукова форма

*'''AdvancedSearchTypes'''
*'''expandedSearchOption'''

=== Параметри групи „Серіальні видання“ ===
*'''opacSerialDefaultTab'''
*'''OPACSerialIssueDisplayCount'''
*'''RenewSerialAddsSuggestion'''
*'''RoutingListAddReserves'''
*'''RoutingSerials'''
*'''StaffSerialIssueDisplayCount'''
*'''SubscriptionHistory'''

=== Параметри групи „Клієнт для бібліотекарів“ ===

Зовнішній вигляд

*'''Display856uAsImage'''
*'''intranet'''_includes
*'''intranetcolorstylesheet'''
*'''IntranetFavicon'''
*'''IntranetmainUserblock'''
*'''IntranetNav''' — використовувати зображення за адресою ________ на значок favicon для бібліотечного інтерфейсу (повинно бути повною URL-адресою, що починаються з http://).
*'''intranetstylesheet'''
*'''IntranetUserCSS'''
*'''intranetuserjs'''
*'''StaffAuthorisedValueImages'''
*'''staffClientBaseURL'''
*'''template'''
*'''XSLTDetailsDisplay'''
*'''XSLTResultsDisplay'''
*'''yuipath'''

Параметри

*'''HidePatronName'''
*'''intranetbookbag'''
*'''viewISBD'''
*'''viewLabeledMARC'''
*'''viewMARC'''

=== Параметри групи „Веб-сервіси“ ===

ILS-DI

*'''ILS-DI'''
*'''ILS-DI:AuthorizedIPs'''

OAI-PMH

*'''OAI-PMH'''
*'''OAI-PMH:archiveID'''
*'''OAI-PMH:ConfFile'''
*'''OAI-PMH:MaxCount'''

== Інструменти ==

[[Image:tools.png|1000px|center]]

'''Відвідувачі та обіг'''

*Коментарі
Регулювання коментарів відвідувачів.

*Імпорт відвідувачів
Імпортування даних про відвідувачів. Основний інструмент міграції відвідувачів.

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

*Вмикачі сповіщень/статусів прострочень
Встановлення вмикачів сповіщень/статусів для прострочених примірників.

*Створювач квитків відвідувачів
Створення придатних для друку квитків відвідувачів.

*Відвідувачі (анонімізациія, масове вилучення)
Вилучення старих позичальників та анонімізація історії обігу (очищення історії читання позичальника).

*Мітки
Регулювання читацьких міток.

*Завантаження зображень відвідувачів
Завантаження зображень відвідувачів пакетом або ж по одному за раз.

'''Додаткові інструменти'''

*Календар
Визначення днів коли бібліотека закрита. Можливі унікальні й повторювані (кожну тиждень або рік) свята, індивідуально для кожного підрозділу.

*Профілі форматування CSV
Управління профілями експорту в CSV.

*Засіб перегляду протоколів
Перегляд протоколів системи для операцій в кожному модулі.

*Новини
Написання новин для інтерфейсу бібліотекаря та для загальнодоступного електронного каталогу.

*Планувальник завдань
Планування завдань на виконання.

'''Каталог'''
*Пакетне вилучення примірників
Вилучення групи примірників.

*Пакетна зміна примірників
Зміна групи примірників.

*Експорт бібліографічних записів і одиниць зберігання
Експортування бібліографічної інформації і даних про одиниці зберігання.

*Наявні фонди/інвентаризація
Виконання інвентаризації (переобліку) Вашого каталогу.

*Створювач наклейок
Створення придатних для друку етикеток і штрих-кодів з даних каталогу. Цей інструмент поки погано працює з кириличними текстами на етикетках (проблема в сторонній pdf-бібліотеці), якщо ж використовувати тільки числові та „латинські“ дані, то проблема знімається.

*Швидкий створювач наклейки на корінець
Введіть штрих-код для створення відповідної для друку наклейки на корінець. Для використання зі спеціалізованими друкарками наклейок.

*Заготівля МАРК записів для імпорту
Заготовляємо МАРК-записи в сховище.

*Управління заготовленими МАРК-записами
Управління заготовленими МАРК-записами, зокрема проведення або скасування імпорту. Крім цього є ще більш надійний інструмент міграції для командного рядка (bulkmarcimport.pl).

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Налаштування Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Вилучення Koha, встановленої з джерела]]
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Короткий посібник користувача АБІС Koha]]

[[Категорія:АБІС Koha]]
[[Категорія:Бібліотека]]

Короткий посібник користувача АБІС Koha

2023-11-01T18:05:32Z

Dubyk:

<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br />
Ласкаво просимо!</b>

= Історія =

<div align="right">[[Image:koha_logo_with_text.png|70px|left]]'''''Na to raurau na taku raurau ka ora ai te iwi '''''</div>

<div align="right">'''''(завдяки нашим спільним вкладами наші племена процвітатимуть)<br />''' прислів’я маорі''</div>

На мальовничих островах Нової Зеландії проживають тубільці [http://en.wikipedia.org/wiki/Māori ма́орі]. Роблячи дарунки один одному, вони кажуть [http://en.wikipedia.org/wiki/Koha_(custom) koha], що значить на їх мові ''дарунок'', ''дар ''або ж ''внесок''. Це слово було вибране для автоматизованої бібліотечної інформаційної системи (АБІС), яку новозеландська компанія [http://www.katipo.co.nz/ Katipo Communications] почала створювати у 1999 р. для бібліотечного консорціуму Хороунеуа ([http://www.library.org.nz/ Horowhenua Library Trust]), що знаходиться на Північному острові Нової Зеландії. До того часу там використовувалася комерційна АБІС, яка працювала через модемне з'єднання, не була сумісною з 2000 роком та виходила з моди. Katipo Communications, невеличка компанія, намагаючись зробити своє рішення життєздатним для бібліотек, вирішила ([http://wiki.koha-community.org/wiki/History]), разом з бібліотечним консорціумом, випустити своє дитинча у світ під відкритою ліцензією ''[https://uk.wikipedia.org/wiki/GNU_General_Public_License GPL]''. Це також страхувало розробку та дало можливість бібліотекам міняти/вдосконалювати систему за своїми потребами, стаючи таким чином її співвласниками.

Відкритість та функціональність [https://uk.wikipedia.org/wiki/Koha АБІС Koha] добре узгоджується з моделлю бібліотечних сервісів бібліотек наступного покоління – [http://uk.wikipedia.org/wiki/Бібліотека_2.0 Бібліотека 2.0].

За декілька років навколо Koha утворилася ([http://koha-community.org/about/history/]) спільнота розробників ([http://koha-community.org koha-community.org]) від різноманітних бібліотек з усього світу ([http://www.librarytechnology.org/map.pl?ILS=Koha мапа поширення]). В першу чергу реалізовувалися найбільш необхідні для бібліотек функції. При цьому зберігалася масштабованість – АБІС Koha можна використовувати, завдяки спрощеним режимам, як у невеличких шкільних та приватних бібліотеках, так і, завдяки підтримці сучасних стандартів, у великих бібліотеках.

= Короткий огляд =
Працюючи з бібліотекою в режимі онлайн через АБІС Koha відвідувачі побачать насамперед електронний каталог бібліотеки. За допомогою дружнього веб-інтерфейсу читачі легко можуть здійснювати простий і розширений пошуки. Крім всеосяжного пошуку за ключовими словами, можна звузити пошук за автором, заголовком, тематикою тощо. Читачі можуть запропонувати бібліотеці придбати бажану для них книгу. Опція вибору мови інтерфейсу робить каталог зручним для іншомовних читачів. Цікава можливість збагачення бібліографічного опису інформації з сайтів Google, Amazon.com та інших. Інтерфейс ЕК легко інтегрується в бібліотечний сайт.

Базовою функцією бібліотеки є видача матеріалів читачам. Ця частина Koha використовується бібліотекарями частіше. Модуль обігу АБІС Koha виконує повсякденну роботу з відстеження руху книги, дати повернення, плати за затримку і т.д. Доступна детальна інформація про стан облікового запису читача і матеріалів, що видаються чи повертаються. Можливі продовження і резервування замовлення. Також тут виконуються переміщення книг між підрозділами бібліотеки.

Інструменти самообслуговування Koha дають читачам дружність і приватність, на яку вони заслуговують. За допомогою технології отримання інформації RSS читачі будуть завжди в курсі оновлень бібліотечних фондів. Читачі можуть продовжувати чи бронювати одиниці, бачити попередні замовлення та інформацію про заборгованість. Корисна можливість робити добірки літератури і ділитися ними, наприклад, зі студентами або друзями. Безперечно це все буде економити час бібліотечних працівників.

Однією з сильних сторін АБІС Koha є модуль каталогізації. Добре розвинений MARC-редактор підтримує стандарти [https://ru.wikipedia.org/wiki/MARC21 MARC 21], [https://uk.wikipedia.org/wiki/UNIMARC UNIMARC] та їх похідні (напр., [http://unimarc.org.ua/ УКРМАРК], [http://www.rusmarc.ru/ РУСМАРК]), [http://www.nlb.by/portal/page/portal/index/content?lang=ru&classId=148FA2C2FEB14084864BD443B6B0A6A6 BELMARC]. Зараз все більше бібліотек обмінюються своїми MARC-записами. У АБІС Koha можна отримувати MARC-записи за допомогою пошуку за серверам, які підтримують протокол Z39.50, або ж за допомогою імпорту колекції записів у форматі [https://uk.wikipedia.org/wiki/ISO_2709 ISO 2709]. Далі, здійснюючи швидку каталогізацію, записи зі сховища Koha доповнюються необхідними локальними даними про екземпляри тощо. АБІС Koha також підтримує ведення [https://en.wikipedia.org/wiki/Authority_control авторитетних списків] і тезаурусів.

Окремо можна виділити модуль періодичних видань. Він керує підпискою, підтримує різні схеми випусків видань.

У модулі звітів знайдете чотири потужних майстри звітів: про надходження, каталог, читачів та обіг. Для зручності можна встановити опцію створення повідомлень адміністратору електронною поштою. Звіт за пошуковими запитами читачів допоможе поліпшити бібліотечні послуги, аналізуючи пошукові фрази та знайдені результати.

Функціональний модуль нових надходжень робить замовлення одиниць простою справою. Основні можливості: керування статтями витрат, облік постачальників, освіти замовлень і контроль отримання. Для невеликих бібліотек передбачено спрощений режим надходжень.

Модуль відвідувачів дозволяє управляти як окремими читачами, так і організаціями та сім’ями. Окрім персональної інформації про відвідувача вказуються дані поточної видачі, історія обороту, повідомлення, пеня, резервування, протоколи правок, статистика, фотографія. У цьому ж модулі задаються права бібліотечних працівників. АБІС Koha може взаємодіяти з [https://uk.wikipedia.org/wiki/LDAP LDAP]-каталогом відвідувачів. Серед інших можливостей АБІС Koha є непоганий інструмент для створення штрих-кодів.

На даний час Koha повністю забезпечує основні функції [https://uk.wikipedia.org/wiki/%D0%90%D0%B2%D1%82%D0%BE%D0%BC%D0%B0%D1%82%D0%B8%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B0_%D0%B1%D1%96%D0%B1%D0%BB%D1%96%D0%BE%D1%82%D0%B5%D1%87%D0%BD%D0%B0_%D1%96%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D1%96%D0%B9%D0%BD%D0%B0_%D1%81%D0%B8%D1%81%D1%82%D0%B5%D0%BC%D0%B0 АБІС] локальної бібліотеки і може служити надалі як інструмент для досліджень і як можливий матеріал для навчання.

= Електронний каталог =
== Пошук ==
За умовчанням на головній сторінці в електронному каталозі Koha доступний максимально-широкий пошук за словом або комбінацією слів. Пошук ведеться за усіма доступними пошуковими індексами.
[[Image:basic_search.png|thumb|upright=4|center]]

Також можна дещо звузити пошук за заголовком, автором, тематикою, ISBN, серією чи шифром зберігання.

[[Image:basic_search_menu.png|upright=4|center]]

Якщо пошук видає занадто багато результатів, краще скористатися детальнішим пошуком. Тут можливості ширші.

[[Image:advanced_search_main.png|700px|center]]

Ви можете шукати за комбінацією декількох ключових слів та наступних значень:

* '''тематика, тематика як фраза, тематика та більш широкі терміни, тематика і більш вузькі терміни, тематика і пов’язані терміни;'''
* '''заголовок, заголовок як фраза, серійний заголовок;'''
* '''автор, автор як фраза, найменування організації, назва конференції, назва конференції як фраза, ім’я особи, ім’я особи як фраза;'''
* '''нотатки/коментарі;'''
* '''видавець;'''
* '''місце розташування видавця;'''
* '''стандартний номер, ISBN, ISSN, шифр зберігання.'''

Також можна обмежити пошук деякими типами одиниць зберігання:

[[Image:item_types.png|900px|center]]

Доступні 4 варіанти пошуку за датою публікації:

* '''2000-2011''' — пошук діапазону дат
* '''-1990''' — пошук опублікованого до 1990
* '''2000-''' — пошук опублікованого після 2000
* '''1995''' — пошук лише за цей рік

Пошук за мовою:

[[Image:opac_search_languages.png|200px|center]]

При виборі „більше параметрів“ у розширеному пошуку з’являться додаткові пошукові поля

[[Image:advanced_search_full.png|700px|center]]

Пошук за підтипом „аудиторія“

[[Image:opac_search_audience.png|center]]

Пошук за підтипом „фізична форма документа“

[[Image:opac_search_physical_form.png|center]]

Пошук за підтипом „літературний жанр“

[[Image:opac_search_literature_genre.png|center]]

Пошук за підтипом „біографія“

[[Image:opac_search_biography.png|center]]

Пошук за підтипом „ілюстрація“

[[Image:opac_search_illustration.png|center]]

Пошук за підтипом „зміст“

[[Image:opac_search_content.png|center]]

Пошук за підтипом „типи відео-матеріалів“

[[Image:opac_search_video_material_types.png|center]]

Пошук за підтипом „тип серіального видання“

[[Image:opac_search_serial_types.png|center]]

Пошук за підтипом „періодичність“

[[Image:opac_search_periodical.png|center]]

Пошук за підтипом „регулярність“

[[Image:opac_search_regularity.png|center]]

Пошук за 2 підтипами „двовимірний зображувальний об’єкт“

[[Image:opac_search_2d_visible_object_1.png|center]]
[[Image:opac_search_2d_visible_object_2.png|center]]

Також є можливість вибрати бібліотеку для пошуку, вибрати сортування результатів пошуку або обмежити пошук лише екземплярами, доступними для видачі.

[[Image:opac_search_sort.png|center]]

Для правильної роботи пошуку повинні бути заповнені в кожному записі відповідні поля.

== Результати пошуку ==
Розібравшись з початковими параметрами пошуку переходимо до результатів. Типовий екран результатів виглядає наступним чином

[[Image:opac_search_result.png|center]]

На екрані результатів пошуку ми бачимо:
*кількість знайдених записів;
*можливість сортування за датою, автором чи назвою;
*інформацію про доступність примірників запису (скільки, у якій бібліотеці, стан);
*можливість підписатися на RSS-новини (нові надходження) для цього пошуку;
*можливі дії із записом: резервування, додавання у список чи добірку;
*обкладинки одиниць (якщо ця можливість задіяна);
*шукані слова підсвічені.
Далі Ви можете перейти до розгляду конкретного запису.

== Бібліографічний запис ==
На цьому екрані подана уся доступна інформація як про бібліографічний запис так й про долучені примірники.

[[Image:opac_biblio_normal.png|center]]

Є декілька представлень запису: звичайне, ISBD-варіант на кшталт каталожної карточки та МАРК-представлення у табличному варіанті з полями Unimarc.

Зручно переходити від цього запису до пошуку робіт того ж автора чи до пошуку книг тієї ж тематики.

Запис можна роздрукувати, зберегти у списку (особистому або загальнодоступному), зберегти у добірці чи файлі. Також є можливість пошукати цю назву у інших бібліотеках, онлайн-магазинах чи Google Академії.

Користувач може додати коментар і мітку „класифікації користувача“, яка буде збережена у запису а також відображена на „хмарі міток“. Коментар і мітки можуть модеруватися бібліотекарем.

Якщо в записі присутній індекс поличної класифікації, з’явиться можливість перегляду полички та сусідніх примірників.

Якщо у Koha налаштована можливість отримання розширеного вмісту, також буде відображатися обкладинка книги та інші дані від сервісів Amazon.com, Google, FRBR, Babelthèque, Baker and Taylor, Library Thing, OCLC, Syndetics та ін.

Також на цьому екрані представлена детальна інформація про усі примірники біб-запису.

== Списки та добірки ==
Списки — зручний інструмент для складання різних переліків. Наприклад, викладач може створювати список книг зі свого предмета. Бібліотекарі можуть вести тематичні переліки.

Є три види списків:
*особисті — веде відвідувач і доступний лише йому
*загальні — веде лише відвідувач але переглядати можуть усі
*відкриті — редагують та переглядають усі

== Покращений вміст ==
Як згадувалося вище в Koha є можливість отримання та відображення додаткового змісту окрім того що міститься у самому записі. Це обкладинки книг, огляди рецензії, інші видання тієї ж книги і т.п.

Деякі зауваження:
*для запису повинно бути заповнене поле ISBN чи ISSN;
*деякі сервіси вимагають обов’язкової реєстрації та/чи віддають обмежену кількість інформації на день;
*більшість сервісів англомовні, відповідно російськомовних книг там мінімум чи немає взагалі;
*стандартна можливість підключати свої обкладинки з’явилася з версії 3.8.

Детальне налаштування сервісів можна зробити у модулі „Управління » Параметри системи » Розширений вміст“.

== Мій обліковий запис ==
[[Image:opac_login.png|170px|right]] Для зареєстрованих читачів бібліотеки є можливість увійти у свій обліковий запис АБІС Koha. Про деякі можливості зареєстрованого читача вже згадувалося вище.

Розглянемо основний екран облікового запису.

[[Image:opac_profile_summary.png|700px|center]]

На вкладці „моє зведення“ читач бачить список книг, які у нього зараз на руках. Відображається дата, до якої необхідно повернути книгу. Якщо дата повернення прострочена, відповідна позиція буде позначена червоним.

Детальніше про правила видачі та повернення можна подивитися й налаштувати у модулі „Управління » Правила обігу та штрафи“.

На вкладці „мої персональні дані“ читач може подивитися які дані про себе він залишив у бібліотеці при реєстрації.

[[Image:opac_profile_personal_data.png|700px|center]]

Іноді бібліотека може запросити оновити ці дані. Якщо включена системна змінна „OPACPatronDetails“ відвідувачі також зможуть редагувати / оновлювати свої персональні дані.

На вкладці мої мітки наведені усі користувацькі мітки, які читач присвоював біб-записам при роботі з електронним каталогом. Якісь невірні мітки він може вилучити.

Також читач може змінити свій пароль. Наприклад якщо початкові паролі присвоюються бібліотекарем.

[[Image:opac_profile_change_password.png|center]]

У вкладці „моя історія читання“ можна переглянути всю історію видач й повернень.

Також доступна вкладка з історією пошуків у електронному каталозі.

[[Image:opac_profile_search_history.png|center]]

У вкладці „Мої списки“ доступна розширена функціональність для управління особистими і загальними списками. Читач може переглядати список, редагувати його назву а також вилучати. Є можливість зберегти список (у форматах ISO2709, RIS, BibTeX), роздрукувати чи вислати електронною поштою.

== Пропозиції на придбання ==

При пошуку а також в обліковому записі відвідувача можна помітити можливість запропонувати бібліотеці нове придбання. Можливо читач вважатиме що ця нова книга обов'язково повинна бути у бібліотеці. Або ж викладач подає бібліотеці заявку на книгу, потрібну для його навчального курсу.

[[Image:opac_profile_my_suggestion.png|center]]

Заявка на книгу надходить в модуль Надходження »Управління придбаннями. Далі бібліотекар може зробити деякі дії щодо цієї книги, про які відвідувач оповіщається через цю ж вкладку „Пропозиції на придбання“.

[[Image:opac_profile_my_suggestions.png|center]]

На закінчення необхідно відзначити що зовнішній вигляд та спектр можливостей значно відрізняються в залежності від вибору системних змінних з групи „Електронний каталог“.

= Огляд інтерфейсу бібліотекаря АБІС Koha =

== Вступ ==

Приступимо до короткого огляду інтерфейсу бібліотекаря АБІС Koha. Перш за все необхідно увійти в систему.

[[Image:intranet_login.png|center]]

При наявності прав супербібліотекаря ми побачимо наступний початковий екран для усіх можливостей АБІС Koha.

[[Image:intranet_main.png|1000px|center]]

Для працівників бібліотеки з меншими привілеями деякі з можливостей можуть бути не доступні (не відображені).

Нижні й верхні колонтитули доступні для бібліотекаря на усіх екранах й модулях. Знизу ми бачимо вибір мов а зверху — меню модулів, відображено зареєстрованого бібліотекаря, вибір поточної бібліотеки/підрозділу та контекстна довідка „[?]“.

Початковий екран побудований таким чином щоб дати доступ до найбільш часто використовуваних функцій і завдань.

== Новини ==
Зліва на початковому екрані відображаються новини для бібліотекарів. Такою новиною може бути, наприклад, добірка корисної для роботи інформації.

[[Image:intranet_news.png|center]]

== Пошук, добірка, списки ==
Ці функції вже були детально розглянуті раніше. У бібліотечному інтерфейсі вони працюють практично так само як і в електронному каталозі.

== Каталогізація ==
Один з найбільш важливих модулів, який дозволяє працювати з бібліографічними записами, створювати, редагувати і отримувати їх по протоколу Z39-50. Більш детально каталогізація буде розглянута в розділі „Каталогізація бібліографічних записів та примірників“.

== Відвідувачі ==
З початкового екрана також доступний пошук відвідувачів.

[[Image:intranet_patrons_search.png|center]]

Зверніть увагу вище на невеликий значок „[+]“ біля пошукового поля. При натиску на нього з’являється можливість обмеження пошуку бібліотекою чи категорією відвідувача.

[[Image:intranet_patrons_search_options.png|center]]

Детальніше про ведення користувачів в АБІС Koha буде розглянуто у розділі „Ведення відвідувачів“.

== Обіг ==
Функціональність модуля обігу включає книговидачу (видача й повернення примірників), переміщення між підрозділами (наприклад, фондосховище «» читацький зал), підтримку можливості віддаленого резервування книг читачами, стеження за простроченнями й підрахунки пені.

[[Image:intranet_circ_main.png|center]]

Функції книговидачі можна задіяти після успішного внесення як БД читачів так й БД бібліографічних записів з примірниками для підрозділу з книговидачею. Унікальним ідентифікаторам книги виступає штрихкод, а читача — № читацького квитка (також може бути закодований штрихкодом).

== Звіти ==
У Koha досить потужний модуль звітів і статистики. Серед стандартних можливостей:
*Майстри статистики
**Надходження
**Відвідувачі
**Каталог
**Обіг
**Серіальні видання
*Верхні місця
**Відвідувачі з найбільшою кількістю видач
**Найбільш видавані одиниці
*Не задіяне
**Відвідувачі, яким ще нічого не видавалося
**Примірники, що не видавалися
*Інше
**Втрачені екземпляри
**Каталог за типами одиниць
**Середній час позички

[[Image:intranet_report_main.png|center]]

Широкі можливості дає інструмент керованих звітів. Це конструктор будь-яких звітів, які можуть знадобитися бібліотекарям. На вікі-сайті АБІС Koha доступна сторіночка (http://wiki.koha-community.org/wiki/SQL_Reports_Library), де користувачі Koha наводять свої приклади звітів (їх там вже кілька сотень). Кілька цікавих з цієї бібліотеки звітів вибрані і для цього встановлення:

*Звіт за дублетними записами (за назвою)
*Підрахунок усіх примірників (за штрихкодом)
*Підрахунок усіх записів
*Кількість усіх примірників за типами одиниць
*Перелік усіх записів без примірників
*Список пошкоджених екземплярів
*Кількості примірників за шифром зберігання
*Список вилучених примірників
*Список примірників за шифром зберігання
*Список дублетних записів

== Надходження ==
Тут представлена функціональність щодо комплектування бібліотеки новими надходженнями.

[[Image:intranet_acquision_main.png|center]]

Можна заводити постачальників та відслідковувати замовлення на книги. При цьому відслідковуються витрачені кошти з бюджету.

У цей модуль також входить управління пропозиціями від читачів.

[[Image:intranet_acquision_suggestion.png|center]]

== Авторитетні джерела ==

Цей модуль дозволяє вносити авторитетні записі наступних типів:
*'''Хронологічне поняття''' (хронологічне поняття як предметна пошукова ознака).
*'''Найменування колективу чи юрисдикції''' (найменування колективу / постійної організації як предметна пошукова ознака).
*'''Термін жанру/форми''' (термін жанру, форми та/чи фізичних характеристик описуваних матеріалів).
*'''Географічна назва''' (географічна рубрика).
*'''Найменування заходу''' (найменування заходу / тимчасового колективу).
*'''Ім’я особи''' (ім’я особи як пошукова ознака).
*'''Тематичний термін''' (тематична рубрика).
*'''Уніфікований заголовок''' (уніфікована, умовна, узагальнююча назва як предметна пошукова ознака).

[[Image:intranet_authorities_main.png|center]]

Створення та редагування записів схоже на роботу з бібліографічними записами і відповідає формату Unimarc для авторитетних записів. Якщо включена системна змінна „OpacAuthorities“, в електронному каталозі відвідувачі також зможуть шукати за авторитетними джерелами.

== Серіальні видання ==
Цей модуль дозволяє організувати передплату та планування надходжень на серіальні видання найрізноманітнішої періодичності, схемою нумерації примірників і т.п.

[[Image:intranet_serial_main.png|center]]

== Інструменти ==

У модуль „Інструменти“ винесені бібліотечні операції які виконуються не настільки часто як каталогізація чи книговидача.

[[Image:intranet_tools_main.png|center]]

Доступні інструменти об’єднані в групи:

'''Відвідувачі та обіг'''
*Коментарі
*Імпорт відвідувачів
*Оповіщення
*Вмикачі оповіщень / статусів прострочень
*Створювач квитків відвідувачів
*Відвідувачі (анонімізації, масове вилучення)
*Мітки
*Завантаження зображень відвідувачів

'''Додаткові інструменти'''
*Календар
*Профілі форматування CSV
*Засіб перегляду протоколів
*Новини
*Планувальник задач

'''Каталог'''
*Пакетне вилучення екземплярів
*Пакетне зміна примірників
*Експорт бібліографічних записів і одиниць зберігання
*Наявні фонди / інвентаризація
*Створювач наклейок
*Швидкий створювач наклейки на корінець
*Заготівля МАРК-записів для імпорту
*Управління заготовленими МАРК-записами

== Управління ==

У цей модуль входять можливості як початкового налаштування системи так і подальшої кастомізації під потреби бібліотеки або ж для задіяння додаткових можливостей.

[[Image:intranet_admin_main.png|center]]

У „Загальні параметри системи“ входить великий набір системних змінних для визначення яких-небудь або значень або включення/виключення можливостей.

Можливості управління системою поділені на такі групи:

'''Основні параметри'''
*Бібліотеки, підрозділи та групи
*Типи одиниць
*Авторитетні значення

'''Відвідувачі та обіг'''
*Категорії відвідувачів
*Міста і селища
*Типи доріг
*Види атрибутів відвідувачів
*Правила обігу та штрафи
*Обмеження бібліотечних переміщень
*Попередження при обігу екземплярів

'''Каталог'''
*Бібліографічна МАРК-структура
*Відображення БД Koha у МАРК
*Відображення ключових слів у МАРК
*Перевірка бібліографічної МАРК-структури
*Типи авторитетних джерел
*Джерела класифікації
*Правила відповідності записів

'''Параметри надходжень'''
*Грошові одиниці та обмінні курси
*Кошториси
*Кошти

'''Додаткові параметри'''
*Несуттєві слова
*Цільові сервера для клієнта Z39.50

== Про АБІС Koha ==
У цьому розділі можна побачити технічну інформацію про версію Koha, операційної системи та супутніх програм, список встановлених Perl-модулів з інформацією про їх актуальності. Також приведений довгий перелік людей та організацій, які брали участь у розробці АБІС Koha. Окремим списком вказані доступні локалізації Koha а також імена перекладачів. На вкладці Ліцензії вказана ліцензія на джерельний код АБІС Koha („GNU General Public License“) а також ліцензії на деякі допоміжні матеріали.

[[Image:intranet_about_authors.png|600px|center]]

= Каталогізація бібліографічних записів та примірників =

Для внесення нового бібліографічного запису є 3 можливості:

1. Створення нового запису з використанням одного з шаблонів.

2: Пошук і імпорт запису з джерел Z39-50.

3. Імпорт запису з файлу (через модуль інструментів).

Розглянемо перші два способи.

== Пошук через Z39-50 ==

Багато великих бібліотек мають сервіс доступу до бібліографічних записів за протоколом Z39-50. Кілька таких сервісів вказані у налаштуваннях. У модулі каталогізації натисніть на кнопку „Пошук через Z39-50“. Далі заповніть деякі поля (автор, заголовок, ISBN тощо).

[[Image:intranet_z3950_search_options.png|center]]

Також можете поміняти вибір серверів Z39-50 для економії часу пошуку. Натиснувши на кнопку „Пошук“ через деякий час побачите результати.

[[Image:intranet_z3950_search_result.png|center]]

Уважно подивіться на результати пошуку, виберіть найбільш підходящий (скористайтеся MARC та ISBD передпереглядом) і з більш повним описом та натисніть „Імпорт“ для імпорту бібліографічною запису у АБІС Koha. Далі Ви побачите цей запис в стандартному редакторі Koha та зможете доповнити його локальними даними (каталогізаційних індекс, шифр зберігання, екземпляри і т.п).

== Створення бібліографічного запису за шаблоном у стандартному редакторі Koha ==

Для нових бібліографічних записів доступні наступні шаблони чи Marc-структури:

*Структура за умовчанням
*Аудіоматеріали на касетах, CD
*Відеоматеріали (DVD, VHS)
*Книги (монографічні видання)
*Комплекти, набори змішаних матеріалів
*Моделі
*Переплетення (видавниче, розповсюджувальне, власницький конволют)
*Продовжуючі (серіальні) видання
*Структура швидкого додавання
*Електронні ресурси (диски, веб, файли, …)

Для введення/редагування записів використовується єдиний стандартний редактор Koha, а відмінності для Marc-структур проявляються у наборі полів / підполів та їх угрупованнях за вкладками, даних за умовчанням і т.д.

„Структура за умовчанням» містить найбільш повний набір Marc-даних та інші (або нові) Marc-структури засновані на ній.

Розглянемо внесення запису на прикладі структури „Структура за умовчанням“.

[[Image:intranet_cataloguing_main.png|center]]

Поля для введення даних у MARC-редакторі згруповані за вкладками. Максимум може бути до 9 вкладок для бібліографічних даних. 10 вкладка захована і вважається вкладкою примірників. Використовується схема — у кожній вкладці зібрані поля / підполя з відповідного Marc-блоку (хоча це й не обов'язково — Marc-структуру можна перегрупувати). Поля можуть мати кілька станів — розгорнуте (видно усі подполя), згорнуте (розгортається при натисканні мишкою) і сховане (не відображається але може містити дані, наприклад, системні). Деякі поля та подполя можуть повторюватися (тоді біля них з’являється знак „+“ та значок дублювання відповідно). Знак „?“ Відсилає до документації Unimarc на сайті IFLA.

[[Image:intranet_cataloguing_add_biblio.png|center]]

Червоний знак „*“ біля підполя говорить про його обов’язковість. Деякі поля не доступні для введення — вони повинні бути обрані з авторитетних списків або з авторитетних джерел.

[[Image:intranet_cataloguing_add_biblio_obligatory_and_lists.png|center]]

У другому випадку поле також захищене від зміни (знак замку).

[[Image:intranet_cataloguing_add_biblio_blocked.png|center]]

Якщо біля поля присутні три крапки — це поле може бути заповнене за допомогою додатку (наприклад кодоване підполе 100).

[[Image:intranet_cataloguing_add_biblio_plugin.png|center]]

Якщо всі необхідні дані введені — натискаємо кнопку „Зберегти“. Система збереже бібліографічний запис і запропонує ввести екземпляри.

[[Image:intranet_cataloguing_add_item.png|center]]

У даному випадку поля з трикрапкою можуть заповняться автоматично — потрібно лише натиснути на трикрапку мишкою. Для примірників, як правило, потрібно заповнити наступні поля:
*вихідне місце зберігання;
*штрихкод;
*інвентарний номер;
*екземплярний шифр зберігання.

Таким способом можна внести один чи кілька примірників.

Після внесення усі даних бібліографічний запис та приєднані примірники будуть доступні у каталозі.

[[Image:intranet_biblio_detail.png|center]]

У інтерфейсі бібліотекаря для бібліографічного запису доступна розширена оболонка дій та інформації: запис можна редагувати/вилучати/дублювати/зберігати/друкувати/резервувати а також переглядати у різних форматах (MARC, ISBD), дивитися журнал змін та історію видач примірників.

= Ведення відвідувачів =

У модулі „Відвідувачі“ доступно введення трьох типів відвідувачів:
*індивідуальні дорослі відвідувачі;
*колективні відвідувачі-організації;
*діти.

Відвідувачів у Koha, як правило, ділять на більш детальні категорії, в основному, з огляду на різницю в правилах книговидачі.

== Реєстрація відвідувача ==

Розглянемо реєстрацію в системі індивідуального дорослого відвідувача.

[[Image:intranet_member_new.png|center]]

Обов’язкові поля у даному випадку — прізвище та № читацького квитка (інші обов’язкові поля можна визначити у системних параметрах). У поле „Ім’я“ краще вводити ім’я та по батькові. Також вводимо необхідну кількість особистих та контактних даних. Електронна пошта може використовуватися для розсилки повідомлень (наприклад про прострочення).
Для можливості більш персональної роботи з електронним каталогом потрібно також ввести логін (ім’я для входу в ЕК) та пароль.
Крім стандартних даних доступне введення додаткових ідентифікаторів та атрибутів.
Після внесення всіх необхідних даних натискаємо „Зберегти“.

[[Image:intranet_member_profile.png|center]]

В результаті побачимо основну сторінку відвідувача в АБІС Koha.

== Привілеї для бібліотекаря ==
Для можливості входу у бібліотечний інтерфейс для бібліотекарів потрібно присвоїти привілеї.

[[Image:intranet_member_previlegy_menu.png|center]]

Доступні наступні привілеї:
*'''superlibrarian''' — доступ до всіх бібліотечних функцій
*'''circulate''' — обіг книг
**'''circulate_remaining_permissions''' — обіг без обходу привілеїв
**'''override_renewals''' — обхід блокування продовжень
*'''catalogue''' — перегляд каталогу (інтерфейс бібліотекаря)
*'''parameters''' — встановлення системних налаштувань Koha
*'''borrowers''' — внесення та зміна відвідувачів
*'''permissions''' — встановлення привілеїв користувача
*'''reserveforothers''' — резервування книжок для відвідувачів
**'''modify_holds_priority''' — зміна пріоритету резервувань
**'''place_holds''' — розміщення резервувань для відвідувачів
*'''borrow''' — позика книг
*'''editcatalogue''' — зміна каталогу (зміна бібліографічних/локальних даних)
**'''edit_catalogue''' — редагування каталогу (зміна бібліографічних та локальних/екземплярних даних)
**'''edit_items''' — редагування примірників
**'''fast_cataloging''' — швидка каталогізація
*'''updatecharges''' — оновлення сплат користувачів
*'''acquisition''' — управління надходженнями та / чи пропозиціями
**'''budget_add_del''' — Add and delete budgets (but cant modify budgets)
**'''budget_manage''' — управління кошторисами
**'''budget_modify''' — зміна кошторису (не можна створювати рядки, але можна змінювати існуючі)
**'''contracts_manage''' — управління договорами
**'''group_manage''' — Manage orders & basketgroups
**'''order_manage''' — Manage orders & basket
**'''order_receive''' — Manage orders & basket
**'''period_manage''' — Manage periods
**'''planning_manage''' — управління розплануванням кошторису
**'''vendors_manage''' — управління постачальниками
*'''management''' — встановлення параметрів управління бібліотекою
*'''tools''' — використання інструментів (експорт, імпорт, штрих-коди)
**'''batch_upload_patron_images''' — завантаження зображень відвідувачів партіями або усіх відразу
**'''delete_anonymize_patrons''' — вилучення користувачів з протермінованним періодом реєстрації та анонімізації історії обігу (вилучення історія читання користувачів)
**'''edit_calendar''' — визначення днів, коли бібліотека закрита
**'''edit_news''' — написання новин для електронного каталогу та інтерфейсу бібліотекарів
**'''edit_notice_status_triggers''' — встановлення тригерів повідомлень / статусів для прострочених примірників
**'''edit_notices''' — визначення повідомлень
**'''export_catalog''' — експортування бібліографічної інформації і даних про одиниці зберігання
**'''import_patrons''' — імпорт даних про відвідувачів
**'''inventory''' — проведення інвентаризації (аналізу) Вашого каталогу
**'''items_batchdel''' — виконання пакетного вилучення екземплярів
**'''items_batchmod''' — виконання пакетної зміни примірників
**'''label_creator''' — створення друкованих наклейок та штрих-кодів з каталогу і з даними про користувачів
**'''manage_csv_profiles''' — управління профілями експорту в CSV
**'''manage_staged_marc''' — управління заготовленими МАРК-записами, у тому числі доповнення та зворотний імпорт
**'''moderate_comments''' — регулювання коментарів від відвідувачів
**'''moderate_tags''' — регулювання читацьких міток
**'''rotating_collections''' — управління по черзі переміщуваними зборами
**'''schedule_tasks''' — планування завдань до виконання
**'''stage_marc_import''' — заготівля МАРК-записів у сховище
**'''view_system_logs''' — перегляд протоколів системи
*'''editauthorities''' — дозвіл на зміну авторитетних джерел
*'''serials''' — дозвіл на управління підпискою періодичних видань
**'''check_expiration''' — перевірка закінчення підписки серіального видання
**'''claim_serials''' — претензії на відсутнє серіальне видання
**'''create_subscription''' — створення нової підписки
**'''delete_subscription''' — вилучення існуючої підписки
**'''edit_subscription''' — редагування існуючої підписки
**'''receive_serials''' — отримання серіальних видань
**'''renew_subscription''' — оновлення підписки
**'''routing''' — маршрутизація
*'''reports''' — дозвіл на доступ до модуля звітів
**'''create_reports''' — створення звітів SQL
**'''execute_reports''' — виконання звітів SQL
*'''staffaccess''' — зміна імені (логіну) / привілеїв для працівників бібліотеки

== Сторінка відвідувача ==

Крім редагування запису про відвідувача можна ще додати фотографію, роздрукувати листок чи картку, вилучити чи продовжити відвідувача.

На сторінці відвідувача також доступна інформація про книговидачу.

[[Image:intranet_member_issues.png|center]]

Можна побачити скільки в даний момент книг на руках у відвідувача, продовжити або повернути їх а також видати нові. Для кожної книги є дата видачі та можлива дата повернення.

Інформація про всі попередні видачі доступна на вкладці „Історія обігу“.

[[Image:intranet_member_history_of_reading.png|center]]

= Висновок =

Koha — доволі молода АБІС. Спільнота розробників активно готує до випуску нові версії системи, що міститимуть вдосконалення згідно з потребами сьогодення. Бібліотеки доклали багато зусиль, часу і грошей, щоб зробити свої ресурси доступними. Чому б не об’єднати такі ж зусилля, щоб створити програмне забезпечення, яке задовольнить наші професійні потреби?

Вислови керівників бібліотек, де впроваджено АБІС Koha:

„'''Використання відкритого ПЗ відповідає філософії вільного доступу громадськості до інформації'''“ — вважає директор Нельсонвільской публічної бібліотеки (Nelsonville Public Library) Лаурен Міллер (Lauren Miller).

„'''Ми віримо, що в Koha є всі умови і функціональність для того,
щоб стати Apache (найпопулярніший веб-сервер) в світі науки
інформаційних систем бібліотек'''“ — так бачить майбутнє Koha директор
Кіпрського університету близького сходу (Near East University) Тюмер
Ґарп (Tümer B. Garp).

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Налаштування Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Вилучення Koha, встановленої з джерела]]
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Коротка інструкція для адміністратора АБІС Koha]]

[[Категорія:АБІС Koha]]
[[Категорія:Бібліотека]]

Налаштування Koha, встановленої з джерела

2023-11-01T18:05:24Z

Dubyk:

<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br />
Ласкаво просимо!</b>

== Koha SiteMaps ==

Існуємодуль „Koha::Contrib::Tamil“ (https://metacpan.org/module/koha-sitemap) для створення файлів sitemaps.

sudo apt-get install libkoha-contrib-tamil-perl

Створити у теці /usr/share/koha3/opac/htdocs файл robots.txt з вмістом

Sitemap: http://koha.tntu.edu.ua/sitemapindex.xml
User-agent: *
Disallow: /cgi-bin/

Створити скрипт /home/АдміністраторСистемиKoha/koha/sitemaps/prepare_sitemaps.sh з правами виконання та вмістом

cd /usr/share/koha3/opac/htdocs
koha-sitemap --url=http://koha.tntu.edu.ua

Запустити й перевірити появу файлів у теці /usr/share/koha3/opac/htdocs

Додати в crontab (користувача АдміністраторСистемиKoha) запис

# Prepare Koha-sitemaps
0 6 * * * /home/АдміністраторСистемиKoha/koha/sitemaps/prepare_sitemaps.sh

== topissues ==

/cgi-bin/koha/opac-topissues.pl:

my $timeLimit = $input->param('timeLimit') || 12;

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Вилучення Koha, встановленої з джерела]]
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Категорія:АБІС Koha]]
[[Категорія:Бібліотека]]

Встановлення Koha з репозитарію на ОС Debian

2023-11-01T18:05:17Z

Dubyk:

<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br />
Ласкаво просимо!</b>

Розглядається встановлення АБІС Koha версії 16.05.05 '''з репозитарію''' [http://debian.koha-community.org/ debian.koha-community.org].

Див. також
* [https://wiki.koha-community.org/wiki/Koha_on_Debian Koha_on_Debian] на Koha Wiki
* [http://git.koha-community.org/gitweb/?p=koha.git;a=blob;f=INSTALL.debian;hb=HEAD INSTALL.debian] на Git
* [https://wiki.koha-community.org/wiki/Category:Installation Category:Installation] на Koha Wiki

'''Цей варіант встановлення ще тестується, наразі більш апробованим та універсальним залишається [[Встановлення Koha з джерела на ОС Debian|встановлення з джерельних кодів]].'''

= Встановлення ОС Debian GNU/Linux 9 Stratch =

Детальніше: [[Встановлення ОС Debian Linux]].

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8,ru_RU.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"





== Підключення репозитарію Koha ==

В репозитарії [http://debian.koha-community.org/ debian.koha-community.org] доступні стабільна та розробницька версії.

Підключаємо у файлі '''/etc/apt/sources.list''' стабільну версію (рекомендується)
deb http://debian.koha-community.org/koha stable main
(доступні й інші версії, див. тут http://debian.koha-community.org/koha/dists/)

Швидко підключити репозитарій Koha можна командою
echo 'deb http://debian.koha-community.org/koha stable main' | sudo tee /etc/apt/sources.list.d/koha.list

Також додаємо ключ gpg.asc до довірених ключів APT:
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Оновлюємо список доступних для встановлення пакунків
apt-get update

= Встановлення Koha =

== Встановлення пакунка „koha-common“ ==
Доступні два пакунки, що встановлюють АБІС Koha, це

„'''koha-common'''“ — містить увесь код та допоміжні сценарії. Цей пакунок після встановлення не надає налаштованого та працюючого екземпляру Koha, однак доступна команда „'''koha-create'''“ та інші корисні інструменти, що дозволять Вам створити скільки завгодно налаштованих та працюючих екземплярів (включаючи завдання cron та індексацію Zebra).

та

„'''koha'''“ — подібний пакунок, однак надає один екземпляр Koha. Однак цей варіант ще не керується сценаріями а також необхідно вручну додавати завдання cron та індексування Zebra (див. [http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=5071 bug 5071].

Отож рекомендовано встановлювати пакунок „'''koha-common'''“

apt-get install koha-common

При цьому може з’явитися вивід повідомлень Debconf, напр.

If you are upgrading from a Koha 3.2 to 3.4 release, you must run:
sudo /usr/sbin/koha-upgrade-to-3.4
For large catalogues, running this may take a while. Your Koha installation should be largely operational during the process, but some things,
particularly to do with items, may appear strange until the upgrade and re-index is complete.

Читаємо та слідуємо вказівкам.

Також читаємо стандартну інструкцію про подальше налаштування

less /usr/share/doc/koha-common/README.Debian

Може бути помилка з конфігурацією пакунка libapache2-mpm-itk, див. рішення тут https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=734865

== Встановлення БД MySQL та допоміжних пакунків ==

sudo apt-get install \
mysql-server \
phpmyadmin

* при встановленні сервера MySQL вказуємо пароль адміністратора (користувач „root“), надалі „ПарольАдмінаMySQL“
* для „phpmyadmin“ вибрати лише „apache2“
* при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку

У файлі /etc/phpmyadmin/phpmyadmin.service змінити порт
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

/etc/init.d/apache2 restart

== Налаштування MySQL ==

1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL
Якщо пароль не вибрано при встановленні MySQL чи необхідно вказати новий, то діємо наступним чином
sudo dpkg-reconfigure mysql-server-5.5
2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне
[mysqld]
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'
character-set-server=utf8
collation-server=utf8_unicode_ci
character_set_client=utf8
skip-character-set-client-handshake
3) Перезапускаємо сервер MySQL
sudo /etc/init.d/mysql restart
4) Переконуємося, що зміни внесені, виконавши
sudo mysql -uroot -pПарольАдмінаMySQL
show variables;
quit

== Налаштування Apache та сценарій „koha-post-install-setup“ ==

1) Виконуємо сценарій
sudo koha-post-install-setup
(він задіює модулі Rewrite та Suexec для Apache)

2) Додатково задіюємо модулі Expires, Deflate, Cgi, Mpm_Itk та виключаємо[https://wiki.koha-community.org/wiki/Koha_on_Debian#Aside:_a_common_problem_on_Ubuntu_happens_here] модуль Event
sudo a2enmod expires
sudo a2enmod deflate
sudo a2enmod cgi
sudo a2enmod mpm_itk
sudo a2dismod mpm_event

3) Редагуємо /etc/apache2/conf-available/charset.conf
AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

та задіюємо його

sudo a2enconf charset

4) Перезапуск Apache
sudo /etc/init.d/apache2 restart

== Створення екземпляра АБІС Koha ==

=== Варіанти налаштування АБІС Koha з доменами та портами ===

==== Варіант з портами 8080 та 8888 (тестовий) ====
Цей варіант зручно використовувати на початковому етапі, коли домен (порт 80) зайнято під інший сайт/сервіс.

===== koha-ukr-unimarc-site.conf =====

Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="8080" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8888" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.

===== ports.conf =====
Додаємо

Listen 8080
Listen 8888

у файл /etc/apache2/ports.conf

Також перезапускаємо Apache

/etc/init.d/apache2 restart

==== Варіант з портами 80 та 8080 ====
Цей варіант зручно використовувати, коли під АБІС Koha відведено окремий домен/сервер.

===== koha-ukr-unimarc-site.conf =====
/змінюється/
Створюємо файл
sudo mc -e /etc/koha/koha-ukr-unimarc-site.conf
наступного змісту

DOMAIN="localhost" # Change this to be your domain. Any instance will be a subdomain of this string.
OPACPORT="80" # TCP listening port for the users' interface (if you skip this, the apache default of 80 will be used)
OPACPREFIX="" # For users' interface URL: Prefix to be added to the instance name.
OPACSUFFIX="" # For users' interface URL: Suffix to be added to the instance name.
INTRAPORT="8080" # TCP listening port for the administration interface
INTRAPREFIX="" # For administration interface URL: Prefix to be added to the instance name.
INTRASUFFIX="" # For administration interface URL: Suffix to be added to the instance name.
ZEBRA_MARC_FORMAT="unimarc" # Specifies format of MARC records to be indexed by Zebra. Possible values are 'marc21', 'normarc' and 'unimarc'.
ZEBRA_LANGUAGE="uk" # Primary language for Zebra indexing. Possible values are 'en', 'fr' and 'nb'.
DEFAULTSQL="" # a value is generally not needed.

===== ports.conf =====
Додаємо

Listen 8080
Listen 8008

у файл /etc/apache2/ports.conf

Порт 8008 додано для того щоб переспрямувати типовий віртуальний хост сервера Apache з порта 80 на порт 8008.
Для цього редагуємо типовий файл /etc/apache2/sites-enabled/000-default.conf і змінюємо наступний рядок

<VirtualHost *:8008>

Також перезапускаємо Apache

/etc/init.d/apache2 restart

==== Варіант з доменами ====

Цей варіант для випадку, коли є можливість попередньо налаштувати для АБІС Koha 2 домени на кшталт

opac.librarydomain.ua
staff.librarydomain.ua

Щодо налаштування див. тут https://wiki.koha-community.org/wiki/How_to_set_up_a_domain_name_for_Koha

=== Команда „koha-create“ ===

Синтаксис [https://wiki.koha-community.org/wiki/Commands_provided_by_the_Debian_packages#koha-create]

koha-create [--create-db|--request-db|--populate-db|--use-db] \
[--marcflavor marc21|normarc|unimarc] \
[--zebralang en|es|fr|nb|ru|uk] \
[--defaultsql /path/to/some.sql] \
[--configfile /path/to/config] [--passwdfile /path/to/passwd] \
[--database database] [--adminuser n] instancename

Створення екземпляра АБІС Koha (українська, Unimarc)

sudo koha-create --create-db --marcflavor unimarc --zebralang uk \
--auth-idx dom --biblio-idx dom \
--configfile /etc/koha/koha-ukr-unimarc-site.conf ukr_unimarc

Вивід:

Koha instance is empty, no staff user created.
Starting Zebra server for ukr_unimarc

== Веб-встановлювач ==

=== Актуальні українські sql-файли ===

Актуальні локалізовані SQL-таблиці (у [https://www.dropbox.com/referrals/NTE4MzAyOTY5?src=global9 DrobBox] Сергія Дубика) '''українською''' знаходяться за адресою:

https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0

Звантажуємо звідси найновішу версію теки '''uk-UA''' та замінюємо нею відповідну теку у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''.

Примітка: локалізація SQL-таблиць російською '''ru-RU''' доступна лише для версії 3.4.х.

=== Утворення локалізованих шаблонів ===



Спочатку дивимося перелік доступних мов

sudo koha-translate --list --available

Встановлюємо переклади для української та російської

sudo koha-translate --install uk-UA
sudo koha-translate --install ru-RU

та декілька інших

sudo koha-translate --install pl-PL
sudo koha-translate --install be-BY
…

=== Кроки веб-встановлювача ===

У файлі '''/etc/koha/sites/ukr_unimarc/koha-conf.xml''' у розділі '''config''' знаходимо користувача ('''user''') та пароль ('''pass'''). Також побачити логін та пароль можна через команди

sudo xmlstarlet sel -t -v 'yazgfs/config/user' /etc/koha/sites/ukr_unimarc/koha-conf.xml
sudo xmlstarlet sel -t -v 'yazgfs/config/pass' /etc/koha/sites/ukr_unimarc/koha-conf.xml

У веб-оглядачі переходимо за адресою http://localhost:8080/?language=uk-UA. Бачимо запит на авторизацію від веб-встановлювача.

Крок 1: мова uk-UA, перевірка залежностей

Крок 2: налаштування бази даних, перевірка з’єднання, існування БД та привілеїв

Крок 3: створення таблиць, вибір МАРК-стандарту ('''Unimarc'''), вибір типових даних.

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

Встановлення завершено!.

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}æäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha/zebradb/lang_defs/en/'''sort-string-utf.chr''' (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

При оновленнях пакунка „koha-common“ також потрібно вносити ці зміни.

=== Запуск служби Zebra ===

sudo koha-start-zebra ukr_unimarc

=== Запуск індексації Zebra ===

sudo koha-rebuild-zebra -f -v ukr_unimarc

=== E-mail ===

By default, email is turned off. This is to let you get everything set up before you risk sending unwanted notices to people. To turn email on:

$ sudo koha-email-enable libraryname

=== Перевірка пошуку ===

У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами

'''Україна''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Україна)

'''Інвестиції''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Інвестиції)

'''2011''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=2011)

== До перевірки ==

* що додано у завдання cron?
* переіндесація автоматична чи по розкладу і чи взагалі робиться?
* як задіяти ICU? (Зауваження щодо ICU див. [http://wiki.tntu.edu.ua/%D0%9E%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha,_%D0%B2%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BE%D1%97_%D0%B7_%D0%B4%D0%B6%D0%B5%D1%80%D0%B5%D0%BB%D0%B0#.D0.97.D0.B0.D1.83.D0.B2.D0.B0.D0.B6.D0.B5.D0.BD.D0.BD.D1.8F_.D1.89.D0.BE.D0.B4.D0.BE_ICU тут])
* чи можна обійтися без правки word-phrase-utf.chr?
* пошук за „Інвестиції“ мав дати 4 результати..?

= Оновлення Koha =

Буде додано…

= Вилучення Koha =

Вилучення пакунка „koha-common“ не приводить до автоматичного вилучення екземплярів АБІС Koha. '''Попередньо''' необхідно вилучити усі екземпляри АБІС Koha. Екземпляри АБІС Koha вилучаються за допомогою команди

koha-remove ukr_unimarc

Перегляд переліку наявних екземплярів

koha-list

Остаточне вилучення пакунків Koha

apt-get purge koha koha-common

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Вилучення Koha, встановленої з джерела]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Категорія:АБІС Koha]]
[[Категорія:Бібліотека]]

Вилучення Koha, встановленої з джерела

2023-11-01T18:05:07Z

Dubyk:

<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br />
Ласкаво просимо!</b>

Вилучення Koha 3.4.x, встановленої з джерела

Стосується встановлення Koha 3.4.x за інструкцією „[[Встановлення Koha з джерела на ОС Debian]]“

= Зупинка служб тощо =

Відключення сайту Koha
$ sudo a2dissite Koha3

Вилучення посилань на Koha в Apache
$ sudo rm -vrf /etc/apache2/sites-available/Koha3
$ sudo rm -rvf /etc/apache2/sites-enabled/Koha3

Вилучення портів Apache, пов’язаних з Koha, з файлу

/etc/apache2/ports.conf

Перезапуск Apache
$ sudo apache2ctl restart

Відключення служб Zebra
$ sudo update-rc.d -f zebra-server remove
$ sudo update-rc.d -f zebraqueue-daemon remove
$ sudo update-rc.d -f koha-zebra-daemon remove

Вилучення посилань на служби Zebra
$ sudo rm -rv /etc/init.d/zebra-server
$ sudo rm -rv /etc/init.d/zebraqueue-daemon
$ sudo rm -rv /etc/init.d/koha-zebra-daemon

= Вилучення бази даних та індексів =

Вилучення бази даних з MySQL
$ sudo mysql -uroot -pПарольАдмінаMySQL -e "drop database Koha3";

Індекси Zebra
$ zebraidx -c /etc/koha3/zebradb/zebra-biblios.cfg -g iso2709 -d biblios init
$ zebraidx -c /etc/koha3/zebradb/zebra-authorities.cfg -g iso2709 -d authorities init

= Вилучення тек Koha та файлів конфігурації =

Вилучення основних файлів встановлення Koha
$ sudo rm -rvf /usr/share/koha3

Вилучення журнальних файлів
$ sudo rm -rvf /var/log/koha3

Вилучення розділюваних бібліотечних файлів
$ sudo rm -rvf /var/lib/koha
$ sudo rm -rvf /var/lib/koha3

Вилучення файлів блокувань з /var/lock
$ sudo rm -rvf /var/lock/koha3

Вилучення файлів з /var/run
$ sudo rm -rvf /var/run/koha
$ sudo rm -rvf /var/run/koha3

Вилучення конфігураційних файлів
$ sudo rm -rvf /etc/koha3

Варто глянути у теки /etc/apache2/sites-available та /etc/apache2/sites-enabled, можливо, там ще залишилися налаштування віртуальних сайтів Koha.

= Не забуваємо про записи завдань „crontab“ =
для користувачів АдміністраторСистемиKoha та root

$ sudo crontab -e
$ sudo -u АдміністраторСистемиKoha crontab -e

= Змінні оточення =

Вилучити змінні, пов’язані з Кохою, з файлу

/etc/environment

= Вилучення користувача =
$ sudo deluser --remove-home АдміністраторСистемиKoha

Також потрібно вилучити користувача АдміністраторСистемиKoha з БД MySQL (напр., через phpmyadmin). Також перезапустити сервер (sudo /etc/init.d/mysql restart).

= Див. також =
* [[Встановлення Koha з джерела на ОС Debian]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Категорія:АБІС Koha]]
[[Категорія:Бібліотека]]

Оновлення Koha, встановленої з джерела

2023-11-01T18:04:56Z

Dubyk:

<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br />
Ласкаво просимо!</b>

Оновлення до Koha 3.16.x, встановленої з джерела

Стосується встановлення Koha 3.16.x за інструкцією „[[Встановлення Koha з джерела на ОС Debian]]“

= Резервні копії =

== Резервування даних ==

Резервуємо командою

mysqldump -u$MySQLUser -p$MySQLPassword $KohaDB > mysqldump__$time_shtamp.sql

(замість змінних $value підставляємо власні значення)

Якщо надалі буде потрібно повернутися до резервної версії, це можна буде зробити командою mysql -u$MySQLUser -p$MySQLPassword $KohaDB < mysqldump__$time_shtamp.sql, попередньо очистивши чи створивши БД $KohaDB).

== Резервування програмних файлів ==

Виконуємо команди

tar -cvf $folder_$time_shtamp.tar $folder
bzip2 -f $folder_$time_shtamp.tar

для кожної з тек

/usr/share/koha3
/etc/apache2/sites-available/Koha3
/etc/apache2/sites-enabled/Koha3
/etc/apache2/ports.conf
/etc/koha3/
/etc/init.d/zebra-server
/etc/init.d/zebraqueue-daemon
/etc/init.d/koha-zebra-daemon
/var/log/koha3
/var/lib/koha3
/var/lock/koha3

= Журнал попереднього встановлення =

Дивимося у конфігураційному файлі
/etc/koha3/koha-conf.xml
за розміщенням журналу встановлення, напр.
<config>
<install_log>/usr/share/koha3/misc/koha-install-log</install_log>

= Отримання останньої стабільної версій Koha 3.16.02 =

su АдміністраторСистемиKoha
(та вводимо пароль користувача АдміністраторСистемиKoha)

cd ~/koha;

rm koha-latest.tar.gz
wget http://download.koha-community.org/koha-latest.tar.gz
tar -xzf koha-latest.tar.gz
ls

(для наступних оновлень зручно з цього коду створити сценарій, напр., get_latest_KOHA_and_unpack.sh)

= Перевірки та довстановлення пакунків =

== Перевірка аналізатора SAX Parser ==

У теці Koha виконати

perl ~/koha/koha-3.16.02/misc/sax_parser_print.pl

Ви повинні побачити щось таке

XML::LibXML::SAX::Parser=HASH(0x81fe220)

Якщо ж є PurePerl чи Expat, то необхідно поправити файл /etc/perl/XML/SAX/ParserDetails.ini (запис щодо XML::LibXML::SAX::Parser має бути найнижче)

== Перевірка чи встановлені усі необхідні пакунки ==

Команда

perl ~/koha/koha-3.16.02/koha_perl_deps.pl -c -u -m

видасть список відсутніх модулів та модулів, які необхідно оновити.

Вам необхідно знайти та встановити ці модулі (ймовірно, що список буде порожнім, оскільки всі необхідні пакунки повинні згадуватися у цьому керівництві вище).

Відсутні модулі чи оновлені версії шукайте у гілках Debian testin/unstable, репозитарії debian.koha-community.org або ж в CPAN (Perl-модулі з CPAN встановлюються командую на кшталт „sudo cpan HTTP::OAI“).

== Якщо у попередньому виводі є зауваження на кшталт такого ==

Warning: prerequisite DateTime::Format::DateParse 0.04 not found.
Warning: prerequisite Gravatar::URL 1.03 not found.
Warning: prerequisite DateTime::Format::ICal 0.09 not found.
Warning: prerequisite Modern::Perl 1.03 not found.
Warning: prerequisite Readonly 1.03 not found.
Warning: prerequisite Readonly::XS 1.02 not found.
Warning: prerequisite Test::Strict not found.
Warning: prerequisite Test::YAML::Valid 0.04 not found.
Warning: prerequisite AnyEvent 5.0 not found.
Warning: prerequisite AnyEvent::HTTP 2.13 not found.
Warning: prerequisite CHI 0.36 not found.
Warning: prerequisite CHI::Driver::Memcached 0.12 not found.
Warning: prerequisite Moose 1.09 not found.
Warning: prerequisite Cache::Memcached::Fast 0.17 not found.
Warning: prerequisite DBD::Mock 1.39 not found.
Warning: prerequisite DateTime::Format::MySQL 0.04 not found.
Warning: prerequisite JSON::Any 1.28 not found.
Warning: prerequisite MooseX::Storage 0.30 not found.
Warning: prerequisite MooseX::Types 0.30 not found.
Warning: prerequisite String::RewritePrefix 0.006 not found.
Warning: prerequisite Test::Deep 0.106 not found.
Warning: prerequisite Test::MockModule 0.05 not found.
Warning: prerequisite Test::Warn 0.21 not found.
Warning: prerequisite Text::Unaccent 1.08 not found.
Warning: prerequisite Time::Progress 1.7 not found.
Warning: prerequisite Gravatar::URL 1.03 not found. We have 1.02.
Warning: prerequisite DateTime::TimeZone 1.26 not found. We have 1.20.
Warning: prerequisite Template::Plugin::HtmlToText 0.03 not found.
Warning: prerequisite Data::Paginator 0.04 not found.
Warning: prerequisite Archive::Extract 0.60 not found. We have 0.48.
Warning: prerequisite Archive::Zip 1.30 not found.
Warning: prerequisite Cache::Memory 2.04 not found.
Warning: prerequisite Module::Bundled::Files 0.03 not found.
Warning: prerequisite String::Random 0.22 not found.
Warning: prerequisite Test::WWW::Mechanize 1.44 not found.

то необхідно довстановити чи поновити згадувані пакунки…

== Пакунки з репозитарію Дебіен ==

sudo apt-get install \
libgravatar-url-perl \
libdatetime-format-ical-perl \
libmodern-perl-perl \
libdatetime-format-dateparse-perl \
libreadonly-perl \
libreadonly-xs-perl \
libtest-strict-perl \
libtest-yaml-valid-perl \
libanyevent-perl \
libdbd-mock-perl \
libdatetime-format-mysql-perl \
libjson-any-perl \
libmoosex-storage-perl \
libmoosex-types-perl \
libstring-rewriteprefix-perl \
libtest-deep-perl \
libtest-mockmodule-perl \
libtest-warn-perl \
libtext-unaccent-perl \
libtime-progress-perl \
libarchive-zip-perl \
libcache-perl \
libstring-random-perl \
libtest-www-mechanize-perl \
libcrypt-eksblowfish-perl \
liblibrary-callnumber-lc-perl \
libdbix-class-schema-loader-perl \
libemail-valid-perl \
liblocale-maketext-lexicon-perl \
libopenoffice-oodoc-perl

== Пакунки з тестового репозитарію Дебіен ==

sudo apt-get -t testing install \
libgravatar-url-perl \
libdatetime-timezone-perl \
libtemplate-plugin-htmltotext-perl \
libanyevent-http-perl \
libchi-perl \
libchi-driver-memcached-perl \
libmouse-perl \
libcache-memcached-fast-perl \
libarchive-extract-perl \
libmarc-record-perl \
libmarc-xml-perl

== Пакунки з репозитарію Koha ==

Деякі perl-пакунки ще не пакетизовані в офіційних репозитаріях Дебіен (перевіряємо [http://packages.debian.org/uk/wheezy/libdata-paginator-perl libdata-paginator-perl] та
[http://packages.debian.org/uk/wheezy/libtemplate-plugin-htmltotext-perl libtemplate-plugin-htmltotext-perl], [http://packages.debian.org/uk/wheezy/libmodule-bundled-files-perl libmodule-bundled-files-perl]). Однак відповідні deb-пакети можна знайти в
репозитарії [http://debian.koha-community.org/ debian.koha-community.org].

Підключаємо у файлі '''/etc/apt/sources.list'''
deb http://debian.koha-community.org/koha squeeze main

Також додаємо ключ gpg.asc до довірених ключів APT:
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Оновлюємо список доступних для встановлення пакунків
apt-get update

Встановлюємо пакунки з репозитарію Koha

sudo apt-get install \
libdata-paginator-perl \
libtemplate-plugin-htmltotext-perl \
libmodule-bundled-files-perl

== Пакунки з CPAN ==

Якщо пакунок все таки не вдалося знайти в одному з репозитаріїв — встановлюємо з CPAN.

Наприклад, можуть бути й зауваження такого роду:

Warning: prerequisite Data::Pagination 0.44 not found.

Цей Perl-модуль ще не доступний в жодному з репозиторіїв Дебіен (перевірити в Debian: [http://packages.debian.org/uk/wheezy/libdata-pagination-perl libdata-pagination-perl]). Встановлюємо командою

sudo perl -MCPAN -e 'install Data::Pagination'

Для таких зауважень

HTTPD::Bench::ApacheBench 0 0.73 No
Test::WWW::Mechanize 1.42 1.44 No

— встановлюємо

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
sudo perl -MCPAN -e 'install Test::WWW::Mechanize'

= Оновлення =

cd ~/koha/koha-3.16.02/; perl Makefile.PL --prev-install-log /usr/share/koha3/misc/koha-install-log

у випадку оновлення 3.6-3.12 з’явилася можливість налаштувати Zebra для кращої підтримки Unicode-символів. Вибираємо '''icu''':

Zebra has two methods to perform records tokenization
and characters normalization: CHR and ICU. ICU is
recommended for catalogs containing non-Latin
characters. (chr, icu) [chr] '''icu'''

у випадку оновлення 3.8.2-3.8.3 з’явився більш прогресивний режим індексації Zebra за допопогою фільтра DOM XML. Вибираємо '''dom''':

Koha can use one of two different indexing modes
for the MARC bibliographic records:

grs1 - uses the Zebra GRS-1 filter, available
for legacy support
dom - uses the DOM XML filter; offers improved
functionality.

Bibliographic indexing mode (dom, grs1) ['''dom''']

далі решту запитань і вивід —

Reading values from install log /usr/share/koha3/misc/koha-install-log. You
will be prompted only for settings that have been
added since the last time you installed Koha. To
be prompted for all settings, run 'perl Makefile.PL'
without the --prev-install-log option.

Found 'zebrasrv' and 'zebraidx' in /usr/bin.

Koha will be installed with the following configuration parameters:

AUTH_INDEX_MODE dom
BIB_INDEX_MODE dom
DB_HOST localhost
DB_NAME Koha3
DB_PASS ПарольКористувачаБДKoha3
DB_PORT 3306
DB_TYPE mysql
DB_USER КористувачБДKoha3
INSTALL_BASE /usr/share/koha3
INSTALL_MODE standard
INSTALL_PAZPAR2 yes
INSTALL_SRU yes
INSTALL_ZEBRA yes
KOHA_GROUP АдміністраторСистемиKoha
KOHA_INSTALLED_VERSION 3.16.02.000
KOHA_USER АдміністраторСистемиKoha
MEMCACHED_NAMESPACE KOHA
MEMCACHED_SERVERS 127.0.0.1:11211
MERGE_SERVER_HOST localhost
MERGE_SERVER_PORT 11001
PATH_TO_ZEBRA /usr/bin
PAZPAR2_HOST localhost
PAZPAR2_PORT 11002
RUN_DATABASE_TESTS no
USE_MEMCACHED yes
ZEBRA_LANGUAGE uk
ZEBRA_MARC_FORMAT unimarc
ZEBRA_PASS ПарольКористувачаZebra
ZEBRA_SRU_AUTHORITIES_POR9999
ZEBRA_SRU_BIBLIOS_PORT 9998
ZEBRA_SRU_HOST localhost
ZEBRA_TOKENIZER icu
ZEBRA_USER КористувачZebra

and in the following directories:

BACKUP_DIR $(DESTDIR)/var/spool/koha3
DOC_DIR $(DESTDIR)/usr/share/koha3/doc
INTRANET_CGI_DIR $(DESTDIR)/usr/share/koha3/intranet/cgi-bin
INTRANET_TMPL_DIR $(DESTDIR)/usr/share/koha3/intranet/htdocs/intranet-tmpl
INTRANET_WWW_DIR $(DESTDIR)/usr/share/koha3/intranet/htdocs
KOHA_CONF_DIR $(DESTDIR)/etc/koha3
LOG_DIR $(DESTDIR)/var/log/koha3
MAN_DIR $(DESTDIR)/usr/share/koha3/man
MISC_DIR $(DESTDIR)/usr/share/koha3/misc
OPAC_CGI_DIR $(DESTDIR)/usr/share/koha3/opac/cgi-bin
OPAC_TMPL_DIR $(DESTDIR)/usr/share/koha3/opac/htdocs/opac-tmpl
OPAC_WWW_DIR $(DESTDIR)/usr/share/koha3/opac/htdocs
PAZPAR2_CONF_DIR $(DESTDIR)/etc/koha3/pazpar2
PERL_MODULE_DIR $(DESTDIR)/usr/share/koha3/lib
PLUGINS_DIR $(DESTDIR)/var/lib/koha3/plugins
SCRIPT_DIR $(DESTDIR)/usr/share/koha3/bin
SCRIPT_NONDEV_DIR $(DESTDIR)/usr/share/koha3/bin
ZEBRA_CONF_DIR $(DESTDIR)/etc/koha3/zebradb
ZEBRA_DATA_DIR $(DESTDIR)/var/lib/koha3/zebradb
ZEBRA_LOCK_DIR $(DESTDIR)/var/lock/koha3/zebradb
ZEBRA_RUN_DIR $(DESTDIR)/var/run/koha3/zebradb

To change any configuration setting, please run
perl Makefile.PL again. To override one of the target
directories, you can do so on the command line like this:

perl Makefile.PL PERL_MODULE_DIR=/usr/share/perl/5.14

You can also set different default values for parameters
or override directory locations by using environment variables.

For example:

export DB_USER=my_koha
perl Makefile.PL

or

DB_USER=my_koha DOC_DIR=/usr/local/info perl Makefile.PL

If installing on a Win32 platform, be sure to use:
'dmake -x MAXLINELENGTH=300000'

Writing Makefile for koha
Writing MYMETA.yml

= Компіляція та встановлення =

make
make test
sudo make upgrade

= Поправити налаштування хоста Apache =

sudo mc -e /etc/koha3/koha-httpd.conf

/etc/koha3/koha-httpd.conf

...
<VirtualHost *:80>
ServerName koha
...
...
<VirtualHost *:8080>
ServerName koha:8080
...

та перезапустити сервер Apache

sudo /etc/init.d/apache2 restart

= Куки =
Інколи при оновленні між версіями, при спробі доступу до веб-інтерфейсу з’являється у оглядачі помилка на зразок
Koha Byte order is not compatible at Storable.pm line Auth.pm

Вирішує проблему очищення куків в оглядачі для даного домену.

= Продовжуємо оновлення через веб-інтерфейс =

http://localhost:8080

Вводимо логін АдміністраторСистемиKoha та пароль, оновлюємо БД:

Ми модернізуємо Коха від версії 3.16.00.000 до 3.16.02.000, Ви повинні також оновити Вашу баз даних
Звіт про оновлення:

Upgrade to 3.16.01.000 done (3.16.1 release)
Upgrade to 3.16.02.000 done (3.16.2 release)

Все пройшло добре, оновлення зроблено.
Продовжуємо та входимо до Коха

= Поновлення мовних шаблонів =

Усі шаблони для мов відмінних від en залишаються старі — '''необхідно оновити''',
напр. для укр. та рос.:

cd /usr/share/koha3/misc/translator/;sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install uk-UA
cd /usr/share/koha3/misc/translator/;sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install ru-RU

Бажано після цього перезапустити й службу memcached

sudo /etc/init.d/memcached restart



= Відновлення Zebra =
Поновлювач перезаписує файл

/etc/koha3/zebradb/etc/word-phrase-utf.chr

витираючи набори кириличних символів й апостроф, необхідні для працездатності пошуку Zebra, отож виправляємо у цьому файлі на наступне:

lowercase {0-9}{a-z}æäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Зауваження: ймовірно, при виборі ICU цього не потрібно (ще варто детально протестувати)

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу

/etc/koha3/zebradb/lang_defs/en/sort-string-utf.chr

(наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

= Переіндексація БД =

sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib \
/usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -b -r -x -v

sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib \
/usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -a -r -v

= Зауваження щодо ICU =

Використання ICU, ймовірно, ще потребує дослідження.
На великій БД з'явилась помилка при переіндесації Zebra:

...
*** glibc detected *** zebraidx: corrupted double-linked list: 0x09d57700 ***
...

Згадки по цій проблемі:
http://lists.nongnu.org/archive/html/koha-zebra/2011-06/msg00001.html
http://irc.koha-community.org/irclog/koha/2011-05-29

'''Лише у випадку''', якщо присутня така проблема з індексацією, пробуємо відключити ICU у файлі /etc/koha3/'''zebradb/etc/default.idx''', замінивши у двох рядках

icuchain words-icu.xml

на

charmap word-phrase-utf.chr

Також у файлі /etc/koha3/zebradb/etc/word-phrase-utf.chr
повинен бути кириличний алфавіт (згадується вище).

= Відновлення алфавітного вибору читачів (застаріло) =

З версії 3.12 алфавіт для вибору читачів можна вказувати у системній змінній '''alphabet'''.

= Відновлення індексування УДК в Zebra =

Кроки:

1) У файлі /etc/koha3/zebradb/biblios/etc/bib1.att вже є необхідний рядок

att 14 UDC-classification

2) У файлі /etc/koha3/zebradb/ccl.properties знаходимо абзац

#Classification-UDC 14 A classification number from 080
# Universal Decimal
# Classification, a system based
# on the Dewey Decimal
# Classification.
#UDC-classification 1=14

та розкоментовуємо

UDC-classification 1=14

3) Далі для '''Unimarc''' у файлі /etc/koha3/zebradb/marc_defs/unimarc/biblios/record.abs потрібно додати

melm 675$a UDC-classification:w,UDC-classification:p

Ймовірно, що record.abs застарілий і тепер потрібно вносити зміни в XSL-файли...

у файл /etc/koha3/zebradb/marc_defs/unimarc/biblios/biblio-zebra-indexdefs.xsl додати

<xslo:template mode="index_subfields" match="marc:datafield[@tag='675']">
<xslo:for-each select="marc:subfield">
<xslo:if test="contains('a', @code)">
<z:index name="UDC-classification:w UDC-classification:p">
<xslo:value-of select="."/>
</z:index>
</xslo:if>
</xslo:for-each>
</xslo:template>

та у файл /etc/koha3/zebradb/marc_defs/unimarc/biblios/biblio-koha-indexdefs.xml додати

<------>UDC-classification:w,UDC-classification:p-->
<index_subfields xmlns="http://www.koha-community.org/schemas/index-defs" tag="675" subfields="a">
<target_index>UDC-classification:w</target_index>
<target_index>UDC-classification:p</target_index>
</index_subfields>

Далі для '''Marc21''' у файлі /etc/koha3/zebradb/marc_defs/marc21/biblios/record.abs:

melm 080 UDC-classification:w,UDC-classification:s

Ймовірно, що record.abs застарілий і тепер потрібно вносити зміни в XSL-файли...

у файлі /etc/koha3/zebradb/marc_defs/marc21/biblios/biblio-zebra-indexdefs.xsl має бути (є)

<xslo:template mode="index_data_field" match="marc:datafield[@tag='080']">
<z:index name="UDC-classification:w UDC-classification:s">
<xslo:variable name="raw_heading">
<xslo:for-each select="marc:subfield">
<xslo:if test="position() > 1">
<xslo:value-of select="substring(' ', 1, 1)"/>
</xslo:if>
<xslo:value-of select="."/>
</xslo:for-each>
</xslo:variable>
<xslo:value-of select="normalize-space($raw_heading)"/>
</z:index>
</xslo:template>

та у файлі /etc/koha3/zebradb/marc_defs/marc21/biblios/biblio-koha-indexdefs.xml має бути (є)


<index_data_field xmlns="http://www.koha-community.org/schemas/index-defs" tag="080">
<target_index>UDC-classification:w</target_index>
<target_index>UDC-classification:s</target_index>
</index_data_field>

4) Також потрібно у файлі /usr/share/koha3/lib/C4/Search.pm у масив @indexes додати елемент-індекс

'UDC-classification',

= Відновлення індексування ББК в Zebra =

Кроки:

1) У файлі /etc/koha3/zebradb/biblios/etc/bib1.att є рядок

att 1040 Classification

Виглядає так, що він не використовується надалі. Отож замінюємо його на такий

att 1040 bbk

2) У файлі /etc/koha3/zebradb/ccl.properties повинен бути наступний рядок

#bbk 1040 Soviet Bibliothecal-Bibliographic Classification (BBK; LBC)
bbk 1=1040

3) Далі для '''Unimarc''' у файлі /etc/koha3/zebradb/marc_defs/unimarc/biblios/record.abs потрібно додати

melm 686$a bbk,bbk:p

Ймовірно, що record.abs застарілий і тепер потрібно вносити зміни в XSL-файли...

у файл /etc/koha3/zebradb/marc_defs/unimarc/biblios/biblio-zebra-indexdefs.xsl додати

<xslo:template mode="index_subfields" match="marc:datafield[@tag='686']">
<xslo:for-each select="marc:subfield">
<xslo:if test="contains('a', @code)">
<z:index name="bbk bbk:p">
<xslo:value-of select="."/>
</z:index>
</xslo:if>
</xslo:for-each>
</xslo:template>

або, якщо є 686-секція, то вставити в неї

<xslo:for-each select="marc:subfield">
<xslo:if test="contains('a', @code)">
<z:index name="bbk bbk:p">
<xslo:value-of select="."/>
</z:index>
</xslo:if>
</xslo:for-each>

та у файл /etc/koha3/zebradb/marc_defs/unimarc/biblios/biblio-koha-indexdefs.xml додати

<------>bbk,bbk:p-->
<index_subfields xmlns="http://www.koha-community.org/schemas/index-defs" tag="686" subfields="a">
<target_index>bbk</target_index>
<target_index>bbk:p</target_index>
</index_subfields>

Далі для '''Marc21''' у файлі /etc/koha3/zebradb/marc_defs/marc21/biblios/record.abs:

melm 084 bbk:w,bbk:s

Ймовірно, що record.abs застарілий і тепер потрібно вносити зміни в XSL-файли...

у файлі /etc/koha3/zebradb/marc_defs/marc21/biblios/biblio-zebra-indexdefs.xsl має бути (є)

<xslo:template mode="index_data_field" match="marc:datafield[@tag='084']">
<z:index name="bbk:w bbk:s">
<xslo:variable name="raw_heading">
<xslo:for-each select="marc:subfield">
<xslo:if test="position() > 1">
<xslo:value-of select="substring(' ', 1, 1)"/>
</xslo:if>
<xslo:value-of select="."/>
</xslo:for-each>
</xslo:variable>
<xslo:value-of select="normalize-space($raw_heading)"/>
</z:index>
</xslo:template>

та у файлі /etc/koha3/zebradb/marc_defs/marc21/biblios/biblio-koha-indexdefs.xml має бути (є)


<index_data_field xmlns="http://www.koha-community.org/schemas/index-defs" tag="084">
<target_index>bbk:w</target_index>
<target_index>bbk:s</target_index>
</index_data_field>

4) Також потрібно у файлі /usr/share/koha3/lib/C4/Search.pm у масив @indexes додати елемент-індекс

'bbk',

= Відновлення індексування ДКД (Дьюї) в Zebra =

Кроки:

1) У файлі /etc/koha3/zebradb/biblios/etc/bib1.att вже є необхідний рядок

att 13 Dewey-classification

2) У файлі /etc/koha3/zebradb/ccl.properties находимо абзац

#Classification-Dewey 13 A classification number from 082
# the Dewey Decimal
# Classification, developed by
# Melvyl Dewey.
#Dewey-classification 1=13

та розкоментовуємо

Dewey-classification 1=13

3) Далі для '''Unimarc''' у файлі /etc/koha3/zebradb/marc_defs/unimarc/biblios/record.abs повинно бути (є)

melm 676$a Dewey-classification:w,Dewey-classification:p

Ймовірно, що record.abs застарілий і тепер потрібно вносити зміни в XSL-файли...

у файлі /etc/koha3/zebradb/marc_defs/unimarc/biblios/biblio-zebra-indexdefs.xsl має бути (є)

<xslo:template mode="index_subfields" match="marc:datafield[@tag='676']">
<xslo:for-each select="marc:subfield">
<xslo:if test="contains('a', @code)">
<z:index name="Dewey-classification:w Dewey-classification:p">
<xslo:value-of select="."/>
</z:index>
</xslo:if>
</xslo:for-each>
</xslo:template>

та у файлі /etc/koha3/zebradb/marc_defs/unimarc/biblios/biblio-koha-indexdefs.xml має бути (є)

Dewey-classification:w,Dewey-classification:p-->
<index_subfields xmlns="http://www.koha-community.org/schemas/index-defs" tag="676" subfields="a">
<target_index>Dewey-classification:w</target_index>
<target_index>Dewey-classification:p</target_index>
</index_subfields>

Далі для '''Marc21''' у файлі /etc/koha3/zebradb/marc_defs/marc21/biblios/record.abs:

melm 082 Dewey-classification:w,Dewey-classification:s

Ймовірно, що record.abs застарілий і тепер потрібно вносити зміни в XSL-файли...

Додаково внести зміни й у /etc/koha3/zebradb/marc_defs/marc21/biblios/biblio-zebra-indexdefs.xsl:

<xslo:template mode="index_data_field" match="marc:datafield[@tag='082']">
<z:index name="Dewey-classification:w Dewey-classification:s">
<xslo:variable name="raw_heading">
<xslo:for-each select="marc:subfield">
<xslo:if test="position() > 1">
<xslo:value-of select="substring(' ', 1, 1)"/>
</xslo:if>
<xslo:value-of select="."/>
</xslo:for-each>
</xslo:variable>
<xslo:value-of select="normalize-space($raw_heading)"/>
</z:index>
</xslo:template>

та /etc/koha3/zebradb/marc_defs/marc21/biblios/biblio-koha-indexdefs.xml:


<index_data_field xmlns="http://www.koha-community.org/schemas/index-defs" tag="082">
<target_index>Dewey-classification:w</target_index>
<target_index>Dewey-classification:s</target_index>
</index_data_field>

4) Також потрібно у файлі /usr/share/koha3/lib/C4/Search.pm у масиві @indexes має бути (є) елемент-індекс

'Dewey-classification',

= Відновлення індексування КБК (клас. Бібліотеки Конгресу) в Zebra =

Кроки:

1) У файлі /etc/koha3/zebradb/biblios/etc/bib1.att вже є необхідний рядок

att 16 LC-call-number

2) У файлі /etc/koha3/zebradb/ccl.properties находимо абзац

#Classification-LC 16 A classification number from 050
# the US Library of Congress
# Classification.
#LC-call-number 1=16

та розкоментовуємо

LC-call-number 1=16

3) Далі для '''Unimarc''' у файлі /etc/koha3/zebradb/marc_defs/unimarc/biblios/record.abs повинно бути (є)

melm 680$b LC-call-number:s
melm 680 LC-call-number

Ймовірно, що record.abs застарілий і тепер потрібно вносити зміни в XSL-файли...

у файлі /etc/koha3/zebradb/marc_defs/unimarc/biblios/biblio-zebra-indexdefs.xsl має бути (є)

<xslo:template mode="index_subfields" match="marc:datafield[@tag='680']">
<xslo:for-each select="marc:subfield">
<xslo:if test="contains('b', @code)">
<z:index name="LC-call-number:s">
<xslo:value-of select="."/>
</z:index>
</xslo:if>
</xslo:for-each>
</xslo:template>

<xslo:template mode="index_data_field" match="marc:datafield[@tag='680']">
<z:index name="LC-call-number:w">
<xslo:variable name="raw_heading">
<xslo:for-each select="marc:subfield">
<xslo:if test="position() > 1">
<xslo:value-of select="substring(' ', 1, 1)"/>
</xslo:if>
<xslo:value-of select="."/>
</xslo:for-each>
</xslo:variable>
<xslo:value-of select="normalize-space($raw_heading)"/>
</z:index>
</xslo:template>

та у файлі /etc/koha3/zebradb/marc_defs/unimarc/biblios/biblio-koha-indexdefs.xml має бути (є)

<------>LC-call-number:s-->
<index_subfields xmlns="http://www.koha-community.org/schemas/index-defs" tag="680" subfields="b">
<target_index>LC-call-number:s</target_index>
</index_subfields>
<------>LC-call-number-->
<index_data_field xmlns="http://www.koha-community.org/schemas/index-defs" tag="680">
<target_index>LC-call-number:w</target_index>
</index_data_field>

Далі для '''Marc21''' у файлі /etc/koha3/zebradb/marc_defs/marc21/biblios/record.abs:

melm 050$b LC-call-number:w,LC-call-number:p,LC-call-number:s
melm 050 LC-call-number:w,LC-call-number:p,LC-call-number:s

Ймовірно, що record.abs застарілий і тепер потрібно вносити зміни в XSL-файли...

Додаково внести зміни й у /etc/koha3/zebradb/marc_defs/marc21/biblios/biblio-zebra-indexdefs.xsl:

<xslo:template mode="index_subfields" match="marc:datafield[@tag='050']">
<xslo:for-each select="marc:subfield">
<xslo:if test="contains('b', @code)">
<z:index name="LC-call-number:w LC-call-number:p LC-call-number:s">
<xslo:value-of select="."/>
</z:index>
</xslo:if>
</xslo:for-each>
</xslo:template>

<xslo:template mode="index_data_field" match="marc:datafield[@tag='050']">
<z:index name="LC-call-number:w LC-call-number:p LC-call-number:s">
<xslo:variable name="raw_heading">
<xslo:for-each select="marc:subfield">
<xslo:if test="position() > 1">
<xslo:value-of select="substring(' ', 1, 1)"/>
</xslo:if>
<xslo:value-of select="."/>
</xslo:for-each>
</xslo:variable>
<xslo:value-of select="normalize-space($raw_heading)"/>
</z:index>
</xslo:template>

та /etc/koha3/zebradb/marc_defs/marc21/biblios/biblio-koha-indexdefs.xml:


<index_subfields xmlns="http://www.koha-community.org/schemas/index-defs" tag="050" subfields="b">
<target_index>LC-call-number:w</target_index>
<target_index>LC-call-number:p</target_index>
<target_index>LC-call-number:s</target_index>
</index_subfields>

<index_data_field xmlns="http://www.koha-community.org/schemas/index-defs" tag="050">
<target_index>LC-call-number:w</target_index>
<target_index>LC-call-number:p</target_index>
<target_index>LC-call-number:s</target_index>
</index_data_field>

4) Також потрібно у файлі /usr/share/koha3/lib/C4/Search.pm у масиві @indexes має бути (є) елемент-індекс

'LC-call-number',

= Утворення індексів УДК, Дьюї, ББК, КБК та можливість пошуку за ними =

Для витягнення означених класифікаційних індексів запускаємо переіндексацію Zebra

sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib \
/usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -b -r -x -v

ЕК) У файлі /usr/share/koha3/opac/htdocs/opac-tmpl/prog/en/modules/opac-advsearch.tt

замість рядка

<option value="callnum">Call number</option>

додати рядки

<option value="sn">Standart number</option>
<option value="callnum">&nbsp;&nbsp;&nbsp;&nbsp; Call number</option>
<option value="UDC-classification,first-in-subfield">&nbsp;&nbsp;&nbsp;&nbsp; UDC-classification</option>
<option value="Dewey-classification,first-in-subfield">&nbsp;&nbsp;&nbsp;&nbsp; Dewey-classification</option>
<option value="bbk,first-in-subfield">&nbsp;&nbsp;&nbsp;&nbsp; BBK</option>
<option value="LC-call-number,first-in-subfield">&nbsp;&nbsp;&nbsp;&nbsp; LC-call-number</option>

Біб. інтерфейс) У файлі /usr/share/koha3/intranet/htdocs/intranet-tmpl/prog/en/includes/search_indexes.inc

замість рядка

<option value="callnum">&nbsp;&nbsp;&nbsp;&nbsp; Call number</option>

додати рядки

<option value="callnum">&nbsp;&nbsp;&nbsp;&nbsp; Call number</option>
<option value="UDC-classification,first-in-subfield">&nbsp;&nbsp;&nbsp;&nbsp; UDC-classification</option>
<option value="Dewey-classification,first-in-subfield">&nbsp;&nbsp;&nbsp;&nbsp; Dewey-classification</option>
<option value="bbk,first-in-subfield">&nbsp;&nbsp;&nbsp;&nbsp; BBK</option>
<option value="LC-call-number,first-in-subfield">&nbsp;&nbsp;&nbsp;&nbsp; LC-call-number</option>

Відповідно також потрібно перегенерувати мовні шаблони, напр. для укр. та рос.:

cd /usr/share/koha3/misc/translator
sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install uk-UA
sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install ru-RU

= Відновлення налаштування за класифікацією =

Типово це не працює для використовуваного класифікаційного індексу (УДК, ББК, ДДК) і при оновленні вертається типовий варіант.

Декілька кроків:

1) build_browser_and_cloud.pl з інтегрованими таблицями УДК, ББК, ДДК для української.

Файл [https://www.dropbox.com/sh/yeaazk77nysjckh/Czf7mMZtcM/files/usr_share_koha3_bin_cronjobs/build_browser_and_cloud.pl build_browser_and_cloud.pl] можна знайти у теці [https://www.dropbox.com/sh/yeaazk77nysjckh/dzrfLOI_fK PUBLIC] хмарного сховища [htp://db.tt/ExL7MRZ Dropbox] Сергія Дубика.

Розміщуємо файл за шляхом /usr/share/koha3/bin/cronjobs

2) До таблиці „browser“ додати колонки „class_source“ та “language“

sql-команди для додавання

ALTER TABLE browser ADD class_source varchar(10);
ALTER TABLE browser ADD language varchar(25);
ALTER TABLE browser ADD parent_class varchar(255);
ALTER TABLE browser ADD query mediumtext;

Додатково: тип колонки „description“ змінити на „mediumtext“, тип колонки „classification“ змінити на „varchar(255)“.

3) Для періодичного оновлення ієрархії класифікаційних індексів (УДК, скорочені табл.) необхідно періодично (crontab) запускати сценарій

env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=usr/share/koha3/lib perl -I /usr/share/koha3/lib build_browser_and_cloud.pl \
-b -f 675a -t 606 -c -m 3 -s udc -l uk_UA

для ДДК (скорочені табл. Дьюї) параметри:

-b -f 676a -t 606 -c -m 3 -k ddc -l uk_UA

для ББК (скорочені таблиці ББК для наукових бібліотек) параметри:

-b -f 686a -t 606 -c -m 3 -k rubbk -l uk_UA

4) Також змінюємо файл /usr/share/koha3/opac/htdocs/opac-tmpl/prog/en/modules/opac-browser.tt

Замінюємо рядок з пошуковим запитом

opac-search.pl?q=Dewey-classification

для УДК на

opac-search.pl?q=UDC-classification,first-in-subfield

для ББК на

opac-search.pl?q=bbk,first-in-subfield

для ДДК (Дьюї) на

opac-search.pl?q=Dewey-classification,first-in-subfield

Шаблон opac-browser.tt для мов відмінних від en залишається старий — необхідно теж оновити, напр. для укр. та рос.:

cd /usr/share/koha3/misc/translator/;sudo env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install uk-UA
cd /usr/share/koha3/misc/translator/;sudo env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install ru-RU

P.S. Ще не реалізований у файлі build_browser_and_cloud.pl переклад терму "classification $_" у рядку

$sth->execute(length($_),$_,$classification->{$_}?$classification->{$_}:"classification $_",$browser_result{$_}->{value},

= Оновлення завершено =

Заходимо у інтерфейс бібліотекаря.
Бачимо зміну версії за адресою http://localhost:8080/cgi-bin/koha/about.pl

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Встановлення Koha з джерела на ОС Debian]]
* [[Вилучення Koha, встановленої з джерела]]
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Категорія:АБІС Koha]]
[[Категорія:Бібліотека]]

Встановлення Koha з джерела на ОС Debian

2023-11-01T18:03:47Z

Dubyk:

<b>Наповнення цієї сторінки на цій площадці заморожено! <br />
Подальше редагування відбувається на сайті української спільноти користувачів АБІС Koha [http://wiki.koha.org.ua wiki.koha.org.ua]!<br />
Ласкаво просимо!</b>

Розглядається встановлення АБІС Koha серії 3.16.X з джерельних кодів. Опис, в основному взятий початково з http://wiki.koha-community.org/wiki/Category:Installation з доповненнями.

= Встановлення ОС Debian GNU/Linux 7 Wheezy =

Детальніше: [[Встановлення ОС Debian Linux]].

= Попередні налаштування =
== Локаль з UTF-8 ==
Перевірка локалі:
sudo locale
у виводі повинно бути магічне „'''UTF-8'''“ (en.UTF-8, ru_RU.UTF-8 тощо), наприклад для України

LANG=uk_UA.UTF-8
LANGUAGE=
LC_CTYPE="uk_UA.UTF-8"
LC_NUMERIC="uk_UA.UTF-8"
LC_TIME="uk_UA.UTF-8"
LC_COLLATE="uk_UA.UTF-8"
LC_MONETARY="uk_UA.UTF-8"
LC_MESSAGES="uk_UA.UTF-8"
LC_PAPER="uk_UA.UTF-8"
LC_NAME="uk_UA.UTF-8"
LC_ADDRESS="uk_UA.UTF-8"
LC_TELEPHONE="uk_UA.UTF-8"
LC_MEASUREMENT="uk_UA.UTF-8"
LC_IDENTIFICATION="uk_UA.UTF-8"

Якщо '''UTF-8''' не згадується, то встановлюємо локаль
sudo /usr/sbin/update-locale LANG=uk_UA.UTF-8 LANGUAGE="uk_UA:uk"

== Користувач для Koha ==

Додаємо користувача

(нижче замість „АдміністраторСистемиKoha“ вводимо своє)

sudo adduser АдміністраторСистемиKoha

Деколи група автоматично не створюється — тоді потрібно ще

sudo addgroup АдміністраторСистемиKoha
sudo adduser АдміністраторСистемиKoha АдміністраторСистемиKoha

Командою „sudo visudo“ відкриваємо для редагування файл привілеїв адміністратора і надаємо їх користувачу АдміністраторСистемиKoha, додавши у кінці файлу рядок

АдміністраторСистемиKoha ALL=(ALL:ALL) ALL

Після додавання клавіатурним скороченням Ctrl-O зберігаємо файл (/etc/sudoers) та через Ctrl-X виходимо.

= Встановлення й налаштування додаткових пакунків =

Встановленню безпосередньо ПЗ Koha передує встановлення усіх необхідних пакунків та модулів, від яких залежить Koha.

== Встановлення пакунків з репозитаріїв ==

=== Веб-сервер, БД MySQL та допоміжні пакунки ===

Однією командою

sudo apt-get install \
at \
apache2 \
cvs \
git \
git-core \
make \
gcc \
daemon \
perlmagick \
mysql-server \
phpmyadmin

* при встановленні сервера MySQL вказуємо пароль адміністратора (користувач „root“), надалі „ПарольАдмінаMySQL“.
* для „phpmyadmin“ вибрати лише „apache2“
* при встановленні „phpmyadmin“ нагадати системі пароль адміна MySQL а також встановити пароль застосунку

У файлі /etc/phpmyadmin/phpmyadmin.service змінити порт
...
<port>8888</port>
...

та додати цей порт у файл /etc/apache2/ports.conf

Listen 8888

Перезапуск Apache

/etc/init.d/apache2 restart

=== Перлівські модулі ===

Однією командою

sudo apt-get install \
libcgi-session-perl \
libclass-factory-util-perl \
libdata-ical-perl \
libdate-calc-perl \
libdate-manip-perl \
libdatetime-format-mail-perl \
libdatetime-format-strptime-perl \
libdatetime-format-w3cdtf-perl \
libdatetime-locale-perl \
libdatetime-perl \
libdatetime-timezone-perl \
libdbd-mysql-perl \
libdbi-perl \
libemail-date-perl \
libgd-barcode-perl \
libhtml-scrubber-perl \
libimage-magick-perl \
libjson-perl \
liblingua-ispell-perl \
liblingua-stem-perl \
liblist-moreutils-perl \
liblist-moreutils-perl \
liblocale-gettext-perl \
liblocale-po-perl \
libmail-sendmail-perl \
libmime-lite-perl \
libnet-ldap-perl \
libpdf-api2-perl \
libpoe-perl \
libtext-charwidth-perl \
libtext-csv-perl \
libtext-iconv-perl \
libtext-wrapi18n-perl \
libtimedate-perl \
libtime-duration-perl \
libtime-format-perl \
libunix-syslog-perl \
libxml-dom-perl \
libxml-dumper-perl \
libxml-libxml-perl \
libxml-libxslt-perl \
libxml-namespacesupport-perl \
libxml-parser-perl \
libxml-perl \
libxml-regexp-perl \
libxml-sax-writer-perl \
libxml-simple-perl \
libxml-xslt-perl \
libyaml-syck-perl \
libbiblio-endnotestyle-perl \
libcgi-session-serialize-yaml-perl \
libhtml-template-pro-perl \
libmarc-charset-perl \
libmarc-crosswalk-dublincore-perl \
libmarc-xml-perl \
libmarc-record-perl \
libnet-z3950-zoom-perl \
libpdf-reuse-perl \
libpdf-reuse-barcode-perl \
libschedule-at-perl \
libxml-rss-perl \
libyaml-perl \
libalgorithm-checkdigits-perl \
libhttp-oai-perl \
libsms-send-perl \
libtemplate-perl \
libmemoize-memcached-perl \
libbusiness-isbn-perl \
libdbd-sqlite2-perl \
libuniversal-require-perl \
libtext-csv-encoded-perl \
libpdf-api2-simple-perl \
libpdf-table-perl \
libnet-server-perl \
libnumber-format-perl \
liblocale-currency-format-perl \
liblingua-stem-snowball-perl \
libgraphics-magick-perl \
libauthen-cas-client-perl \
libdatetime-format-dateparse-perl \
libreadonly-perl \
libreadonly-xs-perl \
libanyevent-perl \
libmoosex-storage-perl \
libmoosex-types-perl \
libfile-slurp-perl \
libdbd-mock-perl \
libanyevent-http-perl \
libarchive-zip-perl \
libcgi-session-driver-memcached-perl \
libgravatar-url-perl \
libcache-fastmmap-perl \
libcache-memcached-fast-perl \
libcache-perl \
libdatetime-event-ical-perl \
libdatetime-format-ical-perl \
libdatetime-format-mysql-perl \
libmodern-perl-perl \
libstring-random-perl \
libtest-deep-perl \
libtest-mockmodule-perl \
libtest-strict-perl \
libtest-www-mechanize-perl \
libtest-warn-perl \
libtest-yaml-valid-perl \
libtext-unaccent-perl \
libtime-progress-perl \
libchi-driver-memcached-perl \
libcrypt-eksblowfish-perl \
liblibrary-callnumber-lc-perl \
libdbix-class-schema-loader-perl \
libemail-valid-perl \
liblocale-maketext-lexicon-perl \
libopenoffice-oodoc-perl

=== Zebra та Yaz ===

Однією командою

sudo apt-get install \
idzebra-2.0-common \
idzebra-2.0-doc \
idzebra-2.0 \
idzebra-2.0-utils \
libidzebra-2.0-dev \
libidzebra-2.0-0 \
libidzebra-2.0-mod-alvis \
libidzebra-2.0-mod-grs-marc \
libidzebra-2.0-mod-grs-regx \
libidzebra-2.0-mod-grs-xml \
libidzebra-2.0-mod-text \
libidzebra-2.0-modules \
yaz \
yaz-doc \
libyaz4 \
libyaz4-dev

=== Інші пакунки ===

Однією командою

sudo apt-get install \
gettext \
libgcrypt11-dev \
libgcrypt11 \
libmysqlclient-dev \
libxml2-dev \
libxml2 \
libxml2-utils \
libxslt1.1 \
libxslt1-dev \
memcached \
libapache2-mod-perl2

=== Пакунки з гілок Дебіен „testing“ та „unstable“ ===

Деякі пакунки (чи оновленні версії) не попали в стабільний випуск Debian, проте можуть бути у випуску „testing“ чи „unstable“.

1) Створюємо файл /etc/apt/apt.conf і додаємо наступне

# Зробити „wheezy“ дистрибутивом за умовчанням
APT::Default-Release "wheezy";

2) Створюємо файл /etc/apt/preferences і додаємо наступне (щоб у стабільної гілки „wheezy“ був вищий пріоритет)

Package: *
Pin: release a=stable
Pin-Priority: 700

Package: *
Pin: release a=testing
Pin-Priority: 650

Package: *
Pin: release a=unstable
Pin-Priority: 600

3) У файл /etc/apt/sources.list додаємо наступні джерела

# Джерело пакунків з гілки Дебіен „testing“
deb http://http.us.debian.org/debian/ testing main contrib non-free
deb-src http://http.us.debian.org/debian/ testing main contrib non-free

# Джерело пакунків з гілки Дебіен „testing“ — оновлення безпеки
deb http://security.debian.org/ testing/updates main contrib non-free
deb-src http://security.debian.org/ testing/updates main contrib non-free

# Джерело пакунків з гілки Дебіен „unstable“
deb http://http.us.debian.org/debian/ unstable main contrib non-free
deb-src http://http.us.debian.org/debian/ unstable main contrib non-free

4) Встановлення пакунків з гілки „testing“

sudo apt-get update


sudo apt-get -t testing install \
libarchive-extract-perl \
libmarc-record-perl \
libmarc-xml-perl

=== Пакунки з репозитарію Koha ===

Деякі perl-пакунки ще не пакетизовані в офіційних репозитаріях Дебіен (перевіряємо [http://packages.debian.org/uk/wheezy/libdata-paginator-perl libdata-paginator-perl] та
[http://packages.debian.org/uk/wheezy/libtemplate-plugin-htmltotext-perl libtemplate-plugin-htmltotext-perl], [http://packages.debian.org/uk/wheezy/libmodule-bundled-files-perl libmodule-bundled-files-perl]). Однак відповідні deb-пакети можна знайти в
репозитарії [http://debian.koha-community.org/ debian.koha-community.org].

Підключаємо у файлі '''/etc/apt/sources.list'''
# Джерело пакунків з Дебіен-репозитарію „debian.koha-community.org“
deb http://debian.koha-community.org/koha squeeze main

Також додаємо ключ gpg.asc до довірених ключів APT:
wget -O- http://debian.koha-community.org/koha/gpg.asc | sudo apt-key add -

Оновлюємо список доступних для встановлення пакунків
apt-get update

Встановлюємо пакунки з репозитарію Koha

sudo apt-get install \
libdata-paginator-perl \
libtemplate-plugin-htmltotext-perl \
libmodule-bundled-files-perl

=== Пакунки з CPAN ===

Якщо пакунок все таки не вдалося знайти в одному з репозитаріїв — встановлюємо з CPAN.

Наприклад, можуть бути й зауваження такого роду:

Warning: prerequisite Data::Pagination 0.44 not found.

Цей Perl-модуль ще не доступний в жодному з репозиторіїв Дебіен (перевірити в Debian: [https://packages.debian.org/search?keywords=libdata-pagination-perl&searchon=names&suite=all&section=all libdata-pagination-perl]). Встановлюємо командою

sudo perl -MCPAN -e 'install Data::Pagination'

(при цьому, якщо це перше використання CPAN, підтверджуємо автоматичне налаштування та підключення до Інтернет)

Для таких зауважень

HTTPD::Bench::ApacheBench 0 0.73 No
Test::WWW::Mechanize 1.42 1.44 No

Перевіряємо [https://packages.debian.org/search?keywords=Test-WWW-Mechanize&searchon=names&suite=all&section=all libtest-www-mechanize-perl] чи з’явився пакунок Test::WWW::Mechanize версії 1.44 чи вище.
Також перевіряємо наявність пакунка [https://packages.debian.org/search?suite=all&section=all&arch=any&searchon=names&keywords=HTTPD-Bench-ApacheBench libHTTPD-Bench-ApacheBench-perl].

— встановлюємо

sudo perl -MCPAN -e 'install HTTPD::Bench::ApacheBench'
sudo perl -MCPAN -e 'install Test::WWW::Mechanize'

Чомусь є ще зауваження про пакунок Readonly::XS, хоча він і повинен бути встановлений командами вище (?).

== Налаштування пакунків ==
=== Apache ===

1) Модулі

Задіюємо модуль Rewrite
sudo a2enmod rewrite

а також модулі Expires та Deflate
sudo a2enmod expires
sudo a2enmod deflate

2) Редагуємо /etc/apache2/conf.d/charset

AddCharset UTF-8 .utf8
AddDefaultCharset UTF-8

3) Перезапуск Apache
sudo /etc/init.d/apache2 restart

=== MySQL ===

1) Пароль для користувача root БД MySQL: ПарольАдмінаMySQL

Якщо пароль не вибрано при встановленні MySQL, то змінити можна так

sudo dpkg-reconfigure mysql-server-5.5

2) Для підтримки UTF-8 у MySQL у файлі /etc/mysql/my.cnf (в кінці) має бути наступне

[mysqld]
init-connect='SET NAMES utf8, collation_connection=utf8_unicode_ci'
character-set-server=utf8
collation-server=utf8_unicode_ci
character_set_client=utf8
skip-character-set-client-handshake

3) Перезапускаємо сервер MySQL
sudo /etc/init.d/mysql restart

4) Переконуємося, що зміни внесені, виконавши
sudo mysql -uroot -pПарольАдмінаMySQL
show variables;
quit

= Встановлення Koha =

Вхід від користувача АдміністраторСистемиKoha

Переходимо у середовище користувача АдміністраторСистемиKoha (вводимо пароль користувача АдміністраторСистемиKoha)

su АдміністраторСистемиKoha
cd ~/

== Отримання Koha ==

1) Для отримання останньої стабільної Koha — звантажуємо її з http://download.koha-community.org

mkdir ~/koha; wget -O ~/koha/koha-latest.tar.gz http://download.koha-community.org/koha-latest.tar.gz

2) Розпаковування архіву

cd ~/koha; tar -xzf koha-latest.tar.gz

=== Створення БД для Koha в MySQL ===

Утворюємо базу даних Koha3 та привілеї користувачів щодо неї:

sudo mysqladmin -uroot -pПарольАдмінаMySQL create Koha3
sudo mysql -uroot -pПарольАдмінаMySQL

У середовищі mysql виконати наступне

grant all on Koha3.* to 'КористувачБДKoha3'@'localhost' identified by 'ПарольКористувачаБДKoha3';\
flush privileges;
exit

=== Перевірка аналізатора SAX Parser ===

У теці Koha виконати

perl ~/koha/koha-3.16.03/misc/sax_parser_print.pl

Ви повинні побачити щось таке

XML::LibXML::SAX::Parser=HASH(0x81fe220)

Якщо ж є PurePerl чи Expat, то необхідно поправити файл /etc/perl/XML/SAX/ParserDetails.ini (запис щодо XML::LibXML::SAX::Parser має бути найнижче)

=== Перевірка чи встановлені усі необхідні пакунки ===

Команда

perl ~/koha/koha-3.16.03/koha_perl_deps.pl -c -u -m

видасть список відсутніх модулів та модулів, які необхідно оновити.

Вам необхідно знайти та встановити ці модулі (ймовірно, що список буде порожнім, оскільки всі необхідні пакунки повинні згадуватися у цьому керівництві вище).

Відсутні модулі чи оновлені версії шукайте у гілках Debian testin/unstable, репозитарії debian.koha-community.org або ж в CPAN (Perl-модулі з CPAN встановлюються командою на кшталт „sudo cpan HTTP::OAI“).

== Запуск встановлювача ==

Запускаємо встановлювач (у наступній команді вказуємо власні дані)

cd ~/koha/koha-3.16.03/

INSTALL_BASE=/usr/share/koha3 \
KOHA_USER=АдміністраторСистемиKoha \
KOHA_GROUP=АдміністраторСистемиKoha \
DB_NAME=Koha3 \
DB_USER=КористувачБДKoha3 \
DB_PASS=ПарольКористувачаБДKoha3 \
ZEBRA_MARC_FORMAT=unimarc \
ZEBRA_TOKENIZER=icu \
ZEBRA_LANGUAGE=uk \
ZEBRA_USER=КористувачZebra \
ZEBRA_PASS=ПарольКористувачаZebra \
INSTALL_PAZPAR2=yes \
INSTALL_SRU=yes \
INSTALL_ZEBRA=yes \
USE_MEMCACHED=yes \
perl Makefile.PL

Відповідаємо на питання:

=== Відповіді на питання ===

By default, Koha can be installed in one of three ways:

'''standard''': Install files in conformance with the Filesystem Hierarchy Standard (FHS). This is the default mode and should be used when installing a production Koha system. On Unix systems, root access is needed to complete a standard installation.

'''single''': Install files under a single directory. This option is useful for installing Koha without root access, e.g., on a web host that allows CGI scripts and MySQL databases but requires the user to keep all files under the user's HOME directory.

'''dev''': Create a set of symbolic links and configuration files to allow Koha to run directly from the source distribution. This mode is useful for developers who want to run Koha from a git clone.

Installation mode (dev, single, standard) ['''standard''']

Please specify the directory under which most Koha files
will be installed.

Note that if you are planning in installing more than
one instance of Koha, you may want to modify the last
component of the directory path, which will be used
as the package name in the FHS layout.

Base installation directory (default from environment) ['''/usr/share/koha3''']

Since you are using the 'standard' install
mode, you should run 'make install' as root.
However, it is recommended that a non-root
user (on Unix and Linux platforms) have
ownership of Koha's files, including the
Zebra indexes if applicable.

Please specify a user account. This
user account does not need to exist
right now, but it needs to exist
before you run 'make install'. Please
note that for security reasons, this
user should not be the same as the user
account Apache runs under.

User account (default from environment) ['''АдміністраторСистемиKoha''']

Please specify the group that should own
Koha's files. As above, this group need
not exist right now, but should be created
before you run 'make install'.

Group (default from environment) ['''АдміністраторСистемиKoha''']

Please specify which database engine you will use
to store data in Koha. The choices are MySQL and
PostgreSQL; please note that at the moment
PostgreSQL support is highly experimental.

DBMS to use (Pg, mysql) ['''mysql''']

Please specify the name or address of your
database server. Note that the database
does not have to exist at this point, it
can be created after running 'make install'
and before you try using Koha for the first time.

Database server ['''localhost''']

Please specify the port used to connect to the
DMBS ['''3306''']

Please specify the name of the database to be
used by Koha (default from environment) ['''Koha3''']

Please specify the user that owns the database to be
used by Koha (default from environment) ['''КористувачБДKoha3''']

Please specify the password of the user that owns the
database to be used by Koha (default from environment) ['''ПарольКористувачаБДKoha3''']

Koha can use the Zebra search engine for high-performance
searching of bibliographic and authority records. If you
have installed the Zebra software and would like to use it,
please answer 'yes' to the following question. Otherwise,
Koha will default to using its internal search engine.

Please note that if you choose *NOT* to install Zebra,
koha-conf.xml will still contain some references to Zebra
settings. Those references will be ignored by Koha.

Install the Zebra configuration files? (no, yes) ['''yes''']

Found 'zebrasrv' and 'zebraidx' in /usr/bin.

Since you've chosen to use Zebra with Koha,
you must specify the primary MARC format of the
records to be indexed by Zebra.

Koha provides Zebra configuration files for MARC 21
and UNIMARC.

MARC format for Zebra indexing (marc21, normarc, unimarc) (default from environment) ['''unimarc''']

Koha supplies Zebra configuration files tuned for
searching either English (en) or French (fr) MARC
records.

Primary language for Zebra indexing (en, es, fr, nb, ru, uk) (default from environment) ['''uk''']

Koha can use one of two different indexing modes
for the MARC bibliographic records:

grs1 - uses the Zebra GRS-1 filter, available for legacy support
dom - uses the DOM XML filter; offers improved functionality.

Bibliographic indexing mode (dom, grs1) ['''dom''']

Koha can use one of two different indexing modes
for the MARC authorities records:

grs1 - uses the Zebra GRS-1 filter, available for legacy support
dom - uses the DOM XML filter; offers improved functionality.

Authorities indexing mode (dom, grs1) ['''dom''']

Zebra has two methods to perform records tokenization
and characters normalization: CHR and ICU. ICU is
recommended for catalogs containing non-Latin
characters. (chr, icu) (default from environment) ['''icu''']

Please specify Zebra database user (default from environment) ['''КористувачZebra''']

Please specify the Zebra database password (default from environment) ['''ПарольКористувачаZebra''']

Since you've chosen to use Zebra, you can enable the SRU/
Z39.50 Server if you so choose, but you must specify a
few configuration options for it.

Please note that if you choose *NOT* to configure SRU,
koha-conf.xml will still contain some references to SRU
settings. Those references will be ignored by Koha.

Install the SRU configuration files? (no, yes) ['''yes''']

SRU Database host? ['''localhost''']

SRU port for bibliographic data? ['''9998''']

SRU port for authority data? ['''9999''']

Since you've chosen to use Zebra, you can also choose to
install PazPar2, which is a metasearch tool. With PazPar2,
Koha can perform on-the-fly merging of bibliographic
records during searching, allowing for FRBRization of
the results list.

Install the PazPar2 configuration files? (default from environment) ['''yes''']

Zebra bibliographic server host? ['''localhost''']

Zebra bibliographic port for PazPar2 to use? ['''11001''']

PazPar2 host? ['''localhost''']

PazPar2 port? ['''11002''']

Use memcached and memoize to cache the results of some function calls?
This provides a signficant performance improvement.
You will need a Memcached server running. (no, yes) [no] '''yes'''

Memcached server address? ['''127.0.0.1:11211''']

Memcached namespace? ['''KOHA''']

Would you like to run the database-dependent test suite? (no, yes) ['''no''']

До речі, якщо Ви помилитеся, чи побачите наприкінці що ще не всі залежності задоволені, то можете поправити файл Makefile.PL, внісши в нього відповіді

Після завершення опитування Koha виводить список усіх параметрів.

== Компіляція та встановлення Koha ==

make

(тут не повинно бути помилок чи зауважень)

make test

Тут з’являються результати тестування — більшість мають проходити успішно (ок), в результаті повинні отримати — „'''Result: PASS'''“.

Власне встановлення:

sudo make install

== Доналаштування Apache ==

=== Віртуальні хости Apache ===

1) Підключаємо до Apache2 конфігурацію для Koha

sudo ln -s /etc/koha3/koha-httpd.conf /etc/apache2/sites-available/Koha3
sudo a2ensite Koha3

2) Додаємо порти до /etc/apache2/ports.conf

Listen 80
Listen 8888
Listen 8008

Зауваження: деколи порт 80 може бути зайнятий на даному IP/домені — тоді тут і нижче тимчасово замінити порт 80 на 8008.

3) Також підправляємо порти у файлі /etc/koha3/koha-httpd.conf на зразок

<VirtualHost '''*:80'''>
...
ServerName koha:'''80'''
...
<VirtualHost '''*:8888'''>
...
ServerName koha:'''8888'''

4) Якщо стандартний порт 80 не використовується на даному сервері, переправляємо типовий сервер-заглушку на порт 8008, редагуючи файл /etc/apache2/sites-enabled/000-default

<VirtualHost '''*:8008'''>
...

5) Перезапускаємо веб-сервер Apache 2

sudo /etc/init.d/apache2 restart

== Сервер Zebra ==

Для підтримки автозапуску сервера Zebra виконуємо наступне

sudo ln -s /usr/share/koha3/bin/koha-zebra-ctl.sh /etc/init.d/koha-zebra-daemon
sudo update-rc.d koha-zebra-daemon defaults
sudo /usr/share/koha3/bin/koha-zebra-ctl.sh start

== Підтримка кирилиці рушієм пошуку Zebra ==

Необхідно додати кириличні символи до файлу

/etc/koha3/zebradb/etc/word-phrase-utf.chr

а саме виправити на наступне:

lowercase {0-9}{a-z}æäåąßćęłńóśøöüźżабвгдежзийклмнопрстуфхцчшщьыъэюяёєїґўі’
uppercase {0-9}{A-Z}ÆÄÅĄẞĆĘŁŃÓŚØÖÜŹŻАБВГДЕЖЗИЙКЛМНОПРСТУФХЦЧШЩЬЫЪЭЮЯЁЄЇҐЎІ’

space {\001-\040}!"#$%&'\()*+,-./:;<=>?@\[\\]^_`\{|}~{\x88-\x89}{\x98-\x9C}

Без цієї зміни пошук або не буде працювати або даватиме некоректні результати.

Також для коректного сортування кирилиці аналогічні зміни також потрібно внести і до файлу
/etc/koha3/zebradb/lang_defs/en/sort-string-utf.chr (наявність uk/sort-string-utf.chr наразі не дає бажаного результату).

== Налаштування переіндексації за розкладом (cron) ==

Додаємо з допомогою команди

sudo crontab -e -u АдміністраторСистемиKoha

наступне завдання (коректуємо дані відповідно попередньо заданих у встановлювачі)

# Поновлення індексації Zebra - що 5 хвилин
*/5 * * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -b -a -z -v >/dev/null

# Повна переіндексація Zebra - опівночі
0 0 * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -b -a -r -x -v >/dev/null

Зауваження: також варто перевірити дію цього завдання і з консолі для певності що буде виконуватися коректно - створимо два скрипти:

1) add_zebra_new_records.sh

time env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib \/usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -b -a -z -v

2) rebuild_zebra_all_records.sh

time env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -b -a -r -x -v

Якщо при виконанні будуть наступні помилки:

10:29:41-11/08 zebraidx(29193) [warn] zebra_lock_create fail fname=/var/lock/koha3/zebradb/biblios/norm..LCK [No such file or directory]
10:29:41-11/08 zebraidx(29193) [warn] zebra_lock_create fail fname=/var/lock/koha3/zebradb/biblios/shadow..LCK [No such file or directory]

то

cd /var/lock/koha3/
mkdir zebradb
chmod ugoa+r+w+x zebradb
cd zebradb/
mkdir biblios
chmod ugoa+r+w+x biblios

== Інші періодичні завдання (cron) ==

1) Періодичне створення ієрархічної класифікації та хмари міток (для класифікацій необхідно правити [http://git.koha-community.org/gitweb/?p=koha.git;a=blob;f=misc/cronjobs/build_browser_and_cloud.pl;hb=HEAD build_browser_and_cloud.pl] та [http://git.koha-community.org/gitweb/?p=koha.git;a=blob;f=opac/opac-browser.pl;hb=HEAD opac-browser.tmpl], детальніше див. [http://wiki.taltek.info//%D0%9E%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha,_%D0%B2%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BE%D1%97_%D0%B7_%D0%B4%D0%B6%D0%B5%D1%80%D0%B5%D0%BB%D0%B0#.D0.92.D1.96.D0.B4.D0.BD.D0.BE.D0.B2.D0.BB.D0.B5.D0.BD.D0.BD.D1.8F_.D0.BD.D0.B0.D0.BB.D0.B0.D1.88.D1.82.D1.83.D0.B2.D0.B0.D0.BD.D0.BD.D1.8F_.D0.B7.D0.B0_.D0.BA.D0.BB.D0.B0.D1.81.D0.B8.D1.84.D1.96.D0.BA.D0.B0.D1.86.D1.96.D1.94.D1.8E тут])

# Створення ієрархічної класифікації (приклад для УДК (3 ділення) та Unimarc) та хмари міток - щоночі о 1-шій
0 1 * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/cronjobs/build_browser_and_cloud.pl -b -f 675a -t 606 -c -m 3

2) Періодичне очищення таблиць „sessions“ та „zebraqueue“

# Очищення таблиць „sessions“ та „zebraqueue“ в Koha - щоночі о 2-гій
0 2 * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/cronjobs/cleanup_database.pl --sessdays 7 --zebraqueue 7

3) Періодичний підрахунок найбільш популярних одиниць

# Підрахунок найбільш популярних одиниць - щоночі о 3-тій
0 3 * * * env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib /usr/share/koha3/bin/cronjobs/update_totalissues.pl --use-items --commit=1000 -v

== Запуск веб-встановлювача ==

У веб-оглядачі вводимо адресу нашого сервера

http://localhost:8080?language=uk-UA

(повинно з’явитися запрошення для входу в систему і подальшого встановлення)

Проте, наразі не продовжуємо, бо в джерельних кодах не доступні локазовані шаблони для інших мов окрім англійської.
Шаблони для української, російської і т.д. необхідно згенерувати.

== Утворення локалізованих шаблонів ==

Переходимо у теку сценаріїв локалізації Коха

cd /usr/share/koha3/misc/translator

та запускаємо утворення локалізованих шаблонів тощо для кожної мови

sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install uk-UA
sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib "./translate" install ru-RU
... і для інших необхідних мов (окрім „en“)

== Підготовка локалізованих sql-таблиць (у роботі) ==

Актуальні локалізовані SQL-таблиці (у [https://www.dropbox.com/referrals/NTE4MzAyOTY5?src=global9 DrobBox] Сергія Дубика) '''українською''' знаходяться за адресою:

https://www.dropbox.com/sh/nybt54x8yhh7frq/AACfsG32sJnBgNh1CdivXDjYa?dl=0

Звантажуємо звідси найновішу версію теки '''uk-UA''' та замінюємо нею відповідну теку у '''/usr/share/koha/intranet/cgi-bin/installer/data/mysql'''.

Примітка: локалізація SQL-таблиць російською '''ru-RU''' доступна лише для версії 3.4.х.

Після цього необхідно перезавантажити сервер (веб-встановлювач чомусь вперто не помічав інші мови окрім англійської).

== Кроки веб-встановлювача ==

Далі продовжуємо у веб-оглядачі

http://localhost:8080?language=uk-UA

Реєструємося (згадуємо логін АдміністраторСистемиKoha та пароль ПарольАдміністратораСистемиKoha)

Крок 1.

* Вибір мови: uk-UA
* Перевірка встановлених залежностей (пакунки)

Крок 2.

* Вивід налаштувань БД
* Перевірка існування БД '''Koha3''' та привілеїв доступу користувача '''АдміністраторСистемиKoha'''

Крок 3.

* Підготовка таблиць
* Створення таблиць
* Підготовка базового налаштування
* Вибір стандарту МАРК-записів: Unimarc
* Вибір sql-таблиць для імпорту — вибрати усі

Нижче наведений перелік типових таблиць з теки „uk-UA“ при виборі МАРК-структури: UNIMARC

'''Mandatory'''
Авторитетні записи — типова структура за УКРМАРК (поля, підполя).
(unimarc_authorities_DEFAULT_general)
Бібліографічні записи — типова структура за УКРМАРК (загальні поля, підполя).
(unimarc_bibliographic_DEFAULT_general)
Бібліографічні записи — типова структура в доповнення до УКРМАРК (локальні поля, підполя на основі 995).
(unimarc_bibliographic_DEFAULT_local)
Коди відношення (використовуються для визначення виду інтелектуальної відповідальності).
(unimarc_relatorterms)
Системні параметри, пов’язані з UNIMARC (УКРМАРК).
(unimarc_system_preferences)

'''Optional'''
Авторитетні записи — структура „Auteur (collectif/collectivité)“ ([210a ][ (210c)][. 210b][ -- 210d][ ; 210e][ ; 210f]) за Unimarc (загальні поля/підполя).
(unimarc_authorities_CO_general)
Авторитетні записи — структура „Auteur“ ([200a][, 200b][ 200d][ ; 200c][ (200f)]) за Unimarc (загальні поля/підполя).
(unimarc_authorities_NP_general)
Авторитетні записи — структура „Auteur titre“ ([240a][, 240b][ 240d][ ; 240c][ (240f)][. 240t]) за Unimarc (загальні поля/підполя).
(unimarc_authorities_SAUTTIT_general)
Авторитетні записи — структура „Sujet (auteur)“ ([200a][, 200b][(200g)][ 200d][ ; 200c][ (200f)][ -- 200x][ -- 200z][ -- 200y]) за Unimarc (загальні поля/підполя).
(unimarc_authorities_SAUT_general)
Авторитетні записи — структура „Sujet (collectivité)“ ([210a ][ (210c)][. 210b][ -- 210d][ ; 210e][ ; 210f][ -- 210x][ -- 210z][ -- 210y]) за Unimarc (загальні поля/підполя).
(unimarc_authorities_SCO_general)
Авторитетні записи — структура „Sujet (nom commun)“ ([250a][ -- 250x][ -- 250y][ -- 250z] [(250b)]) за Unimarc (загальні поля/підполя).
(unimarc_authorities_SNC_general)
Авторитетні записи — структура „Sujet (nom géographique)“ ([215a][ -- 215y][ -- 215x][ -- 215z]) за Unimarc (загальні поля/підполя).
(unimarc_authorities_SNG_general)
Авторитетні записи — структура „Sujet (titre uniforme)“ ([230a][. 230i][. 230h][. 230m][. 230k][ -- 230x][ -- 230q][ -- 230y][ -- 230z][ -- 230l]) за Unimarc (загальні поля/підполя).
(unimarc_authorities_STU_general)
Авторитетні записи — структура „Titre Uniforme“ ([230a][. 230i][. 230h][. 230m][. 230q][. 230k][ -- 230x][ -- 230y][ -- 230z][ -- 230l]) за Unimarc (загальні поля/підполя).
(unimarc_authorities_TU_general)
Аналітичні описи (AN) — структура (загальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_AN_general)
Аналітичні описи (AN) — структура (локальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_AN_local)
Аудіоматеріали (AUD) — структура (загальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_AUD_general)
Аудіоматеріали (AUD) — структура (локальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_AUD_local)
Книги (монографічні видання) (BOOK) — структура (загальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_BOOK_general)
Книги (монографічні видання) (BOOK) — структура (локальні поля, підполя) бібліографічних записів. (unimarc_bibliographic_BOOK_local)
Електронні видання (EL) — структура (загальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_EL_general)
Електронні видання (EL) — структура (локальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_EL_local)
Рівень мінімального опису (MIN) — структура (загальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_MIN_general)
Рівень мінімального опису (MIN) — структура (локальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_MIN_local)
Нотні видання (NOTE) — структура (загальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_NOTE_general)
Нотні видання (NOTE) — структура (локальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_NOTE_local)
Періодика (серіальні видання) (PER) — структура (загальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_PER_general)
Періодика (серіальні видання) (PER) — структура (локальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_PER_local)
Нормативно-технічні та неопубліковані матеріали (TECH) — структура (загальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_TECH_general)
Нормативно-технічні та неопубліковані матеріали (TECH) — структура (локальні поля, підполя) бібліографічних записів.
(unimarc_bibliographic_TECH_local)
Деякі правила відповідності для бібліографічних записів у форматах UNIMARC/УкрМарк, у тому числі:
ISBN
ISSN.
(unimarc_default_matching_rules)
Зразки записів Unimarc/Укрмарк — таблиця „biblio“ (біб-опис).
(unimarc_sample_biblio_data)
Зразки записів Unimarc/Укрмарк — таблиця „biblioitems“ (біб-опис).
(unimarc_sample_biblioitems_data)
Зразки записів Unimarc/Укрмарк — таблиця „items“ (примірники).
(unimarc_sample_items_data)

'''Інші дані
Authorised_values'''
Особливі нотатки щодо відвідувача.
(authorised_values_[BOR_NOTES])
Коди видів зібрань для примірників.
(authorised_values_[CCODE])
Перелік країн.
(authorised_values_[COUNTRY])
Статус пошкодження примірника.
(authorised_values_[DAMAGED])
Індикатори поля 852. (authorised_values_[IND_852])
Перелік мов.
(authorised_values_[LANG])
Кваліфікації розміщення примірників, областей що пов’язані по умовчанню з items.location.
(authorised_values_[LOC])
Статуси доступності.
(authorised_values_[LOST])
Типи ручних рахунків.
(authorised_values_[MANUAL_INV])
Статус можливості випозичання примірника, пов’язаний з items.notforloan.
(authorised_values_[NOT_LOAN])
Причини читацьких пропозицій в ЕК.
(authorised_values_[OPAC_SUG])
Статус обмеження доступу до примірника, зв’язаний з items.restricted.
(authorised_values_[RESTRICTED])
Перелік STACK.
(authorised_values_[STACK])
Підстави для прийняття або відхилення пропозицій на придбання. (authorised_values_[SUGGEST])
Статус приховування біб-запису в електронному каталозі. (authorised_values_[SUPPRESS])
Статус вилучення примірника, зв’язаний з items.wthdrawn.
(authorised_values_[WITHDRAWN])

'''Mandatory'''
Типові системні авторитетні значення Koha.
(auth_values)
Типові класифікаційні джерела та правила заповнення.
(class_sources)
Означення типових способів повідомлень з допомогою електронної пошти та SMS.
(message_transport_types)
Типові позначки про привілеї користувача та деталізовані привілеї для працівників бібліотеки.
(permissions_and_user_flags)
Зразок сповіщень.
(sample_notices)
Означення повідомлень по умовчанню для заборгованих примірників, завчасних сповіщень та майбутніх бібліотечних подій.
(sample_notices_message_attributes)
Означення типових повідомляльних транспортів для повідомлень про заборговані примірники, завчасних сповіщень а також повідомлення про бібліотечні події з допомогою електронної пошти та SMS.
(sample_notices_message_transports)
Несуттєві для пошуку українські слова. Ви можете коригувати їх після встановлення.
(stopwords)
Підтримка інтернаціоналізації (I18N) в Koha.
Підтримка двонаправленого (BIDI) письма, арабська та іврит.
Стандартне відображення між письмом та підкодами мови.
Розширення мови.
(subtag_registry)
Типові системні параметри Koha для України і т.п. (окрім МАРК-специфіки).
(system_preferences)

'''Optional'''
Приклади бібліотек, підрозділів та групувань за властивостями та пошуковими областями.
(example_branches)
Офіційні повторювальні свята в Україні.
(holidays)
Набір типів одиниць за умовчанням (типи матеріалів та коди зібрань).
(library_item_types)
Додаткові атрибути відвідувачів (паспортні дані, освіта тощо).
(patron_atributes)
Типові категорії відвідувачів.
(patron_categories)
Приклад бібліотечного персоналу („супербібліотекар“, „каталог“, „обіг“, „відвідувач“, „періодика“, „надходження“).
(sample_borrowers_staff)
Зразок річного кошторису, підпорядкованих коштів та планування витрат.
(sample_budgets)
Міста — обласні центри України.
(sample_cities)
Приклади шаблонів наклейок та читацьких карток.
(sample_creator_data)
Приклади курсів валют.
(sample_currency)
Приклад новин для ЕК та Б.І.
(sample_news)
Цитати, афоризми, приказки тощо.
(sample_quotes)
Підбірка sql-звітів.
(sample_saved_sql_reports)
Приклади пропозицій для комплектування.
(sample_user_suggestions)
Добірка серверів Z39-50 (UNIMARC, Rusmarc, UkrMarc …).
(z39-50servers_collection)

Продовжуємо…

* Імпорт sql-таблиць

На 3 кроці слідкуємо за помилками при імпорті типових даних. Якщо є помилки — знаходимо відповідні sql-файли, виправляємо їх та імпортуємо вручну (напр., через phpmyadmin). Також повідомляйте про sql-помилки Сергія Дубика, serhijdubykЖАБКАgmail.com.

'''Встановлення завершено.'''

== Додатково ==

=== Зауваження щодо ICU ===
Див. [http://wiki.tntu.edu.ua/%D0%9E%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_Koha,_%D0%B2%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BE%D1%97_%D0%B7_%D0%B4%D0%B6%D0%B5%D1%80%D0%B5%D0%BB%D0%B0#.D0.97.D0.B0.D1.83.D0.B2.D0.B0.D0.B6.D0.B5.D0.BD.D0.BD.D1.8F_.D1.89.D0.BE.D0.B4.D0.BE_ICU тут]

=== Переіндексація БД ===

sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib \
/usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -b -r -x -v

sudo -u АдміністраторСистемиKoha env KOHA_CONF=/etc/koha3/koha-conf.xml PERL5LIB=/usr/share/koha3/lib perl -I /usr/share/koha3/lib \
/usr/share/koha3/bin/migration_tools/rebuild_zebra.pl -a -r -v

=== Перевірка пошуку ===

У типових даних є декілька біб-записів й примірників. Перевіряємо пошук за словами

'''Україна''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Україна)

'''Інвестиції''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=Інвестиції)

'''2011''' (http://localhost:80/cgi-bin/koha/opac-search.pl?q=2011)

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування Koha, встановленої з джерела]].

= Див. також =

* [[Налаштування Koha, встановленої з джерела]]
* [[Оновлення Koha, встановленої з джерела]]
* [[Вилучення Koha, встановленої з джерела]]
* [[Встановлення Koha з репозитарію на ОС Debian]]
* [[Коротка інструкція для адміністратора АБІС Koha]]
* [[Короткий посібник користувача АБІС Koha]]

[[Категорія:АБІС Koha]]
[[Категорія:Бібліотека]]

Встановлення ОС Debian Linux

2018-12-26T11:44:56Z

Dubyk: /* Завантаження з образу */

Стисло про встановлення ОС Debian GNU/Linux…

Детальніше про [http://uk.wikipedia.org/wiki/Debian ОС Debian GNU/Linux на Вікіпедії] та сайті [http://www.debian.org/index.uk.html debian.org].

= Встановлення Debian GNU/Linux 8 Jessie (8.4.0, amd64) =

Розглядатиметься поточна стабільна версія Debian GNU/Linux 8 Wheezy (8.3.0, amd64)…

== Отримання образів CD/DVD ==

1) Образи CD:

http://cdimage.debian.org/debian-cd/current/amd64/iso-cd/

зокрема для встановлення необхідний хоча б 1 CD:

http://cdimage.debian.org/debian-cd/current/amd64/iso-cd/debian-8.4.0-amd64-CD-1.iso

або

2) Образи DVD:

http://cdimage.debian.org/debian-cd/current/amd64/iso-dvd/

для встановлення необхідний хоча б 1 DVD:

http://cdimage.debian.org/debian-cd/current/amd64/iso-dvd/debian-8.4.0-amd64-DVD-1.iso

3) Варіант образу „netinst“ (біля 180Мб) для встановлення через мережу:

http://cdimage.debian.org/debian-cd/8.4.0/amd64/iso-cd/debian-8.4.0-amd64-netinst.iso

(детальніше — http://www.debian.org/CD/netinst/)

== Запис образів на CD/DVD/USB ==

На CD/DVD записати можна з допомогою [https://www.debian.org/CD/faq/#record-unix K3B чи іншого ПЗ].

На флешку iso-образи можна записати напр. [https://www.altlinux.org/%D0%97%D0%B0%D0%BF%D0%B8%D1%81%D1%8C_%D0%BE%D0%B1%D1%80%D0%B0%D0%B7%D0%BE%D0%B2_%D0%BD%D0%B0_DVD_%D0%B8_USB_Flash#.D0.97.D0.B0.D0.BF.D0.B8.D1.81.D1.8C_.D0.BD.D0.B0.D0.BF.D1.80.D1.8F.D0.BC.D1.83.D1.8E_.D1.87.D0.B5.D1.80.D0.B5.D0.B7_dd так] (увага: UNetbootin, Rufus та UltraISO не використовувати, запорчують встановлення).

lsblk | grep disk
pv debian-8.6.0-amd64-DVD-1.iso | dd oflag=direct of=/dev/sdc bs=1M;sync
eject /dev/sdc

(перевіряти пристрої дисків, щоб не затерти власний жорсткий диск!!!)

== Завантаження з образу ==

Виставити в BIOS завантаження з пристрою компакт-дисків чи з USB-флешки.

== Кроки встановлення ==

На початку завантаження встановлювального образу (DVD/CD/USB) в меню вибрати „'''Graphical install'''“.

„''Select language''“ — вибираємо „'''Ukrainian - Українська'''“.

„''Виберіть ваше місце розташування''“ — '''Україна'''.

„''Налаштувати клавіатуру''“ » Розкладка клавіатури: Українська.

„''Метод перемикання між національною та латинською розкладкою''“: '''Control+Shift'''.

Інколи потрібна прошивка для специфічного обладнання.
Напр., якщо згадується:
''Відсутні файли вбудованого програмного забезпечення: rtl_nic/rtl8168e-2.fw''
то необхідно довстановити пакунок
https://packages.debian.org/jessie/firmware-realtek

Тут мало б бути про налаштування мережі, наразі пропускаємо.

„''Введіть назву цього комп’ютера''“:

Назва комп’ютера: (типово '''debian''', вказуємо свою, латиницею).

''Назва домену'': (вказуємо свою)

Назва домену — це частина вашої Інтернет-адреси, справа від назви комп’ютера.

Налаштувати користувачів та паролі

''Пароль користувача root'': (вибираємо складний пароль)

''Повторіть ввід паролю для перевірки'':

''Повне ім’я нового користувача'': (просто ім’я нового користувача, не логін)

''Назва облікового запису'': (вибираємо логін для нового користувача)

''Введіть пароль для нового користувача'': (…)

''Розбити диски на розділи'': '''Вручну'''

Необхідно вибрати принаймні 2 розділи

- розділ „'''/'''“, ф.с. '''Ext4''', форматувати

- розділ '''swap''' (розмір приблизно подвійному розмірі оперативної пам’яті)

''Записати зміни на диски'': '''Так'''

''Встановлення базової системи'' триває деякий час (~ 5 хв.).

Налаштувати менеджер пакунків

''Використовувати джерело в мережі?'' '''Так'''

''Країна дзеркала архіву Debian'': '''Україна'''

''Дзеркальний сервер Debian'': '''ftp.ua.debian.org'''

''Інформація про HTTP-проксі'': (залишаємо порожнім)

Налаштування popularity-contest

''Приймати участь в опитуванні про використання пакунків?'' '''Так'''

Вибір програмного забезпечення

''Виберіть програмне забезпечення для встановлення'':

+ '''Debian desktop environment'''

+ '''GNOME'''

- Xfce

- KDE

- Cinnamon

- MATE

- LXDE

- web server

- print server

- SSH server

+ '''Стандартні системні утиліти'''

(веб-сервер та інші сервіси встановлювати зразу непотрібно, графічне середовище для роботи сервера не потрібне, однак можна встановити для зручності — браузер, робота з файлами, настройки через GUI)

„''Вибрати та встановити програмне забезпечення''“ триває деякий час (~10-ки хв.).

Встановити завантажувач GRUB на жорсткий диск

''Встановити завантажувач GRUB у головний завантажувальний запис?'' '''Так'''

''Пристрій для встановлення системного завантажувача:'' (вибираємо потрібний пристрій)

'''Встановлення завершено!'''

''Нотатки'': Бажано мати підключення до інтернет і вказати по ходу IP та інші мережеві параметри...(це дозволить встановити зразу ж оновлення, також потрібно якщо було вибрано netinst-встановлення)...
... якщо є RAID, програмний чи апаратний, див. https://wiki.debian.org/SataRaid, https://wiki.debian.org/DebianInstaller/SataRaid, https://www.debian.org/releases/stable/amd64/ch06s03#partman-fs, https://wiki.debian.org/LinuxRaidForAdmins, http://www.it-35.ru/linux-world/124-sozdanie-programmnogo-raid-v-processe-ustanovki-debian.html

== SSH ==

apt-get install ssh

Надалі встановлення пакунків та налаштування системи можна продовжувати віддалено через ssh

== Корисні утиліти ==

apt-get install bzip2 pbzip2 zip mc screen lynx htop

== Sudo ==

Делегування повноважень супер-користувача для користувача (напр. sysadmin)

apt-get install sudo

Та у файлі /etc/sudoers (відкрити в редакторі, напр, командою mc -e /etc/sudoers, див. також http://debianforum.ru/index.php?topic=5571.0)

sysadmin ALL=(ALL:ALL) ALL



= Див. також =

* [[Оновлення ОС Debian Linux]]
* [[Налаштування Debian та Gnome]]

= Посилання =
* [https://www.debian.org/releases/stable/amd64/ Руководство по установке Debian GNU/Linux]
* [http://cdimage.debian.org/cdimage/unofficial/non-free/cd-including-firmware/ Неофіційні non-free образи, включаючи прошивки]

[[Категорія:Linux]]

Оновлення DSpace

2017-10-26T11:53:23Z

Dubyk: /* Див. також */

Оновлення DSpace

= Оновлення DSpace 1.5.2 » 5.6 =

Якщо різниця між версіями DSpace значна, рекомендується [[Встановлення DSpace на ОС Debian|встановити DSpace начисто]] та перенести БД і сховище.

== Архівування старої БД і сховища ==

Дії проводимо на старій системі...

Дамп БД
sudo pg_dump -U postgres dspace > dump.sql

Архівування сховища.

tar -cvf assetstore.tar /usr/share/dspace/assetstore/

== Імпорт старої БД і сховища у новий DSpace і міграція ==

Дії проводимо на новій системі...

Копіюємо сюди файли dump.sql та assetstore.tar.

1) Якщо в новому DSpace вже є якісь тестові дані, очищуємо їх.

/etc/init.d/tomcat8 stop
sudo service postgresql restart

sudo su postgres
psql -U postgres
DROP DATABASE dspace;
\q
exit

rm -R /home/data/dspace/assetstore/*

2) Наново створюємо БД dspace і користувача dspace
sudo su postgres
createuser -U postgres -d -A -P dspace
createdb -U dspace -E UNICODE dspace
exit

service postgresql restart

(придумуємо і запам'ятовуємо „ПАРОЛЬ“)

3) Надання прав користувачу dspace на БД dspace

sudo su postgres
psql -U postgres -d dspace
ALTER ROLE dspace WITH PASSWORD 'ПАРОЛЬ';
ALTER DATABASE dspace OWNER TO dspace;
GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;
CREATE EXTENSION pgcrypto;
\q
exit

service postgresql restart

4) Імпорт старої БД
sudo -u postgres psql dspace < dump.sql

/etc/init.d/postgresql restart

5) Оновлення послідовностей

sudo -u postgres psql -f update-sequences.sql dspace > 4_update_sequences_LOG.txt

Якщо у виводі є помилки див. далі

5) У dspace.cfg коректуємо назву БД і вказуємо пароль

db.url = jdbc:postgresql://localhost:5432/dspace
db.username = dspace
db.password = ПАРОЛЬ

7) На імпортовані таблиці ще раз надаємо права користувачу dspace на БД dspace

sudo su postgres
psql -U postgres -d dspace
ALTER ROLE dspace WITH PASSWORD 'ПАРОЛЬ';
ALTER DATABASE dspace OWNER TO dspace;
GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;
REASSIGN OWNED BY dspace TO dspace;
\q
exit
/etc/init.d/postgresql restart

8) Розпаковуємо старий бекап assetstore.tar
у теку /home/data/dspace/assetstore/ та змінюємо права
sudo chown tomcat8:tomcat8 /home/data/dspace/assetstore/ -R

9) Запуск процедури міграції БД

sudo /etc/init.d/tomcat8 restart
sudo -u tomcat8 /home/data/dspace/bin/dspace database info > dspace_database_migrate_LOG.txt
sudo -u tomcat8 /home/data/dspace/bin/dspace database migrate >> dspace_database_migrate_LOG.txt

В результаті у виводі повинно бути щось на кшталат
Database URL: jdbc:postgresql://localhost:5432/dspace
Database Schema: public
Database Software: PostgreSQL version 9.6.2
Database Driver: PostgreSQL Native Driver version PostgreSQL 9.1 JDBC4 (build 901)

+----------------+----------------------------+---------------------+---------+
| Version | Description | Installed on | State |
+----------------+----------------------------+---------------------+---------+
| 1.1 | Initial DSpace 1.1 databas | | PreInit |
| 1.2 | Upgrade to DSpace 1.2 sche | | PreInit |
| 1.3 | Upgrade to DSpace 1.3 sche | | PreInit |
| 1.3.9 | Drop constraint for DSpace | | PreInit |
| 1.4 | Upgrade to DSpace 1.4 sche | | PreInit |
| 1.5 | Initializing from DSpace 1 | 2017-05-11 00:32:28 | Success |
| 1.5.9 | Drop constraint for DSpace | 2017-05-11 00:32:29 | Success |
| 1.6 | Upgrade to DSpace 1.6 sche | 2017-05-11 00:32:33 | Success |
| 1.7 | Upgrade to DSpace 1.7 sche | 2017-05-11 00:32:42 | Success |
| 1.8 | Upgrade to DSpace 1.8 sche | 2017-05-11 00:32:42 | Success |
| 3.0 | Upgrade to DSpace 3.x sche | 2017-05-11 00:32:48 | Success |
| 4.0 | Upgrade to DSpace 4.x sche | 2017-05-11 00:32:49 | Success |
| 5.0.2014.08.08 | DS-1945 Helpdesk Request a | 2017-05-11 00:32:49 | Success |
| 5.0.2014.09.25 | DS 1582 Metadata For All O | 2017-05-11 00:32:49 | Success |
| 5.0.2014.09.26 | DS-1582 Metadata For All O | 2017-05-11 00:32:49 | Success |
| 5.6.2016.08.23 | DS-3097 | 2017-05-11 00:32:48 | Success |
+----------------+----------------------------+---------------------+---------+

Database URL: jdbc:postgresql://localhost:5432/dspace
Migrating database to latest version... (Check logs for details)
Done.

Між старою версією БД DSpace і новою у колонці State повинно бути „Success“.

10) Якщо на кроці 5 є помилки чи на 9 кроці немає „Success“ необхідно повторити (можливо декілька разів)
крок 5, перезапуск БД (/etc/init.d/postgresql restart) та крок 9.
Не зрозуміло чому так. Є підозра, що скрипти міграції кроку 9 завершуються але дії продовжуються у фонових процесах.

== Переіндексація DSpace ==
При успішній міграції запускаємо переіндексацію DSpace

/etc/init.d/tomcat8 restart
sudo -u tomcat8 /home/data/dspace/bin/dspace index-discovery >> reindex_LOG.txt

При великій БД (десятки тисяч записів) це може зайняти декілька годин.

= Оновлення DSpace 1.5.2 »» 1.8.1 (ЗАСТАРІЛО) =

== Відхід від рекомендованого оновлення ==

В офіційних керівництвах рекомендується робити покрокові оновлення, зокрема:

* „[https://wiki.duraspace.org/display/DSDOC18/Upgrading+From+1.5.x+to+1.6.x Upgrading From 1.5.x to 1.6.x]“
* „[https://wiki.duraspace.org/display/DSDOC18/Upgrading+From+1.6.x+to+1.7.x Upgrading From 1.6.x to 1.7.x]“
* „[https://wiki.duraspace.org/display/DSDOC18/Upgrading+From+1.7.x+to+1.8.x Upgrading From 1.7.x to 1.8.x]“

Однак описаний в цих керівництвах метод не дав результату. Декілька причин:

1) Конфігураційний файл dspace.cfg — рекомендується вносити в нього усі зміни, що з’являються від версії до версії, а їх доволі багато. Виявилося простіше перенести персональні налаштування у новий dspace.cfg.

2) Скомпілювати DSpace на 1.6.2 так і не вдалося.

Отож розглядається варіант встановлення нового DSpace 1.8.1 та перенесення на нього усіх даних та налаштувань.

== Резервна копія ==

Копія БД:

для таблиці „dspace“:

sudo -u postgres pg_dump -Ft -b -U dspace dspace | pbzip2 -9 > /home/dspace/backups/pg_dump__dspace__DSpace_1_5_2_Postgres_8_4.tar.bz2

для усєї БД:

sudo -u postgres pg_dumpall -U postgres | pbzip2 -9 > /home/dspace/backups/pg_dumpall__DSpace_1_5_2_Postgres_8_4.sql.bz2

Архівування сховища „assetstore“:

tar -cvf assetstore_dspace.tar /usr/share/dspace/assetstore/
pbzip2 -f assetstore_dspace.tar

== Встановлення Debian GNU/Linux ==

Детальніше про [[Встановлення ОС Debian Linux|встановлення Debian]].

== Встановлення DSpace ==

Детальніше про [[Встановлення DSpace на ОС Debian|встановлення DSpace]].

== Бекапи 1.5.2 ==

Тека бекапу БД DSpace 1.5.2:

mkdir /home/dspace/backups/1_5_2

Сюди копіюємо бекапи

pg_dumpall_elartu_02-20-2012_13-27.sql.bz2
pg_dump_dspace_elartu_02-20-2012_13-27.tar.bz2
assetstore_elartu_02-20-2012_17-52.tar.bz2

та розпаковуємо їх

pbzip2 -d pg_dumpall_elartu_02-20-2012_13-27.sql.bz2
pbzip2 -d pg_dump_dspace_elartu_02-20-2012_13-27.tar.bz2

pbzip2 -d assetstore_elartu_02-20-2012_17-52.tar.bz2
tar -xf assetstore_elartu_02-20-2012_17-52.tar

== Невдала спроба з „pg_restore“ ==

sudo -u postgres pg_restore -c -d dspace -U postgres -Ft pg_dump_dspace_elartu_02-20-2012_13-27.tar

sudo -u postgres psql -U dspace -f /home/dspace/source/dspace-1.8.1-src-release/dspace/etc/postgres/database_schema_15-16.sql dspace
sudo -u postgres psql -U dspace -f /home/dspace/source/dspace-1.8.1-src-release/dspace/etc/postgres/database_schema_16-17.sql dspace
sudo -u postgres psql -U dspace -f /home/dspace/source/dspace-1.8.1-src-release/dspace/etc/postgres/database_schema_17-18.sql dspace

sudo -u postgres psql -U dspace -f /home/dspace/source/dspace-1.8.1-src-release/dspace/etc/postgres/update-sequences.sql dspace

На жаль, при цьому, у виводі 1-ої команди багато помилок і БД відновлюється не повністю (відсутні зібрання та підфонди, групи користувачів і т.п.). Таблиця „collection“ пуста.
Можливо це зв'язано з різницею версію Posgres 8.4 та 9.1.

Зокрема були такі помилки:

pg_restore: [archiver (db)] Error while PROCESSING TOC:
pg_restore: [archiver (db)] Error from TOC entry 2145; 2606 25505 FK CONSTRAINT community2community_child_comm_id_fkey dspace
pg_restore: [archiver (db)] could not execute query: ERROR: constraint "community2community_child_comm_id_fkey" of relation "community2community" does not exist
Command was: ALTER TABLE ONLY public.community2community DROP CONSTRAINT community2community_child_comm_id_fkey;

pg_restore: [archiver (db)] Error from TOC entry 2147; 2606 25522 FK CONSTRAINT community2collection_collection_id_fkey dspace
pg_restore: [archiver (db)] could not execute query: ERROR: constraint "community2collection_collection_id_fkey" of relation "community2collection" does not exist
Command was: ALTER TABLE ONLY public.community2collection DROP CONSTRAINT community2collection_collection_id_fkey;

== Вдала спроба з бекапом „pg_dumpall“ ==

Це варіант відновлення всієї БД Postgres (а не лише таблиці „dspace“ як у попередньому випадку).

Базу даних можна витерти через „phppgadmin“. SQL з бекапу „pg_dumpall“ створить її наново.

sudo -u postgres psql -U postgres -f pg_dumpall_elartu_02-20-2012_13-27.sql

sudo -u postgres psql -U dspace -f /home/dspace/source/dspace-1.8.1-src-release/dspace/etc/postgres/database_schema_15-16.sql dspace
sudo -u postgres psql -U dspace -f /home/dspace/source/dspace-1.8.1-src-release/dspace/etc/postgres/database_schema_17-18.sql dspace
sudo -u postgres psql -U dspace -f /home/dspace/source/dspace-1.8.1-src-release/dspace/etc/postgres/database_schema_17-18.sql dspace

sudo -u postgres psql -U dspace -f /home/dspace/source/dspace-1.8.1-src-release/dspace/etc/postgres/update-sequences.sql dspace

Також

sudo -u dspace /dspace/bin/dspace index-init

При цьому пароль до БД „dspace“ такий як у версії старій 1.5.2. Отож, якщо він відрізняється, то його також потрібно поправити й у dspace.cfg.

== Сховище „assetstore“ ==

Переміщуємо вміст сховища „assetstore“ 1.5.2 до теки /dspace/assetstore

та виставляємо права

sudo chown -R tomcat6:tomcat6 /dspace/assetstore

== Перегенерація пошукового індексу ==

sudo -u dspace /dspace/bin/dspace index-init

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування DSpace]].

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Українізація DSpace]]

= Посилання =

* dspace.2283337.n4.nabble.com/ „[http://dspace.2283337.n4.nabble.com/Dspace-tech-Restoring-backup-td3278291.html Dspace-tech: Restoring backup]“

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Налаштування DSpace

2017-10-26T11:53:10Z

Dubyk: /* Див. також */

= Переключення Tomcat і DSpace з 8080 на порт 80 =

Дозвіл для Tomcat-у на порт 80.

Система не пускає tomcat на привілейований порт (80), для цього (у Debian) редагуємо

sudo mc -e /etc/default/tomcat8

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# (yes/no, default: no)
AUTHBIND=yes

Now we need to tell "authbind" that Tomcat is allowed to use lower port numbers. Type the following commands:

sudo touch /etc/authbind/byport/80
sudo touch /etc/authbind/byport/443
sudo chmod 0755 /etc/authbind/byport/80
sudo chmod 0755 /etc/authbind/byport/443
sudo chown tomcat8.tomcat8 /etc/authbind/byport/80
sudo chown tomcat8.tomcat8 /etc/authbind/byport/443
cd /etc/authbind/byport
ls -l

Now we tell the Tomcat server to listen on the "authbind" ports. Edit the following file.

sudo mc -e /etc/tomcat8/server.xml

Find the connector for port 8080 and change it to port 80.

Замінити
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
на
<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="443" />

/home/data/dspace/config/dspace.cfg

# DSpace base host URL. Include port number etc.
#dspace.baseUrl = http://localhost:8080
dspace.baseUrl = http://localhost

# DSpace base URL. Include port number etc., but NOT trailing slash
# Change to xmlui if you wish to use the xmlui as the default, or remove
# "/jspui" and set webapp of your choice as the "ROOT" webapp in
# the servlet engine.
#dspace.url = http://localhost:8080/xmlui
dspace.url = http://localhost/xmlui

/home/data/dspace/config/modules/oai.cfg

#solr.url=http://localhost:8080/solr/oai
solr.url=http://localhost/solr/oai

#bitstream.baseUrl = http://localhost:8080/xmlui
bitstream.baseUrl = http://localhost/xmlui

/home/data/dspace/config/modules/discovery.cfg
#search.server = http://localhost:8080/solr/search
search.server = http://localhost/solr/search

/home/data/dspace/config/modules/solr-statistics.cfg
#server = http://localhost:8080/solr/statistics
server = http://localhost/solr/statistics

/home/data/dspace/config/modules/rdf.cfg
#contextPath = http://localhost:8080/rdf
contextPath = http://localhost/rdf

/home/data/dspace/config/modules/swordv2-server.cfg

#error.alternate.url = http://localhost:8080/xmlui/contact
error.alternate.url = http://localhost/xmlui/contact

#workspace.url-template = http://localhost:8080/xmlui/submit?workspaceID=#wsid#
workspace.url-template = http://localhost/xmlui/submit?workspaceID=#wsid#

/home/data/dspace/config/modules/sword-client.cfg
#targets = http://localhost:8080/sword/servicedocument, \
targets = http://localhost/sword/servicedocument, \

/home/data/dspace/config/modules/rdf/metadata-rdf-mapping.ttl

замінити
localhost:8080
на
localhost

/home/data/dspace/config/modules/rdf/constant-data-general.ttl

замінити
localhost:8080
на
localhost

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

Див. також
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S05/Ubuntu-14.04

= Веб-сервер Apache (порт 8080) =

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8080.

Редагувати /etc/apache2/ports.conf:

#Listen 80
Listen 8080

та /etc/apache2/sites-enabled/000-default.conf

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

= Ескізи при пошуку =

Редагуємо dspace.cfg у розділі „Settings for Thumbnail creation“

# whether to display thumbnails on browse and search results pages (1.2+)
# If you have customised the Browse columnlist, then you must also
# include a 'thumbnail' column in your configuration (1.5+)
# (This configuration is not used by XMLUI. To show thumbnails in the
# XMLUI, you just need to create a theme which displays them)
#webui.browse.thumbnail.show = false
webui.browse.thumbnail.show = true

= Ескізи при перегляді матеріалів =
Редагуємо dspace.cfg у розділі „Settings for Item Preview“

#webui.preview.enabled = false
webui.preview.enabled = true

= Кількість документів у фондах/зібраннях =

Редагуємо dspace.cfg

webui.strengths.show = true

/etc/init.d/restart tomcat8

Див. також:
* http://irbis.gpntb.ru/read.php?53,59259

= Налаштування пошти =

== SMTP-варіант ==

Редагуємо dspace.cfg у розділі „Email settings“

mail.server=smtp.univer.edu.ua
mail.from.address = user@univer.edu.ua
feedback.recipient = user@univer.edu.ua
mail.admin = user@univer.edu.ua
alert.recipient = user@univer.edu.ua
registration.notify = user@univer.edu.ua

sudo /etc/init.d/restart tomcat8

== GMail-варіант ==

Попередньо створити обліковий запис Google:

ІП = Ім'я Прізвище
namesurname@gmail.com
пароль=ПАРОЛЬ

Налаштування облікового запису > Доступ для менш безпечних додатків: Дозволено

Внести наступні зміни в dspace.cfg

mail.server=smtp.gmail.com
mail.server.username = namesurname@gmail.com
mail.server.password = ПАРОЛЬ

#mail.server.port = 25
#mail.server.port = 587
#mail.server.port = 465

mail.extraproperties = mail.smtp.socketFactory.port=465, \
mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory, \
mail.smtp.socketFactory.fallback=false

Також змінюємо

mail.from.address = namesurname@gmail.com
feedback.recipient = namesurname@gmail.com
mail.admin = namesurname@gmail.com
alert.recipient = namesurname@gmail.com
registration.notify = namesurname@gmail.com

Перевіряємо чи не занятий 465 порт

netstat -aunt | grep 465

з іншого компа перевіряємо відкриті

nmap dspace.univer.edu.ua

чи є прописаний в iptables

iptables -L -n

чи так

openssl s_client -connect smtp.gmail.com:465

(щодо 587 — openssl s_client -starttls smtp -crlf -connect smtp.gmail.com:587)

чи так

telnet smtp.gmail.com 465

додаємо цей порт в iptables

iptables -A INPUT --protocol tcp -j ACCEPT --match tcp --destination-port 465
iptables -A OUTPUT --protocol tcp -j ACCEPT --match tcp --source-port 465

Але краще додати у файл /etc/sysconfig/iptables додаємо правила

-A INPUT --protocol tcp -j ACCEPT --match tcp --destination-port 465
-A OUTPUT --protocol tcp -j ACCEPT --match tcp --source-port 465

Перезапуск iptables і tomcat

sudo service iptables restart
sudo /etc/init.d/restart tomcat8

Перевіряємо дію пошти

/home/data/dspace/bin/dspace test-email

вивід

About to send test email:
- To: user@univer.edu.ua
- Subject: DSpace test email
- Server: smtp.univer.edu.ua

Email sent successfully!

Див. також:
* http://blog.stuartlewis.com/2009/09/05/using-gmail-with-dspace/
* https://jira.duraspace.org/browse/DS-234
* https://www.mail-archive.com/dspace-tech@lists.sourceforge.net/msg21962.html
* http://dspace.2283337.n4.nabble.com/sending-mail-giving-error-td4675341.html
* http://dspace.2283337.n4.nabble.com/Gmail-Authentication-td4674302.html#a4674310
* http://dspace.2283337.n4.nabble.com/Gmail-Configuration-in-Dspace-4-1-td4674042.html
* http://stackoverflow.com/questions/1516754/connecting-to-smtp-gmail-com-via-command-line
* http://dspace.2283337.n4.nabble.com/Dspace-email-regitration-error-td4665752.html

= Sitemaps =

https://wiki.duraspace.org/pages/viewpage.action?pageId=34642415

Налаштувати robots.txt

User-agent: *

# Uncomment the following line ONLY if sitemaps.org or HTML sitemaps are used
# and you have verified that your site is being indexed correctly.
# Disallow: /browse

Host: elartu.tntu.edu.ua

# Disable access to Discovery search and filters
Disallow: /discover
Disallow: /search-filter

# This should be the FULL URL to your HTML Sitemap..
# Make sure to replace "[dspace.url]" with the value of your 'dspace.url' setting in your dspace.cfg file.
Sitemap: http://elartu.tntu.edu.ua/htmlmap

Створювати по крону

# Generate sitemaps
# every day at 6:00
00 06 * * * /usr/share/dspace/bin/generate-sitemaps

Додати в Google та Яндекс ВебМайстри

http://elartu.tntu.edu.ua/htmlmap?map=0
http://elartu.tntu.edu.ua/htmlmap?map=1
http://elartu.tntu.edu.ua/htmlmap?map=2
http://elartu.tntu.edu.ua/htmlmap?map=3
http://elartu.tntu.edu.ua/htmlmap?map=4
http://elartu.tntu.edu.ua/sitemap?map=0

= Переміщення/об’єднання підфондів =

http://my_dspace/phppgadmin/

Вихідні дані

handle старого батьківського фонду =123456789/37
handle нового батьківського фонду = 123456789/18350
handle підфонду, що переміщується = 123456789/64

Через таблицю handle визначаємо внутрішні resource_id, що відповідають parent_comm_id та child_comm_id у таблиці community2community

handle=123456789/64 resource_id=27
handle=123456789/18350 resource_id=223
handle=123456789/37 resource_id=18

Далі робимо переміщення у таблиці community2community
замінюючи 18 на 223

Однак залишається проблема з вилучення старого фонду.
Його номер ще згадується у таблицях community_item_count та communities2item

В community_item_count легко замінити в community_id
з 18 на 223
! примітка: таблицю community_item_count, здається, можна й не чіпати

З таблицею communities2item трохи складніше. Тут є перелік всіх матеріалів, прив’язаних до фонду 18, рядків багато.
Поміг SQL-Запит
UPDATE communities2item SET community_id='223' WHERE "community_id"='21';

Також див. тут
* Moving a DSpace collection (http://timesync.gmu.edu/wordpress/?p=15 )
* http://dspace.2283337.n4.nabble.com/Moving-collections-to-a-new-sub-community-td4657035.html
* http://dspace.2283337.n4.nabble.com/community-deletion-td3543389.html

= Прибирання 1 кроку =
На цьому кроці відбувався вибір: опубліковане чи ні, про декілька назв та декілька файлів.

Щоб прибрати це у файлі item-submission.xml

закоментуйте блок

<step>
<heading>submit.progressbar.initial-questions</heading>
<processing-class>org.dspace.submit.step.InitialQuestionsStep</processing-class>
<jspui-binding>org.dspace.app.webui.submit.step.JSPInitialQuestionsStep</jspui-binding>
<xmlui-binding>org.dspace.app.xmlui.aspect.submission.submit.InitialQuestionsStep</xmlui-binding>
<workflow-editable>true</workflow-editable>
</step>

та розкоментуйте блок
<step>
<processing-class>org.dspace.submit.step.SkipInitialQuestionsStep</processing-class>
</step>

= Задовгі назви зібрань у формі відправки матеріалу =

На сторінці http://localhost:8080/submit
задовгі назви списків „фонди » підфонди » зібрання“.

Якщо назви зібрань унікальні, то можна обрізати назви до „зібрання“

У файлі /dspace-тека/webapps/jspui/submit/select-collection.jsp

шукаємо рядок

<dspace:selectcollection klass="form-control" id="tcollection" collection="-1" name="collection"/>

та замінюємо (чи закоментовуємо ) на блок

<select class="form-control" name="collection" id="tcollection">
<option value="-1"></option>
<%
for (int i = 0; i < collections.size(); i++)
{
%>
<option value="<%= collections.get(i).getID() %>"><%= collections.get(i).getName() %></option>
<%
}
%>
</select>

Примітка: для DSpace 6+. для нижчих версії не працюватиме (змінився клас та назви функцій).

Для DSpace версії 5.5 (можливо і для інших) цей блок виглядатиме так

<select class="form-control" name="collection" id="tcollection">
<option value="-1"></option>
<%
for (int i = 0; i < collections.length; i++)
{
%>
<option value="<%= collections[i].getID() %>"><%= collections[i].getMetadata("name") %></option>
<%
}
%>
</select>

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Оновлення DSpace]]
* [[Українізація DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Встановлення DSpace на ОС Debian

2017-10-26T11:52:55Z

Dubyk: /* Див. також */

Встановлення DSpace на ОС Debian

= Встановлення DSpace 6.1 на ОС Debian GNU/Linux 9 Stretch =

== Встановлення ОС Debian GNU/Linux 9 Stretch ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Джерела ==

* [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace Installing DSpace - DSpace 6.x Documentation - DuraSpace Wiki]

* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_DSpace_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian Встановлення DSpace на ОС Debian] (ця інструкція)

* [https://wiki.duraspace.org/display/DSDOC6x/DSpace+6.x+Documentation DSpace 6.x Documentation - DuraSpace Wiki:] (звантажити можна)

* [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace SUNScholar/Install DSpace], також див. [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_Ubuntu Install Ubuntu Server] та [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu Prepare Ubuntu Server]

* [https://wiki.duraspace.org/display/DSPACE/Installation+Guides?src=search DSpace Installation Guides]

* [https://rspproject.wordpress.com/2010/11/10/installing-dspace-on-debian-5/ Installing DSpace on Debian 5]

* [https://gist.github.com/dchud/8940811 20-minute guide to installing DSpace-4.0 from binary release on Ubuntu 12.04 LTS]

* [http://ideafix.name/?p=2325 Установка DSpace 5.x в среде Ubuntu Server 14.x]

* [http://linuxhalwa.blogspot.com/2016/01/installing-dspace-5x-on-ubuntu-1404-lts.html Installing DSpace 5.x on Ubuntu 14.04 LTS]

* [https://wiki.duraspace.org/display/DSPACE/Installing+DSpace+4.2+on+Ubuntu+Server+14.04.1+LTS Installing DSpace 4.2 on Ubuntu Server 14.04.1 LTS - DSpace - DuraSpace Wiki]

* [http://dspaceclub.blogspot.com/2015/02/how-to-install-dspace-50-on-ubuntu-1410.html How to Install DSpace 5.0 on Ubuntu 14.10 ]

* [https://amdmaher.wordpress.com/dspace-digital-repository/dspace-3-1-installation-on-debian-squeeze-6-0/ DSpace installation on Debian Squeeze 6.0.3]

== Необхідне програмне забезпечення ==

З офіційної документації [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace]:

* Oracle Java JDK or OpenJDK
* Java 8 update 20 or later, or Java 7 update 55 or later. [https://jira.duraspace.org/browse/DS-2653 DS-2653] - Java 8 Support for DSpace Accepted
* Apache Maven (Java build tool) 3.0.5+ або 3.3.9+ (для теми Mirage 2)
* Apache Ant 1.8 or later (Java build tool)
* PostgreSQL 9.4 or later (з встановленим pgcrypto). Oracle 10g or later.
* Servlet Engine: Apache Tomcat 8 (Tomcat 8.0.33 or above) or Tomcat 7 (Tomcat 7.0.30 or above), Jetty, Caucho Resin or equivalent.
* Perl (only required for [dspace]/bin/dspace-info.pl)

Присутнє у Debian GNU/Linux 9 Jessie та бекпортах:
* '''[https://packages.debian.org/stretch/openjdk-8-jdk openjdk-8-jdk]''' (8u141-b15-1~deb9u1)
* '''[https://packages.debian.org/stretch/tomcat8 tomcat8]''' (8.5.14-1+deb9u1)
* '''[https://packages.debian.org/stretch/mavenm maven]''' (3.3.9-4)
* '''[https://packages.debian.org/stretch/ant ant]''' (1.9.9-1)
* '''[https://packages.debian.org/stretch/postgresql postgresql]''' (9.6+181)

Розглядаємо варіант встановлення '''openjdk-8-jdk'''+'''tomcat8'''.

== Підключення додаткових репозитаріїв ==

У файл /etc/apt/sources.list додаємо (перевіряємо наявність) наступні джерела пакунків

deb http://ftp.ua.debian.org/debian/ stretch main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch main contrib non-free

deb http://security.debian.org/ stretch/updates contrib main
deb-src http://security.debian.org/ stretch/updates contrib main

deb http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free

(чи інші дзеркала стабільної версії)

deb http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free

Оновлюємо перелік пакунків та систему

sudo apt-get update
sudo apt-get upgrade

== Встановлення Java OpenJDK 8 ==

sudo apt-get purge openjdk-7-*

sudo apt-get install openjdk-8-jdk

та вибрати саме цей варіант (OpenJDK 8) як основний:

sudo update-alternatives --config java

== Встановлення Tomcat, Maven, Ant ==

sudo apt-get install tomcat8 maven ant git

== Встановлення БД postgresql ==

sudo apt-get install postgresql postgresql-contrib libpg-java

=== Налаштування PostgreSQL ===

У файлі
/etc/postgresql/9.6/main/postgresql.conf
розкоментувати рядок

listen_addresses = 'localhost'

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection], див. також [https://jira.duraspace.org/browse/DS-1458 DuraSpace JIRA DS-1458 Connection pool exhausted]

Редагуємо файл налаштування postgresql:

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== shared_buffers ====
Тут [http://dspace.2283337.n4.nabble.com/Dspace-production-environment-td4684344.html#a4684368 Jan 06, 2017; 5:48pm Re: Dspace production environment] рекомендують також збільшити (від типових 128Мб) до 10% від ОП.
Якщо ОП 10Гб, то
shared_buffers = 1024MB
також
sudo service postgresql restart

==== Збільшення загальної пам’яті ядра для клієнтських підключень сервера PostgreSQL ====

Редагуємо файл "/etc/sysctl.conf":

sudo mcedit /etc/sysctl.conf

Вставити наприкінці файлу наступне:

# For PostgreSQL server client connections
kernel.shmmax = 500000000
kernel.shmall = 500000000

Див. також:
* http://www.postgresql.org/docs/9.3/static/kernel-resources.html
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S06/Ubuntu-14.04

Також виконати:

sudo sysctl -p

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection]

Редагуємо файл налаштування postgresql :

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== Налаштування прав доступу до PostgreSQL на основі хост-сервера ====

Див. посилання в офіційній документації щодо файлу "pg_hba.conf":

* [http://www.postgresql.org/docs/current/static/auth-pg-hba-conf.html 19.1. The pg_hba.conf File]
* [https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-RelationalDatabase:%28PostgreSQLorOracle%29 Relational Database: (PostgreSQL or Oracle)]

У файлі /etc/postgresql/9.6/main/pg_hba.conf замінюємо
local all postgres peer
на
local all postgres trust

та
local all all peer
на
local all all md5

Перезапуск сервера БД
sudo service postgresql restart

==== Створення користувача "dspace" та БД "dspace" PostgreSQL ====

Створюємо користувача БД (dspace) та БД DSpace (dspace)

sudo su postgres
createuser -U postgres -d -A -P dspace
createdb -U dspace -E UNICODE dspace
exit

При створенні користувача придумуємо пароль.

Також може бути питання про створення нових користувачів - Shall the new role be allowed to create more new roles? (y/n) '''n'''

Перезапуск postgresql

service postgresql restart

==== Налаштування пароля, власника та привілеїв БД "dspace" та користувача "dspace" ====

З’єднуємося зі сервером БД PostgreSQL та входимо у оболонку PostgreSQL.

psql -U postgres -d dspace

Встановити пароль для користувача "dspace" (вказуємо свій варіант):

ALTER ROLE dspace WITH PASSWORD 'XXXXXX';

Нехай користувач "dspace" буде власником БД "dspace"

ALTER DATABASE dspace OWNER TO dspace;

Надати усі привілеї для БД "dspace" користувачу "dspace"

GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;

Додаємо розширення "crypto" до БД "dspace".

CREATE EXTENSION pgcrypto;

Вихід з оболонки БД.

\q

=== phppgadmin ===

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/apache2/conf-available/phppgadmin.conf, щоб додати доступ з інших IP:

закоментовуємо

#Require local

та додаємо

allow from 127.0.0.0/255.0.0.0 ::1/128
allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(чи для всіх - allow from all)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://localhost/phppgadmin/

=== Корисні посилання ===

* [http://www.postgresql.org/about/featurematrix PostgreSQL: Feature Matrix]
* [http://manage.jujucharms.com/charms/trusty/postgresql postgresql | Juju]

== Створення користувача DSpace ==

sudo useradd -m dspace
sudo passwd dspace

Придумуємо пароль.

== Створення теки [dspace] для розміщення виконавчого коду DSpace ==

sudo mkdir /home/data
sudo mkdir /home/data/dspace
sudo chown dspace:dspace /home/data
sudo chown dspace:dspace /home/data/dspace

== Звантаження, компіляція та встановлення випуску DSpace ==

=== Звантаження ===

Використовуємо джерельні тексти DSpace з github (доступні також і на SourceForge).

https://github.com/DSpace/DSpace/releases

На час встановлення найбільш стабільною версією була DSpace 6.1 (https://github.com/DSpace/DSpace/releases/tag/dspace-6.1)

Вхід від користувача dspace

su dspace

Тека для джерельних текстів

mkdir /home/dspace/source
cd /home/dspace/source

Звантаження останньої стабільної версії

wget https://github.com/DSpace/DSpace/releases/download/dspace-6.1/dspace-6.1-src-release.tar.gz -O dspace-6.1-src-release.tar.gz

Розпакування

tar -zxf dspace-6.1-src-release.tar.gz

=== Компіляція ===

cd /home/dspace/source/dspace-6.1-src-release/
mvn -U package

Звантажує багато пакунків з repo.maven.apache.org та інших (бажано швидкий доступ до Інтернет).

Довго.

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] DSpace Parent Project .............................. SUCCESS [ 0.889 s]
[INFO] DSpace Services Framework :: API and Implementation SUCCESS [ 3.850 s]
[INFO] DSpace Kernel :: API and Implementation ............ SUCCESS [ 10.404 s]
[INFO] DSpace Addon Modules ............................... SUCCESS [ 0.003 s]
[INFO] DSpace Kernel :: Additions and Local Customizations SUCCESS [ 2.771 s]
[INFO] DSpace XML-UI (Manakin) ............................ SUCCESS [ 7.296 s]
[INFO] DSpace XML-UI (Manakin) :: Local Customizations .... SUCCESS [ 7.851 s]
[INFO] DSpace JSP-UI ...................................... SUCCESS [ 1.713 s]
[INFO] DSpace JSP-UI :: Local Customizations .............. SUCCESS [ 5.258 s]
[INFO] DSpace RDF ......................................... SUCCESS [ 4.785 s]
[INFO] DSpace RDF :: Local Customizations ................. SUCCESS [ 6.146 s]
[INFO] DSpace REST :: API and Implementation .............. SUCCESS [ 7.455 s]
[INFO] DSpace REST :: Local Customizations ................ SUCCESS [ 6.561 s]
[INFO] DSpace SWORD ....................................... SUCCESS [ 2.295 s]
[INFO] DSpace SWORD :: Local Customizations ............... SUCCESS [ 4.785 s]
[INFO] DSpace SWORD v2 .................................... SUCCESS [ 1.234 s]
[INFO] DSpace SWORD v2 :: Local Customizations ............ SUCCESS [ 4.884 s]
[INFO] Apache Solr Webapp ................................. SUCCESS [ 10.204 s]
[INFO] DSpace SOLR :: Local Customizations ................ SUCCESS [ 5.188 s]
[INFO] DSpace OAI-PMH ..................................... SUCCESS [ 1.193 s]
[INFO] DSpace OAI-PMH :: Local Customizations ............. SUCCESS [ 6.207 s]
[INFO] DSpace Assembly and Configuration .................. SUCCESS [ 15.938 s]
[INFO] DSpace XML-UI Mirage2 Theme ........................ SUCCESS [ 0.458 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:57 min
[INFO] Finished at: 2017-08-10T15:20:08+03:00
[INFO] Final Memory: 137M/954M
[INFO] ------------------------------------------------------------------------

=== Тека встановлення та доступ до БД ===

У файлі налаштувань DSpace

/home/dspace/source/dspace-6.1-src-release/dspace/target/dspace-installer/config/dspace.cfg

встановлюємо наступне

# DSpace installation directory
dspace.dir = /home/data/dspace

# Database username and password
db.username = dspace
db.password = MYPASSWORD

(пароль до БД встановлювався вище)

=== Встановлення DSpace та ініціалізація БД ===

su dspace

cd /home/dspace/source/dspace-6.1-src-release/dspace/target/dspace-installer

ant fresh_install

[echo] ====================================================================
[echo] The DSpace code has been installed.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /home/data/dspace/webapps/
[echo]
[echo] OR, copy any web applications from /home/data/dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Start up your servlet container (e.g. Tomcat). DSpace now will
[echo] initialize the database on the first startup.
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /home/data/dspace/bin/dspace create-administrator
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://localhost:8080/xmlui
[echo]
[echo] ====================================================================
[echo]
BUILD SUCCESSFUL
Total time: 16 seconds

=== Крок по переміщенню бази даних у розділ /home ===

sudo service postgresql stop

sudo mv /var/lib/postgresql /home/data/postgresql

sudo chown -R postgres:postgres /home/data/postgresql

''(варіант sudo ln -s /home/data/postgresql /var/lib/postgresql не працює через SELinux)''

редагуємо

sudo mc -e /etc/postgresql/9.6/main/postgresql.conf

data_directory = '/home/data/postgresql/9.6/main'

Перазапуск postgresql

sudo service postgresql start

=== Підключення DSpace-івських webapps до Tomcat ===

Найпростіший спосіб, що рекомендують, це зкопіювати:

sudo cp -R /home/data/dspace/webapps/* /var/lib/tomcat8/webapps/

Однак було вибрано інший спосіб через створення файлів:

Спочатку створити 2 файли
/etc/tomcat8/Catalina/localhost/jspui.xml
/etc/tomcat8/Catalina/localhost/ROOT.xml
з ідентичним вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/jspui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/xmlui.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/xmlui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/solr.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/solr"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/oai.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/oai"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rdf.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rdf"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rest.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rest"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword2.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword2"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Перезапуск Tomcat

sudo service tomcat8 restart

=== Перший обліковий запис адміністратора системи DSpace ===

/home/data/dspace/bin/dspace create-administrator

Creating an initial administrator account
E-mail address: email@of.admin
First name: MyName
Last name: MySurname
Password will not display on screen.
Password:
Again to confirm:
Is the above data correct? (y or n): y
Administrator account created

(вище вибираємо логін та пароль адміністратора DSpace)

=== Ініціалізація БД DSpace (факультативно) ===

/home/data/dspace/bin/dspace database migrate

Вивід:

Database URL: jdbc:postgresql://localhost:5432/dspace
Migrating database to latest version... (Check logs for details)
Done.

=== Встановлення на теку DSpace прав користувача сервера Tomcat ===

sudo chown tomcat8:tomcat8 /home/data/dspace -R

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

== Відкриття DSpace у браузері ==

Повинні бути доступні інтерфейси:

Локально:

http://localhost:8080

http://localhost:8080/xmlui

http://localhost:8080/jspui

http://localhost:8080/oai/request?verb=Identify

= Встановлення DSpace 1.8.1 на ОС Debian 6 (ЗАСТАРІЛО) =

== Встановлення ОС Debian GNU/Linux 6 Squeeze ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Sun Java 6 JDK ==

sudo apt-get install sun-java6-jdk

— прийняти ліцензію

та вибрати саме цей варіант як основний:

sudo update-alternatives --config java

вивід:

There are 2 choices for the alternative java (providing /usr/bin/java).

Selection Path Priority Status
------------------------------------------------------------
* 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode
1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode
2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode

Press enter to keep the current choice[*], or type selection number: 2

== Веб-сервер Tomcat та Maven ==

sudo apt-get install tomcat6 maven2

(„ant“ включено до maven2)

== Postgresql ==

sudo apt-get install postgresql

Налаштування локального доступу до БД Postgresql. Редагуємо файл pg_hba.conf:

sudo mc -e /etc/postgresql/9.1/main/pg_hba.conf

Знаходимо наступні рядки:

закоментовуємо —

# Database administrative login by UNIX sockets
# local all postgres ident

та додаємо —

local all postgres trust

закоментовуємо —

# TYPE DATABASE USER CIDR-ADDRESS METHOD
# "local" is for Unix domain socket connections only
#local all all ident

та додаємо —

local all all trust

Перезапустити Postgresql, щоб задіяти зміни:

sudo /etc/init.d/postgresql restart

== Веб-сервер Apache ==

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8888.

Редагувати /etc/apache2/ports.conf:

#NameVirtualHost *:80
#Listen 80
NameVirtualHost *:8888
Listen 8888

та /etc/apache2/sites-enabled/000-default

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

== phppgadmin ==

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/phppgadmin/apache.conf, щоб додати доступ з інших IP:

allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(allow from 127.0.0.0/255.0.0.0 ::1/128 теж залишити)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://dspace.tntu.edu.ua:8888/phppgadmin/

== Користувач „dspace“ ==

sudo useradd -m dspace

(-m також створює домашню теку)

Додати до „sudoers“ ([[Встановлення ОС Debian Linux#Sudo]]).

Надалі всі дії проводити від користувача „dspace“:

su dspace

== БД „dspace“ ==

Створення користувача „dspace“ (користувач БД)

sudo createuser -U postgres -d -A -P dspace

ввести пароль 2 рази і „yes“

Створення чистої БД „dspace“ для користувача „dspace“:

sudo createdb -U dspace -E UNICODE dspace

== Звантаження DSpace 1.8.1 ==

Від користувача „dspace“

su dspace

створити теку

mkdir source;cd source

та звантажити джерельні тексти

wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.8.1/dspace-1.8.1-src-release.tar.bz2/download -O dspace-1.8.1-src-release.tar.bz2

й розпакувати

tar -xvjf dspace-1.8.1-src-release.tar.bz2

== Налаштування „dspace.cfg“ ==

Мінімальне початкове налаштування.

cd dspace-1.8.1-src-release/dspace/config/
mc -e dspace.cfg

Наведені лише зміни (дещо має бути закоментовано):

dspace.hostname = elartu.tntu.edu.ua

dspace.baseUrl = http://elartu.tntu.edu.ua

dspace.name = ELARTU

#db.name = ${default.db.name}
db.name = postgres

#db.url = ${default.db.url}
db.url = jdbc:postgresql://localhost:5432/dspace

#db.driver = ${default.db.driver}
db.driver = org.postgresql.Driver

#db.username = ${default.db.username}
#db.password = ${default.db.password}
db.username = dspace
db.password = abrakadabra

mail.server = smtp.tu.edu.te.ua
mail.from.address = serhij dubyk@ts tu.edu.ua
feedback.recipient = serhij dubyk@ts tu.edu.ua
mail.admin = serhij dubyk@ts tu.edu.ua
alert.recipient = serhij dubyk@ts tu.edu.ua
registration.notify = serhij dubyk@ts tu.edu.ua
mail.charset = UTF8

== Тека /dspace ==

sudo mkdir /dspace
sudo chown dspace /dspace

== Побудова maven-пакунка ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace
mvn package

При цьому звантажуються файли *.jar та *.pom, а у виводі можна побачити щось на кшталт наступного:

…
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-shared-io/1.1/maven-shared-io-1.1.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-filtering/1.0/maven-filtering-1.0.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-repository-builder/1.0-alpha-2/maven-repository-builder-1.0-alpha-2.jar
[INFO] [assembly:directory-single {execution: default}]
[INFO] Reading assembly descriptor: src/assemble/assembly.xml
[WARNING] Cannot include project artifact: org.dspace:dspace:pom:1.8.1; it doesn't have an associated file or directory.
[WARNING] The following patterns were never triggered in this artifact exclusion filter:
[WARNING] NOTE: Currently, inclusion of module dependencies may produce unpredictable results if a version conflict occurs.
[INFO] Copying files to /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
[INFO]
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] DSpace Addon Modules .................................. SUCCESS [1:49.420s]
[INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [3:01.210s]
[INFO] DSpace LNI :: Web Application ......................... SUCCESS [12.231s]
[INFO] DSpace OAI :: Web Application ......................... SUCCESS [6.012s]
[INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [13.066s]
[INFO] DSpace SWORD :: Web Application ....................... SUCCESS [3.177s]
[INFO] DSpace SWORDv2 :: Web Application ..................... SUCCESS [34.394s]
[INFO] DSpace SOLR :: Web Application ........................ SUCCESS [18.529s]
[INFO] DSpace Assembly and Configuration ..................... SUCCESS [56.354s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7 minutes 15 seconds
[INFO] Finished at: Fri Feb 17 14:02:02 EET 2012
[INFO] Final Memory: 61M/205M
[INFO] ------------------------------------------------------------------------

== Встановлення ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
'''ant fresh_install'''

Частина виводу:

[echo] ====================================================================
[echo] The DSpace code has been installed, and the database initialized.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /dspace/webapps/
[echo]
[echo] OR, copy any web applications from /dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /dspace/bin/dspace create-administrator
[echo]
[echo] * Start up your servlet container (Tomcat etc.)
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui
[echo]
[echo] You should also be able to access the administrator UI:
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui/dspace-admin
[echo] ====================================================================
[echo]

BUILD SUCCESSFUL
Total time: 43 seconds

== Підключення DSpace-івських webapps до Tomcat ==

Найпростіший спосіб, що рекомендують, це зкопіювати:

cp -R /dspace/webapps/* /var/lib/tomcat6/webapps/

Однак було вибрано інший спосіб через редагування

sudo mc -e /var/lib/tomcat6/conf/server.xml

Зокрема необхідно у розділ „<Service name="Catalina">“ додати

<Connector port="80".
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"

змінити localhost на elartu.tntu.edu.ua

<Engine name="Catalina" defaultHost="elartu.tntu.edu.ua">

<Host name="elartu.tntu.edu.ua" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

та перед закриваючою ознакою „</Host>“ додати наступне

<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

Перезапуск Tomcat

sudo /etc/init.d/tomcat6 restart

== Дозвіл для Tomcat-у на порт 80 ==

Система не пускає tomcat на привілейований порт (80), для цього редагуємо

sudo mc -e /etc/default/tomcat6

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
# (yes/no, default: no)
AUTHBIND=yes

== Обліковий запис адміна DSpace ==

/dspace/bin/dspace create-administrator

Вивід:

Creating an initial administrator account
E-mail address: serhi jdubyk@ts tu.edu.ua
First name: Serhij
Last name: Dubyk
WARNING: Password will appear on-screen.
Password: ************
Again to confirm: *********
Is the above data correct? (y or n): y
Administrator account created

== Права на теки „upload“ і „assetstore“ ==

sudo chown -R tomcat6 /dspace/upload
sudo chown -R tomcat6 /dspace/assetstore

== Встановлення завершено ==

УРА!!!

Можна перевірити із середини сервера:

lynx http://localhost
lynx http://localhost/xmlui

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування DSpace]].

= Див. також =

* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Встановлення ОС Debian Linux]]
* [[Українізація DSpace]]

= Посилання =

* wiki.duraspace.org/ „[https://wiki.duraspace.org/display/DSDOC18/Installation#Installation-Installation DSpace 1.8 Documentation » Installation]“
* scribd.com/ „[http://www.scribd.com/doc/72991669/Dspace-Installation-on-Debian-Squeeze-6-0-3 DSpace Installation on Debian Squeeze 6.0.3]“
* linuxhalwa.blogspot.com/ „[http://linuxhalwa.blogspot.com/2011/12/installing-dspace-18-on-ubuntu-1004.html Installing Dspace 1.8 on Ubuntu 10.04]“
* oracle.com/ „[http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u30-oth-JPR Java SE Development Kit 6u30]“
* lightonphiri.org/ „[http://lightonphiri.org/blog/dspace-installation-on-ubuntu-10-10 DSpace Installation on Ubuntu 10.10]“
* losisin.com/ „[http://losisin.com/blog/39-blogs/71-install-dspace-on-ubuntu-server Install Dspace on Ubuntu Server]“
* thelowedown.wordpress.com/ „[http://thelowedown.wordpress.com/2010/08/17/tomcat-6-binding-to-a-privileged-port-on-debianubuntu/ Tomcat 6: Binding to a Privileged Port on Debian/Ubuntu]“
* repositorioinstitucional.wikispaces.com/ „[http://repositorioinstitucional.wikispaces.com/Manual+de+Instalaci%C3%B3n+de+DSpace Manual de Instalación de DSpace]“
* es.scribd.com/ „[http://es.scribd.com/doc/48073504/Instalacion-DSpace-en-Ubuntu Instalacion DSpace en Ubuntu]“
* dspace.2283337.n4.nabble.com/ „[http://dspace.2283337.n4.nabble.com/Dspace-File-Upload-Problem-td3286609.html Dspace: File Upload Problem]“

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Додаткові поля Dublin Core для DSpace

2017-10-26T11:52:23Z

Dubyk: /* Див. також */

== Додаткові поля ==

Додаються/редагуються в інтерфейсі адміністрування » '''Реєстр полів метаданих''':

* '''dc.contributor.advisor''' — '''Використовуйте в першу чергу для наукового керівника дисертації.'''
* '''dc.contributor.affiliation''' — '''Місце роботи автора (повна назва організації, повна адреса, регалії та контактні дані).'''
* '''dc.contributor.committeeMember''' — '''Використовується для членів дисертаційного комітету.'''

* '''dc.coverage.country''' — '''Країна (2-букв. код країни за ISO_3166-1 alpha-2).'''
* '''dc.coverage.placename''' — '''Ареал охоплення або район розташування, охоплювані у даних, наприклад, регіони, країни чи міста.'''

* '''dc.date.submitted''' — '''Дата подання матеріалу. Рекомендовано для творів/тез/дисертацій.'''

* '''dc.description.tableofcontents''' — '''Таблиця змісту для даного матеріалу.'''

* '''dc.format.extent''' — '''Розмір та тривалість. Також діапазон сторінок.'''
* '''dc.format.pages''' — '''Обсяг матеріалу, кількість сторінок.'''

''Додаткові ідентифікатори:''

* '''dc.identifier.citationen''' — '''Accessible to man, standard bibliographic description, not-DSpace format for this material.'''
* '''dc.identifier.doi''' — '''Цифровий ідентифікатор об'єкта (DOI), виданий реєстраційним агенством DOI на цю публікацію.'''
* '''dc.identifier.orcid''' — '''Унікальний ідентифікатор вченого з міжнародного реєстру ORCID.'''
* '''dc.identifier.patent''' — '''№ патенту (число).'''
* '''dc.identifier.scopus''' — '''Ідентифікатор статті у реферативній БД Scopus.'''

''Пов’язані джерела:''

* '''dc.relation.references''' — '''Список використаних джерел, посилання на літературу, що були використані при підготовці матеріалу.'''
* '''dc.relation.referencesen''' — '''List of used sources, literature references that were used during the preparation the material.'''
* '''dc.relation.uri''' — '''Посилається на загальноприйнятий ідентифікатор ресурсу для пов’язаного матеріалу.'''

''Додаткові класифікаційні індекси:''

* '''dc.subject.udc''' — '''УДК'''
* '''dc.subject.bbk''' — '''ББК'''
* '''dc.subject.jel''' — '''Система класифікації JEL для наукової літератури в галузі економіки.'''
* '''dc.subject.mesh''' — '''Медичні тематичні рубрики.'''
* '''dc.subject.pacs''' — '''Код класифікації з фізики та астрономії (PACS).'''

''Група полів для Google Академії:''

* '''dc.citation.conference''' — '''Назва заходу, конференції, події, за результатами яких видано ці матеріали.'''
* '''dc.citation.journalTitle''' — '''Основна офіційна назва журналу.'''
* '''dc.citation.volume''' — '''Номер тому, починається завжди з цифр (араб. чи грець.), якщо є назва, то додається через двокрапку; без слова том.'''
* '''dc.citation.issue''' — '''Номер випуску (для журналу); без „№ “.'''
* '''dc.citation.spage''' — '''Початковий номер сторінки.'''
* '''dc.citation.epage''' — '''Кінцевий номер сторінки.'''

''Група дисертаційних полів:''

* '''thesis.degree.department''' — '''Назва академічного відділу, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.discipline''' — '''Область вивчення інтелектуального змісту дисертації тощо.'''
* '''thesis.degree.grantor''' — '''Назва установи, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.level''' — '''Градація ступеня, пов’язаного з дисертацією тощо. («кандидатська» чи «докторська»).'''
* '''thesis.degree.name''' — '''Назва ступеня, пов’язаного з дисертацією тощо. (доктор філософії, кандидат гуманітарних наук тощо).'''

== Файл QDC.properties ==

Попереднє відображення типових елементів метаданих DSpace у схему QDC XML.
Необхідне для Google Академії і т.п.

Приводиться відображення для існуючих та нових полів.

Розміщення (в залежності від встановлення): /home/data/dspace/config/crosswalks/QDC.properties

Приклад для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/QDC.properties

Додати наприкінці наступне

dc.citation.journalTitle = <dc:citation_journal_title />
dc.citation.volume = <dc:citation_volume />
dc.citation.issue = <dc:citation_issue />
dc.citation.spage = <dc:citation_firstpage />
dc.citation.epage = <dc:citation_lastpage />
dc.identifier.doi = <dc:citation_doi />
dc.identifier.issn = <dc:citation_issn />
dc.identifier.isbn = <dc:citation_isbn />
dc.citation.conference = <dc:citation_conference />
dc.citation.conference = <dc:citation_conference_title />
dc.coverage.country = <dc:citation_patent_country />
dc.identifier.patent = <dc:citation_patent_number />
dc.subject = <dc:citation_keywords />
# dc.date.submitted = <dcterms:dateSubmitted />
dc.contributor.affiliation = <dc:citation_author_institution />
thesis.degree.grantor = <dc:citation_dissertation_institution />
dc.date.available = <dc:citation_online_date />
dc.identifier.doi = <dc:citation_doi />
dc.date.issued = <dc:citation_publication_date />
dc.description.abstract = <dc:citation_abstract />
dc.subject.udc = <dc:subject type="dcterms:UDC" />
dc.subject.bbk = <dc:subject type="dcterms:BBK" />
dc.subject.jel = <dc:subject type="dcterms:JEL" />
dc.subject.pacs = <dc:subject type="dcterms:PACS" />

== Файл xhtml-head-item.properties ==

Відображення між схемою реєстру метаданих DSpace та схемою, що записується у тег <meta> заголовку XHTML.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/crosswalks/xhtml-head-item.properties

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/xhtml-head-item.properties

Деякі ідеї взяті з статті https://jira.duraspace.org/secure/attachment/13020/Invisible_institutional.pdf

Додати наприкінці наступне

dc.citation.journalTitle = citation_journal_title
dc.citation.volume = citation_volume
dc.citation.issue = citation_issue
dc.citation.spage = citation_firstpage
dc.citation.epage = citation_lastpage
dc.identifier.doi = citation_doi
dc.identifier.issn = citation_issn
dc.identifier.isbn = citation_isbn
dc.citation.conference = citation_conference_title
dc.coverage.country = citation_patent_country
dc.identifier.patent = citation_patent_number
dc.subject = citation_keywords
dc.date.submitted = DCTERMS.dateSubmitted,DCTERMS.W3CDTF
dc.contributor.affiliation = citation_author_institution
thesis.degree.grantor = citation_dissertation_institution
dc.date.available = citation_online_date
dc.identifier.doi = citation_doi
dc.date.issued = citation_publication_date
dc.description.abstract = citation_abstract
dc.identifier.citationen = DCTERMS.bibliographicCitation
dc.subject.udc = DCTERMS.UDC
dc.subject.bbk = DCTERMS.BBK
dc.subject.jel = DCTERMS.JEL
dc.subject.pacs = DCTERMS.PACS
dc.relation.references = DCTERMS.references
dc.relation.referencesen = DCTERMS.references

== Файл google-metadata.properties ==

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/google-metadata.properties

Додати наприкінці наступне

google.citation_journal_title = dc.citation.journalTitle
google.citation_volume = dc.citation.volume
google.citation_issue = dc.citation.issue
google.citation_firstpage = dc.citation.spage
google.citation_lastpage = dc.citation.epage
google.citation_doi = dc.identifier.doi
google.citation_issn = dc.identifier.issn
google.citation_isbn = dc.identifier.isbn
google.citation_conference = dc.citation.conference
google.citation_conference_title = dc.citation.conference
google.citation_patent_country = dc.coverage.country
google.citation_patent_number = dc.identifier.patent
google.citation_keywords = dc.subject
google.citation_author_institution = dc.contributor.affiliation
google.citation_dissertation_institution = thesis.degree.grantor
google.citation_online_date = dc.date.available
google.citation_doi = dc.identifier.doi
google.citation_publication_date = dc.date.issued
google.citation_abstract = dc.description.abstract

== Файл форм вводу input-forms_uk.xml ==

Файл форм внесення метаданих.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/input-forms.xml

Замість перерахунку змін (у порівнянні з типовим) наведено файл [http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml input-forms.xml], що використовується в репозитарії [http://elartu.tntu.edu.ua ELARTU].

== Файл dspace.cfg ==

Файл налаштувань DSpace.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/dspace.cfg

Налаштування полів метаданих дублінського ядра що відображаються у вікні '''базового опису матеріалу'''.

webui.itemdisplay.default = dc.title, \
dc.title.alternative, \
dc.contributor.author, \
dc.contributor.affiliation, \
dc.identifier.citation, \
dc.identifier.citationen, \
dc.relation.ispartof, \
dc.citation.conference, \
dc.citation.journalTitle, \
dc.citation.issue, \
dc.citation.volume, \
dc.identifier.patent, \
dc.date.issued(date), dc.date.submitted(date), dc.publisher, \
dc.coverage.country, dc.coverage.placename, dc.coverage.temporal, \
thesis.degree.name, thesis.degree.level, thesis.degree.discipline, \
thesis.degree.department, thesis.degree.grantor, \
dc.contributor.editor, dc.contributor.advisor, dc.contributor.committeeMember, \
dc.contributor.illustrator, dc.contributor.photographer, dc.contributor.translator, \
dc.identifier.orcid, dc.identifier.scopus, \
dc.identifier.doi, \
dc.subject.udc, dc.subject.bbk, dc.subject.jel, dc.subject.mesh, dc.subject.pacs, dc.subject, \
dc.format.pages, dc.format.extent, dc.citation.spage, dc.citation.epage, \
dc.relation.ispartofseries, \
dc.description.abstract, dc.description, dc.description.sponsorship, dc.description.tableofcontents, \
dc.identifier.govdoc, dc.identifier.uri(link), \
dc.identifier.isbn, dc.identifier.issn, \
dc.identifier.ismn, dc.identifier, dc.identifier.grantnumber, \
dc.rights.holder, dc.status, \
dc.relation.uri(link), \
dc.relation.references, \
dc.relation.referencesen

Щоб класифікаційні індекси стали гіперпосиланнями додайте також рядок типу
webui.browse.link.1 = author:dc.contributor.author
webui.browse.link.2 = subject:dc.subject.*
webui.browse.link.3 = affiliation:dc.contributor.affiliation
webui.browse.link.4 = journalTitle:dc.citation.journalTitle
webui.browse.link.5 = ispartof:dc.relation.ispartof
webui.browse.link.6 = issn:dc.identifier.issn
webui.browse.link.7 = thesisdegreename:thesis.degree.name
webui.browse.link.8 = thesisdegreelevel:thesis.degree.level
webui.browse.link.9 = thesisdegreediscipline:thesis.degree.discipline
webui.browse.link.10 = thesisdegreedepartment:thesis.degree.department
webui.browse.link.11 = thesisdegreegrantor:thesis.degree.grantor
webui.browse.link.12 = type:dc.type
webui.browse.link.13 = publisher:dc.publisher
webui.browse.link.14 = dateissued:dc.date.issued
webui.browse.link.15 = conference:dc.citation.conference
webui.browse.link.16 = language:dc.language.*

== Рядки локалізацій для нових полів ==
Також див. [[Українізація DSpace]]

=== Messages_uk.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_uk.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_uk.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Останні надходження
metadata.dc.contributor.advisor = Науковий керівник
metadata.dc.contributor.committeeMember = Члени комітету
metadata.dc.contributor.illustrator = Ілюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Перекладач
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Рада захисту
metadata.thesis.degree.discipline = Шифр та назва спеціальності
metadata.thesis.degree.grantor = Установа захисту
metadata.thesis.degree.level = Рівень дисертації
metadata.thesis.degree.name = Науковий ступінь
metadata.dc.rights.holder = Власник авторського права
metadata.dc.coverage.placename = Місце видання, проведення
metadata.dc.status = Статус публікації
metadata.dc.description.tableofcontents = Зміст
metadata.dc.format.pages = Кількість сторінок
metadata.dc.format.extent = Діапазон сторінок
metadata.dc.identifier.grantnumber = Ідентифікатор гранту
metadata.dc.relation.references = Перелік літератури
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Приналежність
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подання
metadata.dc.coverage.temporal = Часове охоплення
metadata.dc.description.sponsorship = Спонсорська підтримка
metadata.dc.relation.ispartof = Є частиною видання
metadata.dc.citation.conference = Конференція/захід
metadata.dc.citation.journalTitle = Журнал/збірник
metadata.dc.citation.issue = Випуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патенту
metadata.dc.coverage.country = Країна (код)
metadata.dc.identifier.orcid = Ідентифікатор ORCID
metadata.dc.identifier.scopus = Ідентифікатор Scopus
metadata.dc.subject.mesh = Медичні тематичні рубрики (MESH)
metadata.dc.subject.pacs = Код класифікації з фізики та астрономії (PACS)
metadata.dc.citation.spage = Початкова сторінка
metadata.dc.citation.epage = Кінцева сторінка
metadata.dc.relation.uri = URL-посилання пов’язаного матеріалу

=== Messages_ru.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_ru.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_ru.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Последние поступления
browse.menu.author = Автор
browse.menu.subject = Темы
browse.menu.title = Заглавие
browse.menu.dateissued = Даты выпуска
metadata.dc.contributor.advisor = Научный руководитель
metadata.dc.contributor.committeeMember = Члены комитета
metadata.dc.contributor.illustrator = Иллюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Переводчик
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Совет защиты
metadata.thesis.degree.discipline = Шифр и название специальности
metadata.thesis.degree.grantor = Учреждение защиты
metadata.thesis.degree.level = Уровень диссертации
metadata.thesis.degree.name = Научная степень
metadata.dc.rights.holder = Владелец авторского права
metadata.dc.coverage.placename = Место издания, проведения
metadata.dc.status = Статус публикации
metadata.dc.description.tableofcontents = Содержание
metadata.dc.format.pages = Количество страниц
metadata.dc.format.extent = Диапазон страниц
metadata.dc.identifier.grantnumber = Идентификатор гранта
metadata.dc.relation.references = Список литературы
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Принадлежность
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подачи
metadata.dc.coverage.temporal = Временной охват
metadata.dc.description.sponsorship = Спонсорская поддержка
metadata.dc.relation.ispartof = Является частью издания
metadata.dc.citation.conference = Конференция/мероприятие
metadata.dc.citation.journalTitle = Журнал/сборник
metadata.dc.citation.issue = Выпуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патента
metadata.dc.coverage.country = Страна (код)
metadata.dc.identifier.orcid = Идентификатор ORCID
metadata.dc.identifier.scopus = Идентификатор Scopus
metadata.dc.subject.mesh = Медицинские тематические рубрики (MESH)
metadata.dc.subject.pacs = Код классификации по физике и астрономии (PACS)
metadata.dc.citation.spage = Начальная страница
metadata.dc.citation.epage = Последняя страница
metadata.dc.relation.uri = URL-ссылки связанного материала

=== Messages.properties ===
Файл зберігається в бінарному файлі dspace-api-X.X.jar, що розміщується за шляхами
/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/
(чи іншими, залежно від встановлення)

Файл dspace-api-X.X.jar також є архівом, отож Messages.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Recent submissions
metadata.dc.relation.references = References (Ukraine)
metadata.dc.relation.referencesen = References (International)
metadata.dc.identifier.citation = Bibliographic description (Ukraine)
metadata.dc.identifier.citationen = Bibliographic description (International)
metadata.dc.contributor.affiliation = Affiliation
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Submitted date
metadata.dc.coverage.temporal = Temporal Coverage
metadata.dc.description.sponsorship = Sponsorship
metadata.dc.relation.ispartof = Is part of
metadata.dc.citation.conference = Conference/Event
metadata.dc.citation.journalTitle = Journal/Collection
metadata.dc.citation.issue = Issue
metadata.dc.citation.volume = Volume
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = Patent No
metadata.dc.coverage.country = Country (code)
metadata.dc.identifier.orcid = ORCID Id
metadata.dc.identifier.scopus = Scopus Id
metadata.dc.subject.mesh = Medical Subject Headings (MESH)
metadata.dc.subject.pacs = Physics and Astronomy Classification Scheme (PACS)
metadata.dc.citation.spage = Start page
metadata.dc.citation.epage = End page
metadata.dc.relation.uri = URL for reference material
metadata.dc.description.tableofcontents = Content
metadata.dc.coverage.placename = Place of the edition/event
metadata.dc.contributor.advisor = Supervisor
metadata.dc.contributor.committeeMember = Committee members
metadata.dc.format.pages = Number of pages
metadata.dc.format.extent = Page range
metadata.dc.contributor.illustrator = Illustrator
metadata.dc.contributor.photographer = Photographer
metadata.dc.contributor.translator = Translator
metadata.dc.identifier.grantnumber = Grant ID
metadata.dc.rights.holder = Copyright owner
metadata.dc.status = Publications status
metadata.dc.subject.bbk = BBK
metadata.dc.subject.udc = UDC
metadata.thesis.degree.department = Defense council
metadata.thesis.degree.discipline = Code and name of the specialty
metadata.thesis.degree.grantor = Institution defense
metadata.thesis.degree.level = Level thesis
metadata.thesis.degree.name = Science degree

Після доповнення мовних файлів Messages_uk.properties, Messages_ru.properties, Messages.properties, збереженні їх у dspace-api-lang-X.X.X.jar та dspace-api-X.X.jar, розміщенні останніх за відповідними шляхами у системі, також необхідно перезапустити веб-сервер Tomcat

/etc/init.d/tomcat8 restart

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Українізація DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Додаткові поля Dublin Core для DSpace

2017-10-26T11:51:26Z

Dubyk: /* Рядки локалізацій для нових полів */

== Додаткові поля ==

Додаються/редагуються в інтерфейсі адміністрування » '''Реєстр полів метаданих''':

* '''dc.contributor.advisor''' — '''Використовуйте в першу чергу для наукового керівника дисертації.'''
* '''dc.contributor.affiliation''' — '''Місце роботи автора (повна назва організації, повна адреса, регалії та контактні дані).'''
* '''dc.contributor.committeeMember''' — '''Використовується для членів дисертаційного комітету.'''

* '''dc.coverage.country''' — '''Країна (2-букв. код країни за ISO_3166-1 alpha-2).'''
* '''dc.coverage.placename''' — '''Ареал охоплення або район розташування, охоплювані у даних, наприклад, регіони, країни чи міста.'''

* '''dc.date.submitted''' — '''Дата подання матеріалу. Рекомендовано для творів/тез/дисертацій.'''

* '''dc.description.tableofcontents''' — '''Таблиця змісту для даного матеріалу.'''

* '''dc.format.extent''' — '''Розмір та тривалість. Також діапазон сторінок.'''
* '''dc.format.pages''' — '''Обсяг матеріалу, кількість сторінок.'''

''Додаткові ідентифікатори:''

* '''dc.identifier.citationen''' — '''Accessible to man, standard bibliographic description, not-DSpace format for this material.'''
* '''dc.identifier.doi''' — '''Цифровий ідентифікатор об'єкта (DOI), виданий реєстраційним агенством DOI на цю публікацію.'''
* '''dc.identifier.orcid''' — '''Унікальний ідентифікатор вченого з міжнародного реєстру ORCID.'''
* '''dc.identifier.patent''' — '''№ патенту (число).'''
* '''dc.identifier.scopus''' — '''Ідентифікатор статті у реферативній БД Scopus.'''

''Пов’язані джерела:''

* '''dc.relation.references''' — '''Список використаних джерел, посилання на літературу, що були використані при підготовці матеріалу.'''
* '''dc.relation.referencesen''' — '''List of used sources, literature references that were used during the preparation the material.'''
* '''dc.relation.uri''' — '''Посилається на загальноприйнятий ідентифікатор ресурсу для пов’язаного матеріалу.'''

''Додаткові класифікаційні індекси:''

* '''dc.subject.udc''' — '''УДК'''
* '''dc.subject.bbk''' — '''ББК'''
* '''dc.subject.jel''' — '''Система класифікації JEL для наукової літератури в галузі економіки.'''
* '''dc.subject.mesh''' — '''Медичні тематичні рубрики.'''
* '''dc.subject.pacs''' — '''Код класифікації з фізики та астрономії (PACS).'''

''Група полів для Google Академії:''

* '''dc.citation.conference''' — '''Назва заходу, конференції, події, за результатами яких видано ці матеріали.'''
* '''dc.citation.journalTitle''' — '''Основна офіційна назва журналу.'''
* '''dc.citation.volume''' — '''Номер тому, починається завжди з цифр (араб. чи грець.), якщо є назва, то додається через двокрапку; без слова том.'''
* '''dc.citation.issue''' — '''Номер випуску (для журналу); без „№ “.'''
* '''dc.citation.spage''' — '''Початковий номер сторінки.'''
* '''dc.citation.epage''' — '''Кінцевий номер сторінки.'''

''Група дисертаційних полів:''

* '''thesis.degree.department''' — '''Назва академічного відділу, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.discipline''' — '''Область вивчення інтелектуального змісту дисертації тощо.'''
* '''thesis.degree.grantor''' — '''Назва установи, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.level''' — '''Градація ступеня, пов’язаного з дисертацією тощо. («кандидатська» чи «докторська»).'''
* '''thesis.degree.name''' — '''Назва ступеня, пов’язаного з дисертацією тощо. (доктор філософії, кандидат гуманітарних наук тощо).'''

== Файл QDC.properties ==

Попереднє відображення типових елементів метаданих DSpace у схему QDC XML.
Необхідне для Google Академії і т.п.

Приводиться відображення для існуючих та нових полів.

Розміщення (в залежності від встановлення): /home/data/dspace/config/crosswalks/QDC.properties

Приклад для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/QDC.properties

Додати наприкінці наступне

dc.citation.journalTitle = <dc:citation_journal_title />
dc.citation.volume = <dc:citation_volume />
dc.citation.issue = <dc:citation_issue />
dc.citation.spage = <dc:citation_firstpage />
dc.citation.epage = <dc:citation_lastpage />
dc.identifier.doi = <dc:citation_doi />
dc.identifier.issn = <dc:citation_issn />
dc.identifier.isbn = <dc:citation_isbn />
dc.citation.conference = <dc:citation_conference />
dc.citation.conference = <dc:citation_conference_title />
dc.coverage.country = <dc:citation_patent_country />
dc.identifier.patent = <dc:citation_patent_number />
dc.subject = <dc:citation_keywords />
# dc.date.submitted = <dcterms:dateSubmitted />
dc.contributor.affiliation = <dc:citation_author_institution />
thesis.degree.grantor = <dc:citation_dissertation_institution />
dc.date.available = <dc:citation_online_date />
dc.identifier.doi = <dc:citation_doi />
dc.date.issued = <dc:citation_publication_date />
dc.description.abstract = <dc:citation_abstract />
dc.subject.udc = <dc:subject type="dcterms:UDC" />
dc.subject.bbk = <dc:subject type="dcterms:BBK" />
dc.subject.jel = <dc:subject type="dcterms:JEL" />
dc.subject.pacs = <dc:subject type="dcterms:PACS" />

== Файл xhtml-head-item.properties ==

Відображення між схемою реєстру метаданих DSpace та схемою, що записується у тег <meta> заголовку XHTML.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/crosswalks/xhtml-head-item.properties

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/xhtml-head-item.properties

Деякі ідеї взяті з статті https://jira.duraspace.org/secure/attachment/13020/Invisible_institutional.pdf

Додати наприкінці наступне

dc.citation.journalTitle = citation_journal_title
dc.citation.volume = citation_volume
dc.citation.issue = citation_issue
dc.citation.spage = citation_firstpage
dc.citation.epage = citation_lastpage
dc.identifier.doi = citation_doi
dc.identifier.issn = citation_issn
dc.identifier.isbn = citation_isbn
dc.citation.conference = citation_conference_title
dc.coverage.country = citation_patent_country
dc.identifier.patent = citation_patent_number
dc.subject = citation_keywords
dc.date.submitted = DCTERMS.dateSubmitted,DCTERMS.W3CDTF
dc.contributor.affiliation = citation_author_institution
thesis.degree.grantor = citation_dissertation_institution
dc.date.available = citation_online_date
dc.identifier.doi = citation_doi
dc.date.issued = citation_publication_date
dc.description.abstract = citation_abstract
dc.identifier.citationen = DCTERMS.bibliographicCitation
dc.subject.udc = DCTERMS.UDC
dc.subject.bbk = DCTERMS.BBK
dc.subject.jel = DCTERMS.JEL
dc.subject.pacs = DCTERMS.PACS
dc.relation.references = DCTERMS.references
dc.relation.referencesen = DCTERMS.references

== Файл google-metadata.properties ==

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/google-metadata.properties

Додати наприкінці наступне

google.citation_journal_title = dc.citation.journalTitle
google.citation_volume = dc.citation.volume
google.citation_issue = dc.citation.issue
google.citation_firstpage = dc.citation.spage
google.citation_lastpage = dc.citation.epage
google.citation_doi = dc.identifier.doi
google.citation_issn = dc.identifier.issn
google.citation_isbn = dc.identifier.isbn
google.citation_conference = dc.citation.conference
google.citation_conference_title = dc.citation.conference
google.citation_patent_country = dc.coverage.country
google.citation_patent_number = dc.identifier.patent
google.citation_keywords = dc.subject
google.citation_author_institution = dc.contributor.affiliation
google.citation_dissertation_institution = thesis.degree.grantor
google.citation_online_date = dc.date.available
google.citation_doi = dc.identifier.doi
google.citation_publication_date = dc.date.issued
google.citation_abstract = dc.description.abstract

== Файл форм вводу input-forms_uk.xml ==

Файл форм внесення метаданих.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/input-forms.xml

Замість перерахунку змін (у порівнянні з типовим) наведено файл [http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml input-forms.xml], що використовується в репозитарії [http://elartu.tntu.edu.ua ELARTU].

== Файл dspace.cfg ==

Файл налаштувань DSpace.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/dspace.cfg

Налаштування полів метаданих дублінського ядра що відображаються у вікні '''базового опису матеріалу'''.

webui.itemdisplay.default = dc.title, \
dc.title.alternative, \
dc.contributor.author, \
dc.contributor.affiliation, \
dc.identifier.citation, \
dc.identifier.citationen, \
dc.relation.ispartof, \
dc.citation.conference, \
dc.citation.journalTitle, \
dc.citation.issue, \
dc.citation.volume, \
dc.identifier.patent, \
dc.date.issued(date), dc.date.submitted(date), dc.publisher, \
dc.coverage.country, dc.coverage.placename, dc.coverage.temporal, \
thesis.degree.name, thesis.degree.level, thesis.degree.discipline, \
thesis.degree.department, thesis.degree.grantor, \
dc.contributor.editor, dc.contributor.advisor, dc.contributor.committeeMember, \
dc.contributor.illustrator, dc.contributor.photographer, dc.contributor.translator, \
dc.identifier.orcid, dc.identifier.scopus, \
dc.identifier.doi, \
dc.subject.udc, dc.subject.bbk, dc.subject.jel, dc.subject.mesh, dc.subject.pacs, dc.subject, \
dc.format.pages, dc.format.extent, dc.citation.spage, dc.citation.epage, \
dc.relation.ispartofseries, \
dc.description.abstract, dc.description, dc.description.sponsorship, dc.description.tableofcontents, \
dc.identifier.govdoc, dc.identifier.uri(link), \
dc.identifier.isbn, dc.identifier.issn, \
dc.identifier.ismn, dc.identifier, dc.identifier.grantnumber, \
dc.rights.holder, dc.status, \
dc.relation.uri(link), \
dc.relation.references, \
dc.relation.referencesen

Щоб класифікаційні індекси стали гіперпосиланнями додайте також рядок типу
webui.browse.link.1 = author:dc.contributor.author
webui.browse.link.2 = subject:dc.subject.*
webui.browse.link.3 = affiliation:dc.contributor.affiliation
webui.browse.link.4 = journalTitle:dc.citation.journalTitle
webui.browse.link.5 = ispartof:dc.relation.ispartof
webui.browse.link.6 = issn:dc.identifier.issn
webui.browse.link.7 = thesisdegreename:thesis.degree.name
webui.browse.link.8 = thesisdegreelevel:thesis.degree.level
webui.browse.link.9 = thesisdegreediscipline:thesis.degree.discipline
webui.browse.link.10 = thesisdegreedepartment:thesis.degree.department
webui.browse.link.11 = thesisdegreegrantor:thesis.degree.grantor
webui.browse.link.12 = type:dc.type
webui.browse.link.13 = publisher:dc.publisher
webui.browse.link.14 = dateissued:dc.date.issued
webui.browse.link.15 = conference:dc.citation.conference
webui.browse.link.16 = language:dc.language.*

== Рядки локалізацій для нових полів ==
Також див. [[Українізація DSpace]]

=== Messages_uk.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_uk.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_uk.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Останні надходження
metadata.dc.contributor.advisor = Науковий керівник
metadata.dc.contributor.committeeMember = Члени комітету
metadata.dc.contributor.illustrator = Ілюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Перекладач
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Рада захисту
metadata.thesis.degree.discipline = Шифр та назва спеціальності
metadata.thesis.degree.grantor = Установа захисту
metadata.thesis.degree.level = Рівень дисертації
metadata.thesis.degree.name = Науковий ступінь
metadata.dc.rights.holder = Власник авторського права
metadata.dc.coverage.placename = Місце видання, проведення
metadata.dc.status = Статус публікації
metadata.dc.description.tableofcontents = Зміст
metadata.dc.format.pages = Кількість сторінок
metadata.dc.format.extent = Діапазон сторінок
metadata.dc.identifier.grantnumber = Ідентифікатор гранту
metadata.dc.relation.references = Перелік літератури
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Приналежність
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подання
metadata.dc.coverage.temporal = Часове охоплення
metadata.dc.description.sponsorship = Спонсорська підтримка
metadata.dc.relation.ispartof = Є частиною видання
metadata.dc.citation.conference = Конференція/захід
metadata.dc.citation.journalTitle = Журнал/збірник
metadata.dc.citation.issue = Випуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патенту
metadata.dc.coverage.country = Країна (код)
metadata.dc.identifier.orcid = Ідентифікатор ORCID
metadata.dc.identifier.scopus = Ідентифікатор Scopus
metadata.dc.subject.mesh = Медичні тематичні рубрики (MESH)
metadata.dc.subject.pacs = Код класифікації з фізики та астрономії (PACS)
metadata.dc.citation.spage = Початкова сторінка
metadata.dc.citation.epage = Кінцева сторінка
metadata.dc.relation.uri = URL-посилання пов’язаного матеріалу

=== Messages_ru.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_ru.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_ru.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Последние поступления
browse.menu.author = Автор
browse.menu.subject = Темы
browse.menu.title = Заглавие
browse.menu.dateissued = Даты выпуска
metadata.dc.contributor.advisor = Научный руководитель
metadata.dc.contributor.committeeMember = Члены комитета
metadata.dc.contributor.illustrator = Иллюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Переводчик
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Совет защиты
metadata.thesis.degree.discipline = Шифр и название специальности
metadata.thesis.degree.grantor = Учреждение защиты
metadata.thesis.degree.level = Уровень диссертации
metadata.thesis.degree.name = Научная степень
metadata.dc.rights.holder = Владелец авторского права
metadata.dc.coverage.placename = Место издания, проведения
metadata.dc.status = Статус публикации
metadata.dc.description.tableofcontents = Содержание
metadata.dc.format.pages = Количество страниц
metadata.dc.format.extent = Диапазон страниц
metadata.dc.identifier.grantnumber = Идентификатор гранта
metadata.dc.relation.references = Список литературы
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Принадлежность
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подачи
metadata.dc.coverage.temporal = Временной охват
metadata.dc.description.sponsorship = Спонсорская поддержка
metadata.dc.relation.ispartof = Является частью издания
metadata.dc.citation.conference = Конференция/мероприятие
metadata.dc.citation.journalTitle = Журнал/сборник
metadata.dc.citation.issue = Выпуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патента
metadata.dc.coverage.country = Страна (код)
metadata.dc.identifier.orcid = Идентификатор ORCID
metadata.dc.identifier.scopus = Идентификатор Scopus
metadata.dc.subject.mesh = Медицинские тематические рубрики (MESH)
metadata.dc.subject.pacs = Код классификации по физике и астрономии (PACS)
metadata.dc.citation.spage = Начальная страница
metadata.dc.citation.epage = Последняя страница
metadata.dc.relation.uri = URL-ссылки связанного материала

=== Messages.properties ===
Файл зберігається в бінарному файлі dspace-api-X.X.jar, що розміщується за шляхами
/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/
(чи іншими, залежно від встановлення)

Файл dspace-api-X.X.jar також є архівом, отож Messages.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Recent submissions
metadata.dc.relation.references = References (Ukraine)
metadata.dc.relation.referencesen = References (International)
metadata.dc.identifier.citation = Bibliographic description (Ukraine)
metadata.dc.identifier.citationen = Bibliographic description (International)
metadata.dc.contributor.affiliation = Affiliation
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Submitted date
metadata.dc.coverage.temporal = Temporal Coverage
metadata.dc.description.sponsorship = Sponsorship
metadata.dc.relation.ispartof = Is part of
metadata.dc.citation.conference = Conference/Event
metadata.dc.citation.journalTitle = Journal/Collection
metadata.dc.citation.issue = Issue
metadata.dc.citation.volume = Volume
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = Patent No
metadata.dc.coverage.country = Country (code)
metadata.dc.identifier.orcid = ORCID Id
metadata.dc.identifier.scopus = Scopus Id
metadata.dc.subject.mesh = Medical Subject Headings (MESH)
metadata.dc.subject.pacs = Physics and Astronomy Classification Scheme (PACS)
metadata.dc.citation.spage = Start page
metadata.dc.citation.epage = End page
metadata.dc.relation.uri = URL for reference material
metadata.dc.description.tableofcontents = Content
metadata.dc.coverage.placename = Place of the edition/event
metadata.dc.contributor.advisor = Supervisor
metadata.dc.contributor.committeeMember = Committee members
metadata.dc.format.pages = Number of pages
metadata.dc.format.extent = Page range
metadata.dc.contributor.illustrator = Illustrator
metadata.dc.contributor.photographer = Photographer
metadata.dc.contributor.translator = Translator
metadata.dc.identifier.grantnumber = Grant ID
metadata.dc.rights.holder = Copyright owner
metadata.dc.status = Publications status
metadata.dc.subject.bbk = BBK
metadata.dc.subject.udc = UDC
metadata.thesis.degree.department = Defense council
metadata.thesis.degree.discipline = Code and name of the specialty
metadata.thesis.degree.grantor = Institution defense
metadata.thesis.degree.level = Level thesis
metadata.thesis.degree.name = Science degree

Після доповнення мовних файлів Messages_uk.properties, Messages_ru.properties, Messages.properties, збереженні їх у dspace-api-lang-X.X.X.jar та dspace-api-X.X.jar, розміщенні останніх за відповідними шляхами у системі, також необхідно перезапустити веб-сервер Tomcat

/etc/init.d/tomcat8 restart

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Додаткові поля Dublin Core для DSpace

2017-10-26T11:49:41Z

Dubyk: /* Файл dspace.cfg */

== Додаткові поля ==

Додаються/редагуються в інтерфейсі адміністрування » '''Реєстр полів метаданих''':

* '''dc.contributor.advisor''' — '''Використовуйте в першу чергу для наукового керівника дисертації.'''
* '''dc.contributor.affiliation''' — '''Місце роботи автора (повна назва організації, повна адреса, регалії та контактні дані).'''
* '''dc.contributor.committeeMember''' — '''Використовується для членів дисертаційного комітету.'''

* '''dc.coverage.country''' — '''Країна (2-букв. код країни за ISO_3166-1 alpha-2).'''
* '''dc.coverage.placename''' — '''Ареал охоплення або район розташування, охоплювані у даних, наприклад, регіони, країни чи міста.'''

* '''dc.date.submitted''' — '''Дата подання матеріалу. Рекомендовано для творів/тез/дисертацій.'''

* '''dc.description.tableofcontents''' — '''Таблиця змісту для даного матеріалу.'''

* '''dc.format.extent''' — '''Розмір та тривалість. Також діапазон сторінок.'''
* '''dc.format.pages''' — '''Обсяг матеріалу, кількість сторінок.'''

''Додаткові ідентифікатори:''

* '''dc.identifier.citationen''' — '''Accessible to man, standard bibliographic description, not-DSpace format for this material.'''
* '''dc.identifier.doi''' — '''Цифровий ідентифікатор об'єкта (DOI), виданий реєстраційним агенством DOI на цю публікацію.'''
* '''dc.identifier.orcid''' — '''Унікальний ідентифікатор вченого з міжнародного реєстру ORCID.'''
* '''dc.identifier.patent''' — '''№ патенту (число).'''
* '''dc.identifier.scopus''' — '''Ідентифікатор статті у реферативній БД Scopus.'''

''Пов’язані джерела:''

* '''dc.relation.references''' — '''Список використаних джерел, посилання на літературу, що були використані при підготовці матеріалу.'''
* '''dc.relation.referencesen''' — '''List of used sources, literature references that were used during the preparation the material.'''
* '''dc.relation.uri''' — '''Посилається на загальноприйнятий ідентифікатор ресурсу для пов’язаного матеріалу.'''

''Додаткові класифікаційні індекси:''

* '''dc.subject.udc''' — '''УДК'''
* '''dc.subject.bbk''' — '''ББК'''
* '''dc.subject.jel''' — '''Система класифікації JEL для наукової літератури в галузі економіки.'''
* '''dc.subject.mesh''' — '''Медичні тематичні рубрики.'''
* '''dc.subject.pacs''' — '''Код класифікації з фізики та астрономії (PACS).'''

''Група полів для Google Академії:''

* '''dc.citation.conference''' — '''Назва заходу, конференції, події, за результатами яких видано ці матеріали.'''
* '''dc.citation.journalTitle''' — '''Основна офіційна назва журналу.'''
* '''dc.citation.volume''' — '''Номер тому, починається завжди з цифр (араб. чи грець.), якщо є назва, то додається через двокрапку; без слова том.'''
* '''dc.citation.issue''' — '''Номер випуску (для журналу); без „№ “.'''
* '''dc.citation.spage''' — '''Початковий номер сторінки.'''
* '''dc.citation.epage''' — '''Кінцевий номер сторінки.'''

''Група дисертаційних полів:''

* '''thesis.degree.department''' — '''Назва академічного відділу, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.discipline''' — '''Область вивчення інтелектуального змісту дисертації тощо.'''
* '''thesis.degree.grantor''' — '''Назва установи, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.level''' — '''Градація ступеня, пов’язаного з дисертацією тощо. («кандидатська» чи «докторська»).'''
* '''thesis.degree.name''' — '''Назва ступеня, пов’язаного з дисертацією тощо. (доктор філософії, кандидат гуманітарних наук тощо).'''

== Файл QDC.properties ==

Попереднє відображення типових елементів метаданих DSpace у схему QDC XML.
Необхідне для Google Академії і т.п.

Приводиться відображення для існуючих та нових полів.

Розміщення (в залежності від встановлення): /home/data/dspace/config/crosswalks/QDC.properties

Приклад для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/QDC.properties

Додати наприкінці наступне

dc.citation.journalTitle = <dc:citation_journal_title />
dc.citation.volume = <dc:citation_volume />
dc.citation.issue = <dc:citation_issue />
dc.citation.spage = <dc:citation_firstpage />
dc.citation.epage = <dc:citation_lastpage />
dc.identifier.doi = <dc:citation_doi />
dc.identifier.issn = <dc:citation_issn />
dc.identifier.isbn = <dc:citation_isbn />
dc.citation.conference = <dc:citation_conference />
dc.citation.conference = <dc:citation_conference_title />
dc.coverage.country = <dc:citation_patent_country />
dc.identifier.patent = <dc:citation_patent_number />
dc.subject = <dc:citation_keywords />
# dc.date.submitted = <dcterms:dateSubmitted />
dc.contributor.affiliation = <dc:citation_author_institution />
thesis.degree.grantor = <dc:citation_dissertation_institution />
dc.date.available = <dc:citation_online_date />
dc.identifier.doi = <dc:citation_doi />
dc.date.issued = <dc:citation_publication_date />
dc.description.abstract = <dc:citation_abstract />
dc.subject.udc = <dc:subject type="dcterms:UDC" />
dc.subject.bbk = <dc:subject type="dcterms:BBK" />
dc.subject.jel = <dc:subject type="dcterms:JEL" />
dc.subject.pacs = <dc:subject type="dcterms:PACS" />

== Файл xhtml-head-item.properties ==

Відображення між схемою реєстру метаданих DSpace та схемою, що записується у тег <meta> заголовку XHTML.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/crosswalks/xhtml-head-item.properties

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/xhtml-head-item.properties

Деякі ідеї взяті з статті https://jira.duraspace.org/secure/attachment/13020/Invisible_institutional.pdf

Додати наприкінці наступне

dc.citation.journalTitle = citation_journal_title
dc.citation.volume = citation_volume
dc.citation.issue = citation_issue
dc.citation.spage = citation_firstpage
dc.citation.epage = citation_lastpage
dc.identifier.doi = citation_doi
dc.identifier.issn = citation_issn
dc.identifier.isbn = citation_isbn
dc.citation.conference = citation_conference_title
dc.coverage.country = citation_patent_country
dc.identifier.patent = citation_patent_number
dc.subject = citation_keywords
dc.date.submitted = DCTERMS.dateSubmitted,DCTERMS.W3CDTF
dc.contributor.affiliation = citation_author_institution
thesis.degree.grantor = citation_dissertation_institution
dc.date.available = citation_online_date
dc.identifier.doi = citation_doi
dc.date.issued = citation_publication_date
dc.description.abstract = citation_abstract
dc.identifier.citationen = DCTERMS.bibliographicCitation
dc.subject.udc = DCTERMS.UDC
dc.subject.bbk = DCTERMS.BBK
dc.subject.jel = DCTERMS.JEL
dc.subject.pacs = DCTERMS.PACS
dc.relation.references = DCTERMS.references
dc.relation.referencesen = DCTERMS.references

== Файл google-metadata.properties ==

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/google-metadata.properties

Додати наприкінці наступне

google.citation_journal_title = dc.citation.journalTitle
google.citation_volume = dc.citation.volume
google.citation_issue = dc.citation.issue
google.citation_firstpage = dc.citation.spage
google.citation_lastpage = dc.citation.epage
google.citation_doi = dc.identifier.doi
google.citation_issn = dc.identifier.issn
google.citation_isbn = dc.identifier.isbn
google.citation_conference = dc.citation.conference
google.citation_conference_title = dc.citation.conference
google.citation_patent_country = dc.coverage.country
google.citation_patent_number = dc.identifier.patent
google.citation_keywords = dc.subject
google.citation_author_institution = dc.contributor.affiliation
google.citation_dissertation_institution = thesis.degree.grantor
google.citation_online_date = dc.date.available
google.citation_doi = dc.identifier.doi
google.citation_publication_date = dc.date.issued
google.citation_abstract = dc.description.abstract

== Файл форм вводу input-forms_uk.xml ==

Файл форм внесення метаданих.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/input-forms.xml

Замість перерахунку змін (у порівнянні з типовим) наведено файл [http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml input-forms.xml], що використовується в репозитарії [http://elartu.tntu.edu.ua ELARTU].

== Файл dspace.cfg ==

Файл налаштувань DSpace.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/dspace.cfg

Налаштування полів метаданих дублінського ядра що відображаються у вікні '''базового опису матеріалу'''.

webui.itemdisplay.default = dc.title, \
dc.title.alternative, \
dc.contributor.author, \
dc.contributor.affiliation, \
dc.identifier.citation, \
dc.identifier.citationen, \
dc.relation.ispartof, \
dc.citation.conference, \
dc.citation.journalTitle, \
dc.citation.issue, \
dc.citation.volume, \
dc.identifier.patent, \
dc.date.issued(date), dc.date.submitted(date), dc.publisher, \
dc.coverage.country, dc.coverage.placename, dc.coverage.temporal, \
thesis.degree.name, thesis.degree.level, thesis.degree.discipline, \
thesis.degree.department, thesis.degree.grantor, \
dc.contributor.editor, dc.contributor.advisor, dc.contributor.committeeMember, \
dc.contributor.illustrator, dc.contributor.photographer, dc.contributor.translator, \
dc.identifier.orcid, dc.identifier.scopus, \
dc.identifier.doi, \
dc.subject.udc, dc.subject.bbk, dc.subject.jel, dc.subject.mesh, dc.subject.pacs, dc.subject, \
dc.format.pages, dc.format.extent, dc.citation.spage, dc.citation.epage, \
dc.relation.ispartofseries, \
dc.description.abstract, dc.description, dc.description.sponsorship, dc.description.tableofcontents, \
dc.identifier.govdoc, dc.identifier.uri(link), \
dc.identifier.isbn, dc.identifier.issn, \
dc.identifier.ismn, dc.identifier, dc.identifier.grantnumber, \
dc.rights.holder, dc.status, \
dc.relation.uri(link), \
dc.relation.references, \
dc.relation.referencesen

Щоб класифікаційні індекси стали гіперпосиланнями додайте також рядок типу
webui.browse.link.1 = author:dc.contributor.author
webui.browse.link.2 = subject:dc.subject.*
webui.browse.link.3 = affiliation:dc.contributor.affiliation
webui.browse.link.4 = journalTitle:dc.citation.journalTitle
webui.browse.link.5 = ispartof:dc.relation.ispartof
webui.browse.link.6 = issn:dc.identifier.issn
webui.browse.link.7 = thesisdegreename:thesis.degree.name
webui.browse.link.8 = thesisdegreelevel:thesis.degree.level
webui.browse.link.9 = thesisdegreediscipline:thesis.degree.discipline
webui.browse.link.10 = thesisdegreedepartment:thesis.degree.department
webui.browse.link.11 = thesisdegreegrantor:thesis.degree.grantor
webui.browse.link.12 = type:dc.type
webui.browse.link.13 = publisher:dc.publisher
webui.browse.link.14 = dateissued:dc.date.issued
webui.browse.link.15 = conference:dc.citation.conference
webui.browse.link.16 = language:dc.language.*

== Рядки локалізацій для нових полів ==
=== Messages_uk.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_uk.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_uk.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Останні надходження
metadata.dc.contributor.advisor = Науковий керівник
metadata.dc.contributor.committeeMember = Члени комітету
metadata.dc.contributor.illustrator = Ілюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Перекладач
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Рада захисту
metadata.thesis.degree.discipline = Шифр та назва спеціальності
metadata.thesis.degree.grantor = Установа захисту
metadata.thesis.degree.level = Рівень дисертації
metadata.thesis.degree.name = Науковий ступінь
metadata.dc.rights.holder = Власник авторського права
metadata.dc.coverage.placename = Місце видання, проведення
metadata.dc.status = Статус публікації
metadata.dc.description.tableofcontents = Зміст
metadata.dc.format.pages = Кількість сторінок
metadata.dc.format.extent = Діапазон сторінок
metadata.dc.identifier.grantnumber = Ідентифікатор гранту
metadata.dc.relation.references = Перелік літератури
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Приналежність
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подання
metadata.dc.coverage.temporal = Часове охоплення
metadata.dc.description.sponsorship = Спонсорська підтримка
metadata.dc.relation.ispartof = Є частиною видання
metadata.dc.citation.conference = Конференція/захід
metadata.dc.citation.journalTitle = Журнал/збірник
metadata.dc.citation.issue = Випуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патенту
metadata.dc.coverage.country = Країна (код)
metadata.dc.identifier.orcid = Ідентифікатор ORCID
metadata.dc.identifier.scopus = Ідентифікатор Scopus
metadata.dc.subject.mesh = Медичні тематичні рубрики (MESH)
metadata.dc.subject.pacs = Код класифікації з фізики та астрономії (PACS)
metadata.dc.citation.spage = Початкова сторінка
metadata.dc.citation.epage = Кінцева сторінка
metadata.dc.relation.uri = URL-посилання пов’язаного матеріалу

=== Messages_ru.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_ru.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_ru.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Последние поступления
browse.menu.author = Автор
browse.menu.subject = Темы
browse.menu.title = Заглавие
browse.menu.dateissued = Даты выпуска
metadata.dc.contributor.advisor = Научный руководитель
metadata.dc.contributor.committeeMember = Члены комитета
metadata.dc.contributor.illustrator = Иллюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Переводчик
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Совет защиты
metadata.thesis.degree.discipline = Шифр и название специальности
metadata.thesis.degree.grantor = Учреждение защиты
metadata.thesis.degree.level = Уровень диссертации
metadata.thesis.degree.name = Научная степень
metadata.dc.rights.holder = Владелец авторского права
metadata.dc.coverage.placename = Место издания, проведения
metadata.dc.status = Статус публикации
metadata.dc.description.tableofcontents = Содержание
metadata.dc.format.pages = Количество страниц
metadata.dc.format.extent = Диапазон страниц
metadata.dc.identifier.grantnumber = Идентификатор гранта
metadata.dc.relation.references = Список литературы
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Принадлежность
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подачи
metadata.dc.coverage.temporal = Временной охват
metadata.dc.description.sponsorship = Спонсорская поддержка
metadata.dc.relation.ispartof = Является частью издания
metadata.dc.citation.conference = Конференция/мероприятие
metadata.dc.citation.journalTitle = Журнал/сборник
metadata.dc.citation.issue = Выпуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патента
metadata.dc.coverage.country = Страна (код)
metadata.dc.identifier.orcid = Идентификатор ORCID
metadata.dc.identifier.scopus = Идентификатор Scopus
metadata.dc.subject.mesh = Медицинские тематические рубрики (MESH)
metadata.dc.subject.pacs = Код классификации по физике и астрономии (PACS)
metadata.dc.citation.spage = Начальная страница
metadata.dc.citation.epage = Последняя страница
metadata.dc.relation.uri = URL-ссылки связанного материала

=== Messages.properties ===
Файл зберігається в бінарному файлі dspace-api-X.X.jar, що розміщується за шляхами
/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/
(чи іншими, залежно від встановлення)

Файл dspace-api-X.X.jar також є архівом, отож Messages.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Recent submissions
metadata.dc.relation.references = References (Ukraine)
metadata.dc.relation.referencesen = References (International)
metadata.dc.identifier.citation = Bibliographic description (Ukraine)
metadata.dc.identifier.citationen = Bibliographic description (International)
metadata.dc.contributor.affiliation = Affiliation
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Submitted date
metadata.dc.coverage.temporal = Temporal Coverage
metadata.dc.description.sponsorship = Sponsorship
metadata.dc.relation.ispartof = Is part of
metadata.dc.citation.conference = Conference/Event
metadata.dc.citation.journalTitle = Journal/Collection
metadata.dc.citation.issue = Issue
metadata.dc.citation.volume = Volume
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = Patent No
metadata.dc.coverage.country = Country (code)
metadata.dc.identifier.orcid = ORCID Id
metadata.dc.identifier.scopus = Scopus Id
metadata.dc.subject.mesh = Medical Subject Headings (MESH)
metadata.dc.subject.pacs = Physics and Astronomy Classification Scheme (PACS)
metadata.dc.citation.spage = Start page
metadata.dc.citation.epage = End page
metadata.dc.relation.uri = URL for reference material
metadata.dc.description.tableofcontents = Content
metadata.dc.coverage.placename = Place of the edition/event
metadata.dc.contributor.advisor = Supervisor
metadata.dc.contributor.committeeMember = Committee members
metadata.dc.format.pages = Number of pages
metadata.dc.format.extent = Page range
metadata.dc.contributor.illustrator = Illustrator
metadata.dc.contributor.photographer = Photographer
metadata.dc.contributor.translator = Translator
metadata.dc.identifier.grantnumber = Grant ID
metadata.dc.rights.holder = Copyright owner
metadata.dc.status = Publications status
metadata.dc.subject.bbk = BBK
metadata.dc.subject.udc = UDC
metadata.thesis.degree.department = Defense council
metadata.thesis.degree.discipline = Code and name of the specialty
metadata.thesis.degree.grantor = Institution defense
metadata.thesis.degree.level = Level thesis
metadata.thesis.degree.name = Science degree

Після доповнення мовних файлів Messages_uk.properties, Messages_ru.properties, Messages.properties, збереженні їх у dspace-api-lang-X.X.X.jar та dspace-api-X.X.jar, розміщенні останніх за відповідними шляхами у системі, також необхідно перезапустити веб-сервер Tomcat

/etc/init.d/tomcat8 restart

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Додаткові поля Dublin Core для DSpace

2017-10-26T11:46:10Z

Dubyk: /* Файл форм вводу input-forms_uk.xml */

== Додаткові поля ==

Додаються/редагуються в інтерфейсі адміністрування » '''Реєстр полів метаданих''':

* '''dc.contributor.advisor''' — '''Використовуйте в першу чергу для наукового керівника дисертації.'''
* '''dc.contributor.affiliation''' — '''Місце роботи автора (повна назва організації, повна адреса, регалії та контактні дані).'''
* '''dc.contributor.committeeMember''' — '''Використовується для членів дисертаційного комітету.'''

* '''dc.coverage.country''' — '''Країна (2-букв. код країни за ISO_3166-1 alpha-2).'''
* '''dc.coverage.placename''' — '''Ареал охоплення або район розташування, охоплювані у даних, наприклад, регіони, країни чи міста.'''

* '''dc.date.submitted''' — '''Дата подання матеріалу. Рекомендовано для творів/тез/дисертацій.'''

* '''dc.description.tableofcontents''' — '''Таблиця змісту для даного матеріалу.'''

* '''dc.format.extent''' — '''Розмір та тривалість. Також діапазон сторінок.'''
* '''dc.format.pages''' — '''Обсяг матеріалу, кількість сторінок.'''

''Додаткові ідентифікатори:''

* '''dc.identifier.citationen''' — '''Accessible to man, standard bibliographic description, not-DSpace format for this material.'''
* '''dc.identifier.doi''' — '''Цифровий ідентифікатор об'єкта (DOI), виданий реєстраційним агенством DOI на цю публікацію.'''
* '''dc.identifier.orcid''' — '''Унікальний ідентифікатор вченого з міжнародного реєстру ORCID.'''
* '''dc.identifier.patent''' — '''№ патенту (число).'''
* '''dc.identifier.scopus''' — '''Ідентифікатор статті у реферативній БД Scopus.'''

''Пов’язані джерела:''

* '''dc.relation.references''' — '''Список використаних джерел, посилання на літературу, що були використані при підготовці матеріалу.'''
* '''dc.relation.referencesen''' — '''List of used sources, literature references that were used during the preparation the material.'''
* '''dc.relation.uri''' — '''Посилається на загальноприйнятий ідентифікатор ресурсу для пов’язаного матеріалу.'''

''Додаткові класифікаційні індекси:''

* '''dc.subject.udc''' — '''УДК'''
* '''dc.subject.bbk''' — '''ББК'''
* '''dc.subject.jel''' — '''Система класифікації JEL для наукової літератури в галузі економіки.'''
* '''dc.subject.mesh''' — '''Медичні тематичні рубрики.'''
* '''dc.subject.pacs''' — '''Код класифікації з фізики та астрономії (PACS).'''

''Група полів для Google Академії:''

* '''dc.citation.conference''' — '''Назва заходу, конференції, події, за результатами яких видано ці матеріали.'''
* '''dc.citation.journalTitle''' — '''Основна офіційна назва журналу.'''
* '''dc.citation.volume''' — '''Номер тому, починається завжди з цифр (араб. чи грець.), якщо є назва, то додається через двокрапку; без слова том.'''
* '''dc.citation.issue''' — '''Номер випуску (для журналу); без „№ “.'''
* '''dc.citation.spage''' — '''Початковий номер сторінки.'''
* '''dc.citation.epage''' — '''Кінцевий номер сторінки.'''

''Група дисертаційних полів:''

* '''thesis.degree.department''' — '''Назва академічного відділу, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.discipline''' — '''Область вивчення інтелектуального змісту дисертації тощо.'''
* '''thesis.degree.grantor''' — '''Назва установи, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.level''' — '''Градація ступеня, пов’язаного з дисертацією тощо. («кандидатська» чи «докторська»).'''
* '''thesis.degree.name''' — '''Назва ступеня, пов’язаного з дисертацією тощо. (доктор філософії, кандидат гуманітарних наук тощо).'''

== Файл QDC.properties ==

Попереднє відображення типових елементів метаданих DSpace у схему QDC XML.
Необхідне для Google Академії і т.п.

Приводиться відображення для існуючих та нових полів.

Розміщення (в залежності від встановлення): /home/data/dspace/config/crosswalks/QDC.properties

Приклад для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/QDC.properties

Додати наприкінці наступне

dc.citation.journalTitle = <dc:citation_journal_title />
dc.citation.volume = <dc:citation_volume />
dc.citation.issue = <dc:citation_issue />
dc.citation.spage = <dc:citation_firstpage />
dc.citation.epage = <dc:citation_lastpage />
dc.identifier.doi = <dc:citation_doi />
dc.identifier.issn = <dc:citation_issn />
dc.identifier.isbn = <dc:citation_isbn />
dc.citation.conference = <dc:citation_conference />
dc.citation.conference = <dc:citation_conference_title />
dc.coverage.country = <dc:citation_patent_country />
dc.identifier.patent = <dc:citation_patent_number />
dc.subject = <dc:citation_keywords />
# dc.date.submitted = <dcterms:dateSubmitted />
dc.contributor.affiliation = <dc:citation_author_institution />
thesis.degree.grantor = <dc:citation_dissertation_institution />
dc.date.available = <dc:citation_online_date />
dc.identifier.doi = <dc:citation_doi />
dc.date.issued = <dc:citation_publication_date />
dc.description.abstract = <dc:citation_abstract />
dc.subject.udc = <dc:subject type="dcterms:UDC" />
dc.subject.bbk = <dc:subject type="dcterms:BBK" />
dc.subject.jel = <dc:subject type="dcterms:JEL" />
dc.subject.pacs = <dc:subject type="dcterms:PACS" />

== Файл xhtml-head-item.properties ==

Відображення між схемою реєстру метаданих DSpace та схемою, що записується у тег <meta> заголовку XHTML.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/crosswalks/xhtml-head-item.properties

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/xhtml-head-item.properties

Деякі ідеї взяті з статті https://jira.duraspace.org/secure/attachment/13020/Invisible_institutional.pdf

Додати наприкінці наступне

dc.citation.journalTitle = citation_journal_title
dc.citation.volume = citation_volume
dc.citation.issue = citation_issue
dc.citation.spage = citation_firstpage
dc.citation.epage = citation_lastpage
dc.identifier.doi = citation_doi
dc.identifier.issn = citation_issn
dc.identifier.isbn = citation_isbn
dc.citation.conference = citation_conference_title
dc.coverage.country = citation_patent_country
dc.identifier.patent = citation_patent_number
dc.subject = citation_keywords
dc.date.submitted = DCTERMS.dateSubmitted,DCTERMS.W3CDTF
dc.contributor.affiliation = citation_author_institution
thesis.degree.grantor = citation_dissertation_institution
dc.date.available = citation_online_date
dc.identifier.doi = citation_doi
dc.date.issued = citation_publication_date
dc.description.abstract = citation_abstract
dc.identifier.citationen = DCTERMS.bibliographicCitation
dc.subject.udc = DCTERMS.UDC
dc.subject.bbk = DCTERMS.BBK
dc.subject.jel = DCTERMS.JEL
dc.subject.pacs = DCTERMS.PACS
dc.relation.references = DCTERMS.references
dc.relation.referencesen = DCTERMS.references

== Файл google-metadata.properties ==

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/google-metadata.properties

Додати наприкінці наступне

google.citation_journal_title = dc.citation.journalTitle
google.citation_volume = dc.citation.volume
google.citation_issue = dc.citation.issue
google.citation_firstpage = dc.citation.spage
google.citation_lastpage = dc.citation.epage
google.citation_doi = dc.identifier.doi
google.citation_issn = dc.identifier.issn
google.citation_isbn = dc.identifier.isbn
google.citation_conference = dc.citation.conference
google.citation_conference_title = dc.citation.conference
google.citation_patent_country = dc.coverage.country
google.citation_patent_number = dc.identifier.patent
google.citation_keywords = dc.subject
google.citation_author_institution = dc.contributor.affiliation
google.citation_dissertation_institution = thesis.degree.grantor
google.citation_online_date = dc.date.available
google.citation_doi = dc.identifier.doi
google.citation_publication_date = dc.date.issued
google.citation_abstract = dc.description.abstract

== Файл форм вводу input-forms_uk.xml ==

Файл форм внесення метаданих.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/input-forms.xml

Замість перерахунку змін (у порівнянні з типовим) наведено файл [http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml input-forms.xml], що використовується в репозитарії [http://elartu.tntu.edu.ua ELARTU].

== Файл dspace.cfg ==

Файл налаштувань DSpace.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/dspace.cfg

Налаштування полів метаданих дублінського ядра що відображаються у вікні '''базового опису матеріалу'''.

webui.itemdisplay.default = dc.title, \
dc.title.alternative, \
dc.contributor.author, \
dc.contributor.affiliation, \
dc.identifier.citation, \
dc.identifier.citationen, \
dc.relation.ispartof, \
dc.citation.conference, \
dc.citation.journalTitle, \
dc.citation.issue, \
dc.citation.volume, \
dc.identifier.patent, \
dc.date.issued(date), dc.date.submitted(date), dc.publisher, \
dc.coverage.country, dc.coverage.placename, dc.coverage.temporal, \
thesis.degree.name, thesis.degree.level, thesis.degree.discipline, \
thesis.degree.department, thesis.degree.grantor, \
dc.contributor.editor, dc.contributor.advisor, dc.contributor.committeeMember, \
dc.contributor.illustrator, dc.contributor.photographer, dc.contributor.translator, \
dc.identifier.orcid, dc.identifier.scopus, \
dc.identifier.doi, \
dc.subject.udc, dc.subject.bbk, dc.subject.jel, dc.subject.mesh, dc.subject.pacs, dc.subject, \
dc.format.pages, dc.format.extent, dc.citation.spage, dc.citation.epage, \
dc.relation.ispartofseries, \
dc.description.abstract, dc.description, dc.description.sponsorship, dc.description.tableofcontents, \
dc.identifier.govdoc, dc.identifier.uri(link), \
dc.identifier.isbn, dc.identifier.issn, \
dc.identifier.ismn, dc.identifier, dc.identifier.grantnumber, \
dc.rights.holder, dc.status, \
dc.relation.uri(link), \
dc.relation.references, \
dc.relation.referencesen

Щоб класифікаційні індекси стали гіперпосиланнями додайте також рядок типу
webui.browse.link.2 = subject:dc.subject.*

== Рядки локалізацій для нових полів ==
=== Messages_uk.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_uk.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_uk.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Останні надходження
metadata.dc.contributor.advisor = Науковий керівник
metadata.dc.contributor.committeeMember = Члени комітету
metadata.dc.contributor.illustrator = Ілюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Перекладач
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Рада захисту
metadata.thesis.degree.discipline = Шифр та назва спеціальності
metadata.thesis.degree.grantor = Установа захисту
metadata.thesis.degree.level = Рівень дисертації
metadata.thesis.degree.name = Науковий ступінь
metadata.dc.rights.holder = Власник авторського права
metadata.dc.coverage.placename = Місце видання, проведення
metadata.dc.status = Статус публікації
metadata.dc.description.tableofcontents = Зміст
metadata.dc.format.pages = Кількість сторінок
metadata.dc.format.extent = Діапазон сторінок
metadata.dc.identifier.grantnumber = Ідентифікатор гранту
metadata.dc.relation.references = Перелік літератури
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Приналежність
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подання
metadata.dc.coverage.temporal = Часове охоплення
metadata.dc.description.sponsorship = Спонсорська підтримка
metadata.dc.relation.ispartof = Є частиною видання
metadata.dc.citation.conference = Конференція/захід
metadata.dc.citation.journalTitle = Журнал/збірник
metadata.dc.citation.issue = Випуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патенту
metadata.dc.coverage.country = Країна (код)
metadata.dc.identifier.orcid = Ідентифікатор ORCID
metadata.dc.identifier.scopus = Ідентифікатор Scopus
metadata.dc.subject.mesh = Медичні тематичні рубрики (MESH)
metadata.dc.subject.pacs = Код класифікації з фізики та астрономії (PACS)
metadata.dc.citation.spage = Початкова сторінка
metadata.dc.citation.epage = Кінцева сторінка
metadata.dc.relation.uri = URL-посилання пов’язаного матеріалу

=== Messages_ru.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_ru.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_ru.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Последние поступления
browse.menu.author = Автор
browse.menu.subject = Темы
browse.menu.title = Заглавие
browse.menu.dateissued = Даты выпуска
metadata.dc.contributor.advisor = Научный руководитель
metadata.dc.contributor.committeeMember = Члены комитета
metadata.dc.contributor.illustrator = Иллюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Переводчик
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Совет защиты
metadata.thesis.degree.discipline = Шифр и название специальности
metadata.thesis.degree.grantor = Учреждение защиты
metadata.thesis.degree.level = Уровень диссертации
metadata.thesis.degree.name = Научная степень
metadata.dc.rights.holder = Владелец авторского права
metadata.dc.coverage.placename = Место издания, проведения
metadata.dc.status = Статус публикации
metadata.dc.description.tableofcontents = Содержание
metadata.dc.format.pages = Количество страниц
metadata.dc.format.extent = Диапазон страниц
metadata.dc.identifier.grantnumber = Идентификатор гранта
metadata.dc.relation.references = Список литературы
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Принадлежность
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подачи
metadata.dc.coverage.temporal = Временной охват
metadata.dc.description.sponsorship = Спонсорская поддержка
metadata.dc.relation.ispartof = Является частью издания
metadata.dc.citation.conference = Конференция/мероприятие
metadata.dc.citation.journalTitle = Журнал/сборник
metadata.dc.citation.issue = Выпуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патента
metadata.dc.coverage.country = Страна (код)
metadata.dc.identifier.orcid = Идентификатор ORCID
metadata.dc.identifier.scopus = Идентификатор Scopus
metadata.dc.subject.mesh = Медицинские тематические рубрики (MESH)
metadata.dc.subject.pacs = Код классификации по физике и астрономии (PACS)
metadata.dc.citation.spage = Начальная страница
metadata.dc.citation.epage = Последняя страница
metadata.dc.relation.uri = URL-ссылки связанного материала

=== Messages.properties ===
Файл зберігається в бінарному файлі dspace-api-X.X.jar, що розміщується за шляхами
/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/
(чи іншими, залежно від встановлення)

Файл dspace-api-X.X.jar також є архівом, отож Messages.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Recent submissions
metadata.dc.relation.references = References (Ukraine)
metadata.dc.relation.referencesen = References (International)
metadata.dc.identifier.citation = Bibliographic description (Ukraine)
metadata.dc.identifier.citationen = Bibliographic description (International)
metadata.dc.contributor.affiliation = Affiliation
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Submitted date
metadata.dc.coverage.temporal = Temporal Coverage
metadata.dc.description.sponsorship = Sponsorship
metadata.dc.relation.ispartof = Is part of
metadata.dc.citation.conference = Conference/Event
metadata.dc.citation.journalTitle = Journal/Collection
metadata.dc.citation.issue = Issue
metadata.dc.citation.volume = Volume
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = Patent No
metadata.dc.coverage.country = Country (code)
metadata.dc.identifier.orcid = ORCID Id
metadata.dc.identifier.scopus = Scopus Id
metadata.dc.subject.mesh = Medical Subject Headings (MESH)
metadata.dc.subject.pacs = Physics and Astronomy Classification Scheme (PACS)
metadata.dc.citation.spage = Start page
metadata.dc.citation.epage = End page
metadata.dc.relation.uri = URL for reference material
metadata.dc.description.tableofcontents = Content
metadata.dc.coverage.placename = Place of the edition/event
metadata.dc.contributor.advisor = Supervisor
metadata.dc.contributor.committeeMember = Committee members
metadata.dc.format.pages = Number of pages
metadata.dc.format.extent = Page range
metadata.dc.contributor.illustrator = Illustrator
metadata.dc.contributor.photographer = Photographer
metadata.dc.contributor.translator = Translator
metadata.dc.identifier.grantnumber = Grant ID
metadata.dc.rights.holder = Copyright owner
metadata.dc.status = Publications status
metadata.dc.subject.bbk = BBK
metadata.dc.subject.udc = UDC
metadata.thesis.degree.department = Defense council
metadata.thesis.degree.discipline = Code and name of the specialty
metadata.thesis.degree.grantor = Institution defense
metadata.thesis.degree.level = Level thesis
metadata.thesis.degree.name = Science degree

Після доповнення мовних файлів Messages_uk.properties, Messages_ru.properties, Messages.properties, збереженні їх у dspace-api-lang-X.X.X.jar та dspace-api-X.X.jar, розміщенні останніх за відповідними шляхами у системі, також необхідно перезапустити веб-сервер Tomcat

/etc/init.d/tomcat8 restart

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Додаткові поля Dublin Core для DSpace

2017-10-26T11:45:06Z

Dubyk: /* Файл xhtml-head-item.properties */

== Додаткові поля ==

Додаються/редагуються в інтерфейсі адміністрування » '''Реєстр полів метаданих''':

* '''dc.contributor.advisor''' — '''Використовуйте в першу чергу для наукового керівника дисертації.'''
* '''dc.contributor.affiliation''' — '''Місце роботи автора (повна назва організації, повна адреса, регалії та контактні дані).'''
* '''dc.contributor.committeeMember''' — '''Використовується для членів дисертаційного комітету.'''

* '''dc.coverage.country''' — '''Країна (2-букв. код країни за ISO_3166-1 alpha-2).'''
* '''dc.coverage.placename''' — '''Ареал охоплення або район розташування, охоплювані у даних, наприклад, регіони, країни чи міста.'''

* '''dc.date.submitted''' — '''Дата подання матеріалу. Рекомендовано для творів/тез/дисертацій.'''

* '''dc.description.tableofcontents''' — '''Таблиця змісту для даного матеріалу.'''

* '''dc.format.extent''' — '''Розмір та тривалість. Також діапазон сторінок.'''
* '''dc.format.pages''' — '''Обсяг матеріалу, кількість сторінок.'''

''Додаткові ідентифікатори:''

* '''dc.identifier.citationen''' — '''Accessible to man, standard bibliographic description, not-DSpace format for this material.'''
* '''dc.identifier.doi''' — '''Цифровий ідентифікатор об'єкта (DOI), виданий реєстраційним агенством DOI на цю публікацію.'''
* '''dc.identifier.orcid''' — '''Унікальний ідентифікатор вченого з міжнародного реєстру ORCID.'''
* '''dc.identifier.patent''' — '''№ патенту (число).'''
* '''dc.identifier.scopus''' — '''Ідентифікатор статті у реферативній БД Scopus.'''

''Пов’язані джерела:''

* '''dc.relation.references''' — '''Список використаних джерел, посилання на літературу, що були використані при підготовці матеріалу.'''
* '''dc.relation.referencesen''' — '''List of used sources, literature references that were used during the preparation the material.'''
* '''dc.relation.uri''' — '''Посилається на загальноприйнятий ідентифікатор ресурсу для пов’язаного матеріалу.'''

''Додаткові класифікаційні індекси:''

* '''dc.subject.udc''' — '''УДК'''
* '''dc.subject.bbk''' — '''ББК'''
* '''dc.subject.jel''' — '''Система класифікації JEL для наукової літератури в галузі економіки.'''
* '''dc.subject.mesh''' — '''Медичні тематичні рубрики.'''
* '''dc.subject.pacs''' — '''Код класифікації з фізики та астрономії (PACS).'''

''Група полів для Google Академії:''

* '''dc.citation.conference''' — '''Назва заходу, конференції, події, за результатами яких видано ці матеріали.'''
* '''dc.citation.journalTitle''' — '''Основна офіційна назва журналу.'''
* '''dc.citation.volume''' — '''Номер тому, починається завжди з цифр (араб. чи грець.), якщо є назва, то додається через двокрапку; без слова том.'''
* '''dc.citation.issue''' — '''Номер випуску (для журналу); без „№ “.'''
* '''dc.citation.spage''' — '''Початковий номер сторінки.'''
* '''dc.citation.epage''' — '''Кінцевий номер сторінки.'''

''Група дисертаційних полів:''

* '''thesis.degree.department''' — '''Назва академічного відділу, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.discipline''' — '''Область вивчення інтелектуального змісту дисертації тощо.'''
* '''thesis.degree.grantor''' — '''Назва установи, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.level''' — '''Градація ступеня, пов’язаного з дисертацією тощо. («кандидатська» чи «докторська»).'''
* '''thesis.degree.name''' — '''Назва ступеня, пов’язаного з дисертацією тощо. (доктор філософії, кандидат гуманітарних наук тощо).'''

== Файл QDC.properties ==

Попереднє відображення типових елементів метаданих DSpace у схему QDC XML.
Необхідне для Google Академії і т.п.

Приводиться відображення для існуючих та нових полів.

Розміщення (в залежності від встановлення): /home/data/dspace/config/crosswalks/QDC.properties

Приклад для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/QDC.properties

Додати наприкінці наступне

dc.citation.journalTitle = <dc:citation_journal_title />
dc.citation.volume = <dc:citation_volume />
dc.citation.issue = <dc:citation_issue />
dc.citation.spage = <dc:citation_firstpage />
dc.citation.epage = <dc:citation_lastpage />
dc.identifier.doi = <dc:citation_doi />
dc.identifier.issn = <dc:citation_issn />
dc.identifier.isbn = <dc:citation_isbn />
dc.citation.conference = <dc:citation_conference />
dc.citation.conference = <dc:citation_conference_title />
dc.coverage.country = <dc:citation_patent_country />
dc.identifier.patent = <dc:citation_patent_number />
dc.subject = <dc:citation_keywords />
# dc.date.submitted = <dcterms:dateSubmitted />
dc.contributor.affiliation = <dc:citation_author_institution />
thesis.degree.grantor = <dc:citation_dissertation_institution />
dc.date.available = <dc:citation_online_date />
dc.identifier.doi = <dc:citation_doi />
dc.date.issued = <dc:citation_publication_date />
dc.description.abstract = <dc:citation_abstract />
dc.subject.udc = <dc:subject type="dcterms:UDC" />
dc.subject.bbk = <dc:subject type="dcterms:BBK" />
dc.subject.jel = <dc:subject type="dcterms:JEL" />
dc.subject.pacs = <dc:subject type="dcterms:PACS" />

== Файл xhtml-head-item.properties ==

Відображення між схемою реєстру метаданих DSpace та схемою, що записується у тег <meta> заголовку XHTML.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/crosswalks/xhtml-head-item.properties

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/xhtml-head-item.properties

Деякі ідеї взяті з статті https://jira.duraspace.org/secure/attachment/13020/Invisible_institutional.pdf

Додати наприкінці наступне

dc.citation.journalTitle = citation_journal_title
dc.citation.volume = citation_volume
dc.citation.issue = citation_issue
dc.citation.spage = citation_firstpage
dc.citation.epage = citation_lastpage
dc.identifier.doi = citation_doi
dc.identifier.issn = citation_issn
dc.identifier.isbn = citation_isbn
dc.citation.conference = citation_conference_title
dc.coverage.country = citation_patent_country
dc.identifier.patent = citation_patent_number
dc.subject = citation_keywords
dc.date.submitted = DCTERMS.dateSubmitted,DCTERMS.W3CDTF
dc.contributor.affiliation = citation_author_institution
thesis.degree.grantor = citation_dissertation_institution
dc.date.available = citation_online_date
dc.identifier.doi = citation_doi
dc.date.issued = citation_publication_date
dc.description.abstract = citation_abstract
dc.identifier.citationen = DCTERMS.bibliographicCitation
dc.subject.udc = DCTERMS.UDC
dc.subject.bbk = DCTERMS.BBK
dc.subject.jel = DCTERMS.JEL
dc.subject.pacs = DCTERMS.PACS
dc.relation.references = DCTERMS.references
dc.relation.referencesen = DCTERMS.references

== Файл google-metadata.properties ==

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/google-metadata.properties

Додати наприкінці наступне

google.citation_journal_title = dc.citation.journalTitle
google.citation_volume = dc.citation.volume
google.citation_issue = dc.citation.issue
google.citation_firstpage = dc.citation.spage
google.citation_lastpage = dc.citation.epage
google.citation_doi = dc.identifier.doi
google.citation_issn = dc.identifier.issn
google.citation_isbn = dc.identifier.isbn
google.citation_conference = dc.citation.conference
google.citation_conference_title = dc.citation.conference
google.citation_patent_country = dc.coverage.country
google.citation_patent_number = dc.identifier.patent
google.citation_keywords = dc.subject
google.citation_author_institution = dc.contributor.affiliation
google.citation_dissertation_institution = thesis.degree.grantor
google.citation_online_date = dc.date.available
google.citation_doi = dc.identifier.doi
google.citation_publication_date = dc.date.issued
google.citation_abstract = dc.description.abstract

== Файл форм вводу input-forms_uk.xml ==

Файл форм внесення метаданих.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/input-forms.xml

Замість перерахунку змін (у порівнянні з типовим) наведено файл [http://elartu.tntu.edu.ua:8080/files/input-forms.xml input-forms.xml], що використовується в репозитарії [http://elartu.tntu.edu.ua ELARTU].

== Файл dspace.cfg ==

Файл налаштувань DSpace.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/dspace.cfg

Налаштування полів метаданих дублінського ядра що відображаються у вікні '''базового опису матеріалу'''.

webui.itemdisplay.default = dc.title, \
dc.title.alternative, \
dc.contributor.author, \
dc.contributor.affiliation, \
dc.identifier.citation, \
dc.identifier.citationen, \
dc.relation.ispartof, \
dc.citation.conference, \
dc.citation.journalTitle, \
dc.citation.issue, \
dc.citation.volume, \
dc.identifier.patent, \
dc.date.issued(date), dc.date.submitted(date), dc.publisher, \
dc.coverage.country, dc.coverage.placename, dc.coverage.temporal, \
thesis.degree.name, thesis.degree.level, thesis.degree.discipline, \
thesis.degree.department, thesis.degree.grantor, \
dc.contributor.editor, dc.contributor.advisor, dc.contributor.committeeMember, \
dc.contributor.illustrator, dc.contributor.photographer, dc.contributor.translator, \
dc.identifier.orcid, dc.identifier.scopus, \
dc.identifier.doi, \
dc.subject.udc, dc.subject.bbk, dc.subject.jel, dc.subject.mesh, dc.subject.pacs, dc.subject, \
dc.format.pages, dc.format.extent, dc.citation.spage, dc.citation.epage, \
dc.relation.ispartofseries, \
dc.description.abstract, dc.description, dc.description.sponsorship, dc.description.tableofcontents, \
dc.identifier.govdoc, dc.identifier.uri(link), \
dc.identifier.isbn, dc.identifier.issn, \
dc.identifier.ismn, dc.identifier, dc.identifier.grantnumber, \
dc.rights.holder, dc.status, \
dc.relation.uri(link), \
dc.relation.references, \
dc.relation.referencesen

Щоб класифікаційні індекси стали гіперпосиланнями додайте також рядок типу
webui.browse.link.2 = subject:dc.subject.*

== Рядки локалізацій для нових полів ==
=== Messages_uk.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_uk.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_uk.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Останні надходження
metadata.dc.contributor.advisor = Науковий керівник
metadata.dc.contributor.committeeMember = Члени комітету
metadata.dc.contributor.illustrator = Ілюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Перекладач
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Рада захисту
metadata.thesis.degree.discipline = Шифр та назва спеціальності
metadata.thesis.degree.grantor = Установа захисту
metadata.thesis.degree.level = Рівень дисертації
metadata.thesis.degree.name = Науковий ступінь
metadata.dc.rights.holder = Власник авторського права
metadata.dc.coverage.placename = Місце видання, проведення
metadata.dc.status = Статус публікації
metadata.dc.description.tableofcontents = Зміст
metadata.dc.format.pages = Кількість сторінок
metadata.dc.format.extent = Діапазон сторінок
metadata.dc.identifier.grantnumber = Ідентифікатор гранту
metadata.dc.relation.references = Перелік літератури
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Приналежність
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подання
metadata.dc.coverage.temporal = Часове охоплення
metadata.dc.description.sponsorship = Спонсорська підтримка
metadata.dc.relation.ispartof = Є частиною видання
metadata.dc.citation.conference = Конференція/захід
metadata.dc.citation.journalTitle = Журнал/збірник
metadata.dc.citation.issue = Випуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патенту
metadata.dc.coverage.country = Країна (код)
metadata.dc.identifier.orcid = Ідентифікатор ORCID
metadata.dc.identifier.scopus = Ідентифікатор Scopus
metadata.dc.subject.mesh = Медичні тематичні рубрики (MESH)
metadata.dc.subject.pacs = Код класифікації з фізики та астрономії (PACS)
metadata.dc.citation.spage = Початкова сторінка
metadata.dc.citation.epage = Кінцева сторінка
metadata.dc.relation.uri = URL-посилання пов’язаного матеріалу

=== Messages_ru.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_ru.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_ru.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Последние поступления
browse.menu.author = Автор
browse.menu.subject = Темы
browse.menu.title = Заглавие
browse.menu.dateissued = Даты выпуска
metadata.dc.contributor.advisor = Научный руководитель
metadata.dc.contributor.committeeMember = Члены комитета
metadata.dc.contributor.illustrator = Иллюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Переводчик
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Совет защиты
metadata.thesis.degree.discipline = Шифр и название специальности
metadata.thesis.degree.grantor = Учреждение защиты
metadata.thesis.degree.level = Уровень диссертации
metadata.thesis.degree.name = Научная степень
metadata.dc.rights.holder = Владелец авторского права
metadata.dc.coverage.placename = Место издания, проведения
metadata.dc.status = Статус публикации
metadata.dc.description.tableofcontents = Содержание
metadata.dc.format.pages = Количество страниц
metadata.dc.format.extent = Диапазон страниц
metadata.dc.identifier.grantnumber = Идентификатор гранта
metadata.dc.relation.references = Список литературы
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Принадлежность
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подачи
metadata.dc.coverage.temporal = Временной охват
metadata.dc.description.sponsorship = Спонсорская поддержка
metadata.dc.relation.ispartof = Является частью издания
metadata.dc.citation.conference = Конференция/мероприятие
metadata.dc.citation.journalTitle = Журнал/сборник
metadata.dc.citation.issue = Выпуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патента
metadata.dc.coverage.country = Страна (код)
metadata.dc.identifier.orcid = Идентификатор ORCID
metadata.dc.identifier.scopus = Идентификатор Scopus
metadata.dc.subject.mesh = Медицинские тематические рубрики (MESH)
metadata.dc.subject.pacs = Код классификации по физике и астрономии (PACS)
metadata.dc.citation.spage = Начальная страница
metadata.dc.citation.epage = Последняя страница
metadata.dc.relation.uri = URL-ссылки связанного материала

=== Messages.properties ===
Файл зберігається в бінарному файлі dspace-api-X.X.jar, що розміщується за шляхами
/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/
(чи іншими, залежно від встановлення)

Файл dspace-api-X.X.jar також є архівом, отож Messages.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Recent submissions
metadata.dc.relation.references = References (Ukraine)
metadata.dc.relation.referencesen = References (International)
metadata.dc.identifier.citation = Bibliographic description (Ukraine)
metadata.dc.identifier.citationen = Bibliographic description (International)
metadata.dc.contributor.affiliation = Affiliation
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Submitted date
metadata.dc.coverage.temporal = Temporal Coverage
metadata.dc.description.sponsorship = Sponsorship
metadata.dc.relation.ispartof = Is part of
metadata.dc.citation.conference = Conference/Event
metadata.dc.citation.journalTitle = Journal/Collection
metadata.dc.citation.issue = Issue
metadata.dc.citation.volume = Volume
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = Patent No
metadata.dc.coverage.country = Country (code)
metadata.dc.identifier.orcid = ORCID Id
metadata.dc.identifier.scopus = Scopus Id
metadata.dc.subject.mesh = Medical Subject Headings (MESH)
metadata.dc.subject.pacs = Physics and Astronomy Classification Scheme (PACS)
metadata.dc.citation.spage = Start page
metadata.dc.citation.epage = End page
metadata.dc.relation.uri = URL for reference material
metadata.dc.description.tableofcontents = Content
metadata.dc.coverage.placename = Place of the edition/event
metadata.dc.contributor.advisor = Supervisor
metadata.dc.contributor.committeeMember = Committee members
metadata.dc.format.pages = Number of pages
metadata.dc.format.extent = Page range
metadata.dc.contributor.illustrator = Illustrator
metadata.dc.contributor.photographer = Photographer
metadata.dc.contributor.translator = Translator
metadata.dc.identifier.grantnumber = Grant ID
metadata.dc.rights.holder = Copyright owner
metadata.dc.status = Publications status
metadata.dc.subject.bbk = BBK
metadata.dc.subject.udc = UDC
metadata.thesis.degree.department = Defense council
metadata.thesis.degree.discipline = Code and name of the specialty
metadata.thesis.degree.grantor = Institution defense
metadata.thesis.degree.level = Level thesis
metadata.thesis.degree.name = Science degree

Після доповнення мовних файлів Messages_uk.properties, Messages_ru.properties, Messages.properties, збереженні їх у dspace-api-lang-X.X.X.jar та dspace-api-X.X.jar, розміщенні останніх за відповідними шляхами у системі, також необхідно перезапустити веб-сервер Tomcat

/etc/init.d/tomcat8 restart

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Додаткові поля Dublin Core для DSpace

2017-10-26T11:43:22Z

Dubyk: /* Файл xhtml-head-item.properties */

== Додаткові поля ==

Додаються/редагуються в інтерфейсі адміністрування » '''Реєстр полів метаданих''':

* '''dc.contributor.advisor''' — '''Використовуйте в першу чергу для наукового керівника дисертації.'''
* '''dc.contributor.affiliation''' — '''Місце роботи автора (повна назва організації, повна адреса, регалії та контактні дані).'''
* '''dc.contributor.committeeMember''' — '''Використовується для членів дисертаційного комітету.'''

* '''dc.coverage.country''' — '''Країна (2-букв. код країни за ISO_3166-1 alpha-2).'''
* '''dc.coverage.placename''' — '''Ареал охоплення або район розташування, охоплювані у даних, наприклад, регіони, країни чи міста.'''

* '''dc.date.submitted''' — '''Дата подання матеріалу. Рекомендовано для творів/тез/дисертацій.'''

* '''dc.description.tableofcontents''' — '''Таблиця змісту для даного матеріалу.'''

* '''dc.format.extent''' — '''Розмір та тривалість. Також діапазон сторінок.'''
* '''dc.format.pages''' — '''Обсяг матеріалу, кількість сторінок.'''

''Додаткові ідентифікатори:''

* '''dc.identifier.citationen''' — '''Accessible to man, standard bibliographic description, not-DSpace format for this material.'''
* '''dc.identifier.doi''' — '''Цифровий ідентифікатор об'єкта (DOI), виданий реєстраційним агенством DOI на цю публікацію.'''
* '''dc.identifier.orcid''' — '''Унікальний ідентифікатор вченого з міжнародного реєстру ORCID.'''
* '''dc.identifier.patent''' — '''№ патенту (число).'''
* '''dc.identifier.scopus''' — '''Ідентифікатор статті у реферативній БД Scopus.'''

''Пов’язані джерела:''

* '''dc.relation.references''' — '''Список використаних джерел, посилання на літературу, що були використані при підготовці матеріалу.'''
* '''dc.relation.referencesen''' — '''List of used sources, literature references that were used during the preparation the material.'''
* '''dc.relation.uri''' — '''Посилається на загальноприйнятий ідентифікатор ресурсу для пов’язаного матеріалу.'''

''Додаткові класифікаційні індекси:''

* '''dc.subject.udc''' — '''УДК'''
* '''dc.subject.bbk''' — '''ББК'''
* '''dc.subject.jel''' — '''Система класифікації JEL для наукової літератури в галузі економіки.'''
* '''dc.subject.mesh''' — '''Медичні тематичні рубрики.'''
* '''dc.subject.pacs''' — '''Код класифікації з фізики та астрономії (PACS).'''

''Група полів для Google Академії:''

* '''dc.citation.conference''' — '''Назва заходу, конференції, події, за результатами яких видано ці матеріали.'''
* '''dc.citation.journalTitle''' — '''Основна офіційна назва журналу.'''
* '''dc.citation.volume''' — '''Номер тому, починається завжди з цифр (араб. чи грець.), якщо є назва, то додається через двокрапку; без слова том.'''
* '''dc.citation.issue''' — '''Номер випуску (для журналу); без „№ “.'''
* '''dc.citation.spage''' — '''Початковий номер сторінки.'''
* '''dc.citation.epage''' — '''Кінцевий номер сторінки.'''

''Група дисертаційних полів:''

* '''thesis.degree.department''' — '''Назва академічного відділу, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.discipline''' — '''Область вивчення інтелектуального змісту дисертації тощо.'''
* '''thesis.degree.grantor''' — '''Назва установи, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.level''' — '''Градація ступеня, пов’язаного з дисертацією тощо. («кандидатська» чи «докторська»).'''
* '''thesis.degree.name''' — '''Назва ступеня, пов’язаного з дисертацією тощо. (доктор філософії, кандидат гуманітарних наук тощо).'''

== Файл QDC.properties ==

Попереднє відображення типових елементів метаданих DSpace у схему QDC XML.
Необхідне для Google Академії і т.п.

Приводиться відображення для існуючих та нових полів.

Розміщення (в залежності від встановлення): /home/data/dspace/config/crosswalks/QDC.properties

Приклад для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/QDC.properties

Додати наприкінці наступне

dc.citation.journalTitle = <dc:citation_journal_title />
dc.citation.volume = <dc:citation_volume />
dc.citation.issue = <dc:citation_issue />
dc.citation.spage = <dc:citation_firstpage />
dc.citation.epage = <dc:citation_lastpage />
dc.identifier.doi = <dc:citation_doi />
dc.identifier.issn = <dc:citation_issn />
dc.identifier.isbn = <dc:citation_isbn />
dc.citation.conference = <dc:citation_conference />
dc.citation.conference = <dc:citation_conference_title />
dc.coverage.country = <dc:citation_patent_country />
dc.identifier.patent = <dc:citation_patent_number />
dc.subject = <dc:citation_keywords />
# dc.date.submitted = <dcterms:dateSubmitted />
dc.contributor.affiliation = <dc:citation_author_institution />
thesis.degree.grantor = <dc:citation_dissertation_institution />
dc.date.available = <dc:citation_online_date />
dc.identifier.doi = <dc:citation_doi />
dc.date.issued = <dc:citation_publication_date />
dc.description.abstract = <dc:citation_abstract />
dc.subject.udc = <dc:subject type="dcterms:UDC" />
dc.subject.bbk = <dc:subject type="dcterms:BBK" />
dc.subject.jel = <dc:subject type="dcterms:JEL" />
dc.subject.pacs = <dc:subject type="dcterms:PACS" />

== Файл xhtml-head-item.properties ==

Відображення між схемою реєстру метаданих DSpace та схемою, що записується у тег <meta> заголовку XHTML.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/crosswalks/xhtml-head-item.properties

Деякі ідеї взяті з статті https://jira.duraspace.org/secure/attachment/13020/Invisible_institutional.pdf

Додати наприкінці наступне

dc.citation.journalTitle = citation_journal_title
dc.citation.volume = citation_volume
dc.citation.issue = citation_issue
dc.citation.spage = citation_firstpage
dc.citation.epage = citation_lastpage
dc.identifier.doi = citation_doi
dc.identifier.issn = citation_issn
dc.identifier.isbn = citation_isbn
# dc.citation.conference = citation_conference
dc.citation.conference = citation_conference_title
dc.coverage.country = citation_patent_country
dc.identifier.patent = citation_patent_number
dc.subject = citation_keywords
dc.date.submitted = DCTERMS.dateSubmitted,DCTERMS.W3CDTF
# = citation_section
dc.contributor.affiliation = citation_author_institution
# = citation_patent_application_number

== Файл google-metadata.properties ==

Приклад файлу для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/google-metadata.properties

Додати наприкінці наступне

google.citation_journal_title = dc.citation.journalTitle
google.citation_volume = dc.citation.volume
google.citation_issue = dc.citation.issue
google.citation_firstpage = dc.citation.spage
google.citation_lastpage = dc.citation.epage
google.citation_doi = dc.identifier.doi
google.citation_issn = dc.identifier.issn
google.citation_isbn = dc.identifier.isbn
google.citation_conference = dc.citation.conference
google.citation_conference_title = dc.citation.conference
google.citation_patent_country = dc.coverage.country
google.citation_patent_number = dc.identifier.patent
google.citation_keywords = dc.subject
google.citation_author_institution = dc.contributor.affiliation
google.citation_dissertation_institution = thesis.degree.grantor
google.citation_online_date = dc.date.available
google.citation_doi = dc.identifier.doi
google.citation_publication_date = dc.date.issued
google.citation_abstract = dc.description.abstract

== Файл форм вводу input-forms_uk.xml ==

Файл форм внесення метаданих.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/input-forms.xml

Замість перерахунку змін (у порівнянні з типовим) наведено файл [http://elartu.tntu.edu.ua:8080/files/input-forms.xml input-forms.xml], що використовується в репозитарії [http://elartu.tntu.edu.ua ELARTU].

== Файл dspace.cfg ==

Файл налаштувань DSpace.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/dspace.cfg

Налаштування полів метаданих дублінського ядра що відображаються у вікні '''базового опису матеріалу'''.

webui.itemdisplay.default = dc.title, \
dc.title.alternative, \
dc.contributor.author, \
dc.contributor.affiliation, \
dc.identifier.citation, \
dc.identifier.citationen, \
dc.relation.ispartof, \
dc.citation.conference, \
dc.citation.journalTitle, \
dc.citation.issue, \
dc.citation.volume, \
dc.identifier.patent, \
dc.date.issued(date), dc.date.submitted(date), dc.publisher, \
dc.coverage.country, dc.coverage.placename, dc.coverage.temporal, \
thesis.degree.name, thesis.degree.level, thesis.degree.discipline, \
thesis.degree.department, thesis.degree.grantor, \
dc.contributor.editor, dc.contributor.advisor, dc.contributor.committeeMember, \
dc.contributor.illustrator, dc.contributor.photographer, dc.contributor.translator, \
dc.identifier.orcid, dc.identifier.scopus, \
dc.identifier.doi, \
dc.subject.udc, dc.subject.bbk, dc.subject.jel, dc.subject.mesh, dc.subject.pacs, dc.subject, \
dc.format.pages, dc.format.extent, dc.citation.spage, dc.citation.epage, \
dc.relation.ispartofseries, \
dc.description.abstract, dc.description, dc.description.sponsorship, dc.description.tableofcontents, \
dc.identifier.govdoc, dc.identifier.uri(link), \
dc.identifier.isbn, dc.identifier.issn, \
dc.identifier.ismn, dc.identifier, dc.identifier.grantnumber, \
dc.rights.holder, dc.status, \
dc.relation.uri(link), \
dc.relation.references, \
dc.relation.referencesen

Щоб класифікаційні індекси стали гіперпосиланнями додайте також рядок типу
webui.browse.link.2 = subject:dc.subject.*

== Рядки локалізацій для нових полів ==
=== Messages_uk.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_uk.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_uk.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Останні надходження
metadata.dc.contributor.advisor = Науковий керівник
metadata.dc.contributor.committeeMember = Члени комітету
metadata.dc.contributor.illustrator = Ілюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Перекладач
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Рада захисту
metadata.thesis.degree.discipline = Шифр та назва спеціальності
metadata.thesis.degree.grantor = Установа захисту
metadata.thesis.degree.level = Рівень дисертації
metadata.thesis.degree.name = Науковий ступінь
metadata.dc.rights.holder = Власник авторського права
metadata.dc.coverage.placename = Місце видання, проведення
metadata.dc.status = Статус публікації
metadata.dc.description.tableofcontents = Зміст
metadata.dc.format.pages = Кількість сторінок
metadata.dc.format.extent = Діапазон сторінок
metadata.dc.identifier.grantnumber = Ідентифікатор гранту
metadata.dc.relation.references = Перелік літератури
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Приналежність
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подання
metadata.dc.coverage.temporal = Часове охоплення
metadata.dc.description.sponsorship = Спонсорська підтримка
metadata.dc.relation.ispartof = Є частиною видання
metadata.dc.citation.conference = Конференція/захід
metadata.dc.citation.journalTitle = Журнал/збірник
metadata.dc.citation.issue = Випуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патенту
metadata.dc.coverage.country = Країна (код)
metadata.dc.identifier.orcid = Ідентифікатор ORCID
metadata.dc.identifier.scopus = Ідентифікатор Scopus
metadata.dc.subject.mesh = Медичні тематичні рубрики (MESH)
metadata.dc.subject.pacs = Код класифікації з фізики та астрономії (PACS)
metadata.dc.citation.spage = Початкова сторінка
metadata.dc.citation.epage = Кінцева сторінка
metadata.dc.relation.uri = URL-посилання пов’язаного матеріалу

=== Messages_ru.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_ru.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_ru.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Последние поступления
browse.menu.author = Автор
browse.menu.subject = Темы
browse.menu.title = Заглавие
browse.menu.dateissued = Даты выпуска
metadata.dc.contributor.advisor = Научный руководитель
metadata.dc.contributor.committeeMember = Члены комитета
metadata.dc.contributor.illustrator = Иллюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Переводчик
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Совет защиты
metadata.thesis.degree.discipline = Шифр и название специальности
metadata.thesis.degree.grantor = Учреждение защиты
metadata.thesis.degree.level = Уровень диссертации
metadata.thesis.degree.name = Научная степень
metadata.dc.rights.holder = Владелец авторского права
metadata.dc.coverage.placename = Место издания, проведения
metadata.dc.status = Статус публикации
metadata.dc.description.tableofcontents = Содержание
metadata.dc.format.pages = Количество страниц
metadata.dc.format.extent = Диапазон страниц
metadata.dc.identifier.grantnumber = Идентификатор гранта
metadata.dc.relation.references = Список литературы
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Принадлежность
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подачи
metadata.dc.coverage.temporal = Временной охват
metadata.dc.description.sponsorship = Спонсорская поддержка
metadata.dc.relation.ispartof = Является частью издания
metadata.dc.citation.conference = Конференция/мероприятие
metadata.dc.citation.journalTitle = Журнал/сборник
metadata.dc.citation.issue = Выпуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патента
metadata.dc.coverage.country = Страна (код)
metadata.dc.identifier.orcid = Идентификатор ORCID
metadata.dc.identifier.scopus = Идентификатор Scopus
metadata.dc.subject.mesh = Медицинские тематические рубрики (MESH)
metadata.dc.subject.pacs = Код классификации по физике и астрономии (PACS)
metadata.dc.citation.spage = Начальная страница
metadata.dc.citation.epage = Последняя страница
metadata.dc.relation.uri = URL-ссылки связанного материала

=== Messages.properties ===
Файл зберігається в бінарному файлі dspace-api-X.X.jar, що розміщується за шляхами
/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/
(чи іншими, залежно від встановлення)

Файл dspace-api-X.X.jar також є архівом, отож Messages.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Recent submissions
metadata.dc.relation.references = References (Ukraine)
metadata.dc.relation.referencesen = References (International)
metadata.dc.identifier.citation = Bibliographic description (Ukraine)
metadata.dc.identifier.citationen = Bibliographic description (International)
metadata.dc.contributor.affiliation = Affiliation
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Submitted date
metadata.dc.coverage.temporal = Temporal Coverage
metadata.dc.description.sponsorship = Sponsorship
metadata.dc.relation.ispartof = Is part of
metadata.dc.citation.conference = Conference/Event
metadata.dc.citation.journalTitle = Journal/Collection
metadata.dc.citation.issue = Issue
metadata.dc.citation.volume = Volume
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = Patent No
metadata.dc.coverage.country = Country (code)
metadata.dc.identifier.orcid = ORCID Id
metadata.dc.identifier.scopus = Scopus Id
metadata.dc.subject.mesh = Medical Subject Headings (MESH)
metadata.dc.subject.pacs = Physics and Astronomy Classification Scheme (PACS)
metadata.dc.citation.spage = Start page
metadata.dc.citation.epage = End page
metadata.dc.relation.uri = URL for reference material
metadata.dc.description.tableofcontents = Content
metadata.dc.coverage.placename = Place of the edition/event
metadata.dc.contributor.advisor = Supervisor
metadata.dc.contributor.committeeMember = Committee members
metadata.dc.format.pages = Number of pages
metadata.dc.format.extent = Page range
metadata.dc.contributor.illustrator = Illustrator
metadata.dc.contributor.photographer = Photographer
metadata.dc.contributor.translator = Translator
metadata.dc.identifier.grantnumber = Grant ID
metadata.dc.rights.holder = Copyright owner
metadata.dc.status = Publications status
metadata.dc.subject.bbk = BBK
metadata.dc.subject.udc = UDC
metadata.thesis.degree.department = Defense council
metadata.thesis.degree.discipline = Code and name of the specialty
metadata.thesis.degree.grantor = Institution defense
metadata.thesis.degree.level = Level thesis
metadata.thesis.degree.name = Science degree

Після доповнення мовних файлів Messages_uk.properties, Messages_ru.properties, Messages.properties, збереженні їх у dspace-api-lang-X.X.X.jar та dspace-api-X.X.jar, розміщенні останніх за відповідними шляхами у системі, також необхідно перезапустити веб-сервер Tomcat

/etc/init.d/tomcat8 restart

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Додаткові поля Dublin Core для DSpace

2017-10-26T11:41:05Z

Dubyk: /* Файл QDC.properties */

== Додаткові поля ==

Додаються/редагуються в інтерфейсі адміністрування » '''Реєстр полів метаданих''':

* '''dc.contributor.advisor''' — '''Використовуйте в першу чергу для наукового керівника дисертації.'''
* '''dc.contributor.affiliation''' — '''Місце роботи автора (повна назва організації, повна адреса, регалії та контактні дані).'''
* '''dc.contributor.committeeMember''' — '''Використовується для членів дисертаційного комітету.'''

* '''dc.coverage.country''' — '''Країна (2-букв. код країни за ISO_3166-1 alpha-2).'''
* '''dc.coverage.placename''' — '''Ареал охоплення або район розташування, охоплювані у даних, наприклад, регіони, країни чи міста.'''

* '''dc.date.submitted''' — '''Дата подання матеріалу. Рекомендовано для творів/тез/дисертацій.'''

* '''dc.description.tableofcontents''' — '''Таблиця змісту для даного матеріалу.'''

* '''dc.format.extent''' — '''Розмір та тривалість. Також діапазон сторінок.'''
* '''dc.format.pages''' — '''Обсяг матеріалу, кількість сторінок.'''

''Додаткові ідентифікатори:''

* '''dc.identifier.citationen''' — '''Accessible to man, standard bibliographic description, not-DSpace format for this material.'''
* '''dc.identifier.doi''' — '''Цифровий ідентифікатор об'єкта (DOI), виданий реєстраційним агенством DOI на цю публікацію.'''
* '''dc.identifier.orcid''' — '''Унікальний ідентифікатор вченого з міжнародного реєстру ORCID.'''
* '''dc.identifier.patent''' — '''№ патенту (число).'''
* '''dc.identifier.scopus''' — '''Ідентифікатор статті у реферативній БД Scopus.'''

''Пов’язані джерела:''

* '''dc.relation.references''' — '''Список використаних джерел, посилання на літературу, що були використані при підготовці матеріалу.'''
* '''dc.relation.referencesen''' — '''List of used sources, literature references that were used during the preparation the material.'''
* '''dc.relation.uri''' — '''Посилається на загальноприйнятий ідентифікатор ресурсу для пов’язаного матеріалу.'''

''Додаткові класифікаційні індекси:''

* '''dc.subject.udc''' — '''УДК'''
* '''dc.subject.bbk''' — '''ББК'''
* '''dc.subject.jel''' — '''Система класифікації JEL для наукової літератури в галузі економіки.'''
* '''dc.subject.mesh''' — '''Медичні тематичні рубрики.'''
* '''dc.subject.pacs''' — '''Код класифікації з фізики та астрономії (PACS).'''

''Група полів для Google Академії:''

* '''dc.citation.conference''' — '''Назва заходу, конференції, події, за результатами яких видано ці матеріали.'''
* '''dc.citation.journalTitle''' — '''Основна офіційна назва журналу.'''
* '''dc.citation.volume''' — '''Номер тому, починається завжди з цифр (араб. чи грець.), якщо є назва, то додається через двокрапку; без слова том.'''
* '''dc.citation.issue''' — '''Номер випуску (для журналу); без „№ “.'''
* '''dc.citation.spage''' — '''Початковий номер сторінки.'''
* '''dc.citation.epage''' — '''Кінцевий номер сторінки.'''

''Група дисертаційних полів:''

* '''thesis.degree.department''' — '''Назва академічного відділу, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.discipline''' — '''Область вивчення інтелектуального змісту дисертації тощо.'''
* '''thesis.degree.grantor''' — '''Назва установи, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.level''' — '''Градація ступеня, пов’язаного з дисертацією тощо. («кандидатська» чи «докторська»).'''
* '''thesis.degree.name''' — '''Назва ступеня, пов’язаного з дисертацією тощо. (доктор філософії, кандидат гуманітарних наук тощо).'''

== Файл QDC.properties ==

Попереднє відображення типових елементів метаданих DSpace у схему QDC XML.
Необхідне для Google Академії і т.п.

Приводиться відображення для існуючих та нових полів.

Розміщення (в залежності від встановлення): /home/data/dspace/config/crosswalks/QDC.properties

Приклад для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/QDC.properties

Додати наприкінці наступне

dc.citation.journalTitle = <dc:citation_journal_title />
dc.citation.volume = <dc:citation_volume />
dc.citation.issue = <dc:citation_issue />
dc.citation.spage = <dc:citation_firstpage />
dc.citation.epage = <dc:citation_lastpage />
dc.identifier.doi = <dc:citation_doi />
dc.identifier.issn = <dc:citation_issn />
dc.identifier.isbn = <dc:citation_isbn />
dc.citation.conference = <dc:citation_conference />
dc.citation.conference = <dc:citation_conference_title />
dc.coverage.country = <dc:citation_patent_country />
dc.identifier.patent = <dc:citation_patent_number />
dc.subject = <dc:citation_keywords />
# dc.date.submitted = <dcterms:dateSubmitted />
dc.contributor.affiliation = <dc:citation_author_institution />
thesis.degree.grantor = <dc:citation_dissertation_institution />
dc.date.available = <dc:citation_online_date />
dc.identifier.doi = <dc:citation_doi />
dc.date.issued = <dc:citation_publication_date />
dc.description.abstract = <dc:citation_abstract />
dc.subject.udc = <dc:subject type="dcterms:UDC" />
dc.subject.bbk = <dc:subject type="dcterms:BBK" />
dc.subject.jel = <dc:subject type="dcterms:JEL" />
dc.subject.pacs = <dc:subject type="dcterms:PACS" />

== Файл xhtml-head-item.properties ==

Відображення між схемою реєстру метаданих DSpace та схемою, що записується у тег <meta> заголовку XHTML.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/crosswalks/xhtml-head-item.properties

Деякі ідеї взяті з статті https://jira.duraspace.org/secure/attachment/13020/Invisible_institutional.pdf

Додати наприкінці наступне

dc.citation.journalTitle = citation_journal_title
dc.citation.volume = citation_volume
dc.citation.issue = citation_issue
dc.citation.spage = citation_firstpage
dc.citation.epage = citation_lastpage
dc.identifier.doi = citation_doi
dc.identifier.issn = citation_issn
dc.identifier.isbn = citation_isbn
# dc.citation.conference = citation_conference
dc.citation.conference = citation_conference_title
dc.coverage.country = citation_patent_country
dc.identifier.patent = citation_patent_number
dc.subject = citation_keywords
dc.date.submitted = DCTERMS.dateSubmitted,DCTERMS.W3CDTF
# = citation_section
dc.contributor.affiliation = citation_author_institution
# = citation_patent_application_number

== Файл форм вводу input-forms_uk.xml ==

Файл форм внесення метаданих.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/input-forms.xml

Замість перерахунку змін (у порівнянні з типовим) наведено файл [http://elartu.tntu.edu.ua:8080/files/input-forms.xml input-forms.xml], що використовується в репозитарії [http://elartu.tntu.edu.ua ELARTU].

== Файл dspace.cfg ==

Файл налаштувань DSpace.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/dspace.cfg

Налаштування полів метаданих дублінського ядра що відображаються у вікні '''базового опису матеріалу'''.

webui.itemdisplay.default = dc.title, \
dc.title.alternative, \
dc.contributor.author, \
dc.contributor.affiliation, \
dc.identifier.citation, \
dc.identifier.citationen, \
dc.relation.ispartof, \
dc.citation.conference, \
dc.citation.journalTitle, \
dc.citation.issue, \
dc.citation.volume, \
dc.identifier.patent, \
dc.date.issued(date), dc.date.submitted(date), dc.publisher, \
dc.coverage.country, dc.coverage.placename, dc.coverage.temporal, \
thesis.degree.name, thesis.degree.level, thesis.degree.discipline, \
thesis.degree.department, thesis.degree.grantor, \
dc.contributor.editor, dc.contributor.advisor, dc.contributor.committeeMember, \
dc.contributor.illustrator, dc.contributor.photographer, dc.contributor.translator, \
dc.identifier.orcid, dc.identifier.scopus, \
dc.identifier.doi, \
dc.subject.udc, dc.subject.bbk, dc.subject.jel, dc.subject.mesh, dc.subject.pacs, dc.subject, \
dc.format.pages, dc.format.extent, dc.citation.spage, dc.citation.epage, \
dc.relation.ispartofseries, \
dc.description.abstract, dc.description, dc.description.sponsorship, dc.description.tableofcontents, \
dc.identifier.govdoc, dc.identifier.uri(link), \
dc.identifier.isbn, dc.identifier.issn, \
dc.identifier.ismn, dc.identifier, dc.identifier.grantnumber, \
dc.rights.holder, dc.status, \
dc.relation.uri(link), \
dc.relation.references, \
dc.relation.referencesen

Щоб класифікаційні індекси стали гіперпосиланнями додайте також рядок типу
webui.browse.link.2 = subject:dc.subject.*

== Рядки локалізацій для нових полів ==
=== Messages_uk.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_uk.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_uk.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Останні надходження
metadata.dc.contributor.advisor = Науковий керівник
metadata.dc.contributor.committeeMember = Члени комітету
metadata.dc.contributor.illustrator = Ілюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Перекладач
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Рада захисту
metadata.thesis.degree.discipline = Шифр та назва спеціальності
metadata.thesis.degree.grantor = Установа захисту
metadata.thesis.degree.level = Рівень дисертації
metadata.thesis.degree.name = Науковий ступінь
metadata.dc.rights.holder = Власник авторського права
metadata.dc.coverage.placename = Місце видання, проведення
metadata.dc.status = Статус публікації
metadata.dc.description.tableofcontents = Зміст
metadata.dc.format.pages = Кількість сторінок
metadata.dc.format.extent = Діапазон сторінок
metadata.dc.identifier.grantnumber = Ідентифікатор гранту
metadata.dc.relation.references = Перелік літератури
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Приналежність
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подання
metadata.dc.coverage.temporal = Часове охоплення
metadata.dc.description.sponsorship = Спонсорська підтримка
metadata.dc.relation.ispartof = Є частиною видання
metadata.dc.citation.conference = Конференція/захід
metadata.dc.citation.journalTitle = Журнал/збірник
metadata.dc.citation.issue = Випуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патенту
metadata.dc.coverage.country = Країна (код)
metadata.dc.identifier.orcid = Ідентифікатор ORCID
metadata.dc.identifier.scopus = Ідентифікатор Scopus
metadata.dc.subject.mesh = Медичні тематичні рубрики (MESH)
metadata.dc.subject.pacs = Код класифікації з фізики та астрономії (PACS)
metadata.dc.citation.spage = Початкова сторінка
metadata.dc.citation.epage = Кінцева сторінка
metadata.dc.relation.uri = URL-посилання пов’язаного матеріалу

=== Messages_ru.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_ru.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_ru.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Последние поступления
browse.menu.author = Автор
browse.menu.subject = Темы
browse.menu.title = Заглавие
browse.menu.dateissued = Даты выпуска
metadata.dc.contributor.advisor = Научный руководитель
metadata.dc.contributor.committeeMember = Члены комитета
metadata.dc.contributor.illustrator = Иллюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Переводчик
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Совет защиты
metadata.thesis.degree.discipline = Шифр и название специальности
metadata.thesis.degree.grantor = Учреждение защиты
metadata.thesis.degree.level = Уровень диссертации
metadata.thesis.degree.name = Научная степень
metadata.dc.rights.holder = Владелец авторского права
metadata.dc.coverage.placename = Место издания, проведения
metadata.dc.status = Статус публикации
metadata.dc.description.tableofcontents = Содержание
metadata.dc.format.pages = Количество страниц
metadata.dc.format.extent = Диапазон страниц
metadata.dc.identifier.grantnumber = Идентификатор гранта
metadata.dc.relation.references = Список литературы
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Принадлежность
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подачи
metadata.dc.coverage.temporal = Временной охват
metadata.dc.description.sponsorship = Спонсорская поддержка
metadata.dc.relation.ispartof = Является частью издания
metadata.dc.citation.conference = Конференция/мероприятие
metadata.dc.citation.journalTitle = Журнал/сборник
metadata.dc.citation.issue = Выпуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патента
metadata.dc.coverage.country = Страна (код)
metadata.dc.identifier.orcid = Идентификатор ORCID
metadata.dc.identifier.scopus = Идентификатор Scopus
metadata.dc.subject.mesh = Медицинские тематические рубрики (MESH)
metadata.dc.subject.pacs = Код классификации по физике и астрономии (PACS)
metadata.dc.citation.spage = Начальная страница
metadata.dc.citation.epage = Последняя страница
metadata.dc.relation.uri = URL-ссылки связанного материала

=== Messages.properties ===
Файл зберігається в бінарному файлі dspace-api-X.X.jar, що розміщується за шляхами
/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/
(чи іншими, залежно від встановлення)

Файл dspace-api-X.X.jar також є архівом, отож Messages.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Recent submissions
metadata.dc.relation.references = References (Ukraine)
metadata.dc.relation.referencesen = References (International)
metadata.dc.identifier.citation = Bibliographic description (Ukraine)
metadata.dc.identifier.citationen = Bibliographic description (International)
metadata.dc.contributor.affiliation = Affiliation
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Submitted date
metadata.dc.coverage.temporal = Temporal Coverage
metadata.dc.description.sponsorship = Sponsorship
metadata.dc.relation.ispartof = Is part of
metadata.dc.citation.conference = Conference/Event
metadata.dc.citation.journalTitle = Journal/Collection
metadata.dc.citation.issue = Issue
metadata.dc.citation.volume = Volume
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = Patent No
metadata.dc.coverage.country = Country (code)
metadata.dc.identifier.orcid = ORCID Id
metadata.dc.identifier.scopus = Scopus Id
metadata.dc.subject.mesh = Medical Subject Headings (MESH)
metadata.dc.subject.pacs = Physics and Astronomy Classification Scheme (PACS)
metadata.dc.citation.spage = Start page
metadata.dc.citation.epage = End page
metadata.dc.relation.uri = URL for reference material
metadata.dc.description.tableofcontents = Content
metadata.dc.coverage.placename = Place of the edition/event
metadata.dc.contributor.advisor = Supervisor
metadata.dc.contributor.committeeMember = Committee members
metadata.dc.format.pages = Number of pages
metadata.dc.format.extent = Page range
metadata.dc.contributor.illustrator = Illustrator
metadata.dc.contributor.photographer = Photographer
metadata.dc.contributor.translator = Translator
metadata.dc.identifier.grantnumber = Grant ID
metadata.dc.rights.holder = Copyright owner
metadata.dc.status = Publications status
metadata.dc.subject.bbk = BBK
metadata.dc.subject.udc = UDC
metadata.thesis.degree.department = Defense council
metadata.thesis.degree.discipline = Code and name of the specialty
metadata.thesis.degree.grantor = Institution defense
metadata.thesis.degree.level = Level thesis
metadata.thesis.degree.name = Science degree

Після доповнення мовних файлів Messages_uk.properties, Messages_ru.properties, Messages.properties, збереженні їх у dspace-api-lang-X.X.X.jar та dspace-api-X.X.jar, розміщенні останніх за відповідними шляхами у системі, також необхідно перезапустити веб-сервер Tomcat

/etc/init.d/tomcat8 restart

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Додаткові поля Dublin Core для DSpace

2017-10-26T11:40:35Z

Dubyk: /* Файл QDC.properties */

== Додаткові поля ==

Додаються/редагуються в інтерфейсі адміністрування » '''Реєстр полів метаданих''':

* '''dc.contributor.advisor''' — '''Використовуйте в першу чергу для наукового керівника дисертації.'''
* '''dc.contributor.affiliation''' — '''Місце роботи автора (повна назва організації, повна адреса, регалії та контактні дані).'''
* '''dc.contributor.committeeMember''' — '''Використовується для членів дисертаційного комітету.'''

* '''dc.coverage.country''' — '''Країна (2-букв. код країни за ISO_3166-1 alpha-2).'''
* '''dc.coverage.placename''' — '''Ареал охоплення або район розташування, охоплювані у даних, наприклад, регіони, країни чи міста.'''

* '''dc.date.submitted''' — '''Дата подання матеріалу. Рекомендовано для творів/тез/дисертацій.'''

* '''dc.description.tableofcontents''' — '''Таблиця змісту для даного матеріалу.'''

* '''dc.format.extent''' — '''Розмір та тривалість. Також діапазон сторінок.'''
* '''dc.format.pages''' — '''Обсяг матеріалу, кількість сторінок.'''

''Додаткові ідентифікатори:''

* '''dc.identifier.citationen''' — '''Accessible to man, standard bibliographic description, not-DSpace format for this material.'''
* '''dc.identifier.doi''' — '''Цифровий ідентифікатор об'єкта (DOI), виданий реєстраційним агенством DOI на цю публікацію.'''
* '''dc.identifier.orcid''' — '''Унікальний ідентифікатор вченого з міжнародного реєстру ORCID.'''
* '''dc.identifier.patent''' — '''№ патенту (число).'''
* '''dc.identifier.scopus''' — '''Ідентифікатор статті у реферативній БД Scopus.'''

''Пов’язані джерела:''

* '''dc.relation.references''' — '''Список використаних джерел, посилання на літературу, що були використані при підготовці матеріалу.'''
* '''dc.relation.referencesen''' — '''List of used sources, literature references that were used during the preparation the material.'''
* '''dc.relation.uri''' — '''Посилається на загальноприйнятий ідентифікатор ресурсу для пов’язаного матеріалу.'''

''Додаткові класифікаційні індекси:''

* '''dc.subject.udc''' — '''УДК'''
* '''dc.subject.bbk''' — '''ББК'''
* '''dc.subject.jel''' — '''Система класифікації JEL для наукової літератури в галузі економіки.'''
* '''dc.subject.mesh''' — '''Медичні тематичні рубрики.'''
* '''dc.subject.pacs''' — '''Код класифікації з фізики та астрономії (PACS).'''

''Група полів для Google Академії:''

* '''dc.citation.conference''' — '''Назва заходу, конференції, події, за результатами яких видано ці матеріали.'''
* '''dc.citation.journalTitle''' — '''Основна офіційна назва журналу.'''
* '''dc.citation.volume''' — '''Номер тому, починається завжди з цифр (араб. чи грець.), якщо є назва, то додається через двокрапку; без слова том.'''
* '''dc.citation.issue''' — '''Номер випуску (для журналу); без „№ “.'''
* '''dc.citation.spage''' — '''Початковий номер сторінки.'''
* '''dc.citation.epage''' — '''Кінцевий номер сторінки.'''

''Група дисертаційних полів:''

* '''thesis.degree.department''' — '''Назва академічного відділу, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.discipline''' — '''Область вивчення інтелектуального змісту дисертації тощо.'''
* '''thesis.degree.grantor''' — '''Назва установи, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.level''' — '''Градація ступеня, пов’язаного з дисертацією тощо. («кандидатська» чи «докторська»).'''
* '''thesis.degree.name''' — '''Назва ступеня, пов’язаного з дисертацією тощо. (доктор філософії, кандидат гуманітарних наук тощо).'''

== Файл QDC.properties ==

Попереднє відображення типових елементів метаданих DSpace у схему QDC XML.
Необхідне для Google Академії і т.п.

Приводиться відображення для існуючих та нових полів.

Розміщення (в залежності від встановлення): /home/data/dspace/config/crosswalks/QDC.properties

Приклад для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/QDC.properties

Додати наприкінці наступне

dc.citation.journalTitle = <dc:citation_journal_title />
dc.citation.volume = <dc:citation_volume />
dc.citation.issue = <dc:citation_issue />
dc.citation.spage = <dc:citation_firstpage />
dc.citation.epage = <dc:citation_lastpage />
dc.identifier.doi = <dc:citation_doi />
dc.identifier.issn = <dc:citation_issn />
dc.identifier.isbn = <dc:citation_isbn />
dc.citation.conference = <dc:citation_conference />
dc.citation.conference = <dc:citation_conference_title />
dc.coverage.country = <dc:citation_patent_country />
dc.identifier.patent = <dc:citation_patent_number />
dc.subject = <dc:citation_keywords />
# dc.date.submitted = <dcterms:dateSubmitted />
dc.contributor.affiliation = <dc:citation_author_institution />
thesis.degree.grantor = <dc:citation_dissertation_institution />
dc.date.available = <dc:citation_online_date />
dc.identifier.doi = <dc:citation_doi />
dc.date.issued = <dc:citation_publication_date />
dc.description.abstract = <dc:citation_abstract />
dc.subject.udc = <dc:subject type="dcterms:UDC" />
dc.subject.bbk = <dc:subject type="dcterms:BBK" />
dc.subject.jel = <dc:subject type="dcterms:JEL" />
dc.subject.pacs = <dc:subject type="dcterms:PACS" />

== Файл xhtml-head-item.properties ==

Відображення між схемою реєстру метаданих DSpace та схемою, що записується у тег <meta> заголовку XHTML.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/crosswalks/xhtml-head-item.properties

Деякі ідеї взяті з статті https://jira.duraspace.org/secure/attachment/13020/Invisible_institutional.pdf

Додати наприкінці наступне

dc.citation.journalTitle = citation_journal_title
dc.citation.volume = citation_volume
dc.citation.issue = citation_issue
dc.citation.spage = citation_firstpage
dc.citation.epage = citation_lastpage
dc.identifier.doi = citation_doi
dc.identifier.issn = citation_issn
dc.identifier.isbn = citation_isbn
# dc.citation.conference = citation_conference
dc.citation.conference = citation_conference_title
dc.coverage.country = citation_patent_country
dc.identifier.patent = citation_patent_number
dc.subject = citation_keywords
dc.date.submitted = DCTERMS.dateSubmitted,DCTERMS.W3CDTF
# = citation_section
dc.contributor.affiliation = citation_author_institution
# = citation_patent_application_number

== Файл форм вводу input-forms_uk.xml ==

Файл форм внесення метаданих.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/input-forms.xml

Замість перерахунку змін (у порівнянні з типовим) наведено файл [http://elartu.tntu.edu.ua:8080/files/input-forms.xml input-forms.xml], що використовується в репозитарії [http://elartu.tntu.edu.ua ELARTU].

== Файл dspace.cfg ==

Файл налаштувань DSpace.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/dspace.cfg

Налаштування полів метаданих дублінського ядра що відображаються у вікні '''базового опису матеріалу'''.

webui.itemdisplay.default = dc.title, \
dc.title.alternative, \
dc.contributor.author, \
dc.contributor.affiliation, \
dc.identifier.citation, \
dc.identifier.citationen, \
dc.relation.ispartof, \
dc.citation.conference, \
dc.citation.journalTitle, \
dc.citation.issue, \
dc.citation.volume, \
dc.identifier.patent, \
dc.date.issued(date), dc.date.submitted(date), dc.publisher, \
dc.coverage.country, dc.coverage.placename, dc.coverage.temporal, \
thesis.degree.name, thesis.degree.level, thesis.degree.discipline, \
thesis.degree.department, thesis.degree.grantor, \
dc.contributor.editor, dc.contributor.advisor, dc.contributor.committeeMember, \
dc.contributor.illustrator, dc.contributor.photographer, dc.contributor.translator, \
dc.identifier.orcid, dc.identifier.scopus, \
dc.identifier.doi, \
dc.subject.udc, dc.subject.bbk, dc.subject.jel, dc.subject.mesh, dc.subject.pacs, dc.subject, \
dc.format.pages, dc.format.extent, dc.citation.spage, dc.citation.epage, \
dc.relation.ispartofseries, \
dc.description.abstract, dc.description, dc.description.sponsorship, dc.description.tableofcontents, \
dc.identifier.govdoc, dc.identifier.uri(link), \
dc.identifier.isbn, dc.identifier.issn, \
dc.identifier.ismn, dc.identifier, dc.identifier.grantnumber, \
dc.rights.holder, dc.status, \
dc.relation.uri(link), \
dc.relation.references, \
dc.relation.referencesen

Щоб класифікаційні індекси стали гіперпосиланнями додайте також рядок типу
webui.browse.link.2 = subject:dc.subject.*

== Рядки локалізацій для нових полів ==
=== Messages_uk.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_uk.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_uk.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Останні надходження
metadata.dc.contributor.advisor = Науковий керівник
metadata.dc.contributor.committeeMember = Члени комітету
metadata.dc.contributor.illustrator = Ілюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Перекладач
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Рада захисту
metadata.thesis.degree.discipline = Шифр та назва спеціальності
metadata.thesis.degree.grantor = Установа захисту
metadata.thesis.degree.level = Рівень дисертації
metadata.thesis.degree.name = Науковий ступінь
metadata.dc.rights.holder = Власник авторського права
metadata.dc.coverage.placename = Місце видання, проведення
metadata.dc.status = Статус публікації
metadata.dc.description.tableofcontents = Зміст
metadata.dc.format.pages = Кількість сторінок
metadata.dc.format.extent = Діапазон сторінок
metadata.dc.identifier.grantnumber = Ідентифікатор гранту
metadata.dc.relation.references = Перелік літератури
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Приналежність
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подання
metadata.dc.coverage.temporal = Часове охоплення
metadata.dc.description.sponsorship = Спонсорська підтримка
metadata.dc.relation.ispartof = Є частиною видання
metadata.dc.citation.conference = Конференція/захід
metadata.dc.citation.journalTitle = Журнал/збірник
metadata.dc.citation.issue = Випуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патенту
metadata.dc.coverage.country = Країна (код)
metadata.dc.identifier.orcid = Ідентифікатор ORCID
metadata.dc.identifier.scopus = Ідентифікатор Scopus
metadata.dc.subject.mesh = Медичні тематичні рубрики (MESH)
metadata.dc.subject.pacs = Код класифікації з фізики та астрономії (PACS)
metadata.dc.citation.spage = Початкова сторінка
metadata.dc.citation.epage = Кінцева сторінка
metadata.dc.relation.uri = URL-посилання пов’язаного матеріалу

=== Messages_ru.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_ru.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_ru.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Последние поступления
browse.menu.author = Автор
browse.menu.subject = Темы
browse.menu.title = Заглавие
browse.menu.dateissued = Даты выпуска
metadata.dc.contributor.advisor = Научный руководитель
metadata.dc.contributor.committeeMember = Члены комитета
metadata.dc.contributor.illustrator = Иллюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Переводчик
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Совет защиты
metadata.thesis.degree.discipline = Шифр и название специальности
metadata.thesis.degree.grantor = Учреждение защиты
metadata.thesis.degree.level = Уровень диссертации
metadata.thesis.degree.name = Научная степень
metadata.dc.rights.holder = Владелец авторского права
metadata.dc.coverage.placename = Место издания, проведения
metadata.dc.status = Статус публикации
metadata.dc.description.tableofcontents = Содержание
metadata.dc.format.pages = Количество страниц
metadata.dc.format.extent = Диапазон страниц
metadata.dc.identifier.grantnumber = Идентификатор гранта
metadata.dc.relation.references = Список литературы
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Принадлежность
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подачи
metadata.dc.coverage.temporal = Временной охват
metadata.dc.description.sponsorship = Спонсорская поддержка
metadata.dc.relation.ispartof = Является частью издания
metadata.dc.citation.conference = Конференция/мероприятие
metadata.dc.citation.journalTitle = Журнал/сборник
metadata.dc.citation.issue = Выпуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патента
metadata.dc.coverage.country = Страна (код)
metadata.dc.identifier.orcid = Идентификатор ORCID
metadata.dc.identifier.scopus = Идентификатор Scopus
metadata.dc.subject.mesh = Медицинские тематические рубрики (MESH)
metadata.dc.subject.pacs = Код классификации по физике и астрономии (PACS)
metadata.dc.citation.spage = Начальная страница
metadata.dc.citation.epage = Последняя страница
metadata.dc.relation.uri = URL-ссылки связанного материала

=== Messages.properties ===
Файл зберігається в бінарному файлі dspace-api-X.X.jar, що розміщується за шляхами
/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/
(чи іншими, залежно від встановлення)

Файл dspace-api-X.X.jar також є архівом, отож Messages.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Recent submissions
metadata.dc.relation.references = References (Ukraine)
metadata.dc.relation.referencesen = References (International)
metadata.dc.identifier.citation = Bibliographic description (Ukraine)
metadata.dc.identifier.citationen = Bibliographic description (International)
metadata.dc.contributor.affiliation = Affiliation
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Submitted date
metadata.dc.coverage.temporal = Temporal Coverage
metadata.dc.description.sponsorship = Sponsorship
metadata.dc.relation.ispartof = Is part of
metadata.dc.citation.conference = Conference/Event
metadata.dc.citation.journalTitle = Journal/Collection
metadata.dc.citation.issue = Issue
metadata.dc.citation.volume = Volume
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = Patent No
metadata.dc.coverage.country = Country (code)
metadata.dc.identifier.orcid = ORCID Id
metadata.dc.identifier.scopus = Scopus Id
metadata.dc.subject.mesh = Medical Subject Headings (MESH)
metadata.dc.subject.pacs = Physics and Astronomy Classification Scheme (PACS)
metadata.dc.citation.spage = Start page
metadata.dc.citation.epage = End page
metadata.dc.relation.uri = URL for reference material
metadata.dc.description.tableofcontents = Content
metadata.dc.coverage.placename = Place of the edition/event
metadata.dc.contributor.advisor = Supervisor
metadata.dc.contributor.committeeMember = Committee members
metadata.dc.format.pages = Number of pages
metadata.dc.format.extent = Page range
metadata.dc.contributor.illustrator = Illustrator
metadata.dc.contributor.photographer = Photographer
metadata.dc.contributor.translator = Translator
metadata.dc.identifier.grantnumber = Grant ID
metadata.dc.rights.holder = Copyright owner
metadata.dc.status = Publications status
metadata.dc.subject.bbk = BBK
metadata.dc.subject.udc = UDC
metadata.thesis.degree.department = Defense council
metadata.thesis.degree.discipline = Code and name of the specialty
metadata.thesis.degree.grantor = Institution defense
metadata.thesis.degree.level = Level thesis
metadata.thesis.degree.name = Science degree

Після доповнення мовних файлів Messages_uk.properties, Messages_ru.properties, Messages.properties, збереженні їх у dspace-api-lang-X.X.X.jar та dspace-api-X.X.jar, розміщенні останніх за відповідними шляхами у системі, також необхідно перезапустити веб-сервер Tomcat

/etc/init.d/tomcat8 restart

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Додаткові поля Dublin Core для DSpace

2017-10-26T11:38:52Z

Dubyk: /* Файл QDC.properties */

== Додаткові поля ==

Додаються/редагуються в інтерфейсі адміністрування » '''Реєстр полів метаданих''':

* '''dc.contributor.advisor''' — '''Використовуйте в першу чергу для наукового керівника дисертації.'''
* '''dc.contributor.affiliation''' — '''Місце роботи автора (повна назва організації, повна адреса, регалії та контактні дані).'''
* '''dc.contributor.committeeMember''' — '''Використовується для членів дисертаційного комітету.'''

* '''dc.coverage.country''' — '''Країна (2-букв. код країни за ISO_3166-1 alpha-2).'''
* '''dc.coverage.placename''' — '''Ареал охоплення або район розташування, охоплювані у даних, наприклад, регіони, країни чи міста.'''

* '''dc.date.submitted''' — '''Дата подання матеріалу. Рекомендовано для творів/тез/дисертацій.'''

* '''dc.description.tableofcontents''' — '''Таблиця змісту для даного матеріалу.'''

* '''dc.format.extent''' — '''Розмір та тривалість. Також діапазон сторінок.'''
* '''dc.format.pages''' — '''Обсяг матеріалу, кількість сторінок.'''

''Додаткові ідентифікатори:''

* '''dc.identifier.citationen''' — '''Accessible to man, standard bibliographic description, not-DSpace format for this material.'''
* '''dc.identifier.doi''' — '''Цифровий ідентифікатор об'єкта (DOI), виданий реєстраційним агенством DOI на цю публікацію.'''
* '''dc.identifier.orcid''' — '''Унікальний ідентифікатор вченого з міжнародного реєстру ORCID.'''
* '''dc.identifier.patent''' — '''№ патенту (число).'''
* '''dc.identifier.scopus''' — '''Ідентифікатор статті у реферативній БД Scopus.'''

''Пов’язані джерела:''

* '''dc.relation.references''' — '''Список використаних джерел, посилання на літературу, що були використані при підготовці матеріалу.'''
* '''dc.relation.referencesen''' — '''List of used sources, literature references that were used during the preparation the material.'''
* '''dc.relation.uri''' — '''Посилається на загальноприйнятий ідентифікатор ресурсу для пов’язаного матеріалу.'''

''Додаткові класифікаційні індекси:''

* '''dc.subject.udc''' — '''УДК'''
* '''dc.subject.bbk''' — '''ББК'''
* '''dc.subject.jel''' — '''Система класифікації JEL для наукової літератури в галузі економіки.'''
* '''dc.subject.mesh''' — '''Медичні тематичні рубрики.'''
* '''dc.subject.pacs''' — '''Код класифікації з фізики та астрономії (PACS).'''

''Група полів для Google Академії:''

* '''dc.citation.conference''' — '''Назва заходу, конференції, події, за результатами яких видано ці матеріали.'''
* '''dc.citation.journalTitle''' — '''Основна офіційна назва журналу.'''
* '''dc.citation.volume''' — '''Номер тому, починається завжди з цифр (араб. чи грець.), якщо є назва, то додається через двокрапку; без слова том.'''
* '''dc.citation.issue''' — '''Номер випуску (для журналу); без „№ “.'''
* '''dc.citation.spage''' — '''Початковий номер сторінки.'''
* '''dc.citation.epage''' — '''Кінцевий номер сторінки.'''

''Група дисертаційних полів:''

* '''thesis.degree.department''' — '''Назва академічного відділу, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.discipline''' — '''Область вивчення інтелектуального змісту дисертації тощо.'''
* '''thesis.degree.grantor''' — '''Назва установи, що присвоює ступінь, пов’язаний з дисертацією тощо.'''
* '''thesis.degree.level''' — '''Градація ступеня, пов’язаного з дисертацією тощо. («кандидатська» чи «докторська»).'''
* '''thesis.degree.name''' — '''Назва ступеня, пов’язаного з дисертацією тощо. (доктор філософії, кандидат гуманітарних наук тощо).'''

== Файл QDC.properties ==

Попереднє відображення типових елементів метаданих DSpace у схему QDC XML.
Необхідне для Google Академії і т.п.

Приводиться відображення для існуючих та нових полів.

Розміщення (в залежності від встановлення): /home/data/dspace/config/crosswalks/QDC.properties

Приклад для DSpace 5.6: http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/QDC.properties

Додати наприкінці наступне

dc.citation.journalTitle = <dc:citation_journal_title />
dc.citation.volume = <dc:citation_volume />
dc.citation.issue = <dc:citation_issue />
dc.citation.spage = <dc:citation_firstpage />
dc.citation.epage = <dc:citation_lastpage />
dc.identifier.doi = <dc:citation_doi />
dc.identifier.issn = <dc:citation_issn />
dc.identifier.isbn = <dc:citation_isbn />
# dc.citation.conference = <dc:citation_conference />
dc.citation.conference = <dc:citation_conference_title />
dc.coverage.country = <dc:citation_patent_country />
dc.identifier.patent = <dc:citation_patent_number />
dc.subject = <dc:citation_keywords />
# dc.date.submitted = <dcterms:dateSubmitted />
dc.contributor.affiliation = <dc:citation_author_institution />
dc.subject.udc = <dc:subject type="dcterms:UDC" />
dc.subject.bbk = <dc:subject type="dcterms:BBK" />
dc.subject.jel = <dc:subject type="dcterms:JEL" />
dc.subject.pacs = <dc:subject type="dcterms:PACS" />

== Файл xhtml-head-item.properties ==

Відображення між схемою реєстру метаданих DSpace та схемою, що записується у тег <meta> заголовку XHTML.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/crosswalks/xhtml-head-item.properties

Деякі ідеї взяті з статті https://jira.duraspace.org/secure/attachment/13020/Invisible_institutional.pdf

Додати наприкінці наступне

dc.citation.journalTitle = citation_journal_title
dc.citation.volume = citation_volume
dc.citation.issue = citation_issue
dc.citation.spage = citation_firstpage
dc.citation.epage = citation_lastpage
dc.identifier.doi = citation_doi
dc.identifier.issn = citation_issn
dc.identifier.isbn = citation_isbn
# dc.citation.conference = citation_conference
dc.citation.conference = citation_conference_title
dc.coverage.country = citation_patent_country
dc.identifier.patent = citation_patent_number
dc.subject = citation_keywords
dc.date.submitted = DCTERMS.dateSubmitted,DCTERMS.W3CDTF
# = citation_section
dc.contributor.affiliation = citation_author_institution
# = citation_patent_application_number

== Файл форм вводу input-forms_uk.xml ==

Файл форм внесення метаданих.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/input-forms.xml

Замість перерахунку змін (у порівнянні з типовим) наведено файл [http://elartu.tntu.edu.ua:8080/files/input-forms.xml input-forms.xml], що використовується в репозитарії [http://elartu.tntu.edu.ua ELARTU].

== Файл dspace.cfg ==

Файл налаштувань DSpace.

Розміщення (в залежності від встановлення): /usr/share/dspace/config/dspace.cfg

Налаштування полів метаданих дублінського ядра що відображаються у вікні '''базового опису матеріалу'''.

webui.itemdisplay.default = dc.title, \
dc.title.alternative, \
dc.contributor.author, \
dc.contributor.affiliation, \
dc.identifier.citation, \
dc.identifier.citationen, \
dc.relation.ispartof, \
dc.citation.conference, \
dc.citation.journalTitle, \
dc.citation.issue, \
dc.citation.volume, \
dc.identifier.patent, \
dc.date.issued(date), dc.date.submitted(date), dc.publisher, \
dc.coverage.country, dc.coverage.placename, dc.coverage.temporal, \
thesis.degree.name, thesis.degree.level, thesis.degree.discipline, \
thesis.degree.department, thesis.degree.grantor, \
dc.contributor.editor, dc.contributor.advisor, dc.contributor.committeeMember, \
dc.contributor.illustrator, dc.contributor.photographer, dc.contributor.translator, \
dc.identifier.orcid, dc.identifier.scopus, \
dc.identifier.doi, \
dc.subject.udc, dc.subject.bbk, dc.subject.jel, dc.subject.mesh, dc.subject.pacs, dc.subject, \
dc.format.pages, dc.format.extent, dc.citation.spage, dc.citation.epage, \
dc.relation.ispartofseries, \
dc.description.abstract, dc.description, dc.description.sponsorship, dc.description.tableofcontents, \
dc.identifier.govdoc, dc.identifier.uri(link), \
dc.identifier.isbn, dc.identifier.issn, \
dc.identifier.ismn, dc.identifier, dc.identifier.grantnumber, \
dc.rights.holder, dc.status, \
dc.relation.uri(link), \
dc.relation.references, \
dc.relation.referencesen

Щоб класифікаційні індекси стали гіперпосиланнями додайте також рядок типу
webui.browse.link.2 = subject:dc.subject.*

== Рядки локалізацій для нових полів ==
=== Messages_uk.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_uk.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_uk.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Останні надходження
metadata.dc.contributor.advisor = Науковий керівник
metadata.dc.contributor.committeeMember = Члени комітету
metadata.dc.contributor.illustrator = Ілюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Перекладач
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Рада захисту
metadata.thesis.degree.discipline = Шифр та назва спеціальності
metadata.thesis.degree.grantor = Установа захисту
metadata.thesis.degree.level = Рівень дисертації
metadata.thesis.degree.name = Науковий ступінь
metadata.dc.rights.holder = Власник авторського права
metadata.dc.coverage.placename = Місце видання, проведення
metadata.dc.status = Статус публікації
metadata.dc.description.tableofcontents = Зміст
metadata.dc.format.pages = Кількість сторінок
metadata.dc.format.extent = Діапазон сторінок
metadata.dc.identifier.grantnumber = Ідентифікатор гранту
metadata.dc.relation.references = Перелік літератури
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Приналежність
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подання
metadata.dc.coverage.temporal = Часове охоплення
metadata.dc.description.sponsorship = Спонсорська підтримка
metadata.dc.relation.ispartof = Є частиною видання
metadata.dc.citation.conference = Конференція/захід
metadata.dc.citation.journalTitle = Журнал/збірник
metadata.dc.citation.issue = Випуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патенту
metadata.dc.coverage.country = Країна (код)
metadata.dc.identifier.orcid = Ідентифікатор ORCID
metadata.dc.identifier.scopus = Ідентифікатор Scopus
metadata.dc.subject.mesh = Медичні тематичні рубрики (MESH)
metadata.dc.subject.pacs = Код класифікації з фізики та астрономії (PACS)
metadata.dc.citation.spage = Початкова сторінка
metadata.dc.citation.epage = Кінцева сторінка
metadata.dc.relation.uri = URL-посилання пов’язаного матеріалу

=== Messages_ru.properties ===

Файл зберігається в бінарному файлі dspace-api-lang-X.X.X.jar, що розміщується за шляхами

/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/

(чи іншими, залежно від встановлення)

Файл dspace-api-lang-X.X.X.jar також є архівом, отож Messages_ru.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages_ru.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Последние поступления
browse.menu.author = Автор
browse.menu.subject = Темы
browse.menu.title = Заглавие
browse.menu.dateissued = Даты выпуска
metadata.dc.contributor.advisor = Научный руководитель
metadata.dc.contributor.committeeMember = Члены комитета
metadata.dc.contributor.illustrator = Иллюстратор
metadata.dc.contributor.photographer = Фотограф
metadata.dc.contributor.translator = Переводчик
metadata.dc.subject.udc = УДК
metadata.dc.subject.bbk = ББК
metadata.thesis.degree.department = Совет защиты
metadata.thesis.degree.discipline = Шифр и название специальности
metadata.thesis.degree.grantor = Учреждение защиты
metadata.thesis.degree.level = Уровень диссертации
metadata.thesis.degree.name = Научная степень
metadata.dc.rights.holder = Владелец авторского права
metadata.dc.coverage.placename = Место издания, проведения
metadata.dc.status = Статус публикации
metadata.dc.description.tableofcontents = Содержание
metadata.dc.format.pages = Количество страниц
metadata.dc.format.extent = Диапазон страниц
metadata.dc.identifier.grantnumber = Идентификатор гранта
metadata.dc.relation.references = Список литературы
metadata.dc.relation.referencesen = References
metadata.dc.identifier.citationen = Bibliographic description
metadata.dc.contributor.affiliation = Принадлежность
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Дата подачи
metadata.dc.coverage.temporal = Временной охват
metadata.dc.description.sponsorship = Спонсорская поддержка
metadata.dc.relation.ispartof = Является частью издания
metadata.dc.citation.conference = Конференция/мероприятие
metadata.dc.citation.journalTitle = Журнал/сборник
metadata.dc.citation.issue = Выпуск/№
metadata.dc.citation.volume = Том
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = № патента
metadata.dc.coverage.country = Страна (код)
metadata.dc.identifier.orcid = Идентификатор ORCID
metadata.dc.identifier.scopus = Идентификатор Scopus
metadata.dc.subject.mesh = Медицинские тематические рубрики (MESH)
metadata.dc.subject.pacs = Код классификации по физике и астрономии (PACS)
metadata.dc.citation.spage = Начальная страница
metadata.dc.citation.epage = Последняя страница
metadata.dc.relation.uri = URL-ссылки связанного материала

=== Messages.properties ===
Файл зберігається в бінарному файлі dspace-api-X.X.jar, що розміщується за шляхами
/usr/local/tomcat/webapps/ROOT/WEB-INF/lib/
/home/dspacesrc/lib/
/home/dspacesrc/webapps/jspui/WEB-INF/lib/
(чи іншими, залежно від встановлення)

Файл dspace-api-X.X.jar також є архівом, отож Messages.properties можна вийняти чи додати за допомогою архіватора (чи mc).

Нові рядки в Messages.properties для нових полів

…
jsp.layout.navbar-default.recent_submissions = Recent submissions
metadata.dc.relation.references = References (Ukraine)
metadata.dc.relation.referencesen = References (International)
metadata.dc.identifier.citation = Bibliographic description (Ukraine)
metadata.dc.identifier.citationen = Bibliographic description (International)
metadata.dc.contributor.affiliation = Affiliation
metadata.dc.subject.jel = JEL
metadata.dc.date.submitted = Submitted date
metadata.dc.coverage.temporal = Temporal Coverage
metadata.dc.description.sponsorship = Sponsorship
metadata.dc.relation.ispartof = Is part of
metadata.dc.citation.conference = Conference/Event
metadata.dc.citation.journalTitle = Journal/Collection
metadata.dc.citation.issue = Issue
metadata.dc.citation.volume = Volume
metadata.dc.identifier.doi = DOI
metadata.dc.identifier.patent = Patent No
metadata.dc.coverage.country = Country (code)
metadata.dc.identifier.orcid = ORCID Id
metadata.dc.identifier.scopus = Scopus Id
metadata.dc.subject.mesh = Medical Subject Headings (MESH)
metadata.dc.subject.pacs = Physics and Astronomy Classification Scheme (PACS)
metadata.dc.citation.spage = Start page
metadata.dc.citation.epage = End page
metadata.dc.relation.uri = URL for reference material
metadata.dc.description.tableofcontents = Content
metadata.dc.coverage.placename = Place of the edition/event
metadata.dc.contributor.advisor = Supervisor
metadata.dc.contributor.committeeMember = Committee members
metadata.dc.format.pages = Number of pages
metadata.dc.format.extent = Page range
metadata.dc.contributor.illustrator = Illustrator
metadata.dc.contributor.photographer = Photographer
metadata.dc.contributor.translator = Translator
metadata.dc.identifier.grantnumber = Grant ID
metadata.dc.rights.holder = Copyright owner
metadata.dc.status = Publications status
metadata.dc.subject.bbk = BBK
metadata.dc.subject.udc = UDC
metadata.thesis.degree.department = Defense council
metadata.thesis.degree.discipline = Code and name of the specialty
metadata.thesis.degree.grantor = Institution defense
metadata.thesis.degree.level = Level thesis
metadata.thesis.degree.name = Science degree

Після доповнення мовних файлів Messages_uk.properties, Messages_ru.properties, Messages.properties, збереженні їх у dspace-api-lang-X.X.X.jar та dspace-api-X.X.jar, розміщенні останніх за відповідними шляхами у системі, також необхідно перезапустити веб-сервер Tomcat

/etc/init.d/tomcat8 restart

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T11:32:33Z

Dubyk: /* Інтерфейс JSPUI */

= dspace.cfg =
default.language = uk_UA
cc.license.locale = uk_UA
default.locale = uk
webui.supported.locales = uk,en,ru,pl,bg,ca,cs,cy,de,el,es,et,eu,fr,gl,hu,id,it,ja,no,pt,sv,th,tr,zh_CN

При підключенні більшості кількості додаткових мов в dspace/config повинні існувати файли:
news-top.html news-side.html news-xmlui.xml
news-side_bg.html news-side_pt_PT.html news-top_cs.html news-top_hu.html news-top_sv.html
news-side_ca.html news-side_ru.html news-top_cy.html news-top_id.html news-top_th.html
news-side_cs.html news-side_hu.html news-side_sv.html news-top_de.html news-top_it.html news-top_tr.html
news-side_cy.html news-side_id.html news-side_th.html news-top_el.html news-top_ja.html news-top_uk.html
news-side_de.html news-side_it.html news-side_tr.html news-top_es.html news-top_no.html news-top_zh_CN.html
news-side_el.html news-side_ja.html news-side_uk.html news-top_et.html news-top_pl.html news-top_zh_TW.html
news-side_es.html news-side_no.html news-side_zh_CN.html news-top_fr.html news-top_pt_BR.html
news-side_et.html news-side_pl.html news-side_zh_TW.html news-top_gl.html news-top_pt.html
news-side_fr.html news-side_pt_BR.html news-top_bg.html news-top_pt_PT.html
news-side_gl.html news-side_pt.html news-top_ca.html news-top_ru.html
uudised kõrval.html uudised ülal.html

= Інтерфейс JSPUI =

Це змінений варіант вбудованого українського перекладу.

DSpace 6.0:
* [https://www.dropbox.com/s/z0cmt9bd9vt00wz/Messages_uk.properties?dl=0 Messages_uk.properties]

Додаткові рядки (пов’язані з новими метаполями):
* [https://www.dropbox.com/s/0zydk5nx1r23hhy/Messages_add_uk.properties?dl=0 Messages_add_uk.properties]
* [https://www.dropbox.com/s/2wbji7ej0iayxau/Messages_add_ru.properties?dl=0 Messages_add_ru.properties]
* [https://www.dropbox.com/s/xs0wtqafpkaeb0q/Messages_add.properties?dl=0 Messages_add.properties]
* [https://www.dropbox.com/s/qfbmbxzbv0w6dyv/Messages_add_pl.properties?dl=0 Messages_add_pl.properties]

Додаткові файли необхідно об’єднати (злити) з основними мовними файлами.

Допоміжні команди:
native2ascii -reverse Messages_add.properties Messages_add.properties.txt
native2ascii Messages_uk.properties.txt Messages_uk.properties
jar uf dspace-api-lang-6.0.4.jar Messages.properties Messages_uk.properties Messages_ru.properties Messages_pl.properties
jar uf dspace-api-6.0.jar Messages.properties
scp -P $port $dspace_api_lang $user@$host:$dspace/lib/$dspace_api_lang
scp -P $port $dspace_api_lang $user@$host:$dspace/webapps/jspui/WEB-INF/lib/$dspace_api_lang
scp -P $port $dspace_api $user@$host:$dspace/lib/$dspace_api
scp -P $port $dspace_api $user@$host:$dspace/webapps/jspui/WEB-INF/lib/$dspace_api

= Інтерфейс XMLUI =

Це змінений варіант вбудованого українського перекладу.

DSpace 5.0:
* [https://www.dropbox.com/s/076wgkm2oiissbt/messages_uk.xml?dl=0 messages_uk.xml]

= Шаблони листів =
Переклад українською шаблонів листів з адаптацією для ELARTU: http://elartu.tntu.edu.ua:8080/files/dspace/config/emails/

= Форма вводу =
Розширена локалізована українською форма вводу, що використовується в репозитаріях ТНТУ і НУ„ЛП“: http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml

= Додаткові поля =
Див. [[Додаткові поля Dublin Core для DSpace]]
= Тека crosswalks =
Метадані для харвестерів, зокрема Google Академії.

Додано метатеги у 3 файли (деякі актуальні для старіших версії DSpace, деякі для новіших): http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/

= Ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_uk_only_translation.license

Інші ліцензії:
* Авторський договір в ТНТУ: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_TNTU.license

= Довідка =

Стара довідка українською та іншими мовами від DSpace 1.5.2: http://elartu.tntu.edu.ua:8080/files/dspace/webapps/jspui/

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T11:32:03Z

Dubyk: /* Інтерфейс XMLUI */

= dspace.cfg =
default.language = uk_UA
cc.license.locale = uk_UA
default.locale = uk
webui.supported.locales = uk,en,ru,pl,bg,ca,cs,cy,de,el,es,et,eu,fr,gl,hu,id,it,ja,no,pt,sv,th,tr,zh_CN

При підключенні більшості кількості додаткових мов в dspace/config повинні існувати файли:
news-top.html news-side.html news-xmlui.xml
news-side_bg.html news-side_pt_PT.html news-top_cs.html news-top_hu.html news-top_sv.html
news-side_ca.html news-side_ru.html news-top_cy.html news-top_id.html news-top_th.html
news-side_cs.html news-side_hu.html news-side_sv.html news-top_de.html news-top_it.html news-top_tr.html
news-side_cy.html news-side_id.html news-side_th.html news-top_el.html news-top_ja.html news-top_uk.html
news-side_de.html news-side_it.html news-side_tr.html news-top_es.html news-top_no.html news-top_zh_CN.html
news-side_el.html news-side_ja.html news-side_uk.html news-top_et.html news-top_pl.html news-top_zh_TW.html
news-side_es.html news-side_no.html news-side_zh_CN.html news-top_fr.html news-top_pt_BR.html
news-side_et.html news-side_pl.html news-side_zh_TW.html news-top_gl.html news-top_pt.html
news-side_fr.html news-side_pt_BR.html news-top_bg.html news-top_pt_PT.html
news-side_gl.html news-side_pt.html news-top_ca.html news-top_ru.html
uudised kõrval.html uudised ülal.html

= Інтерфейс JSPUI =
DSpace 6.0:
* [https://www.dropbox.com/s/z0cmt9bd9vt00wz/Messages_uk.properties?dl=0 Messages_uk.properties]

Додаткові рядки (пов’язані з новими метаполями):
* [https://www.dropbox.com/s/0zydk5nx1r23hhy/Messages_add_uk.properties?dl=0 Messages_add_uk.properties]
* [https://www.dropbox.com/s/2wbji7ej0iayxau/Messages_add_ru.properties?dl=0 Messages_add_ru.properties]
* [https://www.dropbox.com/s/xs0wtqafpkaeb0q/Messages_add.properties?dl=0 Messages_add.properties]
* [https://www.dropbox.com/s/qfbmbxzbv0w6dyv/Messages_add_pl.properties?dl=0 Messages_add_pl.properties]

Додаткові файли необхідно об’єднати (злити) з основними мовними файлами.

Допоміжні команди:
native2ascii -reverse Messages_add.properties Messages_add.properties.txt
native2ascii Messages_uk.properties.txt Messages_uk.properties
jar uf dspace-api-lang-6.0.4.jar Messages.properties Messages_uk.properties Messages_ru.properties Messages_pl.properties
jar uf dspace-api-6.0.jar Messages.properties
scp -P $port $dspace_api_lang $user@$host:$dspace/lib/$dspace_api_lang
scp -P $port $dspace_api_lang $user@$host:$dspace/webapps/jspui/WEB-INF/lib/$dspace_api_lang
scp -P $port $dspace_api $user@$host:$dspace/lib/$dspace_api
scp -P $port $dspace_api $user@$host:$dspace/webapps/jspui/WEB-INF/lib/$dspace_api

= Інтерфейс XMLUI =

Це змінений варіант вбудованого українського перекладу.

DSpace 5.0:
* [https://www.dropbox.com/s/076wgkm2oiissbt/messages_uk.xml?dl=0 messages_uk.xml]

= Шаблони листів =
Переклад українською шаблонів листів з адаптацією для ELARTU: http://elartu.tntu.edu.ua:8080/files/dspace/config/emails/

= Форма вводу =
Розширена локалізована українською форма вводу, що використовується в репозитаріях ТНТУ і НУ„ЛП“: http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml

= Додаткові поля =
Див. [[Додаткові поля Dublin Core для DSpace]]
= Тека crosswalks =
Метадані для харвестерів, зокрема Google Академії.

Додано метатеги у 3 файли (деякі актуальні для старіших версії DSpace, деякі для новіших): http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/

= Ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_uk_only_translation.license

Інші ліцензії:
* Авторський договір в ТНТУ: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_TNTU.license

= Довідка =

Стара довідка українською та іншими мовами від DSpace 1.5.2: http://elartu.tntu.edu.ua:8080/files/dspace/webapps/jspui/

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T11:26:54Z

Dubyk: /* Інтерфейс JSPUI */

= dspace.cfg =
default.language = uk_UA
cc.license.locale = uk_UA
default.locale = uk
webui.supported.locales = uk,en,ru,pl,bg,ca,cs,cy,de,el,es,et,eu,fr,gl,hu,id,it,ja,no,pt,sv,th,tr,zh_CN

При підключенні більшості кількості додаткових мов в dspace/config повинні існувати файли:
news-top.html news-side.html news-xmlui.xml
news-side_bg.html news-side_pt_PT.html news-top_cs.html news-top_hu.html news-top_sv.html
news-side_ca.html news-side_ru.html news-top_cy.html news-top_id.html news-top_th.html
news-side_cs.html news-side_hu.html news-side_sv.html news-top_de.html news-top_it.html news-top_tr.html
news-side_cy.html news-side_id.html news-side_th.html news-top_el.html news-top_ja.html news-top_uk.html
news-side_de.html news-side_it.html news-side_tr.html news-top_es.html news-top_no.html news-top_zh_CN.html
news-side_el.html news-side_ja.html news-side_uk.html news-top_et.html news-top_pl.html news-top_zh_TW.html
news-side_es.html news-side_no.html news-side_zh_CN.html news-top_fr.html news-top_pt_BR.html
news-side_et.html news-side_pl.html news-side_zh_TW.html news-top_gl.html news-top_pt.html
news-side_fr.html news-side_pt_BR.html news-top_bg.html news-top_pt_PT.html
news-side_gl.html news-side_pt.html news-top_ca.html news-top_ru.html
uudised kõrval.html uudised ülal.html

= Інтерфейс JSPUI =
DSpace 6.0:
* [https://www.dropbox.com/s/z0cmt9bd9vt00wz/Messages_uk.properties?dl=0 Messages_uk.properties]

Додаткові рядки (пов’язані з новими метаполями):
* [https://www.dropbox.com/s/0zydk5nx1r23hhy/Messages_add_uk.properties?dl=0 Messages_add_uk.properties]
* [https://www.dropbox.com/s/2wbji7ej0iayxau/Messages_add_ru.properties?dl=0 Messages_add_ru.properties]
* [https://www.dropbox.com/s/xs0wtqafpkaeb0q/Messages_add.properties?dl=0 Messages_add.properties]
* [https://www.dropbox.com/s/qfbmbxzbv0w6dyv/Messages_add_pl.properties?dl=0 Messages_add_pl.properties]

Додаткові файли необхідно об’єднати (злити) з основними мовними файлами.

Допоміжні команди:
native2ascii -reverse Messages_add.properties Messages_add.properties.txt
native2ascii Messages_uk.properties.txt Messages_uk.properties
jar uf dspace-api-lang-6.0.4.jar Messages.properties Messages_uk.properties Messages_ru.properties Messages_pl.properties
jar uf dspace-api-6.0.jar Messages.properties
scp -P $port $dspace_api_lang $user@$host:$dspace/lib/$dspace_api_lang
scp -P $port $dspace_api_lang $user@$host:$dspace/webapps/jspui/WEB-INF/lib/$dspace_api_lang
scp -P $port $dspace_api $user@$host:$dspace/lib/$dspace_api
scp -P $port $dspace_api $user@$host:$dspace/webapps/jspui/WEB-INF/lib/$dspace_api

= Інтерфейс XMLUI =
= Шаблони листів =
Переклад українською шаблонів листів з адаптацією для ELARTU: http://elartu.tntu.edu.ua:8080/files/dspace/config/emails/

= Форма вводу =
Розширена локалізована українською форма вводу, що використовується в репозитаріях ТНТУ і НУ„ЛП“: http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml

= Додаткові поля =
Див. [[Додаткові поля Dublin Core для DSpace]]
= Тека crosswalks =
Метадані для харвестерів, зокрема Google Академії.

Додано метатеги у 3 файли (деякі актуальні для старіших версії DSpace, деякі для новіших): http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/

= Ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_uk_only_translation.license

Інші ліцензії:
* Авторський договір в ТНТУ: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_TNTU.license

= Довідка =

Стара довідка українською та іншими мовами від DSpace 1.5.2: http://elartu.tntu.edu.ua:8080/files/dspace/webapps/jspui/

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T11:12:59Z

Dubyk: /* Інтерфейс JSPUI */

= dspace.cfg =
default.language = uk_UA
cc.license.locale = uk_UA
default.locale = uk
webui.supported.locales = uk,en,ru,pl,bg,ca,cs,cy,de,el,es,et,eu,fr,gl,hu,id,it,ja,no,pt,sv,th,tr,zh_CN

При підключенні більшості кількості додаткових мов в dspace/config повинні існувати файли:
news-top.html news-side.html news-xmlui.xml
news-side_bg.html news-side_pt_PT.html news-top_cs.html news-top_hu.html news-top_sv.html
news-side_ca.html news-side_ru.html news-top_cy.html news-top_id.html news-top_th.html
news-side_cs.html news-side_hu.html news-side_sv.html news-top_de.html news-top_it.html news-top_tr.html
news-side_cy.html news-side_id.html news-side_th.html news-top_el.html news-top_ja.html news-top_uk.html
news-side_de.html news-side_it.html news-side_tr.html news-top_es.html news-top_no.html news-top_zh_CN.html
news-side_el.html news-side_ja.html news-side_uk.html news-top_et.html news-top_pl.html news-top_zh_TW.html
news-side_es.html news-side_no.html news-side_zh_CN.html news-top_fr.html news-top_pt_BR.html
news-side_et.html news-side_pl.html news-side_zh_TW.html news-top_gl.html news-top_pt.html
news-side_fr.html news-side_pt_BR.html news-top_bg.html news-top_pt_PT.html
news-side_gl.html news-side_pt.html news-top_ca.html news-top_ru.html
uudised kõrval.html uudised ülal.html

= Інтерфейс JSPUI =
DSpace 6.0:
* [https://www.dropbox.com/s/z0cmt9bd9vt00wz/Messages_uk.properties?dl=0 Messages_uk.properties]

Додаткові рядки (пов’яазані з новими метаполями):
* [https://www.dropbox.com/s/0zydk5nx1r23hhy/Messages_add_uk.properties?dl=0 Messages_add_uk.properties]
* [https://www.dropbox.com/s/2wbji7ej0iayxau/Messages_add_ru.properties?dl=0 Messages_add_ru.properties]
* [https://www.dropbox.com/s/xs0wtqafpkaeb0q/Messages_add.properties?dl=0 Messages_add.properties]
* [https://www.dropbox.com/s/qfbmbxzbv0w6dyv/Messages_add_pl.properties?dl=0 Messages_add_pl.properties]

Додаткові файли необхідно об’єднати (злити) з основними мовними файлами.

= Інтерфейс XMLUI =
= Шаблони листів =
Переклад українською шаблонів листів з адаптацією для ELARTU: http://elartu.tntu.edu.ua:8080/files/dspace/config/emails/

= Форма вводу =
Розширена локалізована українською форма вводу, що використовується в репозитаріях ТНТУ і НУ„ЛП“: http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml

= Додаткові поля =
Див. [[Додаткові поля Dublin Core для DSpace]]
= Тека crosswalks =
Метадані для харвестерів, зокрема Google Академії.

Додано метатеги у 3 файли (деякі актуальні для старіших версії DSpace, деякі для новіших): http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/

= Ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_uk_only_translation.license

Інші ліцензії:
* Авторський договір в ТНТУ: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_TNTU.license

= Довідка =

Стара довідка українською та іншими мовами від DSpace 1.5.2: http://elartu.tntu.edu.ua:8080/files/dspace/webapps/jspui/

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T09:52:27Z

Dubyk: /* Інтерфейс JSPUI */

= dspace.cfg =
default.language = uk_UA
cc.license.locale = uk_UA
default.locale = uk
webui.supported.locales = uk,en,ru,pl,bg,ca,cs,cy,de,el,es,et,eu,fr,gl,hu,id,it,ja,no,pt,sv,th,tr,zh_CN

При підключенні більшості кількості додаткових мов в dspace/config повинні існувати файли:
news-top.html news-side.html news-xmlui.xml
news-side_bg.html news-side_pt_PT.html news-top_cs.html news-top_hu.html news-top_sv.html
news-side_ca.html news-side_ru.html news-top_cy.html news-top_id.html news-top_th.html
news-side_cs.html news-side_hu.html news-side_sv.html news-top_de.html news-top_it.html news-top_tr.html
news-side_cy.html news-side_id.html news-side_th.html news-top_el.html news-top_ja.html news-top_uk.html
news-side_de.html news-side_it.html news-side_tr.html news-top_es.html news-top_no.html news-top_zh_CN.html
news-side_el.html news-side_ja.html news-side_uk.html news-top_et.html news-top_pl.html news-top_zh_TW.html
news-side_es.html news-side_no.html news-side_zh_CN.html news-top_fr.html news-top_pt_BR.html
news-side_et.html news-side_pl.html news-side_zh_TW.html news-top_gl.html news-top_pt.html
news-side_fr.html news-side_pt_BR.html news-top_bg.html news-top_pt_PT.html
news-side_gl.html news-side_pt.html news-top_ca.html news-top_ru.html
uudised kõrval.html uudised ülal.html

= Інтерфейс JSPUI =
DSpace 6.0:
* [https://www.dropbox.com/s/z0cmt9bd9vt00wz/Messages_uk.properties?dl=0 Messages_uk.properties]

Додаткові рядки (пов’яазані з новими метаполями):
* [https://www.dropbox.com/s/0zydk5nx1r23hhy/Messages_add_uk.properties?dl=0 Messages_add_uk.properties]
* [https://www.dropbox.com/s/2wbji7ej0iayxau/Messages_add_ru.properties?dl=0 Messages_add_ru.properties]
Додаткові файли необхідно об’єднати (злити) з основними мовними файлами.

= Інтерфейс XMLUI =
= Шаблони листів =
Переклад українською шаблонів листів з адаптацією для ELARTU: http://elartu.tntu.edu.ua:8080/files/dspace/config/emails/

= Форма вводу =
Розширена локалізована українською форма вводу, що використовується в репозитаріях ТНТУ і НУ„ЛП“: http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml

= Додаткові поля =
Див. [[Додаткові поля Dublin Core для DSpace]]
= Тека crosswalks =
Метадані для харвестерів, зокрема Google Академії.

Додано метатеги у 3 файли (деякі актуальні для старіших версії DSpace, деякі для новіших): http://elartu.tntu.edu.ua:8080/files/dspace/config/crosswalks/

= Ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_uk_only_translation.license

Інші ліцензії:
* Авторський договір в ТНТУ: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_TNTU.license

= Довідка =

Стара довідка українською та іншими мовами від DSpace 1.5.2: http://elartu.tntu.edu.ua:8080/files/dspace/webapps/jspui/

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T09:50:03Z

Dubyk: /* Інтерфейс JSPUI */

Українізація DSpace

2017-10-26T09:44:30Z

Dubyk: /* Ліцензія */

Українізація DSpace

2017-10-26T09:38:36Z

Dubyk: /* Додаткові поля */

Українізація DSpace

2017-10-26T09:31:19Z

Dubyk: /* Додаткові поля */

Українізація DSpace

2017-10-26T09:30:47Z

Dubyk: /* Шаблони листів */

Українізація DSpace

2017-10-26T09:28:30Z

Dubyk: /* dspace.cfg */

Українізація DSpace

2017-10-26T09:24:01Z

Dubyk: /* Форма вводу */

= dspace.cfg =
default.language = uk_UA
cc.license.locale = uk_UA
default.locale = uk
webui.supported.locales = uk,en,ru,pl,bg,ca,cs,cy,de,el,es,et,eu,fr,gl,hu,id,it,ja,no,pt,sv,th,tr,zh_CN

= Інтерфейс JSPUI =
= Інтерфейс XMLUI =
= Шаблони листів =
= Форма вводу =
Розширена локалізована українською форма вводу, що використовується в репозитаріях ТНТУ і НУ„ЛП“: http://elartu.tntu.edu.ua:8080/files/dspace/config/input-forms.xml

= Додаткові поля =

= Ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_uk_only_translation.license

Інші ліцензії:
* Авторський договір в ТНТУ: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_TNTU.license

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T09:22:12Z

Dubyk:

= dspace.cfg =
default.language = uk_UA
cc.license.locale = uk_UA
default.locale = uk
webui.supported.locales = uk,en,ru,pl,bg,ca,cs,cy,de,el,es,et,eu,fr,gl,hu,id,it,ja,no,pt,sv,th,tr,zh_CN

= Інтерфейс JSPUI =
= Інтерфейс XMLUI =
= Шаблони листів =
= Форма вводу =
= Додаткові поля =

= Ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_uk_only_translation.license

Інші ліцензії:
* Авторський договір в ТНТУ: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_TNTU.license

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T09:18:55Z

Dubyk: /* Типова ліцензія */

= Інтерфейс JSPUI =
= Інтерфейс XMLUI =
= Шаблони листів =
= Форма вводу =
= Додаткові поля =

= Ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_uk_only_translation.license

Інші ліцензії:
* Авторський договір в ТНТУ: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_TNTU.license

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T09:18:27Z

Dubyk: /* Типова ліцензія */

= Інтерфейс JSPUI =
= Інтерфейс XMLUI =
= Шаблони листів =
= Форма вводу =
= Додаткові поля =

= Типова ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_uk_only_translation.license
Інші ліцензії:
* Авторський договір в ТНТУ: http://elartu.tntu.edu.ua:8080/files/dspace/config/default_TNTU.license

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T09:15:33Z

Dubyk: /* Типова ліцензія */

= Інтерфейс JSPUI =
= Інтерфейс XMLUI =
= Шаблони листів =
= Форма вводу =
= Додаткові поля =

= Типова ліцензія =

Переклад типової ліцензії DSpace українською: http://elartu.tntu.edu.ua:8080/files/dspace/config/default.license

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T09:14:08Z

Dubyk: /* Додаткові поля */

= Інтерфейс JSPUI =
= Інтерфейс XMLUI =
= Шаблони листів =
= Форма вводу =
= Додаткові поля =

= Типова ліцензія =

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T09:13:41Z

Dubyk:

= Інтерфейс JSPUI =
= Інтерфейс XMLUI =
= Шаблони листів =
= Форма вводу =
= Додаткові поля =

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Українізація DSpace

2017-10-26T09:11:59Z

Dubyk: Створена сторінка: = Див. також = * Встановлення DSpace на ОС Debian * Налаштування DSpace * Оновлення DSpace * [[Дод...

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Налаштування DSpace

2017-10-06T08:11:46Z

Dubyk: /* Задовгі назви зібрань у формі відправки матеріалу */

= Переключення Tomcat і DSpace з 8080 на порт 80 =

Дозвіл для Tomcat-у на порт 80.

Система не пускає tomcat на привілейований порт (80), для цього (у Debian) редагуємо

sudo mc -e /etc/default/tomcat8

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# (yes/no, default: no)
AUTHBIND=yes

Now we need to tell "authbind" that Tomcat is allowed to use lower port numbers. Type the following commands:

sudo touch /etc/authbind/byport/80
sudo touch /etc/authbind/byport/443
sudo chmod 0755 /etc/authbind/byport/80
sudo chmod 0755 /etc/authbind/byport/443
sudo chown tomcat8.tomcat8 /etc/authbind/byport/80
sudo chown tomcat8.tomcat8 /etc/authbind/byport/443
cd /etc/authbind/byport
ls -l

Now we tell the Tomcat server to listen on the "authbind" ports. Edit the following file.

sudo mc -e /etc/tomcat8/server.xml

Find the connector for port 8080 and change it to port 80.

Замінити
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
на
<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="443" />

/home/data/dspace/config/dspace.cfg

# DSpace base host URL. Include port number etc.
#dspace.baseUrl = http://localhost:8080
dspace.baseUrl = http://localhost

# DSpace base URL. Include port number etc., but NOT trailing slash
# Change to xmlui if you wish to use the xmlui as the default, or remove
# "/jspui" and set webapp of your choice as the "ROOT" webapp in
# the servlet engine.
#dspace.url = http://localhost:8080/xmlui
dspace.url = http://localhost/xmlui

/home/data/dspace/config/modules/oai.cfg

#solr.url=http://localhost:8080/solr/oai
solr.url=http://localhost/solr/oai

#bitstream.baseUrl = http://localhost:8080/xmlui
bitstream.baseUrl = http://localhost/xmlui

/home/data/dspace/config/modules/discovery.cfg
#search.server = http://localhost:8080/solr/search
search.server = http://localhost/solr/search

/home/data/dspace/config/modules/solr-statistics.cfg
#server = http://localhost:8080/solr/statistics
server = http://localhost/solr/statistics

/home/data/dspace/config/modules/rdf.cfg
#contextPath = http://localhost:8080/rdf
contextPath = http://localhost/rdf

/home/data/dspace/config/modules/swordv2-server.cfg

#error.alternate.url = http://localhost:8080/xmlui/contact
error.alternate.url = http://localhost/xmlui/contact

#workspace.url-template = http://localhost:8080/xmlui/submit?workspaceID=#wsid#
workspace.url-template = http://localhost/xmlui/submit?workspaceID=#wsid#

/home/data/dspace/config/modules/sword-client.cfg
#targets = http://localhost:8080/sword/servicedocument, \
targets = http://localhost/sword/servicedocument, \

/home/data/dspace/config/modules/rdf/metadata-rdf-mapping.ttl

замінити
localhost:8080
на
localhost

/home/data/dspace/config/modules/rdf/constant-data-general.ttl

замінити
localhost:8080
на
localhost

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

Див. також
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S05/Ubuntu-14.04

= Веб-сервер Apache (порт 8080) =

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8080.

Редагувати /etc/apache2/ports.conf:

#Listen 80
Listen 8080

та /etc/apache2/sites-enabled/000-default.conf

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

= Ескізи при пошуку =

Редагуємо dspace.cfg у розділі „Settings for Thumbnail creation“

# whether to display thumbnails on browse and search results pages (1.2+)
# If you have customised the Browse columnlist, then you must also
# include a 'thumbnail' column in your configuration (1.5+)
# (This configuration is not used by XMLUI. To show thumbnails in the
# XMLUI, you just need to create a theme which displays them)
#webui.browse.thumbnail.show = false
webui.browse.thumbnail.show = true

= Ескізи при перегляді матеріалів =
Редагуємо dspace.cfg у розділі „Settings for Item Preview“

#webui.preview.enabled = false
webui.preview.enabled = true

= Кількість документів у фондах/зібраннях =

Редагуємо dspace.cfg

webui.strengths.show = true

/etc/init.d/restart tomcat8

Див. також:
* http://irbis.gpntb.ru/read.php?53,59259

= Налаштування пошти =

== SMTP-варіант ==

Редагуємо dspace.cfg у розділі „Email settings“

mail.server=smtp.univer.edu.ua
mail.from.address = user@univer.edu.ua
feedback.recipient = user@univer.edu.ua
mail.admin = user@univer.edu.ua
alert.recipient = user@univer.edu.ua
registration.notify = user@univer.edu.ua

sudo /etc/init.d/restart tomcat8

== GMail-варіант ==

Попередньо створити обліковий запис Google:

ІП = Ім'я Прізвище
namesurname@gmail.com
пароль=ПАРОЛЬ

Налаштування облікового запису > Доступ для менш безпечних додатків: Дозволено

Внести наступні зміни в dspace.cfg

mail.server=smtp.gmail.com
mail.server.username = namesurname@gmail.com
mail.server.password = ПАРОЛЬ

#mail.server.port = 25
#mail.server.port = 587
#mail.server.port = 465

mail.extraproperties = mail.smtp.socketFactory.port=465, \
mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory, \
mail.smtp.socketFactory.fallback=false

Також змінюємо

mail.from.address = namesurname@gmail.com
feedback.recipient = namesurname@gmail.com
mail.admin = namesurname@gmail.com
alert.recipient = namesurname@gmail.com
registration.notify = namesurname@gmail.com

Перевіряємо чи не занятий 465 порт

netstat -aunt | grep 465

з іншого компа перевіряємо відкриті

nmap dspace.univer.edu.ua

чи є прописаний в iptables

iptables -L -n

чи так

openssl s_client -connect smtp.gmail.com:465

(щодо 587 — openssl s_client -starttls smtp -crlf -connect smtp.gmail.com:587)

чи так

telnet smtp.gmail.com 465

додаємо цей порт в iptables

iptables -A INPUT --protocol tcp -j ACCEPT --match tcp --destination-port 465
iptables -A OUTPUT --protocol tcp -j ACCEPT --match tcp --source-port 465

Але краще додати у файл /etc/sysconfig/iptables додаємо правила

-A INPUT --protocol tcp -j ACCEPT --match tcp --destination-port 465
-A OUTPUT --protocol tcp -j ACCEPT --match tcp --source-port 465

Перезапуск iptables і tomcat

sudo service iptables restart
sudo /etc/init.d/restart tomcat8

Перевіряємо дію пошти

/home/data/dspace/bin/dspace test-email

вивід

About to send test email:
- To: user@univer.edu.ua
- Subject: DSpace test email
- Server: smtp.univer.edu.ua

Email sent successfully!

Див. також:
* http://blog.stuartlewis.com/2009/09/05/using-gmail-with-dspace/
* https://jira.duraspace.org/browse/DS-234
* https://www.mail-archive.com/dspace-tech@lists.sourceforge.net/msg21962.html
* http://dspace.2283337.n4.nabble.com/sending-mail-giving-error-td4675341.html
* http://dspace.2283337.n4.nabble.com/Gmail-Authentication-td4674302.html#a4674310
* http://dspace.2283337.n4.nabble.com/Gmail-Configuration-in-Dspace-4-1-td4674042.html
* http://stackoverflow.com/questions/1516754/connecting-to-smtp-gmail-com-via-command-line
* http://dspace.2283337.n4.nabble.com/Dspace-email-regitration-error-td4665752.html

= Sitemaps =

https://wiki.duraspace.org/pages/viewpage.action?pageId=34642415

Налаштувати robots.txt

User-agent: *

# Uncomment the following line ONLY if sitemaps.org or HTML sitemaps are used
# and you have verified that your site is being indexed correctly.
# Disallow: /browse

Host: elartu.tntu.edu.ua

# Disable access to Discovery search and filters
Disallow: /discover
Disallow: /search-filter

# This should be the FULL URL to your HTML Sitemap..
# Make sure to replace "[dspace.url]" with the value of your 'dspace.url' setting in your dspace.cfg file.
Sitemap: http://elartu.tntu.edu.ua/htmlmap

Створювати по крону

# Generate sitemaps
# every day at 6:00
00 06 * * * /usr/share/dspace/bin/generate-sitemaps

Додати в Google та Яндекс ВебМайстри

http://elartu.tntu.edu.ua/htmlmap?map=0
http://elartu.tntu.edu.ua/htmlmap?map=1
http://elartu.tntu.edu.ua/htmlmap?map=2
http://elartu.tntu.edu.ua/htmlmap?map=3
http://elartu.tntu.edu.ua/htmlmap?map=4
http://elartu.tntu.edu.ua/sitemap?map=0

= Переміщення/об’єднання підфондів =

http://my_dspace/phppgadmin/

Вихідні дані

handle старого батьківського фонду =123456789/37
handle нового батьківського фонду = 123456789/18350
handle підфонду, що переміщується = 123456789/64

Через таблицю handle визначаємо внутрішні resource_id, що відповідають parent_comm_id та child_comm_id у таблиці community2community

handle=123456789/64 resource_id=27
handle=123456789/18350 resource_id=223
handle=123456789/37 resource_id=18

Далі робимо переміщення у таблиці community2community
замінюючи 18 на 223

Однак залишається проблема з вилучення старого фонду.
Його номер ще згадується у таблицях community_item_count та communities2item

В community_item_count легко замінити в community_id
з 18 на 223
! примітка: таблицю community_item_count, здається, можна й не чіпати

З таблицею communities2item трохи складніше. Тут є перелік всіх матеріалів, прив’язаних до фонду 18, рядків багато.
Поміг SQL-Запит
UPDATE communities2item SET community_id='223' WHERE "community_id"='21';

Також див. тут
* Moving a DSpace collection (http://timesync.gmu.edu/wordpress/?p=15 )
* http://dspace.2283337.n4.nabble.com/Moving-collections-to-a-new-sub-community-td4657035.html
* http://dspace.2283337.n4.nabble.com/community-deletion-td3543389.html

= Прибирання 1 кроку =
На цьому кроці відбувався вибір: опубліковане чи ні, про декілька назв та декілька файлів.

Щоб прибрати це у файлі item-submission.xml

закоментуйте блок

<step>
<heading>submit.progressbar.initial-questions</heading>
<processing-class>org.dspace.submit.step.InitialQuestionsStep</processing-class>
<jspui-binding>org.dspace.app.webui.submit.step.JSPInitialQuestionsStep</jspui-binding>
<xmlui-binding>org.dspace.app.xmlui.aspect.submission.submit.InitialQuestionsStep</xmlui-binding>
<workflow-editable>true</workflow-editable>
</step>

та розкоментуйте блок
<step>
<processing-class>org.dspace.submit.step.SkipInitialQuestionsStep</processing-class>
</step>

= Задовгі назви зібрань у формі відправки матеріалу =

На сторінці http://localhost:8080/submit
задовгі назви списків „фонди » підфонди » зібрання“.

Якщо назви зібрань унікальні, то можна обрізати назви до „зібрання“

У файлі /dspace-тека/webapps/jspui/submit/select-collection.jsp

шукаємо рядок

<dspace:selectcollection klass="form-control" id="tcollection" collection="-1" name="collection"/>

та замінюємо (чи закоментовуємо ) на блок

<select class="form-control" name="collection" id="tcollection">
<option value="-1"></option>
<%
for (int i = 0; i < collections.size(); i++)
{
%>
<option value="<%= collections.get(i).getID() %>"><%= collections.get(i).getName() %></option>
<%
}
%>
</select>

Примітка: для DSpace 6+. для нижчих версії не працюватиме (змінився клас та назви функцій).

Для DSpace версії 5.5 (можливо і для інших) цей блок виглядатиме так

<select class="form-control" name="collection" id="tcollection">
<option value="-1"></option>
<%
for (int i = 0; i < collections.length; i++)
{
%>
<option value="<%= collections[i].getID() %>"><%= collections[i].getMetadata("name") %></option>
<%
}
%>
</select>

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Налаштування DSpace

2017-10-06T08:06:00Z

Dubyk: /* Задовгі назви зібрань у формі відправки матеріалу */

= Переключення Tomcat і DSpace з 8080 на порт 80 =

Дозвіл для Tomcat-у на порт 80.

Система не пускає tomcat на привілейований порт (80), для цього (у Debian) редагуємо

sudo mc -e /etc/default/tomcat8

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# (yes/no, default: no)
AUTHBIND=yes

Now we need to tell "authbind" that Tomcat is allowed to use lower port numbers. Type the following commands:

sudo touch /etc/authbind/byport/80
sudo touch /etc/authbind/byport/443
sudo chmod 0755 /etc/authbind/byport/80
sudo chmod 0755 /etc/authbind/byport/443
sudo chown tomcat8.tomcat8 /etc/authbind/byport/80
sudo chown tomcat8.tomcat8 /etc/authbind/byport/443
cd /etc/authbind/byport
ls -l

Now we tell the Tomcat server to listen on the "authbind" ports. Edit the following file.

sudo mc -e /etc/tomcat8/server.xml

Find the connector for port 8080 and change it to port 80.

Замінити
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
на
<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="443" />

/home/data/dspace/config/dspace.cfg

# DSpace base host URL. Include port number etc.
#dspace.baseUrl = http://localhost:8080
dspace.baseUrl = http://localhost

# DSpace base URL. Include port number etc., but NOT trailing slash
# Change to xmlui if you wish to use the xmlui as the default, or remove
# "/jspui" and set webapp of your choice as the "ROOT" webapp in
# the servlet engine.
#dspace.url = http://localhost:8080/xmlui
dspace.url = http://localhost/xmlui

/home/data/dspace/config/modules/oai.cfg

#solr.url=http://localhost:8080/solr/oai
solr.url=http://localhost/solr/oai

#bitstream.baseUrl = http://localhost:8080/xmlui
bitstream.baseUrl = http://localhost/xmlui

/home/data/dspace/config/modules/discovery.cfg
#search.server = http://localhost:8080/solr/search
search.server = http://localhost/solr/search

/home/data/dspace/config/modules/solr-statistics.cfg
#server = http://localhost:8080/solr/statistics
server = http://localhost/solr/statistics

/home/data/dspace/config/modules/rdf.cfg
#contextPath = http://localhost:8080/rdf
contextPath = http://localhost/rdf

/home/data/dspace/config/modules/swordv2-server.cfg

#error.alternate.url = http://localhost:8080/xmlui/contact
error.alternate.url = http://localhost/xmlui/contact

#workspace.url-template = http://localhost:8080/xmlui/submit?workspaceID=#wsid#
workspace.url-template = http://localhost/xmlui/submit?workspaceID=#wsid#

/home/data/dspace/config/modules/sword-client.cfg
#targets = http://localhost:8080/sword/servicedocument, \
targets = http://localhost/sword/servicedocument, \

/home/data/dspace/config/modules/rdf/metadata-rdf-mapping.ttl

замінити
localhost:8080
на
localhost

/home/data/dspace/config/modules/rdf/constant-data-general.ttl

замінити
localhost:8080
на
localhost

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

Див. також
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S05/Ubuntu-14.04

= Веб-сервер Apache (порт 8080) =

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8080.

Редагувати /etc/apache2/ports.conf:

#Listen 80
Listen 8080

та /etc/apache2/sites-enabled/000-default.conf

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

= Ескізи при пошуку =

Редагуємо dspace.cfg у розділі „Settings for Thumbnail creation“

# whether to display thumbnails on browse and search results pages (1.2+)
# If you have customised the Browse columnlist, then you must also
# include a 'thumbnail' column in your configuration (1.5+)
# (This configuration is not used by XMLUI. To show thumbnails in the
# XMLUI, you just need to create a theme which displays them)
#webui.browse.thumbnail.show = false
webui.browse.thumbnail.show = true

= Ескізи при перегляді матеріалів =
Редагуємо dspace.cfg у розділі „Settings for Item Preview“

#webui.preview.enabled = false
webui.preview.enabled = true

= Кількість документів у фондах/зібраннях =

Редагуємо dspace.cfg

webui.strengths.show = true

/etc/init.d/restart tomcat8

Див. також:
* http://irbis.gpntb.ru/read.php?53,59259

= Налаштування пошти =

== SMTP-варіант ==

Редагуємо dspace.cfg у розділі „Email settings“

mail.server=smtp.univer.edu.ua
mail.from.address = user@univer.edu.ua
feedback.recipient = user@univer.edu.ua
mail.admin = user@univer.edu.ua
alert.recipient = user@univer.edu.ua
registration.notify = user@univer.edu.ua

sudo /etc/init.d/restart tomcat8

== GMail-варіант ==

Попередньо створити обліковий запис Google:

ІП = Ім'я Прізвище
namesurname@gmail.com
пароль=ПАРОЛЬ

Налаштування облікового запису > Доступ для менш безпечних додатків: Дозволено

Внести наступні зміни в dspace.cfg

mail.server=smtp.gmail.com
mail.server.username = namesurname@gmail.com
mail.server.password = ПАРОЛЬ

#mail.server.port = 25
#mail.server.port = 587
#mail.server.port = 465

mail.extraproperties = mail.smtp.socketFactory.port=465, \
mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory, \
mail.smtp.socketFactory.fallback=false

Також змінюємо

mail.from.address = namesurname@gmail.com
feedback.recipient = namesurname@gmail.com
mail.admin = namesurname@gmail.com
alert.recipient = namesurname@gmail.com
registration.notify = namesurname@gmail.com

Перевіряємо чи не занятий 465 порт

netstat -aunt | grep 465

з іншого компа перевіряємо відкриті

nmap dspace.univer.edu.ua

чи є прописаний в iptables

iptables -L -n

чи так

openssl s_client -connect smtp.gmail.com:465

(щодо 587 — openssl s_client -starttls smtp -crlf -connect smtp.gmail.com:587)

чи так

telnet smtp.gmail.com 465

додаємо цей порт в iptables

iptables -A INPUT --protocol tcp -j ACCEPT --match tcp --destination-port 465
iptables -A OUTPUT --protocol tcp -j ACCEPT --match tcp --source-port 465

Але краще додати у файл /etc/sysconfig/iptables додаємо правила

-A INPUT --protocol tcp -j ACCEPT --match tcp --destination-port 465
-A OUTPUT --protocol tcp -j ACCEPT --match tcp --source-port 465

Перезапуск iptables і tomcat

sudo service iptables restart
sudo /etc/init.d/restart tomcat8

Перевіряємо дію пошти

/home/data/dspace/bin/dspace test-email

вивід

About to send test email:
- To: user@univer.edu.ua
- Subject: DSpace test email
- Server: smtp.univer.edu.ua

Email sent successfully!

Див. також:
* http://blog.stuartlewis.com/2009/09/05/using-gmail-with-dspace/
* https://jira.duraspace.org/browse/DS-234
* https://www.mail-archive.com/dspace-tech@lists.sourceforge.net/msg21962.html
* http://dspace.2283337.n4.nabble.com/sending-mail-giving-error-td4675341.html
* http://dspace.2283337.n4.nabble.com/Gmail-Authentication-td4674302.html#a4674310
* http://dspace.2283337.n4.nabble.com/Gmail-Configuration-in-Dspace-4-1-td4674042.html
* http://stackoverflow.com/questions/1516754/connecting-to-smtp-gmail-com-via-command-line
* http://dspace.2283337.n4.nabble.com/Dspace-email-regitration-error-td4665752.html

= Sitemaps =

https://wiki.duraspace.org/pages/viewpage.action?pageId=34642415

Налаштувати robots.txt

User-agent: *

# Uncomment the following line ONLY if sitemaps.org or HTML sitemaps are used
# and you have verified that your site is being indexed correctly.
# Disallow: /browse

Host: elartu.tntu.edu.ua

# Disable access to Discovery search and filters
Disallow: /discover
Disallow: /search-filter

# This should be the FULL URL to your HTML Sitemap..
# Make sure to replace "[dspace.url]" with the value of your 'dspace.url' setting in your dspace.cfg file.
Sitemap: http://elartu.tntu.edu.ua/htmlmap

Створювати по крону

# Generate sitemaps
# every day at 6:00
00 06 * * * /usr/share/dspace/bin/generate-sitemaps

Додати в Google та Яндекс ВебМайстри

http://elartu.tntu.edu.ua/htmlmap?map=0
http://elartu.tntu.edu.ua/htmlmap?map=1
http://elartu.tntu.edu.ua/htmlmap?map=2
http://elartu.tntu.edu.ua/htmlmap?map=3
http://elartu.tntu.edu.ua/htmlmap?map=4
http://elartu.tntu.edu.ua/sitemap?map=0

= Переміщення/об’єднання підфондів =

http://my_dspace/phppgadmin/

Вихідні дані

handle старого батьківського фонду =123456789/37
handle нового батьківського фонду = 123456789/18350
handle підфонду, що переміщується = 123456789/64

Через таблицю handle визначаємо внутрішні resource_id, що відповідають parent_comm_id та child_comm_id у таблиці community2community

handle=123456789/64 resource_id=27
handle=123456789/18350 resource_id=223
handle=123456789/37 resource_id=18

Далі робимо переміщення у таблиці community2community
замінюючи 18 на 223

Однак залишається проблема з вилучення старого фонду.
Його номер ще згадується у таблицях community_item_count та communities2item

В community_item_count легко замінити в community_id
з 18 на 223
! примітка: таблицю community_item_count, здається, можна й не чіпати

З таблицею communities2item трохи складніше. Тут є перелік всіх матеріалів, прив’язаних до фонду 18, рядків багато.
Поміг SQL-Запит
UPDATE communities2item SET community_id='223' WHERE "community_id"='21';

Також див. тут
* Moving a DSpace collection (http://timesync.gmu.edu/wordpress/?p=15 )
* http://dspace.2283337.n4.nabble.com/Moving-collections-to-a-new-sub-community-td4657035.html
* http://dspace.2283337.n4.nabble.com/community-deletion-td3543389.html

= Прибирання 1 кроку =
На цьому кроці відбувався вибір: опубліковане чи ні, про декілька назв та декілька файлів.

Щоб прибрати це у файлі item-submission.xml

закоментуйте блок

<step>
<heading>submit.progressbar.initial-questions</heading>
<processing-class>org.dspace.submit.step.InitialQuestionsStep</processing-class>
<jspui-binding>org.dspace.app.webui.submit.step.JSPInitialQuestionsStep</jspui-binding>
<xmlui-binding>org.dspace.app.xmlui.aspect.submission.submit.InitialQuestionsStep</xmlui-binding>
<workflow-editable>true</workflow-editable>
</step>

та розкоментуйте блок
<step>
<processing-class>org.dspace.submit.step.SkipInitialQuestionsStep</processing-class>
</step>

= Задовгі назви зібрань у формі відправки матеріалу =

На сторінці http://localhost:8080/submit
задовгі назви списків „фонди » підфонди » зібрання“.

Якщо назви зібрань унікальні, то можна обрізати назви до „зібрання“

У файлі /dspace-тека/webapps/jspui/submit/select-collection.jsp

шукаємо рядок

<dspace:selectcollection klass="form-control" id="tcollection" collection="-1" name="collection"/>

та замінюємо (чи закоментовуємо ) на блок

<select class="form-control" name="collection" id="tcollection">
<option value="-1"></option>
<%
for (int i = 0; i < collections.size(); i++)
{
%>
<option value="<%= collections.get(i).getID() %>"><%= collections.get(i).getName() %></option>
<%
}
%>
</select>

Примітка: для DSpace 6+. для нижчих версії не працюватиме (змінився клас та назви функцій).

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Налаштування DSpace

2017-10-06T08:05:06Z

Dubyk: /* Прибирання 1 кроку */

= Переключення Tomcat і DSpace з 8080 на порт 80 =

Дозвіл для Tomcat-у на порт 80.

Система не пускає tomcat на привілейований порт (80), для цього (у Debian) редагуємо

sudo mc -e /etc/default/tomcat8

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# (yes/no, default: no)
AUTHBIND=yes

Now we need to tell "authbind" that Tomcat is allowed to use lower port numbers. Type the following commands:

sudo touch /etc/authbind/byport/80
sudo touch /etc/authbind/byport/443
sudo chmod 0755 /etc/authbind/byport/80
sudo chmod 0755 /etc/authbind/byport/443
sudo chown tomcat8.tomcat8 /etc/authbind/byport/80
sudo chown tomcat8.tomcat8 /etc/authbind/byport/443
cd /etc/authbind/byport
ls -l

Now we tell the Tomcat server to listen on the "authbind" ports. Edit the following file.

sudo mc -e /etc/tomcat8/server.xml

Find the connector for port 8080 and change it to port 80.

Замінити
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" />
на
<Connector port="80" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="443" />

/home/data/dspace/config/dspace.cfg

# DSpace base host URL. Include port number etc.
#dspace.baseUrl = http://localhost:8080
dspace.baseUrl = http://localhost

# DSpace base URL. Include port number etc., but NOT trailing slash
# Change to xmlui if you wish to use the xmlui as the default, or remove
# "/jspui" and set webapp of your choice as the "ROOT" webapp in
# the servlet engine.
#dspace.url = http://localhost:8080/xmlui
dspace.url = http://localhost/xmlui

/home/data/dspace/config/modules/oai.cfg

#solr.url=http://localhost:8080/solr/oai
solr.url=http://localhost/solr/oai

#bitstream.baseUrl = http://localhost:8080/xmlui
bitstream.baseUrl = http://localhost/xmlui

/home/data/dspace/config/modules/discovery.cfg
#search.server = http://localhost:8080/solr/search
search.server = http://localhost/solr/search

/home/data/dspace/config/modules/solr-statistics.cfg
#server = http://localhost:8080/solr/statistics
server = http://localhost/solr/statistics

/home/data/dspace/config/modules/rdf.cfg
#contextPath = http://localhost:8080/rdf
contextPath = http://localhost/rdf

/home/data/dspace/config/modules/swordv2-server.cfg

#error.alternate.url = http://localhost:8080/xmlui/contact
error.alternate.url = http://localhost/xmlui/contact

#workspace.url-template = http://localhost:8080/xmlui/submit?workspaceID=#wsid#
workspace.url-template = http://localhost/xmlui/submit?workspaceID=#wsid#

/home/data/dspace/config/modules/sword-client.cfg
#targets = http://localhost:8080/sword/servicedocument, \
targets = http://localhost/sword/servicedocument, \

/home/data/dspace/config/modules/rdf/metadata-rdf-mapping.ttl

замінити
localhost:8080
на
localhost

/home/data/dspace/config/modules/rdf/constant-data-general.ttl

замінити
localhost:8080
на
localhost

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

Див. також
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S05/Ubuntu-14.04

= Веб-сервер Apache (порт 8080) =

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8080.

Редагувати /etc/apache2/ports.conf:

#Listen 80
Listen 8080

та /etc/apache2/sites-enabled/000-default.conf

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

= Ескізи при пошуку =

Редагуємо dspace.cfg у розділі „Settings for Thumbnail creation“

# whether to display thumbnails on browse and search results pages (1.2+)
# If you have customised the Browse columnlist, then you must also
# include a 'thumbnail' column in your configuration (1.5+)
# (This configuration is not used by XMLUI. To show thumbnails in the
# XMLUI, you just need to create a theme which displays them)
#webui.browse.thumbnail.show = false
webui.browse.thumbnail.show = true

= Ескізи при перегляді матеріалів =
Редагуємо dspace.cfg у розділі „Settings for Item Preview“

#webui.preview.enabled = false
webui.preview.enabled = true

= Кількість документів у фондах/зібраннях =

Редагуємо dspace.cfg

webui.strengths.show = true

/etc/init.d/restart tomcat8

Див. також:
* http://irbis.gpntb.ru/read.php?53,59259

= Налаштування пошти =

== SMTP-варіант ==

Редагуємо dspace.cfg у розділі „Email settings“

mail.server=smtp.univer.edu.ua
mail.from.address = user@univer.edu.ua
feedback.recipient = user@univer.edu.ua
mail.admin = user@univer.edu.ua
alert.recipient = user@univer.edu.ua
registration.notify = user@univer.edu.ua

sudo /etc/init.d/restart tomcat8

== GMail-варіант ==

Попередньо створити обліковий запис Google:

ІП = Ім'я Прізвище
namesurname@gmail.com
пароль=ПАРОЛЬ

Налаштування облікового запису > Доступ для менш безпечних додатків: Дозволено

Внести наступні зміни в dspace.cfg

mail.server=smtp.gmail.com
mail.server.username = namesurname@gmail.com
mail.server.password = ПАРОЛЬ

#mail.server.port = 25
#mail.server.port = 587
#mail.server.port = 465

mail.extraproperties = mail.smtp.socketFactory.port=465, \
mail.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory, \
mail.smtp.socketFactory.fallback=false

Також змінюємо

mail.from.address = namesurname@gmail.com
feedback.recipient = namesurname@gmail.com
mail.admin = namesurname@gmail.com
alert.recipient = namesurname@gmail.com
registration.notify = namesurname@gmail.com

Перевіряємо чи не занятий 465 порт

netstat -aunt | grep 465

з іншого компа перевіряємо відкриті

nmap dspace.univer.edu.ua

чи є прописаний в iptables

iptables -L -n

чи так

openssl s_client -connect smtp.gmail.com:465

(щодо 587 — openssl s_client -starttls smtp -crlf -connect smtp.gmail.com:587)

чи так

telnet smtp.gmail.com 465

додаємо цей порт в iptables

iptables -A INPUT --protocol tcp -j ACCEPT --match tcp --destination-port 465
iptables -A OUTPUT --protocol tcp -j ACCEPT --match tcp --source-port 465

Але краще додати у файл /etc/sysconfig/iptables додаємо правила

-A INPUT --protocol tcp -j ACCEPT --match tcp --destination-port 465
-A OUTPUT --protocol tcp -j ACCEPT --match tcp --source-port 465

Перезапуск iptables і tomcat

sudo service iptables restart
sudo /etc/init.d/restart tomcat8

Перевіряємо дію пошти

/home/data/dspace/bin/dspace test-email

вивід

About to send test email:
- To: user@univer.edu.ua
- Subject: DSpace test email
- Server: smtp.univer.edu.ua

Email sent successfully!

Див. також:
* http://blog.stuartlewis.com/2009/09/05/using-gmail-with-dspace/
* https://jira.duraspace.org/browse/DS-234
* https://www.mail-archive.com/dspace-tech@lists.sourceforge.net/msg21962.html
* http://dspace.2283337.n4.nabble.com/sending-mail-giving-error-td4675341.html
* http://dspace.2283337.n4.nabble.com/Gmail-Authentication-td4674302.html#a4674310
* http://dspace.2283337.n4.nabble.com/Gmail-Configuration-in-Dspace-4-1-td4674042.html
* http://stackoverflow.com/questions/1516754/connecting-to-smtp-gmail-com-via-command-line
* http://dspace.2283337.n4.nabble.com/Dspace-email-regitration-error-td4665752.html

= Sitemaps =

https://wiki.duraspace.org/pages/viewpage.action?pageId=34642415

Налаштувати robots.txt

User-agent: *

# Uncomment the following line ONLY if sitemaps.org or HTML sitemaps are used
# and you have verified that your site is being indexed correctly.
# Disallow: /browse

Host: elartu.tntu.edu.ua

# Disable access to Discovery search and filters
Disallow: /discover
Disallow: /search-filter

# This should be the FULL URL to your HTML Sitemap..
# Make sure to replace "[dspace.url]" with the value of your 'dspace.url' setting in your dspace.cfg file.
Sitemap: http://elartu.tntu.edu.ua/htmlmap

Створювати по крону

# Generate sitemaps
# every day at 6:00
00 06 * * * /usr/share/dspace/bin/generate-sitemaps

Додати в Google та Яндекс ВебМайстри

http://elartu.tntu.edu.ua/htmlmap?map=0
http://elartu.tntu.edu.ua/htmlmap?map=1
http://elartu.tntu.edu.ua/htmlmap?map=2
http://elartu.tntu.edu.ua/htmlmap?map=3
http://elartu.tntu.edu.ua/htmlmap?map=4
http://elartu.tntu.edu.ua/sitemap?map=0

= Переміщення/об’єднання підфондів =

http://my_dspace/phppgadmin/

Вихідні дані

handle старого батьківського фонду =123456789/37
handle нового батьківського фонду = 123456789/18350
handle підфонду, що переміщується = 123456789/64

Через таблицю handle визначаємо внутрішні resource_id, що відповідають parent_comm_id та child_comm_id у таблиці community2community

handle=123456789/64 resource_id=27
handle=123456789/18350 resource_id=223
handle=123456789/37 resource_id=18

Далі робимо переміщення у таблиці community2community
замінюючи 18 на 223

Однак залишається проблема з вилучення старого фонду.
Його номер ще згадується у таблицях community_item_count та communities2item

В community_item_count легко замінити в community_id
з 18 на 223
! примітка: таблицю community_item_count, здається, можна й не чіпати

З таблицею communities2item трохи складніше. Тут є перелік всіх матеріалів, прив’язаних до фонду 18, рядків багато.
Поміг SQL-Запит
UPDATE communities2item SET community_id='223' WHERE "community_id"='21';

Також див. тут
* Moving a DSpace collection (http://timesync.gmu.edu/wordpress/?p=15 )
* http://dspace.2283337.n4.nabble.com/Moving-collections-to-a-new-sub-community-td4657035.html
* http://dspace.2283337.n4.nabble.com/community-deletion-td3543389.html

= Прибирання 1 кроку =
На цьому кроці відбувався вибір: опубліковане чи ні, про декілька назв та декілька файлів.

Щоб прибрати це у файлі item-submission.xml

закоментуйте блок

<step>
<heading>submit.progressbar.initial-questions</heading>
<processing-class>org.dspace.submit.step.InitialQuestionsStep</processing-class>
<jspui-binding>org.dspace.app.webui.submit.step.JSPInitialQuestionsStep</jspui-binding>
<xmlui-binding>org.dspace.app.xmlui.aspect.submission.submit.InitialQuestionsStep</xmlui-binding>
<workflow-editable>true</workflow-editable>
</step>

та розкоментуйте блок
<step>
<processing-class>org.dspace.submit.step.SkipInitialQuestionsStep</processing-class>
</step>

= Задовгі назви зібрань у формі відправки матеріалу =

На сторінці http://localhost:8080/submit
задовгі назви списків „фонди » підфонди » зібрання“.

Якщо назви зібрань унікальні, то можна обрізати назви до „зібрання“

У файлі /dspace-тека/webapps/jspui/submit/select-collection.jsp

шукаємо рядок

<dspace:selectcollection klass="form-control" id="tcollection" collection="-1" name="collection"/>

та замінюємо (чи закоментовуємо ) на блок

<select class="form-control" name="collection" id="tcollection">
<option value="-1"></option>
<%
for (int i = 0; i < collections.size(); i++)
{
%>
<option value="<%= collections.get(i).getID() %>"><%= collections.get(i).getName() %></option>
<%
}
%>
</select>

Примітка: для DSpace 6+. для нижчих версії не працюватиме (змінився клас та назви функцій).

= Див. також =

* [[Встановлення DSpace на ОС Debian]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Оновлення DSpace]]

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Встановлення DSpace на ОС Debian

2017-08-10T12:37:56Z

Dubyk: /* Встановлення DSpace та ініціалізація БД */

Встановлення DSpace на ОС Debian

= Встановлення DSpace 6.1 на ОС Debian GNU/Linux 9 Stretch =

== Встановлення ОС Debian GNU/Linux 9 Stretch ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Джерела ==

* [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace Installing DSpace - DSpace 6.x Documentation - DuraSpace Wiki]

* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_DSpace_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian Встановлення DSpace на ОС Debian] (ця інструкція)

* [https://wiki.duraspace.org/display/DSDOC6x/DSpace+6.x+Documentation DSpace 6.x Documentation - DuraSpace Wiki:] (звантажити можна)

* [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace SUNScholar/Install DSpace], також див. [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_Ubuntu Install Ubuntu Server] та [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu Prepare Ubuntu Server]

* [https://wiki.duraspace.org/display/DSPACE/Installation+Guides?src=search DSpace Installation Guides]

* [https://rspproject.wordpress.com/2010/11/10/installing-dspace-on-debian-5/ Installing DSpace on Debian 5]

* [https://gist.github.com/dchud/8940811 20-minute guide to installing DSpace-4.0 from binary release on Ubuntu 12.04 LTS]

* [http://ideafix.name/?p=2325 Установка DSpace 5.x в среде Ubuntu Server 14.x]

* [http://linuxhalwa.blogspot.com/2016/01/installing-dspace-5x-on-ubuntu-1404-lts.html Installing DSpace 5.x on Ubuntu 14.04 LTS]

* [https://wiki.duraspace.org/display/DSPACE/Installing+DSpace+4.2+on+Ubuntu+Server+14.04.1+LTS Installing DSpace 4.2 on Ubuntu Server 14.04.1 LTS - DSpace - DuraSpace Wiki]

* [http://dspaceclub.blogspot.com/2015/02/how-to-install-dspace-50-on-ubuntu-1410.html How to Install DSpace 5.0 on Ubuntu 14.10 ]

* [https://amdmaher.wordpress.com/dspace-digital-repository/dspace-3-1-installation-on-debian-squeeze-6-0/ DSpace installation on Debian Squeeze 6.0.3]

== Необхідне програмне забезпечення ==

З офіційної документації [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace]:

* Oracle Java JDK or OpenJDK
* Java 8 update 20 or later, or Java 7 update 55 or later. [https://jira.duraspace.org/browse/DS-2653 DS-2653] - Java 8 Support for DSpace Accepted
* Apache Maven (Java build tool) 3.0.5+ або 3.3.9+ (для теми Mirage 2)
* Apache Ant 1.8 or later (Java build tool)
* PostgreSQL 9.4 or later (з встановленим pgcrypto). Oracle 10g or later.
* Servlet Engine: Apache Tomcat 8 (Tomcat 8.0.33 or above) or Tomcat 7 (Tomcat 7.0.30 or above), Jetty, Caucho Resin or equivalent.
* Perl (only required for [dspace]/bin/dspace-info.pl)

Присутнє у Debian GNU/Linux 9 Jessie та бекпортах:
* '''[https://packages.debian.org/stretch/openjdk-8-jdk openjdk-8-jdk]''' (8u141-b15-1~deb9u1)
* '''[https://packages.debian.org/stretch/tomcat8 tomcat8]''' (8.5.14-1+deb9u1)
* '''[https://packages.debian.org/stretch/mavenm maven]''' (3.3.9-4)
* '''[https://packages.debian.org/stretch/ant ant]''' (1.9.9-1)
* '''[https://packages.debian.org/stretch/postgresql postgresql]''' (9.6+181)

Розглядаємо варіант встановлення '''openjdk-8-jdk'''+'''tomcat8'''.

== Підключення додаткових репозитаріїв ==

У файл /etc/apt/sources.list додаємо (перевіряємо наявність) наступні джерела пакунків

deb http://ftp.ua.debian.org/debian/ stretch main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch main contrib non-free

deb http://security.debian.org/ stretch/updates contrib main
deb-src http://security.debian.org/ stretch/updates contrib main

deb http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free

(чи інші дзеркала стабільної версії)

deb http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free

Оновлюємо перелік пакунків та систему

sudo apt-get update
sudo apt-get upgrade

== Встановлення Java OpenJDK 8 ==

sudo apt-get purge openjdk-7-*

sudo apt-get install openjdk-8-jdk

та вибрати саме цей варіант (OpenJDK 8) як основний:

sudo update-alternatives --config java

== Встановлення Tomcat, Maven, Ant ==

sudo apt-get install tomcat8 maven ant git

== Встановлення БД postgresql ==

sudo apt-get install postgresql postgresql-contrib libpg-java

=== Налаштування PostgreSQL ===

У файлі
/etc/postgresql/9.6/main/postgresql.conf
розкоментувати рядок

listen_addresses = 'localhost'

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection], див. також [https://jira.duraspace.org/browse/DS-1458 DuraSpace JIRA DS-1458 Connection pool exhausted]

Редагуємо файл налаштування postgresql:

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== shared_buffers ====
Тут [http://dspace.2283337.n4.nabble.com/Dspace-production-environment-td4684344.html#a4684368 Jan 06, 2017; 5:48pm Re: Dspace production environment] рекомендують також збільшити (від типових 128Мб) до 10% від ОП.
Якщо ОП 10Гб, то
shared_buffers = 1024MB
також
sudo service postgresql restart

==== Збільшення загальної пам’яті ядра для клієнтських підключень сервера PostgreSQL ====

Редагуємо файл "/etc/sysctl.conf":

sudo mcedit /etc/sysctl.conf

Вставити наприкінці файлу наступне:

# For PostgreSQL server client connections
kernel.shmmax = 500000000
kernel.shmall = 500000000

Див. також:
* http://www.postgresql.org/docs/9.3/static/kernel-resources.html
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S06/Ubuntu-14.04

Також виконати:

sudo sysctl -p

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection]

Редагуємо файл налаштування postgresql :

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== Налаштування прав доступу до PostgreSQL на основі хост-сервера ====

Див. посилання в офіційній документації щодо файлу "pg_hba.conf":

* [http://www.postgresql.org/docs/current/static/auth-pg-hba-conf.html 19.1. The pg_hba.conf File]
* [https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-RelationalDatabase:%28PostgreSQLorOracle%29 Relational Database: (PostgreSQL or Oracle)]

У файлі /etc/postgresql/9.6/main/pg_hba.conf замінюємо
local all postgres peer
на
local all postgres trust

та
local all all peer
на
local all all md5

Перезапуск сервера БД
sudo service postgresql restart

==== Створення користувача "dspace" та БД "dspace" PostgreSQL ====

Створюємо користувача БД (dspace) та БД DSpace (dspace)

sudo su postgres
createuser -U postgres -d -A -P dspace
createdb -U dspace -E UNICODE dspace
exit

При створенні користувача придумуємо пароль.

Також може бути питання про створення нових користувачів - Shall the new role be allowed to create more new roles? (y/n) '''n'''

Перезапуск postgresql

service postgresql restart

==== Налаштування пароля, власника та привілеїв БД "dspace" та користувача "dspace" ====

З’єднуємося зі сервером БД PostgreSQL та входимо у оболонку PostgreSQL.

psql -U postgres -d dspace

Встановити пароль для користувача "dspace" (вказуємо свій варіант):

ALTER ROLE dspace WITH PASSWORD 'XXXXXX';

Нехай користувач "dspace" буде власником БД "dspace"

ALTER DATABASE dspace OWNER TO dspace;

Надати усі привілеї для БД "dspace" користувачу "dspace"

GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;

Додаємо розширення "crypto" до БД "dspace".

CREATE EXTENSION pgcrypto;

Вихід з оболонки БД.

\q

=== phppgadmin ===

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/apache2/conf-available/phppgadmin.conf, щоб додати доступ з інших IP:

закоментовуємо

#Require local

та додаємо

allow from 127.0.0.0/255.0.0.0 ::1/128
allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(чи для всіх - allow from all)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://localhost/phppgadmin/

=== Корисні посилання ===

* [http://www.postgresql.org/about/featurematrix PostgreSQL: Feature Matrix]
* [http://manage.jujucharms.com/charms/trusty/postgresql postgresql | Juju]

== Створення користувача DSpace ==

sudo useradd -m dspace
sudo passwd dspace

Придумуємо пароль.

== Створення теки [dspace] для розміщення виконавчого коду DSpace ==

sudo mkdir /home/data
sudo mkdir /home/data/dspace
sudo chown dspace:dspace /home/data
sudo chown dspace:dspace /home/data/dspace

== Звантаження, компіляція та встановлення випуску DSpace ==

=== Звантаження ===

Використовуємо джерельні тексти DSpace з github (доступні також і на SourceForge).

https://github.com/DSpace/DSpace/releases

На час встановлення найбільш стабільною версією була DSpace 6.1 (https://github.com/DSpace/DSpace/releases/tag/dspace-6.1)

Вхід від користувача dspace

su dspace

Тека для джерельних текстів

mkdir /home/dspace/source
cd /home/dspace/source

Звантаження останньої стабільної версії

wget https://github.com/DSpace/DSpace/releases/download/dspace-6.1/dspace-6.1-src-release.tar.gz -O dspace-6.1-src-release.tar.gz

Розпакування

tar -zxf dspace-6.1-src-release.tar.gz

=== Компіляція ===

cd /home/dspace/source/dspace-6.1-src-release/
mvn -U package

Звантажує багато пакунків з repo.maven.apache.org та інших (бажано швидкий доступ до Інтернет).

Довго.

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] DSpace Parent Project .............................. SUCCESS [ 0.889 s]
[INFO] DSpace Services Framework :: API and Implementation SUCCESS [ 3.850 s]
[INFO] DSpace Kernel :: API and Implementation ............ SUCCESS [ 10.404 s]
[INFO] DSpace Addon Modules ............................... SUCCESS [ 0.003 s]
[INFO] DSpace Kernel :: Additions and Local Customizations SUCCESS [ 2.771 s]
[INFO] DSpace XML-UI (Manakin) ............................ SUCCESS [ 7.296 s]
[INFO] DSpace XML-UI (Manakin) :: Local Customizations .... SUCCESS [ 7.851 s]
[INFO] DSpace JSP-UI ...................................... SUCCESS [ 1.713 s]
[INFO] DSpace JSP-UI :: Local Customizations .............. SUCCESS [ 5.258 s]
[INFO] DSpace RDF ......................................... SUCCESS [ 4.785 s]
[INFO] DSpace RDF :: Local Customizations ................. SUCCESS [ 6.146 s]
[INFO] DSpace REST :: API and Implementation .............. SUCCESS [ 7.455 s]
[INFO] DSpace REST :: Local Customizations ................ SUCCESS [ 6.561 s]
[INFO] DSpace SWORD ....................................... SUCCESS [ 2.295 s]
[INFO] DSpace SWORD :: Local Customizations ............... SUCCESS [ 4.785 s]
[INFO] DSpace SWORD v2 .................................... SUCCESS [ 1.234 s]
[INFO] DSpace SWORD v2 :: Local Customizations ............ SUCCESS [ 4.884 s]
[INFO] Apache Solr Webapp ................................. SUCCESS [ 10.204 s]
[INFO] DSpace SOLR :: Local Customizations ................ SUCCESS [ 5.188 s]
[INFO] DSpace OAI-PMH ..................................... SUCCESS [ 1.193 s]
[INFO] DSpace OAI-PMH :: Local Customizations ............. SUCCESS [ 6.207 s]
[INFO] DSpace Assembly and Configuration .................. SUCCESS [ 15.938 s]
[INFO] DSpace XML-UI Mirage2 Theme ........................ SUCCESS [ 0.458 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:57 min
[INFO] Finished at: 2017-08-10T15:20:08+03:00
[INFO] Final Memory: 137M/954M
[INFO] ------------------------------------------------------------------------

=== Тека встановлення та доступ до БД ===

У файлі налаштувань DSpace

/home/dspace/source/dspace-6.1-src-release/dspace/target/dspace-installer/config/dspace.cfg

встановлюємо наступне

# DSpace installation directory
dspace.dir = /home/data/dspace

# Database username and password
db.username = dspace
db.password = MYPASSWORD

(пароль до БД встановлювався вище)

=== Встановлення DSpace та ініціалізація БД ===

su dspace

cd /home/dspace/source/dspace-6.1-src-release/dspace/target/dspace-installer

ant fresh_install

[echo] ====================================================================
[echo] The DSpace code has been installed.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /home/data/dspace/webapps/
[echo]
[echo] OR, copy any web applications from /home/data/dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Start up your servlet container (e.g. Tomcat). DSpace now will
[echo] initialize the database on the first startup.
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /home/data/dspace/bin/dspace create-administrator
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://localhost:8080/xmlui
[echo]
[echo] ====================================================================
[echo]
BUILD SUCCESSFUL
Total time: 16 seconds

=== Крок по переміщенню бази даних у розділ /home ===

sudo service postgresql stop

sudo mv /var/lib/postgresql /home/data/postgresql

sudo chown -R postgres:postgres /home/data/postgresql

''(варіант sudo ln -s /home/data/postgresql /var/lib/postgresql не працює через SELinux)''

редагуємо

sudo mc -e /etc/postgresql/9.6/main/postgresql.conf

data_directory = '/home/data/postgresql/9.6/main'

Перазапуск postgresql

sudo service postgresql start

=== Підключення DSpace-івських webapps до Tomcat ===

Найпростіший спосіб, що рекомендують, це зкопіювати:

sudo cp -R /home/data/dspace/webapps/* /var/lib/tomcat8/webapps/

Однак було вибрано інший спосіб через створення файлів:

Спочатку створити 2 файли
/etc/tomcat8/Catalina/localhost/jspui.xml
/etc/tomcat8/Catalina/localhost/ROOT.xml
з ідентичним вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/jspui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/xmlui.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/xmlui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/solr.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/solr"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/oai.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/oai"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rdf.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rdf"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rest.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rest"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword2.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword2"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Перезапуск Tomcat

sudo service tomcat8 restart

=== Перший обліковий запис адміністратора системи DSpace ===

/home/data/dspace/bin/dspace create-administrator

Creating an initial administrator account
E-mail address: email@of.admin
First name: MyName
Last name: MySurname
Password will not display on screen.
Password:
Again to confirm:
Is the above data correct? (y or n): y
Administrator account created

(вище вибираємо логін та пароль адміністратора DSpace)

=== Ініціалізація БД DSpace (факультативно) ===

/home/data/dspace/bin/dspace database migrate

Вивід:

Database URL: jdbc:postgresql://localhost:5432/dspace
Migrating database to latest version... (Check logs for details)
Done.

=== Встановлення на теку DSpace прав користувача сервера Tomcat ===

sudo chown tomcat8:tomcat8 /home/data/dspace -R

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

== Відкриття DSpace у браузері ==

Повинні бути доступні інтерфейси:

Локально:

http://localhost:8080

http://localhost:8080/xmlui

http://localhost:8080/jspui

http://localhost:8080/oai/request?verb=Identify

= Встановлення DSpace 1.8.1 на ОС Debian 6 (ЗАСТАРІЛО) =

== Встановлення ОС Debian GNU/Linux 6 Squeeze ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Sun Java 6 JDK ==

sudo apt-get install sun-java6-jdk

— прийняти ліцензію

та вибрати саме цей варіант як основний:

sudo update-alternatives --config java

вивід:

There are 2 choices for the alternative java (providing /usr/bin/java).

Selection Path Priority Status
------------------------------------------------------------
* 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode
1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode
2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode

Press enter to keep the current choice[*], or type selection number: 2

== Веб-сервер Tomcat та Maven ==

sudo apt-get install tomcat6 maven2

(„ant“ включено до maven2)

== Postgresql ==

sudo apt-get install postgresql

Налаштування локального доступу до БД Postgresql. Редагуємо файл pg_hba.conf:

sudo mc -e /etc/postgresql/9.1/main/pg_hba.conf

Знаходимо наступні рядки:

закоментовуємо —

# Database administrative login by UNIX sockets
# local all postgres ident

та додаємо —

local all postgres trust

закоментовуємо —

# TYPE DATABASE USER CIDR-ADDRESS METHOD
# "local" is for Unix domain socket connections only
#local all all ident

та додаємо —

local all all trust

Перезапустити Postgresql, щоб задіяти зміни:

sudo /etc/init.d/postgresql restart

== Веб-сервер Apache ==

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8888.

Редагувати /etc/apache2/ports.conf:

#NameVirtualHost *:80
#Listen 80
NameVirtualHost *:8888
Listen 8888

та /etc/apache2/sites-enabled/000-default

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

== phppgadmin ==

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/phppgadmin/apache.conf, щоб додати доступ з інших IP:

allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(allow from 127.0.0.0/255.0.0.0 ::1/128 теж залишити)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://dspace.tntu.edu.ua:8888/phppgadmin/

== Користувач „dspace“ ==

sudo useradd -m dspace

(-m також створює домашню теку)

Додати до „sudoers“ ([[Встановлення ОС Debian Linux#Sudo]]).

Надалі всі дії проводити від користувача „dspace“:

su dspace

== БД „dspace“ ==

Створення користувача „dspace“ (користувач БД)

sudo createuser -U postgres -d -A -P dspace

ввести пароль 2 рази і „yes“

Створення чистої БД „dspace“ для користувача „dspace“:

sudo createdb -U dspace -E UNICODE dspace

== Звантаження DSpace 1.8.1 ==

Від користувача „dspace“

su dspace

створити теку

mkdir source;cd source

та звантажити джерельні тексти

wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.8.1/dspace-1.8.1-src-release.tar.bz2/download -O dspace-1.8.1-src-release.tar.bz2

й розпакувати

tar -xvjf dspace-1.8.1-src-release.tar.bz2

== Налаштування „dspace.cfg“ ==

Мінімальне початкове налаштування.

cd dspace-1.8.1-src-release/dspace/config/
mc -e dspace.cfg

Наведені лише зміни (дещо має бути закоментовано):

dspace.hostname = elartu.tntu.edu.ua

dspace.baseUrl = http://elartu.tntu.edu.ua

dspace.name = ELARTU

#db.name = ${default.db.name}
db.name = postgres

#db.url = ${default.db.url}
db.url = jdbc:postgresql://localhost:5432/dspace

#db.driver = ${default.db.driver}
db.driver = org.postgresql.Driver

#db.username = ${default.db.username}
#db.password = ${default.db.password}
db.username = dspace
db.password = abrakadabra

mail.server = smtp.tu.edu.te.ua
mail.from.address = serhij dubyk@ts tu.edu.ua
feedback.recipient = serhij dubyk@ts tu.edu.ua
mail.admin = serhij dubyk@ts tu.edu.ua
alert.recipient = serhij dubyk@ts tu.edu.ua
registration.notify = serhij dubyk@ts tu.edu.ua
mail.charset = UTF8

== Тека /dspace ==

sudo mkdir /dspace
sudo chown dspace /dspace

== Побудова maven-пакунка ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace
mvn package

При цьому звантажуються файли *.jar та *.pom, а у виводі можна побачити щось на кшталт наступного:

…
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-shared-io/1.1/maven-shared-io-1.1.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-filtering/1.0/maven-filtering-1.0.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-repository-builder/1.0-alpha-2/maven-repository-builder-1.0-alpha-2.jar
[INFO] [assembly:directory-single {execution: default}]
[INFO] Reading assembly descriptor: src/assemble/assembly.xml
[WARNING] Cannot include project artifact: org.dspace:dspace:pom:1.8.1; it doesn't have an associated file or directory.
[WARNING] The following patterns were never triggered in this artifact exclusion filter:
[WARNING] NOTE: Currently, inclusion of module dependencies may produce unpredictable results if a version conflict occurs.
[INFO] Copying files to /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
[INFO]
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] DSpace Addon Modules .................................. SUCCESS [1:49.420s]
[INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [3:01.210s]
[INFO] DSpace LNI :: Web Application ......................... SUCCESS [12.231s]
[INFO] DSpace OAI :: Web Application ......................... SUCCESS [6.012s]
[INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [13.066s]
[INFO] DSpace SWORD :: Web Application ....................... SUCCESS [3.177s]
[INFO] DSpace SWORDv2 :: Web Application ..................... SUCCESS [34.394s]
[INFO] DSpace SOLR :: Web Application ........................ SUCCESS [18.529s]
[INFO] DSpace Assembly and Configuration ..................... SUCCESS [56.354s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7 minutes 15 seconds
[INFO] Finished at: Fri Feb 17 14:02:02 EET 2012
[INFO] Final Memory: 61M/205M
[INFO] ------------------------------------------------------------------------

== Встановлення ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
'''ant fresh_install'''

Частина виводу:

[echo] ====================================================================
[echo] The DSpace code has been installed, and the database initialized.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /dspace/webapps/
[echo]
[echo] OR, copy any web applications from /dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /dspace/bin/dspace create-administrator
[echo]
[echo] * Start up your servlet container (Tomcat etc.)
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui
[echo]
[echo] You should also be able to access the administrator UI:
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui/dspace-admin
[echo] ====================================================================
[echo]

BUILD SUCCESSFUL
Total time: 43 seconds

== Підключення DSpace-івських webapps до Tomcat ==

Найпростіший спосіб, що рекомендують, це зкопіювати:

cp -R /dspace/webapps/* /var/lib/tomcat6/webapps/

Однак було вибрано інший спосіб через редагування

sudo mc -e /var/lib/tomcat6/conf/server.xml

Зокрема необхідно у розділ „<Service name="Catalina">“ додати

<Connector port="80".
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"

змінити localhost на elartu.tntu.edu.ua

<Engine name="Catalina" defaultHost="elartu.tntu.edu.ua">

<Host name="elartu.tntu.edu.ua" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

та перед закриваючою ознакою „</Host>“ додати наступне

<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

Перезапуск Tomcat

sudo /etc/init.d/tomcat6 restart

== Дозвіл для Tomcat-у на порт 80 ==

Система не пускає tomcat на привілейований порт (80), для цього редагуємо

sudo mc -e /etc/default/tomcat6

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
# (yes/no, default: no)
AUTHBIND=yes

== Обліковий запис адміна DSpace ==

/dspace/bin/dspace create-administrator

Вивід:

Creating an initial administrator account
E-mail address: serhi jdubyk@ts tu.edu.ua
First name: Serhij
Last name: Dubyk
WARNING: Password will appear on-screen.
Password: ************
Again to confirm: *********
Is the above data correct? (y or n): y
Administrator account created

== Права на теки „upload“ і „assetstore“ ==

sudo chown -R tomcat6 /dspace/upload
sudo chown -R tomcat6 /dspace/assetstore

== Встановлення завершено ==

УРА!!!

Можна перевірити із середини сервера:

lynx http://localhost
lynx http://localhost/xmlui

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування DSpace]].

= Див. також =

* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Встановлення ОС Debian Linux]]

= Посилання =

* wiki.duraspace.org/ „[https://wiki.duraspace.org/display/DSDOC18/Installation#Installation-Installation DSpace 1.8 Documentation » Installation]“
* scribd.com/ „[http://www.scribd.com/doc/72991669/Dspace-Installation-on-Debian-Squeeze-6-0-3 DSpace Installation on Debian Squeeze 6.0.3]“
* linuxhalwa.blogspot.com/ „[http://linuxhalwa.blogspot.com/2011/12/installing-dspace-18-on-ubuntu-1004.html Installing Dspace 1.8 on Ubuntu 10.04]“
* oracle.com/ „[http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u30-oth-JPR Java SE Development Kit 6u30]“
* lightonphiri.org/ „[http://lightonphiri.org/blog/dspace-installation-on-ubuntu-10-10 DSpace Installation on Ubuntu 10.10]“
* losisin.com/ „[http://losisin.com/blog/39-blogs/71-install-dspace-on-ubuntu-server Install Dspace on Ubuntu Server]“
* thelowedown.wordpress.com/ „[http://thelowedown.wordpress.com/2010/08/17/tomcat-6-binding-to-a-privileged-port-on-debianubuntu/ Tomcat 6: Binding to a Privileged Port on Debian/Ubuntu]“
* repositorioinstitucional.wikispaces.com/ „[http://repositorioinstitucional.wikispaces.com/Manual+de+Instalaci%C3%B3n+de+DSpace Manual de Instalación de DSpace]“
* es.scribd.com/ „[http://es.scribd.com/doc/48073504/Instalacion-DSpace-en-Ubuntu Instalacion DSpace en Ubuntu]“
* dspace.2283337.n4.nabble.com/ „[http://dspace.2283337.n4.nabble.com/Dspace-File-Upload-Problem-td3286609.html Dspace: File Upload Problem]“

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Встановлення DSpace на ОС Debian

2017-08-10T12:37:18Z

Dubyk: /* Тека встановлення та доступ до БД */

Встановлення DSpace на ОС Debian

= Встановлення DSpace 6.1 на ОС Debian GNU/Linux 9 Stretch =

== Встановлення ОС Debian GNU/Linux 9 Stretch ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Джерела ==

* [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace Installing DSpace - DSpace 6.x Documentation - DuraSpace Wiki]

* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_DSpace_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian Встановлення DSpace на ОС Debian] (ця інструкція)

* [https://wiki.duraspace.org/display/DSDOC6x/DSpace+6.x+Documentation DSpace 6.x Documentation - DuraSpace Wiki:] (звантажити можна)

* [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace SUNScholar/Install DSpace], також див. [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_Ubuntu Install Ubuntu Server] та [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu Prepare Ubuntu Server]

* [https://wiki.duraspace.org/display/DSPACE/Installation+Guides?src=search DSpace Installation Guides]

* [https://rspproject.wordpress.com/2010/11/10/installing-dspace-on-debian-5/ Installing DSpace on Debian 5]

* [https://gist.github.com/dchud/8940811 20-minute guide to installing DSpace-4.0 from binary release on Ubuntu 12.04 LTS]

* [http://ideafix.name/?p=2325 Установка DSpace 5.x в среде Ubuntu Server 14.x]

* [http://linuxhalwa.blogspot.com/2016/01/installing-dspace-5x-on-ubuntu-1404-lts.html Installing DSpace 5.x on Ubuntu 14.04 LTS]

* [https://wiki.duraspace.org/display/DSPACE/Installing+DSpace+4.2+on+Ubuntu+Server+14.04.1+LTS Installing DSpace 4.2 on Ubuntu Server 14.04.1 LTS - DSpace - DuraSpace Wiki]

* [http://dspaceclub.blogspot.com/2015/02/how-to-install-dspace-50-on-ubuntu-1410.html How to Install DSpace 5.0 on Ubuntu 14.10 ]

* [https://amdmaher.wordpress.com/dspace-digital-repository/dspace-3-1-installation-on-debian-squeeze-6-0/ DSpace installation on Debian Squeeze 6.0.3]

== Необхідне програмне забезпечення ==

З офіційної документації [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace]:

* Oracle Java JDK or OpenJDK
* Java 8 update 20 or later, or Java 7 update 55 or later. [https://jira.duraspace.org/browse/DS-2653 DS-2653] - Java 8 Support for DSpace Accepted
* Apache Maven (Java build tool) 3.0.5+ або 3.3.9+ (для теми Mirage 2)
* Apache Ant 1.8 or later (Java build tool)
* PostgreSQL 9.4 or later (з встановленим pgcrypto). Oracle 10g or later.
* Servlet Engine: Apache Tomcat 8 (Tomcat 8.0.33 or above) or Tomcat 7 (Tomcat 7.0.30 or above), Jetty, Caucho Resin or equivalent.
* Perl (only required for [dspace]/bin/dspace-info.pl)

Присутнє у Debian GNU/Linux 9 Jessie та бекпортах:
* '''[https://packages.debian.org/stretch/openjdk-8-jdk openjdk-8-jdk]''' (8u141-b15-1~deb9u1)
* '''[https://packages.debian.org/stretch/tomcat8 tomcat8]''' (8.5.14-1+deb9u1)
* '''[https://packages.debian.org/stretch/mavenm maven]''' (3.3.9-4)
* '''[https://packages.debian.org/stretch/ant ant]''' (1.9.9-1)
* '''[https://packages.debian.org/stretch/postgresql postgresql]''' (9.6+181)

Розглядаємо варіант встановлення '''openjdk-8-jdk'''+'''tomcat8'''.

== Підключення додаткових репозитаріїв ==

У файл /etc/apt/sources.list додаємо (перевіряємо наявність) наступні джерела пакунків

deb http://ftp.ua.debian.org/debian/ stretch main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch main contrib non-free

deb http://security.debian.org/ stretch/updates contrib main
deb-src http://security.debian.org/ stretch/updates contrib main

deb http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free

(чи інші дзеркала стабільної версії)

deb http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free

Оновлюємо перелік пакунків та систему

sudo apt-get update
sudo apt-get upgrade

== Встановлення Java OpenJDK 8 ==

sudo apt-get purge openjdk-7-*

sudo apt-get install openjdk-8-jdk

та вибрати саме цей варіант (OpenJDK 8) як основний:

sudo update-alternatives --config java

== Встановлення Tomcat, Maven, Ant ==

sudo apt-get install tomcat8 maven ant git

== Встановлення БД postgresql ==

sudo apt-get install postgresql postgresql-contrib libpg-java

=== Налаштування PostgreSQL ===

У файлі
/etc/postgresql/9.6/main/postgresql.conf
розкоментувати рядок

listen_addresses = 'localhost'

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection], див. також [https://jira.duraspace.org/browse/DS-1458 DuraSpace JIRA DS-1458 Connection pool exhausted]

Редагуємо файл налаштування postgresql:

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== shared_buffers ====
Тут [http://dspace.2283337.n4.nabble.com/Dspace-production-environment-td4684344.html#a4684368 Jan 06, 2017; 5:48pm Re: Dspace production environment] рекомендують також збільшити (від типових 128Мб) до 10% від ОП.
Якщо ОП 10Гб, то
shared_buffers = 1024MB
також
sudo service postgresql restart

==== Збільшення загальної пам’яті ядра для клієнтських підключень сервера PostgreSQL ====

Редагуємо файл "/etc/sysctl.conf":

sudo mcedit /etc/sysctl.conf

Вставити наприкінці файлу наступне:

# For PostgreSQL server client connections
kernel.shmmax = 500000000
kernel.shmall = 500000000

Див. також:
* http://www.postgresql.org/docs/9.3/static/kernel-resources.html
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S06/Ubuntu-14.04

Також виконати:

sudo sysctl -p

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection]

Редагуємо файл налаштування postgresql :

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== Налаштування прав доступу до PostgreSQL на основі хост-сервера ====

Див. посилання в офіційній документації щодо файлу "pg_hba.conf":

* [http://www.postgresql.org/docs/current/static/auth-pg-hba-conf.html 19.1. The pg_hba.conf File]
* [https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-RelationalDatabase:%28PostgreSQLorOracle%29 Relational Database: (PostgreSQL or Oracle)]

У файлі /etc/postgresql/9.6/main/pg_hba.conf замінюємо
local all postgres peer
на
local all postgres trust

та
local all all peer
на
local all all md5

Перезапуск сервера БД
sudo service postgresql restart

==== Створення користувача "dspace" та БД "dspace" PostgreSQL ====

Створюємо користувача БД (dspace) та БД DSpace (dspace)

sudo su postgres
createuser -U postgres -d -A -P dspace
createdb -U dspace -E UNICODE dspace
exit

При створенні користувача придумуємо пароль.

Також може бути питання про створення нових користувачів - Shall the new role be allowed to create more new roles? (y/n) '''n'''

Перезапуск postgresql

service postgresql restart

==== Налаштування пароля, власника та привілеїв БД "dspace" та користувача "dspace" ====

З’єднуємося зі сервером БД PostgreSQL та входимо у оболонку PostgreSQL.

psql -U postgres -d dspace

Встановити пароль для користувача "dspace" (вказуємо свій варіант):

ALTER ROLE dspace WITH PASSWORD 'XXXXXX';

Нехай користувач "dspace" буде власником БД "dspace"

ALTER DATABASE dspace OWNER TO dspace;

Надати усі привілеї для БД "dspace" користувачу "dspace"

GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;

Додаємо розширення "crypto" до БД "dspace".

CREATE EXTENSION pgcrypto;

Вихід з оболонки БД.

\q

=== phppgadmin ===

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/apache2/conf-available/phppgadmin.conf, щоб додати доступ з інших IP:

закоментовуємо

#Require local

та додаємо

allow from 127.0.0.0/255.0.0.0 ::1/128
allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(чи для всіх - allow from all)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://localhost/phppgadmin/

=== Корисні посилання ===

* [http://www.postgresql.org/about/featurematrix PostgreSQL: Feature Matrix]
* [http://manage.jujucharms.com/charms/trusty/postgresql postgresql | Juju]

== Створення користувача DSpace ==

sudo useradd -m dspace
sudo passwd dspace

Придумуємо пароль.

== Створення теки [dspace] для розміщення виконавчого коду DSpace ==

sudo mkdir /home/data
sudo mkdir /home/data/dspace
sudo chown dspace:dspace /home/data
sudo chown dspace:dspace /home/data/dspace

== Звантаження, компіляція та встановлення випуску DSpace ==

=== Звантаження ===

Використовуємо джерельні тексти DSpace з github (доступні також і на SourceForge).

https://github.com/DSpace/DSpace/releases

На час встановлення найбільш стабільною версією була DSpace 6.1 (https://github.com/DSpace/DSpace/releases/tag/dspace-6.1)

Вхід від користувача dspace

su dspace

Тека для джерельних текстів

mkdir /home/dspace/source
cd /home/dspace/source

Звантаження останньої стабільної версії

wget https://github.com/DSpace/DSpace/releases/download/dspace-6.1/dspace-6.1-src-release.tar.gz -O dspace-6.1-src-release.tar.gz

Розпакування

tar -zxf dspace-6.1-src-release.tar.gz

=== Компіляція ===

cd /home/dspace/source/dspace-6.1-src-release/
mvn -U package

Звантажує багато пакунків з repo.maven.apache.org та інших (бажано швидкий доступ до Інтернет).

Довго.

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] DSpace Parent Project .............................. SUCCESS [ 0.889 s]
[INFO] DSpace Services Framework :: API and Implementation SUCCESS [ 3.850 s]
[INFO] DSpace Kernel :: API and Implementation ............ SUCCESS [ 10.404 s]
[INFO] DSpace Addon Modules ............................... SUCCESS [ 0.003 s]
[INFO] DSpace Kernel :: Additions and Local Customizations SUCCESS [ 2.771 s]
[INFO] DSpace XML-UI (Manakin) ............................ SUCCESS [ 7.296 s]
[INFO] DSpace XML-UI (Manakin) :: Local Customizations .... SUCCESS [ 7.851 s]
[INFO] DSpace JSP-UI ...................................... SUCCESS [ 1.713 s]
[INFO] DSpace JSP-UI :: Local Customizations .............. SUCCESS [ 5.258 s]
[INFO] DSpace RDF ......................................... SUCCESS [ 4.785 s]
[INFO] DSpace RDF :: Local Customizations ................. SUCCESS [ 6.146 s]
[INFO] DSpace REST :: API and Implementation .............. SUCCESS [ 7.455 s]
[INFO] DSpace REST :: Local Customizations ................ SUCCESS [ 6.561 s]
[INFO] DSpace SWORD ....................................... SUCCESS [ 2.295 s]
[INFO] DSpace SWORD :: Local Customizations ............... SUCCESS [ 4.785 s]
[INFO] DSpace SWORD v2 .................................... SUCCESS [ 1.234 s]
[INFO] DSpace SWORD v2 :: Local Customizations ............ SUCCESS [ 4.884 s]
[INFO] Apache Solr Webapp ................................. SUCCESS [ 10.204 s]
[INFO] DSpace SOLR :: Local Customizations ................ SUCCESS [ 5.188 s]
[INFO] DSpace OAI-PMH ..................................... SUCCESS [ 1.193 s]
[INFO] DSpace OAI-PMH :: Local Customizations ............. SUCCESS [ 6.207 s]
[INFO] DSpace Assembly and Configuration .................. SUCCESS [ 15.938 s]
[INFO] DSpace XML-UI Mirage2 Theme ........................ SUCCESS [ 0.458 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:57 min
[INFO] Finished at: 2017-08-10T15:20:08+03:00
[INFO] Final Memory: 137M/954M
[INFO] ------------------------------------------------------------------------

=== Тека встановлення та доступ до БД ===

У файлі налаштувань DSpace

/home/dspace/source/dspace-6.1-src-release/dspace/target/dspace-installer/config/dspace.cfg

встановлюємо наступне

# DSpace installation directory
dspace.dir = /home/data/dspace

# Database username and password
db.username = dspace
db.password = MYPASSWORD

(пароль до БД встановлювався вище)

=== Встановлення DSpace та ініціалізація БД ===

su dspace

cd /home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer

ant fresh_install

[echo] ====================================================================
[echo] The DSpace code has been installed.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /home/data/dspace/webapps/
[echo]
[echo] OR, copy any web applications from /home/data/dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Start up your servlet container (e.g. Tomcat). DSpace now will
[echo] initialize the database on the first startup.
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /home/data/dspace/bin/dspace create-administrator
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://localhost:8080/xmlui
[echo]
[echo] ====================================================================
[echo]
BUILD SUCCESSFUL
Total time: 16 seconds

=== Крок по переміщенню бази даних у розділ /home ===

sudo service postgresql stop

sudo mv /var/lib/postgresql /home/data/postgresql

sudo chown -R postgres:postgres /home/data/postgresql

''(варіант sudo ln -s /home/data/postgresql /var/lib/postgresql не працює через SELinux)''

редагуємо

sudo mc -e /etc/postgresql/9.6/main/postgresql.conf

data_directory = '/home/data/postgresql/9.6/main'

Перазапуск postgresql

sudo service postgresql start

=== Підключення DSpace-івських webapps до Tomcat ===

Найпростіший спосіб, що рекомендують, це зкопіювати:

sudo cp -R /home/data/dspace/webapps/* /var/lib/tomcat8/webapps/

Однак було вибрано інший спосіб через створення файлів:

Спочатку створити 2 файли
/etc/tomcat8/Catalina/localhost/jspui.xml
/etc/tomcat8/Catalina/localhost/ROOT.xml
з ідентичним вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/jspui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/xmlui.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/xmlui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/solr.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/solr"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/oai.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/oai"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rdf.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rdf"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rest.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rest"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword2.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword2"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Перезапуск Tomcat

sudo service tomcat8 restart

=== Перший обліковий запис адміністратора системи DSpace ===

/home/data/dspace/bin/dspace create-administrator

Creating an initial administrator account
E-mail address: email@of.admin
First name: MyName
Last name: MySurname
Password will not display on screen.
Password:
Again to confirm:
Is the above data correct? (y or n): y
Administrator account created

(вище вибираємо логін та пароль адміністратора DSpace)

=== Ініціалізація БД DSpace (факультативно) ===

/home/data/dspace/bin/dspace database migrate

Вивід:

Database URL: jdbc:postgresql://localhost:5432/dspace
Migrating database to latest version... (Check logs for details)
Done.

=== Встановлення на теку DSpace прав користувача сервера Tomcat ===

sudo chown tomcat8:tomcat8 /home/data/dspace -R

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

== Відкриття DSpace у браузері ==

Повинні бути доступні інтерфейси:

Локально:

http://localhost:8080

http://localhost:8080/xmlui

http://localhost:8080/jspui

http://localhost:8080/oai/request?verb=Identify

= Встановлення DSpace 1.8.1 на ОС Debian 6 (ЗАСТАРІЛО) =

== Встановлення ОС Debian GNU/Linux 6 Squeeze ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Sun Java 6 JDK ==

sudo apt-get install sun-java6-jdk

— прийняти ліцензію

та вибрати саме цей варіант як основний:

sudo update-alternatives --config java

вивід:

There are 2 choices for the alternative java (providing /usr/bin/java).

Selection Path Priority Status
------------------------------------------------------------
* 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode
1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode
2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode

Press enter to keep the current choice[*], or type selection number: 2

== Веб-сервер Tomcat та Maven ==

sudo apt-get install tomcat6 maven2

(„ant“ включено до maven2)

== Postgresql ==

sudo apt-get install postgresql

Налаштування локального доступу до БД Postgresql. Редагуємо файл pg_hba.conf:

sudo mc -e /etc/postgresql/9.1/main/pg_hba.conf

Знаходимо наступні рядки:

закоментовуємо —

# Database administrative login by UNIX sockets
# local all postgres ident

та додаємо —

local all postgres trust

закоментовуємо —

# TYPE DATABASE USER CIDR-ADDRESS METHOD
# "local" is for Unix domain socket connections only
#local all all ident

та додаємо —

local all all trust

Перезапустити Postgresql, щоб задіяти зміни:

sudo /etc/init.d/postgresql restart

== Веб-сервер Apache ==

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8888.

Редагувати /etc/apache2/ports.conf:

#NameVirtualHost *:80
#Listen 80
NameVirtualHost *:8888
Listen 8888

та /etc/apache2/sites-enabled/000-default

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

== phppgadmin ==

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/phppgadmin/apache.conf, щоб додати доступ з інших IP:

allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(allow from 127.0.0.0/255.0.0.0 ::1/128 теж залишити)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://dspace.tntu.edu.ua:8888/phppgadmin/

== Користувач „dspace“ ==

sudo useradd -m dspace

(-m також створює домашню теку)

Додати до „sudoers“ ([[Встановлення ОС Debian Linux#Sudo]]).

Надалі всі дії проводити від користувача „dspace“:

su dspace

== БД „dspace“ ==

Створення користувача „dspace“ (користувач БД)

sudo createuser -U postgres -d -A -P dspace

ввести пароль 2 рази і „yes“

Створення чистої БД „dspace“ для користувача „dspace“:

sudo createdb -U dspace -E UNICODE dspace

== Звантаження DSpace 1.8.1 ==

Від користувача „dspace“

su dspace

створити теку

mkdir source;cd source

та звантажити джерельні тексти

wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.8.1/dspace-1.8.1-src-release.tar.bz2/download -O dspace-1.8.1-src-release.tar.bz2

й розпакувати

tar -xvjf dspace-1.8.1-src-release.tar.bz2

== Налаштування „dspace.cfg“ ==

Мінімальне початкове налаштування.

cd dspace-1.8.1-src-release/dspace/config/
mc -e dspace.cfg

Наведені лише зміни (дещо має бути закоментовано):

dspace.hostname = elartu.tntu.edu.ua

dspace.baseUrl = http://elartu.tntu.edu.ua

dspace.name = ELARTU

#db.name = ${default.db.name}
db.name = postgres

#db.url = ${default.db.url}
db.url = jdbc:postgresql://localhost:5432/dspace

#db.driver = ${default.db.driver}
db.driver = org.postgresql.Driver

#db.username = ${default.db.username}
#db.password = ${default.db.password}
db.username = dspace
db.password = abrakadabra

mail.server = smtp.tu.edu.te.ua
mail.from.address = serhij dubyk@ts tu.edu.ua
feedback.recipient = serhij dubyk@ts tu.edu.ua
mail.admin = serhij dubyk@ts tu.edu.ua
alert.recipient = serhij dubyk@ts tu.edu.ua
registration.notify = serhij dubyk@ts tu.edu.ua
mail.charset = UTF8

== Тека /dspace ==

sudo mkdir /dspace
sudo chown dspace /dspace

== Побудова maven-пакунка ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace
mvn package

При цьому звантажуються файли *.jar та *.pom, а у виводі можна побачити щось на кшталт наступного:

…
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-shared-io/1.1/maven-shared-io-1.1.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-filtering/1.0/maven-filtering-1.0.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-repository-builder/1.0-alpha-2/maven-repository-builder-1.0-alpha-2.jar
[INFO] [assembly:directory-single {execution: default}]
[INFO] Reading assembly descriptor: src/assemble/assembly.xml
[WARNING] Cannot include project artifact: org.dspace:dspace:pom:1.8.1; it doesn't have an associated file or directory.
[WARNING] The following patterns were never triggered in this artifact exclusion filter:
[WARNING] NOTE: Currently, inclusion of module dependencies may produce unpredictable results if a version conflict occurs.
[INFO] Copying files to /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
[INFO]
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] DSpace Addon Modules .................................. SUCCESS [1:49.420s]
[INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [3:01.210s]
[INFO] DSpace LNI :: Web Application ......................... SUCCESS [12.231s]
[INFO] DSpace OAI :: Web Application ......................... SUCCESS [6.012s]
[INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [13.066s]
[INFO] DSpace SWORD :: Web Application ....................... SUCCESS [3.177s]
[INFO] DSpace SWORDv2 :: Web Application ..................... SUCCESS [34.394s]
[INFO] DSpace SOLR :: Web Application ........................ SUCCESS [18.529s]
[INFO] DSpace Assembly and Configuration ..................... SUCCESS [56.354s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7 minutes 15 seconds
[INFO] Finished at: Fri Feb 17 14:02:02 EET 2012
[INFO] Final Memory: 61M/205M
[INFO] ------------------------------------------------------------------------

== Встановлення ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
'''ant fresh_install'''

Частина виводу:

[echo] ====================================================================
[echo] The DSpace code has been installed, and the database initialized.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /dspace/webapps/
[echo]
[echo] OR, copy any web applications from /dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /dspace/bin/dspace create-administrator
[echo]
[echo] * Start up your servlet container (Tomcat etc.)
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui
[echo]
[echo] You should also be able to access the administrator UI:
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui/dspace-admin
[echo] ====================================================================
[echo]

BUILD SUCCESSFUL
Total time: 43 seconds

== Підключення DSpace-івських webapps до Tomcat ==

Найпростіший спосіб, що рекомендують, це зкопіювати:

cp -R /dspace/webapps/* /var/lib/tomcat6/webapps/

Однак було вибрано інший спосіб через редагування

sudo mc -e /var/lib/tomcat6/conf/server.xml

Зокрема необхідно у розділ „<Service name="Catalina">“ додати

<Connector port="80".
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"

змінити localhost на elartu.tntu.edu.ua

<Engine name="Catalina" defaultHost="elartu.tntu.edu.ua">

<Host name="elartu.tntu.edu.ua" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

та перед закриваючою ознакою „</Host>“ додати наступне

<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

Перезапуск Tomcat

sudo /etc/init.d/tomcat6 restart

== Дозвіл для Tomcat-у на порт 80 ==

Система не пускає tomcat на привілейований порт (80), для цього редагуємо

sudo mc -e /etc/default/tomcat6

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
# (yes/no, default: no)
AUTHBIND=yes

== Обліковий запис адміна DSpace ==

/dspace/bin/dspace create-administrator

Вивід:

Creating an initial administrator account
E-mail address: serhi jdubyk@ts tu.edu.ua
First name: Serhij
Last name: Dubyk
WARNING: Password will appear on-screen.
Password: ************
Again to confirm: *********
Is the above data correct? (y or n): y
Administrator account created

== Права на теки „upload“ і „assetstore“ ==

sudo chown -R tomcat6 /dspace/upload
sudo chown -R tomcat6 /dspace/assetstore

== Встановлення завершено ==

УРА!!!

Можна перевірити із середини сервера:

lynx http://localhost
lynx http://localhost/xmlui

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування DSpace]].

= Див. також =

* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Встановлення ОС Debian Linux]]

= Посилання =

* wiki.duraspace.org/ „[https://wiki.duraspace.org/display/DSDOC18/Installation#Installation-Installation DSpace 1.8 Documentation » Installation]“
* scribd.com/ „[http://www.scribd.com/doc/72991669/Dspace-Installation-on-Debian-Squeeze-6-0-3 DSpace Installation on Debian Squeeze 6.0.3]“
* linuxhalwa.blogspot.com/ „[http://linuxhalwa.blogspot.com/2011/12/installing-dspace-18-on-ubuntu-1004.html Installing Dspace 1.8 on Ubuntu 10.04]“
* oracle.com/ „[http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u30-oth-JPR Java SE Development Kit 6u30]“
* lightonphiri.org/ „[http://lightonphiri.org/blog/dspace-installation-on-ubuntu-10-10 DSpace Installation on Ubuntu 10.10]“
* losisin.com/ „[http://losisin.com/blog/39-blogs/71-install-dspace-on-ubuntu-server Install Dspace on Ubuntu Server]“
* thelowedown.wordpress.com/ „[http://thelowedown.wordpress.com/2010/08/17/tomcat-6-binding-to-a-privileged-port-on-debianubuntu/ Tomcat 6: Binding to a Privileged Port on Debian/Ubuntu]“
* repositorioinstitucional.wikispaces.com/ „[http://repositorioinstitucional.wikispaces.com/Manual+de+Instalaci%C3%B3n+de+DSpace Manual de Instalación de DSpace]“
* es.scribd.com/ „[http://es.scribd.com/doc/48073504/Instalacion-DSpace-en-Ubuntu Instalacion DSpace en Ubuntu]“
* dspace.2283337.n4.nabble.com/ „[http://dspace.2283337.n4.nabble.com/Dspace-File-Upload-Problem-td3286609.html Dspace: File Upload Problem]“

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Встановлення DSpace на ОС Debian

2017-08-10T12:36:47Z

Dubyk: /* Компіляція */

Встановлення DSpace на ОС Debian

= Встановлення DSpace 6.1 на ОС Debian GNU/Linux 9 Stretch =

== Встановлення ОС Debian GNU/Linux 9 Stretch ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Джерела ==

* [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace Installing DSpace - DSpace 6.x Documentation - DuraSpace Wiki]

* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_DSpace_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian Встановлення DSpace на ОС Debian] (ця інструкція)

* [https://wiki.duraspace.org/display/DSDOC6x/DSpace+6.x+Documentation DSpace 6.x Documentation - DuraSpace Wiki:] (звантажити можна)

* [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace SUNScholar/Install DSpace], також див. [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_Ubuntu Install Ubuntu Server] та [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu Prepare Ubuntu Server]

* [https://wiki.duraspace.org/display/DSPACE/Installation+Guides?src=search DSpace Installation Guides]

* [https://rspproject.wordpress.com/2010/11/10/installing-dspace-on-debian-5/ Installing DSpace on Debian 5]

* [https://gist.github.com/dchud/8940811 20-minute guide to installing DSpace-4.0 from binary release on Ubuntu 12.04 LTS]

* [http://ideafix.name/?p=2325 Установка DSpace 5.x в среде Ubuntu Server 14.x]

* [http://linuxhalwa.blogspot.com/2016/01/installing-dspace-5x-on-ubuntu-1404-lts.html Installing DSpace 5.x on Ubuntu 14.04 LTS]

* [https://wiki.duraspace.org/display/DSPACE/Installing+DSpace+4.2+on+Ubuntu+Server+14.04.1+LTS Installing DSpace 4.2 on Ubuntu Server 14.04.1 LTS - DSpace - DuraSpace Wiki]

* [http://dspaceclub.blogspot.com/2015/02/how-to-install-dspace-50-on-ubuntu-1410.html How to Install DSpace 5.0 on Ubuntu 14.10 ]

* [https://amdmaher.wordpress.com/dspace-digital-repository/dspace-3-1-installation-on-debian-squeeze-6-0/ DSpace installation on Debian Squeeze 6.0.3]

== Необхідне програмне забезпечення ==

З офіційної документації [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace]:

* Oracle Java JDK or OpenJDK
* Java 8 update 20 or later, or Java 7 update 55 or later. [https://jira.duraspace.org/browse/DS-2653 DS-2653] - Java 8 Support for DSpace Accepted
* Apache Maven (Java build tool) 3.0.5+ або 3.3.9+ (для теми Mirage 2)
* Apache Ant 1.8 or later (Java build tool)
* PostgreSQL 9.4 or later (з встановленим pgcrypto). Oracle 10g or later.
* Servlet Engine: Apache Tomcat 8 (Tomcat 8.0.33 or above) or Tomcat 7 (Tomcat 7.0.30 or above), Jetty, Caucho Resin or equivalent.
* Perl (only required for [dspace]/bin/dspace-info.pl)

Присутнє у Debian GNU/Linux 9 Jessie та бекпортах:
* '''[https://packages.debian.org/stretch/openjdk-8-jdk openjdk-8-jdk]''' (8u141-b15-1~deb9u1)
* '''[https://packages.debian.org/stretch/tomcat8 tomcat8]''' (8.5.14-1+deb9u1)
* '''[https://packages.debian.org/stretch/mavenm maven]''' (3.3.9-4)
* '''[https://packages.debian.org/stretch/ant ant]''' (1.9.9-1)
* '''[https://packages.debian.org/stretch/postgresql postgresql]''' (9.6+181)

Розглядаємо варіант встановлення '''openjdk-8-jdk'''+'''tomcat8'''.

== Підключення додаткових репозитаріїв ==

У файл /etc/apt/sources.list додаємо (перевіряємо наявність) наступні джерела пакунків

deb http://ftp.ua.debian.org/debian/ stretch main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch main contrib non-free

deb http://security.debian.org/ stretch/updates contrib main
deb-src http://security.debian.org/ stretch/updates contrib main

deb http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free

(чи інші дзеркала стабільної версії)

deb http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free

Оновлюємо перелік пакунків та систему

sudo apt-get update
sudo apt-get upgrade

== Встановлення Java OpenJDK 8 ==

sudo apt-get purge openjdk-7-*

sudo apt-get install openjdk-8-jdk

та вибрати саме цей варіант (OpenJDK 8) як основний:

sudo update-alternatives --config java

== Встановлення Tomcat, Maven, Ant ==

sudo apt-get install tomcat8 maven ant git

== Встановлення БД postgresql ==

sudo apt-get install postgresql postgresql-contrib libpg-java

=== Налаштування PostgreSQL ===

У файлі
/etc/postgresql/9.6/main/postgresql.conf
розкоментувати рядок

listen_addresses = 'localhost'

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection], див. також [https://jira.duraspace.org/browse/DS-1458 DuraSpace JIRA DS-1458 Connection pool exhausted]

Редагуємо файл налаштування postgresql:

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== shared_buffers ====
Тут [http://dspace.2283337.n4.nabble.com/Dspace-production-environment-td4684344.html#a4684368 Jan 06, 2017; 5:48pm Re: Dspace production environment] рекомендують також збільшити (від типових 128Мб) до 10% від ОП.
Якщо ОП 10Гб, то
shared_buffers = 1024MB
також
sudo service postgresql restart

==== Збільшення загальної пам’яті ядра для клієнтських підключень сервера PostgreSQL ====

Редагуємо файл "/etc/sysctl.conf":

sudo mcedit /etc/sysctl.conf

Вставити наприкінці файлу наступне:

# For PostgreSQL server client connections
kernel.shmmax = 500000000
kernel.shmall = 500000000

Див. також:
* http://www.postgresql.org/docs/9.3/static/kernel-resources.html
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S06/Ubuntu-14.04

Також виконати:

sudo sysctl -p

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection]

Редагуємо файл налаштування postgresql :

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== Налаштування прав доступу до PostgreSQL на основі хост-сервера ====

Див. посилання в офіційній документації щодо файлу "pg_hba.conf":

* [http://www.postgresql.org/docs/current/static/auth-pg-hba-conf.html 19.1. The pg_hba.conf File]
* [https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-RelationalDatabase:%28PostgreSQLorOracle%29 Relational Database: (PostgreSQL or Oracle)]

У файлі /etc/postgresql/9.6/main/pg_hba.conf замінюємо
local all postgres peer
на
local all postgres trust

та
local all all peer
на
local all all md5

Перезапуск сервера БД
sudo service postgresql restart

==== Створення користувача "dspace" та БД "dspace" PostgreSQL ====

Створюємо користувача БД (dspace) та БД DSpace (dspace)

sudo su postgres
createuser -U postgres -d -A -P dspace
createdb -U dspace -E UNICODE dspace
exit

При створенні користувача придумуємо пароль.

Також може бути питання про створення нових користувачів - Shall the new role be allowed to create more new roles? (y/n) '''n'''

Перезапуск postgresql

service postgresql restart

==== Налаштування пароля, власника та привілеїв БД "dspace" та користувача "dspace" ====

З’єднуємося зі сервером БД PostgreSQL та входимо у оболонку PostgreSQL.

psql -U postgres -d dspace

Встановити пароль для користувача "dspace" (вказуємо свій варіант):

ALTER ROLE dspace WITH PASSWORD 'XXXXXX';

Нехай користувач "dspace" буде власником БД "dspace"

ALTER DATABASE dspace OWNER TO dspace;

Надати усі привілеї для БД "dspace" користувачу "dspace"

GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;

Додаємо розширення "crypto" до БД "dspace".

CREATE EXTENSION pgcrypto;

Вихід з оболонки БД.

\q

=== phppgadmin ===

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/apache2/conf-available/phppgadmin.conf, щоб додати доступ з інших IP:

закоментовуємо

#Require local

та додаємо

allow from 127.0.0.0/255.0.0.0 ::1/128
allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(чи для всіх - allow from all)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://localhost/phppgadmin/

=== Корисні посилання ===

* [http://www.postgresql.org/about/featurematrix PostgreSQL: Feature Matrix]
* [http://manage.jujucharms.com/charms/trusty/postgresql postgresql | Juju]

== Створення користувача DSpace ==

sudo useradd -m dspace
sudo passwd dspace

Придумуємо пароль.

== Створення теки [dspace] для розміщення виконавчого коду DSpace ==

sudo mkdir /home/data
sudo mkdir /home/data/dspace
sudo chown dspace:dspace /home/data
sudo chown dspace:dspace /home/data/dspace

== Звантаження, компіляція та встановлення випуску DSpace ==

=== Звантаження ===

Використовуємо джерельні тексти DSpace з github (доступні також і на SourceForge).

https://github.com/DSpace/DSpace/releases

На час встановлення найбільш стабільною версією була DSpace 6.1 (https://github.com/DSpace/DSpace/releases/tag/dspace-6.1)

Вхід від користувача dspace

su dspace

Тека для джерельних текстів

mkdir /home/dspace/source
cd /home/dspace/source

Звантаження останньої стабільної версії

wget https://github.com/DSpace/DSpace/releases/download/dspace-6.1/dspace-6.1-src-release.tar.gz -O dspace-6.1-src-release.tar.gz

Розпакування

tar -zxf dspace-6.1-src-release.tar.gz

=== Компіляція ===

cd /home/dspace/source/dspace-6.1-src-release/
mvn -U package

Звантажує багато пакунків з repo.maven.apache.org та інших (бажано швидкий доступ до Інтернет).

Довго.

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] DSpace Parent Project .............................. SUCCESS [ 0.889 s]
[INFO] DSpace Services Framework :: API and Implementation SUCCESS [ 3.850 s]
[INFO] DSpace Kernel :: API and Implementation ............ SUCCESS [ 10.404 s]
[INFO] DSpace Addon Modules ............................... SUCCESS [ 0.003 s]
[INFO] DSpace Kernel :: Additions and Local Customizations SUCCESS [ 2.771 s]
[INFO] DSpace XML-UI (Manakin) ............................ SUCCESS [ 7.296 s]
[INFO] DSpace XML-UI (Manakin) :: Local Customizations .... SUCCESS [ 7.851 s]
[INFO] DSpace JSP-UI ...................................... SUCCESS [ 1.713 s]
[INFO] DSpace JSP-UI :: Local Customizations .............. SUCCESS [ 5.258 s]
[INFO] DSpace RDF ......................................... SUCCESS [ 4.785 s]
[INFO] DSpace RDF :: Local Customizations ................. SUCCESS [ 6.146 s]
[INFO] DSpace REST :: API and Implementation .............. SUCCESS [ 7.455 s]
[INFO] DSpace REST :: Local Customizations ................ SUCCESS [ 6.561 s]
[INFO] DSpace SWORD ....................................... SUCCESS [ 2.295 s]
[INFO] DSpace SWORD :: Local Customizations ............... SUCCESS [ 4.785 s]
[INFO] DSpace SWORD v2 .................................... SUCCESS [ 1.234 s]
[INFO] DSpace SWORD v2 :: Local Customizations ............ SUCCESS [ 4.884 s]
[INFO] Apache Solr Webapp ................................. SUCCESS [ 10.204 s]
[INFO] DSpace SOLR :: Local Customizations ................ SUCCESS [ 5.188 s]
[INFO] DSpace OAI-PMH ..................................... SUCCESS [ 1.193 s]
[INFO] DSpace OAI-PMH :: Local Customizations ............. SUCCESS [ 6.207 s]
[INFO] DSpace Assembly and Configuration .................. SUCCESS [ 15.938 s]
[INFO] DSpace XML-UI Mirage2 Theme ........................ SUCCESS [ 0.458 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 01:57 min
[INFO] Finished at: 2017-08-10T15:20:08+03:00
[INFO] Final Memory: 137M/954M
[INFO] ------------------------------------------------------------------------

=== Тека встановлення та доступ до БД ===

У файлі налаштувань DSpace

/home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer/config/dspace.cfg

встановлюємо наступне

# DSpace installation directory
dspace.dir = /home/data/dspace

# Database username and password
db.username = dspace
db.password = MYPASSWORD

(пароль до БД встановлювався вище)

=== Встановлення DSpace та ініціалізація БД ===

su dspace

cd /home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer

ant fresh_install

[echo] ====================================================================
[echo] The DSpace code has been installed.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /home/data/dspace/webapps/
[echo]
[echo] OR, copy any web applications from /home/data/dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Start up your servlet container (e.g. Tomcat). DSpace now will
[echo] initialize the database on the first startup.
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /home/data/dspace/bin/dspace create-administrator
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://localhost:8080/xmlui
[echo]
[echo] ====================================================================
[echo]
BUILD SUCCESSFUL
Total time: 16 seconds

=== Крок по переміщенню бази даних у розділ /home ===

sudo service postgresql stop

sudo mv /var/lib/postgresql /home/data/postgresql

sudo chown -R postgres:postgres /home/data/postgresql

''(варіант sudo ln -s /home/data/postgresql /var/lib/postgresql не працює через SELinux)''

редагуємо

sudo mc -e /etc/postgresql/9.6/main/postgresql.conf

data_directory = '/home/data/postgresql/9.6/main'

Перазапуск postgresql

sudo service postgresql start

=== Підключення DSpace-івських webapps до Tomcat ===

Найпростіший спосіб, що рекомендують, це зкопіювати:

sudo cp -R /home/data/dspace/webapps/* /var/lib/tomcat8/webapps/

Однак було вибрано інший спосіб через створення файлів:

Спочатку створити 2 файли
/etc/tomcat8/Catalina/localhost/jspui.xml
/etc/tomcat8/Catalina/localhost/ROOT.xml
з ідентичним вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/jspui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/xmlui.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/xmlui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/solr.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/solr"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/oai.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/oai"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rdf.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rdf"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rest.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rest"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword2.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword2"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Перезапуск Tomcat

sudo service tomcat8 restart

=== Перший обліковий запис адміністратора системи DSpace ===

/home/data/dspace/bin/dspace create-administrator

Creating an initial administrator account
E-mail address: email@of.admin
First name: MyName
Last name: MySurname
Password will not display on screen.
Password:
Again to confirm:
Is the above data correct? (y or n): y
Administrator account created

(вище вибираємо логін та пароль адміністратора DSpace)

=== Ініціалізація БД DSpace (факультативно) ===

/home/data/dspace/bin/dspace database migrate

Вивід:

Database URL: jdbc:postgresql://localhost:5432/dspace
Migrating database to latest version... (Check logs for details)
Done.

=== Встановлення на теку DSpace прав користувача сервера Tomcat ===

sudo chown tomcat8:tomcat8 /home/data/dspace -R

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

== Відкриття DSpace у браузері ==

Повинні бути доступні інтерфейси:

Локально:

http://localhost:8080

http://localhost:8080/xmlui

http://localhost:8080/jspui

http://localhost:8080/oai/request?verb=Identify

= Встановлення DSpace 1.8.1 на ОС Debian 6 (ЗАСТАРІЛО) =

== Встановлення ОС Debian GNU/Linux 6 Squeeze ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Sun Java 6 JDK ==

sudo apt-get install sun-java6-jdk

— прийняти ліцензію

та вибрати саме цей варіант як основний:

sudo update-alternatives --config java

вивід:

There are 2 choices for the alternative java (providing /usr/bin/java).

Selection Path Priority Status
------------------------------------------------------------
* 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode
1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode
2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode

Press enter to keep the current choice[*], or type selection number: 2

== Веб-сервер Tomcat та Maven ==

sudo apt-get install tomcat6 maven2

(„ant“ включено до maven2)

== Postgresql ==

sudo apt-get install postgresql

Налаштування локального доступу до БД Postgresql. Редагуємо файл pg_hba.conf:

sudo mc -e /etc/postgresql/9.1/main/pg_hba.conf

Знаходимо наступні рядки:

закоментовуємо —

# Database administrative login by UNIX sockets
# local all postgres ident

та додаємо —

local all postgres trust

закоментовуємо —

# TYPE DATABASE USER CIDR-ADDRESS METHOD
# "local" is for Unix domain socket connections only
#local all all ident

та додаємо —

local all all trust

Перезапустити Postgresql, щоб задіяти зміни:

sudo /etc/init.d/postgresql restart

== Веб-сервер Apache ==

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8888.

Редагувати /etc/apache2/ports.conf:

#NameVirtualHost *:80
#Listen 80
NameVirtualHost *:8888
Listen 8888

та /etc/apache2/sites-enabled/000-default

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

== phppgadmin ==

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/phppgadmin/apache.conf, щоб додати доступ з інших IP:

allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(allow from 127.0.0.0/255.0.0.0 ::1/128 теж залишити)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://dspace.tntu.edu.ua:8888/phppgadmin/

== Користувач „dspace“ ==

sudo useradd -m dspace

(-m також створює домашню теку)

Додати до „sudoers“ ([[Встановлення ОС Debian Linux#Sudo]]).

Надалі всі дії проводити від користувача „dspace“:

su dspace

== БД „dspace“ ==

Створення користувача „dspace“ (користувач БД)

sudo createuser -U postgres -d -A -P dspace

ввести пароль 2 рази і „yes“

Створення чистої БД „dspace“ для користувача „dspace“:

sudo createdb -U dspace -E UNICODE dspace

== Звантаження DSpace 1.8.1 ==

Від користувача „dspace“

su dspace

створити теку

mkdir source;cd source

та звантажити джерельні тексти

wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.8.1/dspace-1.8.1-src-release.tar.bz2/download -O dspace-1.8.1-src-release.tar.bz2

й розпакувати

tar -xvjf dspace-1.8.1-src-release.tar.bz2

== Налаштування „dspace.cfg“ ==

Мінімальне початкове налаштування.

cd dspace-1.8.1-src-release/dspace/config/
mc -e dspace.cfg

Наведені лише зміни (дещо має бути закоментовано):

dspace.hostname = elartu.tntu.edu.ua

dspace.baseUrl = http://elartu.tntu.edu.ua

dspace.name = ELARTU

#db.name = ${default.db.name}
db.name = postgres

#db.url = ${default.db.url}
db.url = jdbc:postgresql://localhost:5432/dspace

#db.driver = ${default.db.driver}
db.driver = org.postgresql.Driver

#db.username = ${default.db.username}
#db.password = ${default.db.password}
db.username = dspace
db.password = abrakadabra

mail.server = smtp.tu.edu.te.ua
mail.from.address = serhij dubyk@ts tu.edu.ua
feedback.recipient = serhij dubyk@ts tu.edu.ua
mail.admin = serhij dubyk@ts tu.edu.ua
alert.recipient = serhij dubyk@ts tu.edu.ua
registration.notify = serhij dubyk@ts tu.edu.ua
mail.charset = UTF8

== Тека /dspace ==

sudo mkdir /dspace
sudo chown dspace /dspace

== Побудова maven-пакунка ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace
mvn package

При цьому звантажуються файли *.jar та *.pom, а у виводі можна побачити щось на кшталт наступного:

…
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-shared-io/1.1/maven-shared-io-1.1.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-filtering/1.0/maven-filtering-1.0.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-repository-builder/1.0-alpha-2/maven-repository-builder-1.0-alpha-2.jar
[INFO] [assembly:directory-single {execution: default}]
[INFO] Reading assembly descriptor: src/assemble/assembly.xml
[WARNING] Cannot include project artifact: org.dspace:dspace:pom:1.8.1; it doesn't have an associated file or directory.
[WARNING] The following patterns were never triggered in this artifact exclusion filter:
[WARNING] NOTE: Currently, inclusion of module dependencies may produce unpredictable results if a version conflict occurs.
[INFO] Copying files to /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
[INFO]
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] DSpace Addon Modules .................................. SUCCESS [1:49.420s]
[INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [3:01.210s]
[INFO] DSpace LNI :: Web Application ......................... SUCCESS [12.231s]
[INFO] DSpace OAI :: Web Application ......................... SUCCESS [6.012s]
[INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [13.066s]
[INFO] DSpace SWORD :: Web Application ....................... SUCCESS [3.177s]
[INFO] DSpace SWORDv2 :: Web Application ..................... SUCCESS [34.394s]
[INFO] DSpace SOLR :: Web Application ........................ SUCCESS [18.529s]
[INFO] DSpace Assembly and Configuration ..................... SUCCESS [56.354s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7 minutes 15 seconds
[INFO] Finished at: Fri Feb 17 14:02:02 EET 2012
[INFO] Final Memory: 61M/205M
[INFO] ------------------------------------------------------------------------

== Встановлення ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
'''ant fresh_install'''

Частина виводу:

[echo] ====================================================================
[echo] The DSpace code has been installed, and the database initialized.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /dspace/webapps/
[echo]
[echo] OR, copy any web applications from /dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /dspace/bin/dspace create-administrator
[echo]
[echo] * Start up your servlet container (Tomcat etc.)
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui
[echo]
[echo] You should also be able to access the administrator UI:
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui/dspace-admin
[echo] ====================================================================
[echo]

BUILD SUCCESSFUL
Total time: 43 seconds

== Підключення DSpace-івських webapps до Tomcat ==

Найпростіший спосіб, що рекомендують, це зкопіювати:

cp -R /dspace/webapps/* /var/lib/tomcat6/webapps/

Однак було вибрано інший спосіб через редагування

sudo mc -e /var/lib/tomcat6/conf/server.xml

Зокрема необхідно у розділ „<Service name="Catalina">“ додати

<Connector port="80".
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"

змінити localhost на elartu.tntu.edu.ua

<Engine name="Catalina" defaultHost="elartu.tntu.edu.ua">

<Host name="elartu.tntu.edu.ua" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

та перед закриваючою ознакою „</Host>“ додати наступне

<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

Перезапуск Tomcat

sudo /etc/init.d/tomcat6 restart

== Дозвіл для Tomcat-у на порт 80 ==

Система не пускає tomcat на привілейований порт (80), для цього редагуємо

sudo mc -e /etc/default/tomcat6

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
# (yes/no, default: no)
AUTHBIND=yes

== Обліковий запис адміна DSpace ==

/dspace/bin/dspace create-administrator

Вивід:

Creating an initial administrator account
E-mail address: serhi jdubyk@ts tu.edu.ua
First name: Serhij
Last name: Dubyk
WARNING: Password will appear on-screen.
Password: ************
Again to confirm: *********
Is the above data correct? (y or n): y
Administrator account created

== Права на теки „upload“ і „assetstore“ ==

sudo chown -R tomcat6 /dspace/upload
sudo chown -R tomcat6 /dspace/assetstore

== Встановлення завершено ==

УРА!!!

Можна перевірити із середини сервера:

lynx http://localhost
lynx http://localhost/xmlui

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування DSpace]].

= Див. також =

* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Встановлення ОС Debian Linux]]

= Посилання =

* wiki.duraspace.org/ „[https://wiki.duraspace.org/display/DSDOC18/Installation#Installation-Installation DSpace 1.8 Documentation » Installation]“
* scribd.com/ „[http://www.scribd.com/doc/72991669/Dspace-Installation-on-Debian-Squeeze-6-0-3 DSpace Installation on Debian Squeeze 6.0.3]“
* linuxhalwa.blogspot.com/ „[http://linuxhalwa.blogspot.com/2011/12/installing-dspace-18-on-ubuntu-1004.html Installing Dspace 1.8 on Ubuntu 10.04]“
* oracle.com/ „[http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u30-oth-JPR Java SE Development Kit 6u30]“
* lightonphiri.org/ „[http://lightonphiri.org/blog/dspace-installation-on-ubuntu-10-10 DSpace Installation on Ubuntu 10.10]“
* losisin.com/ „[http://losisin.com/blog/39-blogs/71-install-dspace-on-ubuntu-server Install Dspace on Ubuntu Server]“
* thelowedown.wordpress.com/ „[http://thelowedown.wordpress.com/2010/08/17/tomcat-6-binding-to-a-privileged-port-on-debianubuntu/ Tomcat 6: Binding to a Privileged Port on Debian/Ubuntu]“
* repositorioinstitucional.wikispaces.com/ „[http://repositorioinstitucional.wikispaces.com/Manual+de+Instalaci%C3%B3n+de+DSpace Manual de Instalación de DSpace]“
* es.scribd.com/ „[http://es.scribd.com/doc/48073504/Instalacion-DSpace-en-Ubuntu Instalacion DSpace en Ubuntu]“
* dspace.2283337.n4.nabble.com/ „[http://dspace.2283337.n4.nabble.com/Dspace-File-Upload-Problem-td3286609.html Dspace: File Upload Problem]“

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Встановлення DSpace на ОС Debian

2017-08-10T12:22:03Z

Dubyk: /* Компіляція */

Встановлення DSpace на ОС Debian

= Встановлення DSpace 6.1 на ОС Debian GNU/Linux 9 Stretch =

== Встановлення ОС Debian GNU/Linux 9 Stretch ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Джерела ==

* [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace Installing DSpace - DSpace 6.x Documentation - DuraSpace Wiki]

* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_DSpace_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian Встановлення DSpace на ОС Debian] (ця інструкція)

* [https://wiki.duraspace.org/display/DSDOC6x/DSpace+6.x+Documentation DSpace 6.x Documentation - DuraSpace Wiki:] (звантажити можна)

* [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace SUNScholar/Install DSpace], також див. [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_Ubuntu Install Ubuntu Server] та [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu Prepare Ubuntu Server]

* [https://wiki.duraspace.org/display/DSPACE/Installation+Guides?src=search DSpace Installation Guides]

* [https://rspproject.wordpress.com/2010/11/10/installing-dspace-on-debian-5/ Installing DSpace on Debian 5]

* [https://gist.github.com/dchud/8940811 20-minute guide to installing DSpace-4.0 from binary release on Ubuntu 12.04 LTS]

* [http://ideafix.name/?p=2325 Установка DSpace 5.x в среде Ubuntu Server 14.x]

* [http://linuxhalwa.blogspot.com/2016/01/installing-dspace-5x-on-ubuntu-1404-lts.html Installing DSpace 5.x on Ubuntu 14.04 LTS]

* [https://wiki.duraspace.org/display/DSPACE/Installing+DSpace+4.2+on+Ubuntu+Server+14.04.1+LTS Installing DSpace 4.2 on Ubuntu Server 14.04.1 LTS - DSpace - DuraSpace Wiki]

* [http://dspaceclub.blogspot.com/2015/02/how-to-install-dspace-50-on-ubuntu-1410.html How to Install DSpace 5.0 on Ubuntu 14.10 ]

* [https://amdmaher.wordpress.com/dspace-digital-repository/dspace-3-1-installation-on-debian-squeeze-6-0/ DSpace installation on Debian Squeeze 6.0.3]

== Необхідне програмне забезпечення ==

З офіційної документації [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace]:

* Oracle Java JDK or OpenJDK
* Java 8 update 20 or later, or Java 7 update 55 or later. [https://jira.duraspace.org/browse/DS-2653 DS-2653] - Java 8 Support for DSpace Accepted
* Apache Maven (Java build tool) 3.0.5+ або 3.3.9+ (для теми Mirage 2)
* Apache Ant 1.8 or later (Java build tool)
* PostgreSQL 9.4 or later (з встановленим pgcrypto). Oracle 10g or later.
* Servlet Engine: Apache Tomcat 8 (Tomcat 8.0.33 or above) or Tomcat 7 (Tomcat 7.0.30 or above), Jetty, Caucho Resin or equivalent.
* Perl (only required for [dspace]/bin/dspace-info.pl)

Присутнє у Debian GNU/Linux 9 Jessie та бекпортах:
* '''[https://packages.debian.org/stretch/openjdk-8-jdk openjdk-8-jdk]''' (8u141-b15-1~deb9u1)
* '''[https://packages.debian.org/stretch/tomcat8 tomcat8]''' (8.5.14-1+deb9u1)
* '''[https://packages.debian.org/stretch/mavenm maven]''' (3.3.9-4)
* '''[https://packages.debian.org/stretch/ant ant]''' (1.9.9-1)
* '''[https://packages.debian.org/stretch/postgresql postgresql]''' (9.6+181)

Розглядаємо варіант встановлення '''openjdk-8-jdk'''+'''tomcat8'''.

== Підключення додаткових репозитаріїв ==

У файл /etc/apt/sources.list додаємо (перевіряємо наявність) наступні джерела пакунків

deb http://ftp.ua.debian.org/debian/ stretch main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch main contrib non-free

deb http://security.debian.org/ stretch/updates contrib main
deb-src http://security.debian.org/ stretch/updates contrib main

deb http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free

(чи інші дзеркала стабільної версії)

deb http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free

Оновлюємо перелік пакунків та систему

sudo apt-get update
sudo apt-get upgrade

== Встановлення Java OpenJDK 8 ==

sudo apt-get purge openjdk-7-*

sudo apt-get install openjdk-8-jdk

та вибрати саме цей варіант (OpenJDK 8) як основний:

sudo update-alternatives --config java

== Встановлення Tomcat, Maven, Ant ==

sudo apt-get install tomcat8 maven ant git

== Встановлення БД postgresql ==

sudo apt-get install postgresql postgresql-contrib libpg-java

=== Налаштування PostgreSQL ===

У файлі
/etc/postgresql/9.6/main/postgresql.conf
розкоментувати рядок

listen_addresses = 'localhost'

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection], див. також [https://jira.duraspace.org/browse/DS-1458 DuraSpace JIRA DS-1458 Connection pool exhausted]

Редагуємо файл налаштування postgresql:

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== shared_buffers ====
Тут [http://dspace.2283337.n4.nabble.com/Dspace-production-environment-td4684344.html#a4684368 Jan 06, 2017; 5:48pm Re: Dspace production environment] рекомендують також збільшити (від типових 128Мб) до 10% від ОП.
Якщо ОП 10Гб, то
shared_buffers = 1024MB
також
sudo service postgresql restart

==== Збільшення загальної пам’яті ядра для клієнтських підключень сервера PostgreSQL ====

Редагуємо файл "/etc/sysctl.conf":

sudo mcedit /etc/sysctl.conf

Вставити наприкінці файлу наступне:

# For PostgreSQL server client connections
kernel.shmmax = 500000000
kernel.shmall = 500000000

Див. також:
* http://www.postgresql.org/docs/9.3/static/kernel-resources.html
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S06/Ubuntu-14.04

Також виконати:

sudo sysctl -p

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection]

Редагуємо файл налаштування postgresql :

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== Налаштування прав доступу до PostgreSQL на основі хост-сервера ====

Див. посилання в офіційній документації щодо файлу "pg_hba.conf":

* [http://www.postgresql.org/docs/current/static/auth-pg-hba-conf.html 19.1. The pg_hba.conf File]
* [https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-RelationalDatabase:%28PostgreSQLorOracle%29 Relational Database: (PostgreSQL or Oracle)]

У файлі /etc/postgresql/9.6/main/pg_hba.conf замінюємо
local all postgres peer
на
local all postgres trust

та
local all all peer
на
local all all md5

Перезапуск сервера БД
sudo service postgresql restart

==== Створення користувача "dspace" та БД "dspace" PostgreSQL ====

Створюємо користувача БД (dspace) та БД DSpace (dspace)

sudo su postgres
createuser -U postgres -d -A -P dspace
createdb -U dspace -E UNICODE dspace
exit

При створенні користувача придумуємо пароль.

Також може бути питання про створення нових користувачів - Shall the new role be allowed to create more new roles? (y/n) '''n'''

Перезапуск postgresql

service postgresql restart

==== Налаштування пароля, власника та привілеїв БД "dspace" та користувача "dspace" ====

З’єднуємося зі сервером БД PostgreSQL та входимо у оболонку PostgreSQL.

psql -U postgres -d dspace

Встановити пароль для користувача "dspace" (вказуємо свій варіант):

ALTER ROLE dspace WITH PASSWORD 'XXXXXX';

Нехай користувач "dspace" буде власником БД "dspace"

ALTER DATABASE dspace OWNER TO dspace;

Надати усі привілеї для БД "dspace" користувачу "dspace"

GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;

Додаємо розширення "crypto" до БД "dspace".

CREATE EXTENSION pgcrypto;

Вихід з оболонки БД.

\q

=== phppgadmin ===

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/apache2/conf-available/phppgadmin.conf, щоб додати доступ з інших IP:

закоментовуємо

#Require local

та додаємо

allow from 127.0.0.0/255.0.0.0 ::1/128
allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(чи для всіх - allow from all)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://localhost/phppgadmin/

=== Корисні посилання ===

* [http://www.postgresql.org/about/featurematrix PostgreSQL: Feature Matrix]
* [http://manage.jujucharms.com/charms/trusty/postgresql postgresql | Juju]

== Створення користувача DSpace ==

sudo useradd -m dspace
sudo passwd dspace

Придумуємо пароль.

== Створення теки [dspace] для розміщення виконавчого коду DSpace ==

sudo mkdir /home/data
sudo mkdir /home/data/dspace
sudo chown dspace:dspace /home/data
sudo chown dspace:dspace /home/data/dspace

== Звантаження, компіляція та встановлення випуску DSpace ==

=== Звантаження ===

Використовуємо джерельні тексти DSpace з github (доступні також і на SourceForge).

https://github.com/DSpace/DSpace/releases

На час встановлення найбільш стабільною версією була DSpace 6.1 (https://github.com/DSpace/DSpace/releases/tag/dspace-6.1)

Вхід від користувача dspace

su dspace

Тека для джерельних текстів

mkdir /home/dspace/source
cd /home/dspace/source

Звантаження останньої стабільної версії

wget https://github.com/DSpace/DSpace/releases/download/dspace-6.1/dspace-6.1-src-release.tar.gz -O dspace-6.1-src-release.tar.gz

Розпакування

tar -zxf dspace-6.1-src-release.tar.gz

=== Компіляція ===

cd /home/dspace/source/dspace-6.1-src-release/
mvn -U package

Звантажує багато пакунків з repo.maven.apache.org та інших (бажано швидкий доступ до Інтернет).

Довго.

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] DSpace Parent Project ............................. SUCCESS [24.579s]
[INFO] DSpace Services Framework :: API and Implementation SUCCESS [34.343s]
[INFO] DSpace Kernel :: API and Implementation ........... SUCCESS [7:35.974s]
[INFO] DSpace Addon Modules .............................. SUCCESS [0.022s]
[INFO] DSpace Kernel :: Additions and Local Customizations SUCCESS [24.464s]
[INFO] DSpace XML-UI (Manakin) ........................... SUCCESS [2:22.551s]
[INFO] DSpace XML-UI (Manakin) :: Local Customizations ... SUCCESS [8.485s]
[INFO] DSpace JSP-UI ..................................... SUCCESS [5.212s]
[INFO] DSpace JSP-UI :: Local Customizations ............. SUCCESS [3.017s]
[INFO] DSpace RDF ........................................ SUCCESS [2.600s]
[INFO] DSpace RDF :: Local Customizations ................ SUCCESS [3.424s]
[INFO] DSpace REST :: API and Implementation ............. SUCCESS [1:56.880s]
[INFO] DSpace REST :: Local Customizations ............... SUCCESS [3.468s]
[INFO] DSpace SWORD ...................................... SUCCESS [1.113s]
[INFO] DSpace SWORD :: Local Customizations .............. SUCCESS [2.591s]
[INFO] DSpace SWORD v2 ................................... SUCCESS [41.825s]
[INFO] DSpace SWORD v2 :: Local Customizations ........... SUCCESS [4.364s]
[INFO] Apache Solr Webapp ................................ SUCCESS [1:01.951s]
[INFO] DSpace SOLR :: Local Customizations ............... SUCCESS [2:31.404s]
[INFO] DSpace OAI-PMH .................................... SUCCESS [3:28.408s]
[INFO] DSpace OAI-PMH :: Local Customizations ............ SUCCESS [3.519s]
[INFO] DSpace Assembly and Configuration ................. SUCCESS [17.359s]
[INFO] DSpace XML-UI Mirage2 Theme ....................... SUCCESS [0.659s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 22:01.151s
[INFO] Finished at: Mon Aug 22 14:21:42 EEST 2016
[INFO] Final Memory: 70M/269M
[INFO] ------------------------------------------------------------------------

=== Тека встановлення та доступ до БД ===

У файлі налаштувань DSpace

/home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer/config/dspace.cfg

встановлюємо наступне

# DSpace installation directory
dspace.dir = /home/data/dspace

# Database username and password
db.username = dspace
db.password = MYPASSWORD

(пароль до БД встановлювався вище)

=== Встановлення DSpace та ініціалізація БД ===

su dspace

cd /home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer

ant fresh_install

[echo] ====================================================================
[echo] The DSpace code has been installed.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /home/data/dspace/webapps/
[echo]
[echo] OR, copy any web applications from /home/data/dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Start up your servlet container (e.g. Tomcat). DSpace now will
[echo] initialize the database on the first startup.
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /home/data/dspace/bin/dspace create-administrator
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://localhost:8080/xmlui
[echo]
[echo] ====================================================================
[echo]
BUILD SUCCESSFUL
Total time: 16 seconds

=== Крок по переміщенню бази даних у розділ /home ===

sudo service postgresql stop

sudo mv /var/lib/postgresql /home/data/postgresql

sudo chown -R postgres:postgres /home/data/postgresql

''(варіант sudo ln -s /home/data/postgresql /var/lib/postgresql не працює через SELinux)''

редагуємо

sudo mc -e /etc/postgresql/9.6/main/postgresql.conf

data_directory = '/home/data/postgresql/9.6/main'

Перазапуск postgresql

sudo service postgresql start

=== Підключення DSpace-івських webapps до Tomcat ===

Найпростіший спосіб, що рекомендують, це зкопіювати:

sudo cp -R /home/data/dspace/webapps/* /var/lib/tomcat8/webapps/

Однак було вибрано інший спосіб через створення файлів:

Спочатку створити 2 файли
/etc/tomcat8/Catalina/localhost/jspui.xml
/etc/tomcat8/Catalina/localhost/ROOT.xml
з ідентичним вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/jspui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/xmlui.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/xmlui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/solr.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/solr"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/oai.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/oai"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rdf.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rdf"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rest.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rest"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword2.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword2"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Перезапуск Tomcat

sudo service tomcat8 restart

=== Перший обліковий запис адміністратора системи DSpace ===

/home/data/dspace/bin/dspace create-administrator

Creating an initial administrator account
E-mail address: email@of.admin
First name: MyName
Last name: MySurname
Password will not display on screen.
Password:
Again to confirm:
Is the above data correct? (y or n): y
Administrator account created

(вище вибираємо логін та пароль адміністратора DSpace)

=== Ініціалізація БД DSpace (факультативно) ===

/home/data/dspace/bin/dspace database migrate

Вивід:

Database URL: jdbc:postgresql://localhost:5432/dspace
Migrating database to latest version... (Check logs for details)
Done.

=== Встановлення на теку DSpace прав користувача сервера Tomcat ===

sudo chown tomcat8:tomcat8 /home/data/dspace -R

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

== Відкриття DSpace у браузері ==

Повинні бути доступні інтерфейси:

Локально:

http://localhost:8080

http://localhost:8080/xmlui

http://localhost:8080/jspui

http://localhost:8080/oai/request?verb=Identify

= Встановлення DSpace 1.8.1 на ОС Debian 6 (ЗАСТАРІЛО) =

== Встановлення ОС Debian GNU/Linux 6 Squeeze ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Sun Java 6 JDK ==

sudo apt-get install sun-java6-jdk

— прийняти ліцензію

та вибрати саме цей варіант як основний:

sudo update-alternatives --config java

вивід:

There are 2 choices for the alternative java (providing /usr/bin/java).

Selection Path Priority Status
------------------------------------------------------------
* 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode
1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode
2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode

Press enter to keep the current choice[*], or type selection number: 2

== Веб-сервер Tomcat та Maven ==

sudo apt-get install tomcat6 maven2

(„ant“ включено до maven2)

== Postgresql ==

sudo apt-get install postgresql

Налаштування локального доступу до БД Postgresql. Редагуємо файл pg_hba.conf:

sudo mc -e /etc/postgresql/9.1/main/pg_hba.conf

Знаходимо наступні рядки:

закоментовуємо —

# Database administrative login by UNIX sockets
# local all postgres ident

та додаємо —

local all postgres trust

закоментовуємо —

# TYPE DATABASE USER CIDR-ADDRESS METHOD
# "local" is for Unix domain socket connections only
#local all all ident

та додаємо —

local all all trust

Перезапустити Postgresql, щоб задіяти зміни:

sudo /etc/init.d/postgresql restart

== Веб-сервер Apache ==

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8888.

Редагувати /etc/apache2/ports.conf:

#NameVirtualHost *:80
#Listen 80
NameVirtualHost *:8888
Listen 8888

та /etc/apache2/sites-enabled/000-default

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

== phppgadmin ==

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/phppgadmin/apache.conf, щоб додати доступ з інших IP:

allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(allow from 127.0.0.0/255.0.0.0 ::1/128 теж залишити)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://dspace.tntu.edu.ua:8888/phppgadmin/

== Користувач „dspace“ ==

sudo useradd -m dspace

(-m також створює домашню теку)

Додати до „sudoers“ ([[Встановлення ОС Debian Linux#Sudo]]).

Надалі всі дії проводити від користувача „dspace“:

su dspace

== БД „dspace“ ==

Створення користувача „dspace“ (користувач БД)

sudo createuser -U postgres -d -A -P dspace

ввести пароль 2 рази і „yes“

Створення чистої БД „dspace“ для користувача „dspace“:

sudo createdb -U dspace -E UNICODE dspace

== Звантаження DSpace 1.8.1 ==

Від користувача „dspace“

su dspace

створити теку

mkdir source;cd source

та звантажити джерельні тексти

wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.8.1/dspace-1.8.1-src-release.tar.bz2/download -O dspace-1.8.1-src-release.tar.bz2

й розпакувати

tar -xvjf dspace-1.8.1-src-release.tar.bz2

== Налаштування „dspace.cfg“ ==

Мінімальне початкове налаштування.

cd dspace-1.8.1-src-release/dspace/config/
mc -e dspace.cfg

Наведені лише зміни (дещо має бути закоментовано):

dspace.hostname = elartu.tntu.edu.ua

dspace.baseUrl = http://elartu.tntu.edu.ua

dspace.name = ELARTU

#db.name = ${default.db.name}
db.name = postgres

#db.url = ${default.db.url}
db.url = jdbc:postgresql://localhost:5432/dspace

#db.driver = ${default.db.driver}
db.driver = org.postgresql.Driver

#db.username = ${default.db.username}
#db.password = ${default.db.password}
db.username = dspace
db.password = abrakadabra

mail.server = smtp.tu.edu.te.ua
mail.from.address = serhij dubyk@ts tu.edu.ua
feedback.recipient = serhij dubyk@ts tu.edu.ua
mail.admin = serhij dubyk@ts tu.edu.ua
alert.recipient = serhij dubyk@ts tu.edu.ua
registration.notify = serhij dubyk@ts tu.edu.ua
mail.charset = UTF8

== Тека /dspace ==

sudo mkdir /dspace
sudo chown dspace /dspace

== Побудова maven-пакунка ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace
mvn package

При цьому звантажуються файли *.jar та *.pom, а у виводі можна побачити щось на кшталт наступного:

…
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-shared-io/1.1/maven-shared-io-1.1.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-filtering/1.0/maven-filtering-1.0.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-repository-builder/1.0-alpha-2/maven-repository-builder-1.0-alpha-2.jar
[INFO] [assembly:directory-single {execution: default}]
[INFO] Reading assembly descriptor: src/assemble/assembly.xml
[WARNING] Cannot include project artifact: org.dspace:dspace:pom:1.8.1; it doesn't have an associated file or directory.
[WARNING] The following patterns were never triggered in this artifact exclusion filter:
[WARNING] NOTE: Currently, inclusion of module dependencies may produce unpredictable results if a version conflict occurs.
[INFO] Copying files to /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
[INFO]
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] DSpace Addon Modules .................................. SUCCESS [1:49.420s]
[INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [3:01.210s]
[INFO] DSpace LNI :: Web Application ......................... SUCCESS [12.231s]
[INFO] DSpace OAI :: Web Application ......................... SUCCESS [6.012s]
[INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [13.066s]
[INFO] DSpace SWORD :: Web Application ....................... SUCCESS [3.177s]
[INFO] DSpace SWORDv2 :: Web Application ..................... SUCCESS [34.394s]
[INFO] DSpace SOLR :: Web Application ........................ SUCCESS [18.529s]
[INFO] DSpace Assembly and Configuration ..................... SUCCESS [56.354s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7 minutes 15 seconds
[INFO] Finished at: Fri Feb 17 14:02:02 EET 2012
[INFO] Final Memory: 61M/205M
[INFO] ------------------------------------------------------------------------

== Встановлення ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
'''ant fresh_install'''

Частина виводу:

[echo] ====================================================================
[echo] The DSpace code has been installed, and the database initialized.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /dspace/webapps/
[echo]
[echo] OR, copy any web applications from /dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /dspace/bin/dspace create-administrator
[echo]
[echo] * Start up your servlet container (Tomcat etc.)
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui
[echo]
[echo] You should also be able to access the administrator UI:
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui/dspace-admin
[echo] ====================================================================
[echo]

BUILD SUCCESSFUL
Total time: 43 seconds

== Підключення DSpace-івських webapps до Tomcat ==

Найпростіший спосіб, що рекомендують, це зкопіювати:

cp -R /dspace/webapps/* /var/lib/tomcat6/webapps/

Однак було вибрано інший спосіб через редагування

sudo mc -e /var/lib/tomcat6/conf/server.xml

Зокрема необхідно у розділ „<Service name="Catalina">“ додати

<Connector port="80".
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"

змінити localhost на elartu.tntu.edu.ua

<Engine name="Catalina" defaultHost="elartu.tntu.edu.ua">

<Host name="elartu.tntu.edu.ua" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

та перед закриваючою ознакою „</Host>“ додати наступне

<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

Перезапуск Tomcat

sudo /etc/init.d/tomcat6 restart

== Дозвіл для Tomcat-у на порт 80 ==

Система не пускає tomcat на привілейований порт (80), для цього редагуємо

sudo mc -e /etc/default/tomcat6

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
# (yes/no, default: no)
AUTHBIND=yes

== Обліковий запис адміна DSpace ==

/dspace/bin/dspace create-administrator

Вивід:

Creating an initial administrator account
E-mail address: serhi jdubyk@ts tu.edu.ua
First name: Serhij
Last name: Dubyk
WARNING: Password will appear on-screen.
Password: ************
Again to confirm: *********
Is the above data correct? (y or n): y
Administrator account created

== Права на теки „upload“ і „assetstore“ ==

sudo chown -R tomcat6 /dspace/upload
sudo chown -R tomcat6 /dspace/assetstore

== Встановлення завершено ==

УРА!!!

Можна перевірити із середини сервера:

lynx http://localhost
lynx http://localhost/xmlui

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування DSpace]].

= Див. також =

* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Встановлення ОС Debian Linux]]

= Посилання =

* wiki.duraspace.org/ „[https://wiki.duraspace.org/display/DSDOC18/Installation#Installation-Installation DSpace 1.8 Documentation » Installation]“
* scribd.com/ „[http://www.scribd.com/doc/72991669/Dspace-Installation-on-Debian-Squeeze-6-0-3 DSpace Installation on Debian Squeeze 6.0.3]“
* linuxhalwa.blogspot.com/ „[http://linuxhalwa.blogspot.com/2011/12/installing-dspace-18-on-ubuntu-1004.html Installing Dspace 1.8 on Ubuntu 10.04]“
* oracle.com/ „[http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u30-oth-JPR Java SE Development Kit 6u30]“
* lightonphiri.org/ „[http://lightonphiri.org/blog/dspace-installation-on-ubuntu-10-10 DSpace Installation on Ubuntu 10.10]“
* losisin.com/ „[http://losisin.com/blog/39-blogs/71-install-dspace-on-ubuntu-server Install Dspace on Ubuntu Server]“
* thelowedown.wordpress.com/ „[http://thelowedown.wordpress.com/2010/08/17/tomcat-6-binding-to-a-privileged-port-on-debianubuntu/ Tomcat 6: Binding to a Privileged Port on Debian/Ubuntu]“
* repositorioinstitucional.wikispaces.com/ „[http://repositorioinstitucional.wikispaces.com/Manual+de+Instalaci%C3%B3n+de+DSpace Manual de Instalación de DSpace]“
* es.scribd.com/ „[http://es.scribd.com/doc/48073504/Instalacion-DSpace-en-Ubuntu Instalacion DSpace en Ubuntu]“
* dspace.2283337.n4.nabble.com/ „[http://dspace.2283337.n4.nabble.com/Dspace-File-Upload-Problem-td3286609.html Dspace: File Upload Problem]“

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Встановлення DSpace на ОС Debian

2017-08-10T12:20:10Z

Dubyk: /* Звантаження */

Встановлення DSpace на ОС Debian

= Встановлення DSpace 6.1 на ОС Debian GNU/Linux 9 Stretch =

== Встановлення ОС Debian GNU/Linux 9 Stretch ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Джерела ==

* [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace Installing DSpace - DSpace 6.x Documentation - DuraSpace Wiki]

* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_DSpace_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian Встановлення DSpace на ОС Debian] (ця інструкція)

* [https://wiki.duraspace.org/display/DSDOC6x/DSpace+6.x+Documentation DSpace 6.x Documentation - DuraSpace Wiki:] (звантажити можна)

* [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace SUNScholar/Install DSpace], також див. [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_Ubuntu Install Ubuntu Server] та [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu Prepare Ubuntu Server]

* [https://wiki.duraspace.org/display/DSPACE/Installation+Guides?src=search DSpace Installation Guides]

* [https://rspproject.wordpress.com/2010/11/10/installing-dspace-on-debian-5/ Installing DSpace on Debian 5]

* [https://gist.github.com/dchud/8940811 20-minute guide to installing DSpace-4.0 from binary release on Ubuntu 12.04 LTS]

* [http://ideafix.name/?p=2325 Установка DSpace 5.x в среде Ubuntu Server 14.x]

* [http://linuxhalwa.blogspot.com/2016/01/installing-dspace-5x-on-ubuntu-1404-lts.html Installing DSpace 5.x on Ubuntu 14.04 LTS]

* [https://wiki.duraspace.org/display/DSPACE/Installing+DSpace+4.2+on+Ubuntu+Server+14.04.1+LTS Installing DSpace 4.2 on Ubuntu Server 14.04.1 LTS - DSpace - DuraSpace Wiki]

* [http://dspaceclub.blogspot.com/2015/02/how-to-install-dspace-50-on-ubuntu-1410.html How to Install DSpace 5.0 on Ubuntu 14.10 ]

* [https://amdmaher.wordpress.com/dspace-digital-repository/dspace-3-1-installation-on-debian-squeeze-6-0/ DSpace installation on Debian Squeeze 6.0.3]

== Необхідне програмне забезпечення ==

З офіційної документації [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace]:

* Oracle Java JDK or OpenJDK
* Java 8 update 20 or later, or Java 7 update 55 or later. [https://jira.duraspace.org/browse/DS-2653 DS-2653] - Java 8 Support for DSpace Accepted
* Apache Maven (Java build tool) 3.0.5+ або 3.3.9+ (для теми Mirage 2)
* Apache Ant 1.8 or later (Java build tool)
* PostgreSQL 9.4 or later (з встановленим pgcrypto). Oracle 10g or later.
* Servlet Engine: Apache Tomcat 8 (Tomcat 8.0.33 or above) or Tomcat 7 (Tomcat 7.0.30 or above), Jetty, Caucho Resin or equivalent.
* Perl (only required for [dspace]/bin/dspace-info.pl)

Присутнє у Debian GNU/Linux 9 Jessie та бекпортах:
* '''[https://packages.debian.org/stretch/openjdk-8-jdk openjdk-8-jdk]''' (8u141-b15-1~deb9u1)
* '''[https://packages.debian.org/stretch/tomcat8 tomcat8]''' (8.5.14-1+deb9u1)
* '''[https://packages.debian.org/stretch/mavenm maven]''' (3.3.9-4)
* '''[https://packages.debian.org/stretch/ant ant]''' (1.9.9-1)
* '''[https://packages.debian.org/stretch/postgresql postgresql]''' (9.6+181)

Розглядаємо варіант встановлення '''openjdk-8-jdk'''+'''tomcat8'''.

== Підключення додаткових репозитаріїв ==

У файл /etc/apt/sources.list додаємо (перевіряємо наявність) наступні джерела пакунків

deb http://ftp.ua.debian.org/debian/ stretch main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch main contrib non-free

deb http://security.debian.org/ stretch/updates contrib main
deb-src http://security.debian.org/ stretch/updates contrib main

deb http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free

(чи інші дзеркала стабільної версії)

deb http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free

Оновлюємо перелік пакунків та систему

sudo apt-get update
sudo apt-get upgrade

== Встановлення Java OpenJDK 8 ==

sudo apt-get purge openjdk-7-*

sudo apt-get install openjdk-8-jdk

та вибрати саме цей варіант (OpenJDK 8) як основний:

sudo update-alternatives --config java

== Встановлення Tomcat, Maven, Ant ==

sudo apt-get install tomcat8 maven ant git

== Встановлення БД postgresql ==

sudo apt-get install postgresql postgresql-contrib libpg-java

=== Налаштування PostgreSQL ===

У файлі
/etc/postgresql/9.6/main/postgresql.conf
розкоментувати рядок

listen_addresses = 'localhost'

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection], див. також [https://jira.duraspace.org/browse/DS-1458 DuraSpace JIRA DS-1458 Connection pool exhausted]

Редагуємо файл налаштування postgresql:

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== shared_buffers ====
Тут [http://dspace.2283337.n4.nabble.com/Dspace-production-environment-td4684344.html#a4684368 Jan 06, 2017; 5:48pm Re: Dspace production environment] рекомендують також збільшити (від типових 128Мб) до 10% від ОП.
Якщо ОП 10Гб, то
shared_buffers = 1024MB
також
sudo service postgresql restart

==== Збільшення загальної пам’яті ядра для клієнтських підключень сервера PostgreSQL ====

Редагуємо файл "/etc/sysctl.conf":

sudo mcedit /etc/sysctl.conf

Вставити наприкінці файлу наступне:

# For PostgreSQL server client connections
kernel.shmmax = 500000000
kernel.shmall = 500000000

Див. також:
* http://www.postgresql.org/docs/9.3/static/kernel-resources.html
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S06/Ubuntu-14.04

Також виконати:

sudo sysctl -p

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection]

Редагуємо файл налаштування postgresql :

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== Налаштування прав доступу до PostgreSQL на основі хост-сервера ====

Див. посилання в офіційній документації щодо файлу "pg_hba.conf":

* [http://www.postgresql.org/docs/current/static/auth-pg-hba-conf.html 19.1. The pg_hba.conf File]
* [https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-RelationalDatabase:%28PostgreSQLorOracle%29 Relational Database: (PostgreSQL or Oracle)]

У файлі /etc/postgresql/9.6/main/pg_hba.conf замінюємо
local all postgres peer
на
local all postgres trust

та
local all all peer
на
local all all md5

Перезапуск сервера БД
sudo service postgresql restart

==== Створення користувача "dspace" та БД "dspace" PostgreSQL ====

Створюємо користувача БД (dspace) та БД DSpace (dspace)

sudo su postgres
createuser -U postgres -d -A -P dspace
createdb -U dspace -E UNICODE dspace
exit

При створенні користувача придумуємо пароль.

Також може бути питання про створення нових користувачів - Shall the new role be allowed to create more new roles? (y/n) '''n'''

Перезапуск postgresql

service postgresql restart

==== Налаштування пароля, власника та привілеїв БД "dspace" та користувача "dspace" ====

З’єднуємося зі сервером БД PostgreSQL та входимо у оболонку PostgreSQL.

psql -U postgres -d dspace

Встановити пароль для користувача "dspace" (вказуємо свій варіант):

ALTER ROLE dspace WITH PASSWORD 'XXXXXX';

Нехай користувач "dspace" буде власником БД "dspace"

ALTER DATABASE dspace OWNER TO dspace;

Надати усі привілеї для БД "dspace" користувачу "dspace"

GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;

Додаємо розширення "crypto" до БД "dspace".

CREATE EXTENSION pgcrypto;

Вихід з оболонки БД.

\q

=== phppgadmin ===

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/apache2/conf-available/phppgadmin.conf, щоб додати доступ з інших IP:

закоментовуємо

#Require local

та додаємо

allow from 127.0.0.0/255.0.0.0 ::1/128
allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(чи для всіх - allow from all)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://localhost/phppgadmin/

=== Корисні посилання ===

* [http://www.postgresql.org/about/featurematrix PostgreSQL: Feature Matrix]
* [http://manage.jujucharms.com/charms/trusty/postgresql postgresql | Juju]

== Створення користувача DSpace ==

sudo useradd -m dspace
sudo passwd dspace

Придумуємо пароль.

== Створення теки [dspace] для розміщення виконавчого коду DSpace ==

sudo mkdir /home/data
sudo mkdir /home/data/dspace
sudo chown dspace:dspace /home/data
sudo chown dspace:dspace /home/data/dspace

== Звантаження, компіляція та встановлення випуску DSpace ==

=== Звантаження ===

Використовуємо джерельні тексти DSpace з github (доступні також і на SourceForge).

https://github.com/DSpace/DSpace/releases

На час встановлення найбільш стабільною версією була DSpace 6.1 (https://github.com/DSpace/DSpace/releases/tag/dspace-6.1)

Вхід від користувача dspace

su dspace

Тека для джерельних текстів

mkdir /home/dspace/source
cd /home/dspace/source

Звантаження останньої стабільної версії

wget https://github.com/DSpace/DSpace/releases/download/dspace-6.1/dspace-6.1-src-release.tar.gz -O dspace-6.1-src-release.tar.gz

Розпакування

tar -zxf dspace-6.1-src-release.tar.gz

=== Компіляція ===

cd /home/dspace/source/dspace-5.6-src-release/
mvn -U package

Cтягує багато пакунків з repo.maven.apache.org та інших (бажано швидкий доступ до Інтернет).

Довго.

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] DSpace Parent Project ............................. SUCCESS [24.579s]
[INFO] DSpace Services Framework :: API and Implementation SUCCESS [34.343s]
[INFO] DSpace Kernel :: API and Implementation ........... SUCCESS [7:35.974s]
[INFO] DSpace Addon Modules .............................. SUCCESS [0.022s]
[INFO] DSpace Kernel :: Additions and Local Customizations SUCCESS [24.464s]
[INFO] DSpace XML-UI (Manakin) ........................... SUCCESS [2:22.551s]
[INFO] DSpace XML-UI (Manakin) :: Local Customizations ... SUCCESS [8.485s]
[INFO] DSpace JSP-UI ..................................... SUCCESS [5.212s]
[INFO] DSpace JSP-UI :: Local Customizations ............. SUCCESS [3.017s]
[INFO] DSpace RDF ........................................ SUCCESS [2.600s]
[INFO] DSpace RDF :: Local Customizations ................ SUCCESS [3.424s]
[INFO] DSpace REST :: API and Implementation ............. SUCCESS [1:56.880s]
[INFO] DSpace REST :: Local Customizations ............... SUCCESS [3.468s]
[INFO] DSpace SWORD ...................................... SUCCESS [1.113s]
[INFO] DSpace SWORD :: Local Customizations .............. SUCCESS [2.591s]
[INFO] DSpace SWORD v2 ................................... SUCCESS [41.825s]
[INFO] DSpace SWORD v2 :: Local Customizations ........... SUCCESS [4.364s]
[INFO] Apache Solr Webapp ................................ SUCCESS [1:01.951s]
[INFO] DSpace SOLR :: Local Customizations ............... SUCCESS [2:31.404s]
[INFO] DSpace OAI-PMH .................................... SUCCESS [3:28.408s]
[INFO] DSpace OAI-PMH :: Local Customizations ............ SUCCESS [3.519s]
[INFO] DSpace Assembly and Configuration ................. SUCCESS [17.359s]
[INFO] DSpace XML-UI Mirage2 Theme ....................... SUCCESS [0.659s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 22:01.151s
[INFO] Finished at: Mon Aug 22 14:21:42 EEST 2016
[INFO] Final Memory: 70M/269M
[INFO] ------------------------------------------------------------------------

=== Тека встановлення та доступ до БД ===

У файлі налаштувань DSpace

/home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer/config/dspace.cfg

встановлюємо наступне

# DSpace installation directory
dspace.dir = /home/data/dspace

# Database username and password
db.username = dspace
db.password = MYPASSWORD

(пароль до БД встановлювався вище)

=== Встановлення DSpace та ініціалізація БД ===

su dspace

cd /home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer

ant fresh_install

[echo] ====================================================================
[echo] The DSpace code has been installed.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /home/data/dspace/webapps/
[echo]
[echo] OR, copy any web applications from /home/data/dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Start up your servlet container (e.g. Tomcat). DSpace now will
[echo] initialize the database on the first startup.
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /home/data/dspace/bin/dspace create-administrator
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://localhost:8080/xmlui
[echo]
[echo] ====================================================================
[echo]
BUILD SUCCESSFUL
Total time: 16 seconds

=== Крок по переміщенню бази даних у розділ /home ===

sudo service postgresql stop

sudo mv /var/lib/postgresql /home/data/postgresql

sudo chown -R postgres:postgres /home/data/postgresql

''(варіант sudo ln -s /home/data/postgresql /var/lib/postgresql не працює через SELinux)''

редагуємо

sudo mc -e /etc/postgresql/9.6/main/postgresql.conf

data_directory = '/home/data/postgresql/9.6/main'

Перазапуск postgresql

sudo service postgresql start

=== Підключення DSpace-івських webapps до Tomcat ===

Найпростіший спосіб, що рекомендують, це зкопіювати:

sudo cp -R /home/data/dspace/webapps/* /var/lib/tomcat8/webapps/

Однак було вибрано інший спосіб через створення файлів:

Спочатку створити 2 файли
/etc/tomcat8/Catalina/localhost/jspui.xml
/etc/tomcat8/Catalina/localhost/ROOT.xml
з ідентичним вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/jspui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/xmlui.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/xmlui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/solr.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/solr"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/oai.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/oai"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rdf.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rdf"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rest.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rest"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword2.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword2"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Перезапуск Tomcat

sudo service tomcat8 restart

=== Перший обліковий запис адміністратора системи DSpace ===

/home/data/dspace/bin/dspace create-administrator

Creating an initial administrator account
E-mail address: email@of.admin
First name: MyName
Last name: MySurname
Password will not display on screen.
Password:
Again to confirm:
Is the above data correct? (y or n): y
Administrator account created

(вище вибираємо логін та пароль адміністратора DSpace)

=== Ініціалізація БД DSpace (факультативно) ===

/home/data/dspace/bin/dspace database migrate

Вивід:

Database URL: jdbc:postgresql://localhost:5432/dspace
Migrating database to latest version... (Check logs for details)
Done.

=== Встановлення на теку DSpace прав користувача сервера Tomcat ===

sudo chown tomcat8:tomcat8 /home/data/dspace -R

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

== Відкриття DSpace у браузері ==

Повинні бути доступні інтерфейси:

Локально:

http://localhost:8080

http://localhost:8080/xmlui

http://localhost:8080/jspui

http://localhost:8080/oai/request?verb=Identify

= Встановлення DSpace 1.8.1 на ОС Debian 6 (ЗАСТАРІЛО) =

== Встановлення ОС Debian GNU/Linux 6 Squeeze ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Sun Java 6 JDK ==

sudo apt-get install sun-java6-jdk

— прийняти ліцензію

та вибрати саме цей варіант як основний:

sudo update-alternatives --config java

вивід:

There are 2 choices for the alternative java (providing /usr/bin/java).

Selection Path Priority Status
------------------------------------------------------------
* 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode
1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode
2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode

Press enter to keep the current choice[*], or type selection number: 2

== Веб-сервер Tomcat та Maven ==

sudo apt-get install tomcat6 maven2

(„ant“ включено до maven2)

== Postgresql ==

sudo apt-get install postgresql

Налаштування локального доступу до БД Postgresql. Редагуємо файл pg_hba.conf:

sudo mc -e /etc/postgresql/9.1/main/pg_hba.conf

Знаходимо наступні рядки:

закоментовуємо —

# Database administrative login by UNIX sockets
# local all postgres ident

та додаємо —

local all postgres trust

закоментовуємо —

# TYPE DATABASE USER CIDR-ADDRESS METHOD
# "local" is for Unix domain socket connections only
#local all all ident

та додаємо —

local all all trust

Перезапустити Postgresql, щоб задіяти зміни:

sudo /etc/init.d/postgresql restart

== Веб-сервер Apache ==

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8888.

Редагувати /etc/apache2/ports.conf:

#NameVirtualHost *:80
#Listen 80
NameVirtualHost *:8888
Listen 8888

та /etc/apache2/sites-enabled/000-default

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

== phppgadmin ==

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/phppgadmin/apache.conf, щоб додати доступ з інших IP:

allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(allow from 127.0.0.0/255.0.0.0 ::1/128 теж залишити)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://dspace.tntu.edu.ua:8888/phppgadmin/

== Користувач „dspace“ ==

sudo useradd -m dspace

(-m також створює домашню теку)

Додати до „sudoers“ ([[Встановлення ОС Debian Linux#Sudo]]).

Надалі всі дії проводити від користувача „dspace“:

su dspace

== БД „dspace“ ==

Створення користувача „dspace“ (користувач БД)

sudo createuser -U postgres -d -A -P dspace

ввести пароль 2 рази і „yes“

Створення чистої БД „dspace“ для користувача „dspace“:

sudo createdb -U dspace -E UNICODE dspace

== Звантаження DSpace 1.8.1 ==

Від користувача „dspace“

su dspace

створити теку

mkdir source;cd source

та звантажити джерельні тексти

wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.8.1/dspace-1.8.1-src-release.tar.bz2/download -O dspace-1.8.1-src-release.tar.bz2

й розпакувати

tar -xvjf dspace-1.8.1-src-release.tar.bz2

== Налаштування „dspace.cfg“ ==

Мінімальне початкове налаштування.

cd dspace-1.8.1-src-release/dspace/config/
mc -e dspace.cfg

Наведені лише зміни (дещо має бути закоментовано):

dspace.hostname = elartu.tntu.edu.ua

dspace.baseUrl = http://elartu.tntu.edu.ua

dspace.name = ELARTU

#db.name = ${default.db.name}
db.name = postgres

#db.url = ${default.db.url}
db.url = jdbc:postgresql://localhost:5432/dspace

#db.driver = ${default.db.driver}
db.driver = org.postgresql.Driver

#db.username = ${default.db.username}
#db.password = ${default.db.password}
db.username = dspace
db.password = abrakadabra

mail.server = smtp.tu.edu.te.ua
mail.from.address = serhij dubyk@ts tu.edu.ua
feedback.recipient = serhij dubyk@ts tu.edu.ua
mail.admin = serhij dubyk@ts tu.edu.ua
alert.recipient = serhij dubyk@ts tu.edu.ua
registration.notify = serhij dubyk@ts tu.edu.ua
mail.charset = UTF8

== Тека /dspace ==

sudo mkdir /dspace
sudo chown dspace /dspace

== Побудова maven-пакунка ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace
mvn package

При цьому звантажуються файли *.jar та *.pom, а у виводі можна побачити щось на кшталт наступного:

…
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-shared-io/1.1/maven-shared-io-1.1.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-filtering/1.0/maven-filtering-1.0.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-repository-builder/1.0-alpha-2/maven-repository-builder-1.0-alpha-2.jar
[INFO] [assembly:directory-single {execution: default}]
[INFO] Reading assembly descriptor: src/assemble/assembly.xml
[WARNING] Cannot include project artifact: org.dspace:dspace:pom:1.8.1; it doesn't have an associated file or directory.
[WARNING] The following patterns were never triggered in this artifact exclusion filter:
[WARNING] NOTE: Currently, inclusion of module dependencies may produce unpredictable results if a version conflict occurs.
[INFO] Copying files to /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
[INFO]
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] DSpace Addon Modules .................................. SUCCESS [1:49.420s]
[INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [3:01.210s]
[INFO] DSpace LNI :: Web Application ......................... SUCCESS [12.231s]
[INFO] DSpace OAI :: Web Application ......................... SUCCESS [6.012s]
[INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [13.066s]
[INFO] DSpace SWORD :: Web Application ....................... SUCCESS [3.177s]
[INFO] DSpace SWORDv2 :: Web Application ..................... SUCCESS [34.394s]
[INFO] DSpace SOLR :: Web Application ........................ SUCCESS [18.529s]
[INFO] DSpace Assembly and Configuration ..................... SUCCESS [56.354s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7 minutes 15 seconds
[INFO] Finished at: Fri Feb 17 14:02:02 EET 2012
[INFO] Final Memory: 61M/205M
[INFO] ------------------------------------------------------------------------

== Встановлення ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
'''ant fresh_install'''

Частина виводу:

[echo] ====================================================================
[echo] The DSpace code has been installed, and the database initialized.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /dspace/webapps/
[echo]
[echo] OR, copy any web applications from /dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /dspace/bin/dspace create-administrator
[echo]
[echo] * Start up your servlet container (Tomcat etc.)
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui
[echo]
[echo] You should also be able to access the administrator UI:
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui/dspace-admin
[echo] ====================================================================
[echo]

BUILD SUCCESSFUL
Total time: 43 seconds

== Підключення DSpace-івських webapps до Tomcat ==

Найпростіший спосіб, що рекомендують, це зкопіювати:

cp -R /dspace/webapps/* /var/lib/tomcat6/webapps/

Однак було вибрано інший спосіб через редагування

sudo mc -e /var/lib/tomcat6/conf/server.xml

Зокрема необхідно у розділ „<Service name="Catalina">“ додати

<Connector port="80".
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"

змінити localhost на elartu.tntu.edu.ua

<Engine name="Catalina" defaultHost="elartu.tntu.edu.ua">

<Host name="elartu.tntu.edu.ua" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

та перед закриваючою ознакою „</Host>“ додати наступне

<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

Перезапуск Tomcat

sudo /etc/init.d/tomcat6 restart

== Дозвіл для Tomcat-у на порт 80 ==

Система не пускає tomcat на привілейований порт (80), для цього редагуємо

sudo mc -e /etc/default/tomcat6

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
# (yes/no, default: no)
AUTHBIND=yes

== Обліковий запис адміна DSpace ==

/dspace/bin/dspace create-administrator

Вивід:

Creating an initial administrator account
E-mail address: serhi jdubyk@ts tu.edu.ua
First name: Serhij
Last name: Dubyk
WARNING: Password will appear on-screen.
Password: ************
Again to confirm: *********
Is the above data correct? (y or n): y
Administrator account created

== Права на теки „upload“ і „assetstore“ ==

sudo chown -R tomcat6 /dspace/upload
sudo chown -R tomcat6 /dspace/assetstore

== Встановлення завершено ==

УРА!!!

Можна перевірити із середини сервера:

lynx http://localhost
lynx http://localhost/xmlui

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування DSpace]].

= Див. також =

* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Встановлення ОС Debian Linux]]

= Посилання =

* wiki.duraspace.org/ „[https://wiki.duraspace.org/display/DSDOC18/Installation#Installation-Installation DSpace 1.8 Documentation » Installation]“
* scribd.com/ „[http://www.scribd.com/doc/72991669/Dspace-Installation-on-Debian-Squeeze-6-0-3 DSpace Installation on Debian Squeeze 6.0.3]“
* linuxhalwa.blogspot.com/ „[http://linuxhalwa.blogspot.com/2011/12/installing-dspace-18-on-ubuntu-1004.html Installing Dspace 1.8 on Ubuntu 10.04]“
* oracle.com/ „[http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u30-oth-JPR Java SE Development Kit 6u30]“
* lightonphiri.org/ „[http://lightonphiri.org/blog/dspace-installation-on-ubuntu-10-10 DSpace Installation on Ubuntu 10.10]“
* losisin.com/ „[http://losisin.com/blog/39-blogs/71-install-dspace-on-ubuntu-server Install Dspace on Ubuntu Server]“
* thelowedown.wordpress.com/ „[http://thelowedown.wordpress.com/2010/08/17/tomcat-6-binding-to-a-privileged-port-on-debianubuntu/ Tomcat 6: Binding to a Privileged Port on Debian/Ubuntu]“
* repositorioinstitucional.wikispaces.com/ „[http://repositorioinstitucional.wikispaces.com/Manual+de+Instalaci%C3%B3n+de+DSpace Manual de Instalación de DSpace]“
* es.scribd.com/ „[http://es.scribd.com/doc/48073504/Instalacion-DSpace-en-Ubuntu Instalacion DSpace en Ubuntu]“
* dspace.2283337.n4.nabble.com/ „[http://dspace.2283337.n4.nabble.com/Dspace-File-Upload-Problem-td3286609.html Dspace: File Upload Problem]“

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Встановлення DSpace на ОС Debian

2017-08-10T12:14:35Z

Dubyk: /* Встановлення DSpace 5.6 на ОС Debian GNU/Linux 9 Stretch */

Встановлення DSpace на ОС Debian

= Встановлення DSpace 6.1 на ОС Debian GNU/Linux 9 Stretch =

== Встановлення ОС Debian GNU/Linux 9 Stretch ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Джерела ==

* [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace Installing DSpace - DSpace 6.x Documentation - DuraSpace Wiki]

* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_DSpace_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian Встановлення DSpace на ОС Debian] (ця інструкція)

* [https://wiki.duraspace.org/display/DSDOC6x/DSpace+6.x+Documentation DSpace 6.x Documentation - DuraSpace Wiki:] (звантажити можна)

* [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace SUNScholar/Install DSpace], також див. [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_Ubuntu Install Ubuntu Server] та [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu Prepare Ubuntu Server]

* [https://wiki.duraspace.org/display/DSPACE/Installation+Guides?src=search DSpace Installation Guides]

* [https://rspproject.wordpress.com/2010/11/10/installing-dspace-on-debian-5/ Installing DSpace on Debian 5]

* [https://gist.github.com/dchud/8940811 20-minute guide to installing DSpace-4.0 from binary release on Ubuntu 12.04 LTS]

* [http://ideafix.name/?p=2325 Установка DSpace 5.x в среде Ubuntu Server 14.x]

* [http://linuxhalwa.blogspot.com/2016/01/installing-dspace-5x-on-ubuntu-1404-lts.html Installing DSpace 5.x on Ubuntu 14.04 LTS]

* [https://wiki.duraspace.org/display/DSPACE/Installing+DSpace+4.2+on+Ubuntu+Server+14.04.1+LTS Installing DSpace 4.2 on Ubuntu Server 14.04.1 LTS - DSpace - DuraSpace Wiki]

* [http://dspaceclub.blogspot.com/2015/02/how-to-install-dspace-50-on-ubuntu-1410.html How to Install DSpace 5.0 on Ubuntu 14.10 ]

* [https://amdmaher.wordpress.com/dspace-digital-repository/dspace-3-1-installation-on-debian-squeeze-6-0/ DSpace installation on Debian Squeeze 6.0.3]

== Необхідне програмне забезпечення ==

З офіційної документації [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace]:

* Oracle Java JDK or OpenJDK
* Java 8 update 20 or later, or Java 7 update 55 or later. [https://jira.duraspace.org/browse/DS-2653 DS-2653] - Java 8 Support for DSpace Accepted
* Apache Maven (Java build tool) 3.0.5+ або 3.3.9+ (для теми Mirage 2)
* Apache Ant 1.8 or later (Java build tool)
* PostgreSQL 9.4 or later (з встановленим pgcrypto). Oracle 10g or later.
* Servlet Engine: Apache Tomcat 8 (Tomcat 8.0.33 or above) or Tomcat 7 (Tomcat 7.0.30 or above), Jetty, Caucho Resin or equivalent.
* Perl (only required for [dspace]/bin/dspace-info.pl)

Присутнє у Debian GNU/Linux 9 Jessie та бекпортах:
* '''[https://packages.debian.org/stretch/openjdk-8-jdk openjdk-8-jdk]''' (8u141-b15-1~deb9u1)
* '''[https://packages.debian.org/stretch/tomcat8 tomcat8]''' (8.5.14-1+deb9u1)
* '''[https://packages.debian.org/stretch/mavenm maven]''' (3.3.9-4)
* '''[https://packages.debian.org/stretch/ant ant]''' (1.9.9-1)
* '''[https://packages.debian.org/stretch/postgresql postgresql]''' (9.6+181)

Розглядаємо варіант встановлення '''openjdk-8-jdk'''+'''tomcat8'''.

== Підключення додаткових репозитаріїв ==

У файл /etc/apt/sources.list додаємо (перевіряємо наявність) наступні джерела пакунків

deb http://ftp.ua.debian.org/debian/ stretch main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch main contrib non-free

deb http://security.debian.org/ stretch/updates contrib main
deb-src http://security.debian.org/ stretch/updates contrib main

deb http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free

(чи інші дзеркала стабільної версії)

deb http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free

Оновлюємо перелік пакунків та систему

sudo apt-get update
sudo apt-get upgrade

== Встановлення Java OpenJDK 8 ==

sudo apt-get purge openjdk-7-*

sudo apt-get install openjdk-8-jdk

та вибрати саме цей варіант (OpenJDK 8) як основний:

sudo update-alternatives --config java

== Встановлення Tomcat, Maven, Ant ==

sudo apt-get install tomcat8 maven ant git

== Встановлення БД postgresql ==

sudo apt-get install postgresql postgresql-contrib libpg-java

=== Налаштування PostgreSQL ===

У файлі
/etc/postgresql/9.6/main/postgresql.conf
розкоментувати рядок

listen_addresses = 'localhost'

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection], див. також [https://jira.duraspace.org/browse/DS-1458 DuraSpace JIRA DS-1458 Connection pool exhausted]

Редагуємо файл налаштування postgresql:

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== shared_buffers ====
Тут [http://dspace.2283337.n4.nabble.com/Dspace-production-environment-td4684344.html#a4684368 Jan 06, 2017; 5:48pm Re: Dspace production environment] рекомендують також збільшити (від типових 128Мб) до 10% від ОП.
Якщо ОП 10Гб, то
shared_buffers = 1024MB
також
sudo service postgresql restart

==== Збільшення загальної пам’яті ядра для клієнтських підключень сервера PostgreSQL ====

Редагуємо файл "/etc/sysctl.conf":

sudo mcedit /etc/sysctl.conf

Вставити наприкінці файлу наступне:

# For PostgreSQL server client connections
kernel.shmmax = 500000000
kernel.shmall = 500000000

Див. також:
* http://www.postgresql.org/docs/9.3/static/kernel-resources.html
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S06/Ubuntu-14.04

Також виконати:

sudo sysctl -p

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection]

Редагуємо файл налаштування postgresql :

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== Налаштування прав доступу до PostgreSQL на основі хост-сервера ====

Див. посилання в офіційній документації щодо файлу "pg_hba.conf":

* [http://www.postgresql.org/docs/current/static/auth-pg-hba-conf.html 19.1. The pg_hba.conf File]
* [https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-RelationalDatabase:%28PostgreSQLorOracle%29 Relational Database: (PostgreSQL or Oracle)]

У файлі /etc/postgresql/9.6/main/pg_hba.conf замінюємо
local all postgres peer
на
local all postgres trust

та
local all all peer
на
local all all md5

Перезапуск сервера БД
sudo service postgresql restart

==== Створення користувача "dspace" та БД "dspace" PostgreSQL ====

Створюємо користувача БД (dspace) та БД DSpace (dspace)

sudo su postgres
createuser -U postgres -d -A -P dspace
createdb -U dspace -E UNICODE dspace
exit

При створенні користувача придумуємо пароль.

Також може бути питання про створення нових користувачів - Shall the new role be allowed to create more new roles? (y/n) '''n'''

Перезапуск postgresql

service postgresql restart

==== Налаштування пароля, власника та привілеїв БД "dspace" та користувача "dspace" ====

З’єднуємося зі сервером БД PostgreSQL та входимо у оболонку PostgreSQL.

psql -U postgres -d dspace

Встановити пароль для користувача "dspace" (вказуємо свій варіант):

ALTER ROLE dspace WITH PASSWORD 'XXXXXX';

Нехай користувач "dspace" буде власником БД "dspace"

ALTER DATABASE dspace OWNER TO dspace;

Надати усі привілеї для БД "dspace" користувачу "dspace"

GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;

Додаємо розширення "crypto" до БД "dspace".

CREATE EXTENSION pgcrypto;

Вихід з оболонки БД.

\q

=== phppgadmin ===

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/apache2/conf-available/phppgadmin.conf, щоб додати доступ з інших IP:

закоментовуємо

#Require local

та додаємо

allow from 127.0.0.0/255.0.0.0 ::1/128
allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(чи для всіх - allow from all)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://localhost/phppgadmin/

=== Корисні посилання ===

* [http://www.postgresql.org/about/featurematrix PostgreSQL: Feature Matrix]
* [http://manage.jujucharms.com/charms/trusty/postgresql postgresql | Juju]

== Створення користувача DSpace ==

sudo useradd -m dspace
sudo passwd dspace

Придумуємо пароль.

== Створення теки [dspace] для розміщення виконавчого коду DSpace ==

sudo mkdir /home/data
sudo mkdir /home/data/dspace
sudo chown dspace:dspace /home/data
sudo chown dspace:dspace /home/data/dspace

== Звантаження, компіляція та встановлення випуску DSpace ==

=== Звантаження ===

Використовуємо джерельні тексти DSpace з github (доступні також і на SourceForge).

https://github.com/DSpace/DSpace/releases

На час встановлення найбільш стабільною версією була DSpace 5.6 (https://github.com/DSpace/DSpace/releases/tag/dspace-5.6)

Вхід від користувача dspace

su dspace

Тека для джерельних текстів

mkdir /home/dspace/source
cd /home/dspace/source

Звантаження останньої стабільної версії

wget https://github.com/DSpace/DSpace/releases/download/dspace-5.6/dspace-5.6-src-release.tar.gz -O dspace-5.6-src-release.tar.gz

Розпакування

tar -zxf dspace-5.6-src-release.tar.gz

=== Компіляція ===

cd /home/dspace/source/dspace-5.6-src-release/
mvn -U package

Cтягує багато пакунків з repo.maven.apache.org та інших (бажано швидкий доступ до Інтернет).

Довго.

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] DSpace Parent Project ............................. SUCCESS [24.579s]
[INFO] DSpace Services Framework :: API and Implementation SUCCESS [34.343s]
[INFO] DSpace Kernel :: API and Implementation ........... SUCCESS [7:35.974s]
[INFO] DSpace Addon Modules .............................. SUCCESS [0.022s]
[INFO] DSpace Kernel :: Additions and Local Customizations SUCCESS [24.464s]
[INFO] DSpace XML-UI (Manakin) ........................... SUCCESS [2:22.551s]
[INFO] DSpace XML-UI (Manakin) :: Local Customizations ... SUCCESS [8.485s]
[INFO] DSpace JSP-UI ..................................... SUCCESS [5.212s]
[INFO] DSpace JSP-UI :: Local Customizations ............. SUCCESS [3.017s]
[INFO] DSpace RDF ........................................ SUCCESS [2.600s]
[INFO] DSpace RDF :: Local Customizations ................ SUCCESS [3.424s]
[INFO] DSpace REST :: API and Implementation ............. SUCCESS [1:56.880s]
[INFO] DSpace REST :: Local Customizations ............... SUCCESS [3.468s]
[INFO] DSpace SWORD ...................................... SUCCESS [1.113s]
[INFO] DSpace SWORD :: Local Customizations .............. SUCCESS [2.591s]
[INFO] DSpace SWORD v2 ................................... SUCCESS [41.825s]
[INFO] DSpace SWORD v2 :: Local Customizations ........... SUCCESS [4.364s]
[INFO] Apache Solr Webapp ................................ SUCCESS [1:01.951s]
[INFO] DSpace SOLR :: Local Customizations ............... SUCCESS [2:31.404s]
[INFO] DSpace OAI-PMH .................................... SUCCESS [3:28.408s]
[INFO] DSpace OAI-PMH :: Local Customizations ............ SUCCESS [3.519s]
[INFO] DSpace Assembly and Configuration ................. SUCCESS [17.359s]
[INFO] DSpace XML-UI Mirage2 Theme ....................... SUCCESS [0.659s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 22:01.151s
[INFO] Finished at: Mon Aug 22 14:21:42 EEST 2016
[INFO] Final Memory: 70M/269M
[INFO] ------------------------------------------------------------------------

=== Тека встановлення та доступ до БД ===

У файлі налаштувань DSpace

/home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer/config/dspace.cfg

встановлюємо наступне

# DSpace installation directory
dspace.dir = /home/data/dspace

# Database username and password
db.username = dspace
db.password = MYPASSWORD

(пароль до БД встановлювався вище)

=== Встановлення DSpace та ініціалізація БД ===

su dspace

cd /home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer

ant fresh_install

[echo] ====================================================================
[echo] The DSpace code has been installed.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /home/data/dspace/webapps/
[echo]
[echo] OR, copy any web applications from /home/data/dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Start up your servlet container (e.g. Tomcat). DSpace now will
[echo] initialize the database on the first startup.
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /home/data/dspace/bin/dspace create-administrator
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://localhost:8080/xmlui
[echo]
[echo] ====================================================================
[echo]
BUILD SUCCESSFUL
Total time: 16 seconds

=== Крок по переміщенню бази даних у розділ /home ===

sudo service postgresql stop

sudo mv /var/lib/postgresql /home/data/postgresql

sudo chown -R postgres:postgres /home/data/postgresql

''(варіант sudo ln -s /home/data/postgresql /var/lib/postgresql не працює через SELinux)''

редагуємо

sudo mc -e /etc/postgresql/9.6/main/postgresql.conf

data_directory = '/home/data/postgresql/9.6/main'

Перазапуск postgresql

sudo service postgresql start

=== Підключення DSpace-івських webapps до Tomcat ===

Найпростіший спосіб, що рекомендують, це зкопіювати:

sudo cp -R /home/data/dspace/webapps/* /var/lib/tomcat8/webapps/

Однак було вибрано інший спосіб через створення файлів:

Спочатку створити 2 файли
/etc/tomcat8/Catalina/localhost/jspui.xml
/etc/tomcat8/Catalina/localhost/ROOT.xml
з ідентичним вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/jspui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/xmlui.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/xmlui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/solr.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/solr"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/oai.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/oai"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rdf.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rdf"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rest.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rest"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword2.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword2"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Перезапуск Tomcat

sudo service tomcat8 restart

=== Перший обліковий запис адміністратора системи DSpace ===

/home/data/dspace/bin/dspace create-administrator

Creating an initial administrator account
E-mail address: email@of.admin
First name: MyName
Last name: MySurname
Password will not display on screen.
Password:
Again to confirm:
Is the above data correct? (y or n): y
Administrator account created

(вище вибираємо логін та пароль адміністратора DSpace)

=== Ініціалізація БД DSpace (факультативно) ===

/home/data/dspace/bin/dspace database migrate

Вивід:

Database URL: jdbc:postgresql://localhost:5432/dspace
Migrating database to latest version... (Check logs for details)
Done.

=== Встановлення на теку DSpace прав користувача сервера Tomcat ===

sudo chown tomcat8:tomcat8 /home/data/dspace -R

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

== Відкриття DSpace у браузері ==

Повинні бути доступні інтерфейси:

Локально:

http://localhost:8080

http://localhost:8080/xmlui

http://localhost:8080/jspui

http://localhost:8080/oai/request?verb=Identify

= Встановлення DSpace 1.8.1 на ОС Debian 6 (ЗАСТАРІЛО) =

== Встановлення ОС Debian GNU/Linux 6 Squeeze ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Sun Java 6 JDK ==

sudo apt-get install sun-java6-jdk

— прийняти ліцензію

та вибрати саме цей варіант як основний:

sudo update-alternatives --config java

вивід:

There are 2 choices for the alternative java (providing /usr/bin/java).

Selection Path Priority Status
------------------------------------------------------------
* 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode
1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode
2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode

Press enter to keep the current choice[*], or type selection number: 2

== Веб-сервер Tomcat та Maven ==

sudo apt-get install tomcat6 maven2

(„ant“ включено до maven2)

== Postgresql ==

sudo apt-get install postgresql

Налаштування локального доступу до БД Postgresql. Редагуємо файл pg_hba.conf:

sudo mc -e /etc/postgresql/9.1/main/pg_hba.conf

Знаходимо наступні рядки:

закоментовуємо —

# Database administrative login by UNIX sockets
# local all postgres ident

та додаємо —

local all postgres trust

закоментовуємо —

# TYPE DATABASE USER CIDR-ADDRESS METHOD
# "local" is for Unix domain socket connections only
#local all all ident

та додаємо —

local all all trust

Перезапустити Postgresql, щоб задіяти зміни:

sudo /etc/init.d/postgresql restart

== Веб-сервер Apache ==

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8888.

Редагувати /etc/apache2/ports.conf:

#NameVirtualHost *:80
#Listen 80
NameVirtualHost *:8888
Listen 8888

та /etc/apache2/sites-enabled/000-default

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

== phppgadmin ==

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/phppgadmin/apache.conf, щоб додати доступ з інших IP:

allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(allow from 127.0.0.0/255.0.0.0 ::1/128 теж залишити)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://dspace.tntu.edu.ua:8888/phppgadmin/

== Користувач „dspace“ ==

sudo useradd -m dspace

(-m також створює домашню теку)

Додати до „sudoers“ ([[Встановлення ОС Debian Linux#Sudo]]).

Надалі всі дії проводити від користувача „dspace“:

su dspace

== БД „dspace“ ==

Створення користувача „dspace“ (користувач БД)

sudo createuser -U postgres -d -A -P dspace

ввести пароль 2 рази і „yes“

Створення чистої БД „dspace“ для користувача „dspace“:

sudo createdb -U dspace -E UNICODE dspace

== Звантаження DSpace 1.8.1 ==

Від користувача „dspace“

su dspace

створити теку

mkdir source;cd source

та звантажити джерельні тексти

wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.8.1/dspace-1.8.1-src-release.tar.bz2/download -O dspace-1.8.1-src-release.tar.bz2

й розпакувати

tar -xvjf dspace-1.8.1-src-release.tar.bz2

== Налаштування „dspace.cfg“ ==

Мінімальне початкове налаштування.

cd dspace-1.8.1-src-release/dspace/config/
mc -e dspace.cfg

Наведені лише зміни (дещо має бути закоментовано):

dspace.hostname = elartu.tntu.edu.ua

dspace.baseUrl = http://elartu.tntu.edu.ua

dspace.name = ELARTU

#db.name = ${default.db.name}
db.name = postgres

#db.url = ${default.db.url}
db.url = jdbc:postgresql://localhost:5432/dspace

#db.driver = ${default.db.driver}
db.driver = org.postgresql.Driver

#db.username = ${default.db.username}
#db.password = ${default.db.password}
db.username = dspace
db.password = abrakadabra

mail.server = smtp.tu.edu.te.ua
mail.from.address = serhij dubyk@ts tu.edu.ua
feedback.recipient = serhij dubyk@ts tu.edu.ua
mail.admin = serhij dubyk@ts tu.edu.ua
alert.recipient = serhij dubyk@ts tu.edu.ua
registration.notify = serhij dubyk@ts tu.edu.ua
mail.charset = UTF8

== Тека /dspace ==

sudo mkdir /dspace
sudo chown dspace /dspace

== Побудова maven-пакунка ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace
mvn package

При цьому звантажуються файли *.jar та *.pom, а у виводі можна побачити щось на кшталт наступного:

…
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-shared-io/1.1/maven-shared-io-1.1.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-filtering/1.0/maven-filtering-1.0.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-repository-builder/1.0-alpha-2/maven-repository-builder-1.0-alpha-2.jar
[INFO] [assembly:directory-single {execution: default}]
[INFO] Reading assembly descriptor: src/assemble/assembly.xml
[WARNING] Cannot include project artifact: org.dspace:dspace:pom:1.8.1; it doesn't have an associated file or directory.
[WARNING] The following patterns were never triggered in this artifact exclusion filter:
[WARNING] NOTE: Currently, inclusion of module dependencies may produce unpredictable results if a version conflict occurs.
[INFO] Copying files to /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
[INFO]
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] DSpace Addon Modules .................................. SUCCESS [1:49.420s]
[INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [3:01.210s]
[INFO] DSpace LNI :: Web Application ......................... SUCCESS [12.231s]
[INFO] DSpace OAI :: Web Application ......................... SUCCESS [6.012s]
[INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [13.066s]
[INFO] DSpace SWORD :: Web Application ....................... SUCCESS [3.177s]
[INFO] DSpace SWORDv2 :: Web Application ..................... SUCCESS [34.394s]
[INFO] DSpace SOLR :: Web Application ........................ SUCCESS [18.529s]
[INFO] DSpace Assembly and Configuration ..................... SUCCESS [56.354s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7 minutes 15 seconds
[INFO] Finished at: Fri Feb 17 14:02:02 EET 2012
[INFO] Final Memory: 61M/205M
[INFO] ------------------------------------------------------------------------

== Встановлення ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
'''ant fresh_install'''

Частина виводу:

[echo] ====================================================================
[echo] The DSpace code has been installed, and the database initialized.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /dspace/webapps/
[echo]
[echo] OR, copy any web applications from /dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /dspace/bin/dspace create-administrator
[echo]
[echo] * Start up your servlet container (Tomcat etc.)
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui
[echo]
[echo] You should also be able to access the administrator UI:
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui/dspace-admin
[echo] ====================================================================
[echo]

BUILD SUCCESSFUL
Total time: 43 seconds

== Підключення DSpace-івських webapps до Tomcat ==

Найпростіший спосіб, що рекомендують, це зкопіювати:

cp -R /dspace/webapps/* /var/lib/tomcat6/webapps/

Однак було вибрано інший спосіб через редагування

sudo mc -e /var/lib/tomcat6/conf/server.xml

Зокрема необхідно у розділ „<Service name="Catalina">“ додати

<Connector port="80".
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"

змінити localhost на elartu.tntu.edu.ua

<Engine name="Catalina" defaultHost="elartu.tntu.edu.ua">

<Host name="elartu.tntu.edu.ua" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

та перед закриваючою ознакою „</Host>“ додати наступне

<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

Перезапуск Tomcat

sudo /etc/init.d/tomcat6 restart

== Дозвіл для Tomcat-у на порт 80 ==

Система не пускає tomcat на привілейований порт (80), для цього редагуємо

sudo mc -e /etc/default/tomcat6

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
# (yes/no, default: no)
AUTHBIND=yes

== Обліковий запис адміна DSpace ==

/dspace/bin/dspace create-administrator

Вивід:

Creating an initial administrator account
E-mail address: serhi jdubyk@ts tu.edu.ua
First name: Serhij
Last name: Dubyk
WARNING: Password will appear on-screen.
Password: ************
Again to confirm: *********
Is the above data correct? (y or n): y
Administrator account created

== Права на теки „upload“ і „assetstore“ ==

sudo chown -R tomcat6 /dspace/upload
sudo chown -R tomcat6 /dspace/assetstore

== Встановлення завершено ==

УРА!!!

Можна перевірити із середини сервера:

lynx http://localhost
lynx http://localhost/xmlui

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування DSpace]].

= Див. також =

* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Встановлення ОС Debian Linux]]

= Посилання =

* wiki.duraspace.org/ „[https://wiki.duraspace.org/display/DSDOC18/Installation#Installation-Installation DSpace 1.8 Documentation » Installation]“
* scribd.com/ „[http://www.scribd.com/doc/72991669/Dspace-Installation-on-Debian-Squeeze-6-0-3 DSpace Installation on Debian Squeeze 6.0.3]“
* linuxhalwa.blogspot.com/ „[http://linuxhalwa.blogspot.com/2011/12/installing-dspace-18-on-ubuntu-1004.html Installing Dspace 1.8 on Ubuntu 10.04]“
* oracle.com/ „[http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u30-oth-JPR Java SE Development Kit 6u30]“
* lightonphiri.org/ „[http://lightonphiri.org/blog/dspace-installation-on-ubuntu-10-10 DSpace Installation on Ubuntu 10.10]“
* losisin.com/ „[http://losisin.com/blog/39-blogs/71-install-dspace-on-ubuntu-server Install Dspace on Ubuntu Server]“
* thelowedown.wordpress.com/ „[http://thelowedown.wordpress.com/2010/08/17/tomcat-6-binding-to-a-privileged-port-on-debianubuntu/ Tomcat 6: Binding to a Privileged Port on Debian/Ubuntu]“
* repositorioinstitucional.wikispaces.com/ „[http://repositorioinstitucional.wikispaces.com/Manual+de+Instalaci%C3%B3n+de+DSpace Manual de Instalación de DSpace]“
* es.scribd.com/ „[http://es.scribd.com/doc/48073504/Instalacion-DSpace-en-Ubuntu Instalacion DSpace en Ubuntu]“
* dspace.2283337.n4.nabble.com/ „[http://dspace.2283337.n4.nabble.com/Dspace-File-Upload-Problem-td3286609.html Dspace: File Upload Problem]“

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]

Встановлення DSpace на ОС Debian

2017-08-10T12:13:06Z

Dubyk: /* Джерела */

Встановлення DSpace на ОС Debian

= Встановлення DSpace 5.6 на ОС Debian GNU/Linux 9 Stretch =

== Встановлення ОС Debian GNU/Linux 9 Stretch ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Джерела ==

* [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace Installing DSpace - DSpace 6.x Documentation - DuraSpace Wiki]

* [http://wiki.tntu.edu.ua/%D0%92%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D1%8F_DSpace_%D0%BD%D0%B0_%D0%9E%D0%A1_Debian Встановлення DSpace на ОС Debian] (ця інструкція)

* [https://wiki.duraspace.org/display/DSDOC6x/DSpace+6.x+Documentation DSpace 6.x Documentation - DuraSpace Wiki:] (звантажити можна)

* [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace SUNScholar/Install DSpace], також див. [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_Ubuntu Install Ubuntu Server] та [http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu Prepare Ubuntu Server]

* [https://wiki.duraspace.org/display/DSPACE/Installation+Guides?src=search DSpace Installation Guides]

* [https://rspproject.wordpress.com/2010/11/10/installing-dspace-on-debian-5/ Installing DSpace on Debian 5]

* [https://gist.github.com/dchud/8940811 20-minute guide to installing DSpace-4.0 from binary release on Ubuntu 12.04 LTS]

* [http://ideafix.name/?p=2325 Установка DSpace 5.x в среде Ubuntu Server 14.x]

* [http://linuxhalwa.blogspot.com/2016/01/installing-dspace-5x-on-ubuntu-1404-lts.html Installing DSpace 5.x on Ubuntu 14.04 LTS]

* [https://wiki.duraspace.org/display/DSPACE/Installing+DSpace+4.2+on+Ubuntu+Server+14.04.1+LTS Installing DSpace 4.2 on Ubuntu Server 14.04.1 LTS - DSpace - DuraSpace Wiki]

* [http://dspaceclub.blogspot.com/2015/02/how-to-install-dspace-50-on-ubuntu-1410.html How to Install DSpace 5.0 on Ubuntu 14.10 ]

* [https://amdmaher.wordpress.com/dspace-digital-repository/dspace-3-1-installation-on-debian-squeeze-6-0/ DSpace installation on Debian Squeeze 6.0.3]

== Необхідне програмне забезпечення ==

З офіційної документації [https://wiki.duraspace.org/display/DSDOC6x/Installing+DSpace]:

* Oracle Java JDK or OpenJDK
* Java 8 update 20 or later, or Java 7 update 55 or later. [https://jira.duraspace.org/browse/DS-2653 DS-2653] - Java 8 Support for DSpace Accepted
* Apache Maven (Java build tool) 3.0.5+ або 3.3.9+ (для теми Mirage 2)
* Apache Ant 1.8 or later (Java build tool)
* PostgreSQL 9.4 or later (з встановленим pgcrypto). Oracle 10g or later.
* Servlet Engine: Apache Tomcat 8 (Tomcat 8.0.33 or above) or Tomcat 7 (Tomcat 7.0.30 or above), Jetty, Caucho Resin or equivalent.
* Perl (only required for [dspace]/bin/dspace-info.pl)

Присутнє у Debian GNU/Linux 9 Jessie та бекпортах:
* '''[https://packages.debian.org/stretch/openjdk-8-jdk openjdk-8-jdk]''' (8u141-b15-1~deb9u1)
* '''[https://packages.debian.org/stretch/tomcat8 tomcat8]''' (8.5.14-1+deb9u1)
* '''[https://packages.debian.org/stretch/mavenm maven]''' (3.3.9-4)
* '''[https://packages.debian.org/stretch/ant ant]''' (1.9.9-1)
* '''[https://packages.debian.org/stretch/postgresql postgresql]''' (9.6+181)

Розглядаємо варіант встановлення '''openjdk-8-jdk'''+'''tomcat8'''.

== Підключення додаткових репозитаріїв ==

У файл /etc/apt/sources.list додаємо (перевіряємо наявність) наступні джерела пакунків

deb http://ftp.ua.debian.org/debian/ stretch main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch main contrib non-free

deb http://security.debian.org/ stretch/updates contrib main
deb-src http://security.debian.org/ stretch/updates contrib main

deb http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-updates contrib main non-free

(чи інші дзеркала стабільної версії)

deb http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free
deb-src http://ftp.ua.debian.org/debian/ stretch-backports main contrib non-free

Оновлюємо перелік пакунків та систему

sudo apt-get update
sudo apt-get upgrade

== Встановлення Java OpenJDK 8 ==

sudo apt-get purge openjdk-7-*

sudo apt-get install openjdk-8-jdk

та вибрати саме цей варіант (OpenJDK 8) як основний:

sudo update-alternatives --config java

== Встановлення Tomcat, Maven, Ant ==

sudo apt-get install tomcat8 maven ant git

== Встановлення БД postgresql ==

sudo apt-get install postgresql postgresql-contrib libpg-java

=== Налаштування PostgreSQL ===

У файлі
/etc/postgresql/9.6/main/postgresql.conf
розкоментувати рядок

listen_addresses = 'localhost'

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection], див. також [https://jira.duraspace.org/browse/DS-1458 DuraSpace JIRA DS-1458 Connection pool exhausted]

Редагуємо файл налаштування postgresql:

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== shared_buffers ====
Тут [http://dspace.2283337.n4.nabble.com/Dspace-production-environment-td4684344.html#a4684368 Jan 06, 2017; 5:48pm Re: Dspace production environment] рекомендують також збільшити (від типових 128Мб) до 10% від ОП.
Якщо ОП 10Гб, то
shared_buffers = 1024MB
також
sudo service postgresql restart

==== Збільшення загальної пам’яті ядра для клієнтських підключень сервера PostgreSQL ====

Редагуємо файл "/etc/sysctl.conf":

sudo mcedit /etc/sysctl.conf

Вставити наприкінці файлу наступне:

# For PostgreSQL server client connections
kernel.shmmax = 500000000
kernel.shmall = 500000000

Див. також:
* http://www.postgresql.org/docs/9.3/static/kernel-resources.html
* http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S06/Ubuntu-14.04

Також виконати:

sudo sysctl -p

==== Встановлення максимального числа з’єднань клієнта сервера PostgreSQL ====

Зауваження: [https://jira.duraspace.org/browse/DS-2563 DS-2563: Error releasing database connection]

Редагуємо файл налаштування postgresql :

sudo mcedit /etc/postgresql/9.6/main/postgresql.conf

Змінюємо число "max_connections" на 300. Зауважте: якщо отримуватимете помилки з’єднання, то підкрутіть це значення!

Перезапускаємо сервер PostgreSQL

sudo service postgresql restart

==== Налаштування прав доступу до PostgreSQL на основі хост-сервера ====

Див. посилання в офіційній документації щодо файлу "pg_hba.conf":

* [http://www.postgresql.org/docs/current/static/auth-pg-hba-conf.html 19.1. The pg_hba.conf File]
* [https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-RelationalDatabase:%28PostgreSQLorOracle%29 Relational Database: (PostgreSQL or Oracle)]

У файлі /etc/postgresql/9.6/main/pg_hba.conf замінюємо
local all postgres peer
на
local all postgres trust

та
local all all peer
на
local all all md5

Перезапуск сервера БД
sudo service postgresql restart

==== Створення користувача "dspace" та БД "dspace" PostgreSQL ====

Створюємо користувача БД (dspace) та БД DSpace (dspace)

sudo su postgres
createuser -U postgres -d -A -P dspace
createdb -U dspace -E UNICODE dspace
exit

При створенні користувача придумуємо пароль.

Також може бути питання про створення нових користувачів - Shall the new role be allowed to create more new roles? (y/n) '''n'''

Перезапуск postgresql

service postgresql restart

==== Налаштування пароля, власника та привілеїв БД "dspace" та користувача "dspace" ====

З’єднуємося зі сервером БД PostgreSQL та входимо у оболонку PostgreSQL.

psql -U postgres -d dspace

Встановити пароль для користувача "dspace" (вказуємо свій варіант):

ALTER ROLE dspace WITH PASSWORD 'XXXXXX';

Нехай користувач "dspace" буде власником БД "dspace"

ALTER DATABASE dspace OWNER TO dspace;

Надати усі привілеї для БД "dspace" користувачу "dspace"

GRANT ALL PRIVILEGES ON DATABASE dspace TO dspace;

Додаємо розширення "crypto" до БД "dspace".

CREATE EXTENSION pgcrypto;

Вихід з оболонки БД.

\q

=== phppgadmin ===

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/apache2/conf-available/phppgadmin.conf, щоб додати доступ з інших IP:

закоментовуємо

#Require local

та додаємо

allow from 127.0.0.0/255.0.0.0 ::1/128
allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(чи для всіх - allow from all)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://localhost/phppgadmin/

=== Корисні посилання ===

* [http://www.postgresql.org/about/featurematrix PostgreSQL: Feature Matrix]
* [http://manage.jujucharms.com/charms/trusty/postgresql postgresql | Juju]

== Створення користувача DSpace ==

sudo useradd -m dspace
sudo passwd dspace

Придумуємо пароль.

== Створення теки [dspace] для розміщення виконавчого коду DSpace ==

sudo mkdir /home/data
sudo mkdir /home/data/dspace
sudo chown dspace:dspace /home/data
sudo chown dspace:dspace /home/data/dspace

== Звантаження, компіляція та встановлення випуску DSpace ==

=== Звантаження ===

Використовуємо джерельні тексти DSpace з github (доступні також і на SourceForge).

https://github.com/DSpace/DSpace/releases

На час встановлення найбільш стабільною версією була DSpace 5.6 (https://github.com/DSpace/DSpace/releases/tag/dspace-5.6)

Вхід від користувача dspace

su dspace

Тека для джерельних текстів

mkdir /home/dspace/source
cd /home/dspace/source

Звантаження останньої стабільної версії

wget https://github.com/DSpace/DSpace/releases/download/dspace-5.6/dspace-5.6-src-release.tar.gz -O dspace-5.6-src-release.tar.gz

Розпакування

tar -zxf dspace-5.6-src-release.tar.gz

=== Компіляція ===

cd /home/dspace/source/dspace-5.6-src-release/
mvn -U package

Cтягує багато пакунків з repo.maven.apache.org та інших (бажано швидкий доступ до Інтернет).

Довго.

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO]
[INFO] DSpace Parent Project ............................. SUCCESS [24.579s]
[INFO] DSpace Services Framework :: API and Implementation SUCCESS [34.343s]
[INFO] DSpace Kernel :: API and Implementation ........... SUCCESS [7:35.974s]
[INFO] DSpace Addon Modules .............................. SUCCESS [0.022s]
[INFO] DSpace Kernel :: Additions and Local Customizations SUCCESS [24.464s]
[INFO] DSpace XML-UI (Manakin) ........................... SUCCESS [2:22.551s]
[INFO] DSpace XML-UI (Manakin) :: Local Customizations ... SUCCESS [8.485s]
[INFO] DSpace JSP-UI ..................................... SUCCESS [5.212s]
[INFO] DSpace JSP-UI :: Local Customizations ............. SUCCESS [3.017s]
[INFO] DSpace RDF ........................................ SUCCESS [2.600s]
[INFO] DSpace RDF :: Local Customizations ................ SUCCESS [3.424s]
[INFO] DSpace REST :: API and Implementation ............. SUCCESS [1:56.880s]
[INFO] DSpace REST :: Local Customizations ............... SUCCESS [3.468s]
[INFO] DSpace SWORD ...................................... SUCCESS [1.113s]
[INFO] DSpace SWORD :: Local Customizations .............. SUCCESS [2.591s]
[INFO] DSpace SWORD v2 ................................... SUCCESS [41.825s]
[INFO] DSpace SWORD v2 :: Local Customizations ........... SUCCESS [4.364s]
[INFO] Apache Solr Webapp ................................ SUCCESS [1:01.951s]
[INFO] DSpace SOLR :: Local Customizations ............... SUCCESS [2:31.404s]
[INFO] DSpace OAI-PMH .................................... SUCCESS [3:28.408s]
[INFO] DSpace OAI-PMH :: Local Customizations ............ SUCCESS [3.519s]
[INFO] DSpace Assembly and Configuration ................. SUCCESS [17.359s]
[INFO] DSpace XML-UI Mirage2 Theme ....................... SUCCESS [0.659s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 22:01.151s
[INFO] Finished at: Mon Aug 22 14:21:42 EEST 2016
[INFO] Final Memory: 70M/269M
[INFO] ------------------------------------------------------------------------

=== Тека встановлення та доступ до БД ===

У файлі налаштувань DSpace

/home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer/config/dspace.cfg

встановлюємо наступне

# DSpace installation directory
dspace.dir = /home/data/dspace

# Database username and password
db.username = dspace
db.password = MYPASSWORD

(пароль до БД встановлювався вище)

=== Встановлення DSpace та ініціалізація БД ===

su dspace

cd /home/dspace/source/dspace-5.5-src-release/dspace/target/dspace-installer

ant fresh_install

[echo] ====================================================================
[echo] The DSpace code has been installed.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /home/data/dspace/webapps/
[echo]
[echo] OR, copy any web applications from /home/data/dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Start up your servlet container (e.g. Tomcat). DSpace now will
[echo] initialize the database on the first startup.
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /home/data/dspace/bin/dspace create-administrator
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://localhost:8080/xmlui
[echo]
[echo] ====================================================================
[echo]
BUILD SUCCESSFUL
Total time: 16 seconds

=== Крок по переміщенню бази даних у розділ /home ===

sudo service postgresql stop

sudo mv /var/lib/postgresql /home/data/postgresql

sudo chown -R postgres:postgres /home/data/postgresql

''(варіант sudo ln -s /home/data/postgresql /var/lib/postgresql не працює через SELinux)''

редагуємо

sudo mc -e /etc/postgresql/9.6/main/postgresql.conf

data_directory = '/home/data/postgresql/9.6/main'

Перазапуск postgresql

sudo service postgresql start

=== Підключення DSpace-івських webapps до Tomcat ===

Найпростіший спосіб, що рекомендують, це зкопіювати:

sudo cp -R /home/data/dspace/webapps/* /var/lib/tomcat8/webapps/

Однак було вибрано інший спосіб через створення файлів:

Спочатку створити 2 файли
/etc/tomcat8/Catalina/localhost/jspui.xml
/etc/tomcat8/Catalina/localhost/ROOT.xml
з ідентичним вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/jspui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/xmlui.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/xmlui"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/solr.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/solr"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/oai.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/oai"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rdf.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rdf"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/rest.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/rest"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Створити файл
/etc/tomcat8/Catalina/localhost/sword2.xml
з вмістом

<?xml version='1.0'?>
<Context
docBase="/home/data/dspace/webapps/sword2"
debug="0"
reloadable="true"
cachingAllowed="false"
allowLinking="true"/>

Перезапуск Tomcat

sudo service tomcat8 restart

=== Перший обліковий запис адміністратора системи DSpace ===

/home/data/dspace/bin/dspace create-administrator

Creating an initial administrator account
E-mail address: email@of.admin
First name: MyName
Last name: MySurname
Password will not display on screen.
Password:
Again to confirm:
Is the above data correct? (y or n): y
Administrator account created

(вище вибираємо логін та пароль адміністратора DSpace)

=== Ініціалізація БД DSpace (факультативно) ===

/home/data/dspace/bin/dspace database migrate

Вивід:

Database URL: jdbc:postgresql://localhost:5432/dspace
Migrating database to latest version... (Check logs for details)
Done.

=== Встановлення на теку DSpace прав користувача сервера Tomcat ===

sudo chown tomcat8:tomcat8 /home/data/dspace -R

Перезапуск Tomcat

sudo /etc/init.d/tomcat8 restart

== Відкриття DSpace у браузері ==

Повинні бути доступні інтерфейси:

Локально:

http://localhost:8080

http://localhost:8080/xmlui

http://localhost:8080/jspui

http://localhost:8080/oai/request?verb=Identify

= Встановлення DSpace 1.8.1 на ОС Debian 6 (ЗАСТАРІЛО) =

== Встановлення ОС Debian GNU/Linux 6 Squeeze ==

Детальніше: [[Встановлення ОС Debian Linux]].

== Sun Java 6 JDK ==

sudo apt-get install sun-java6-jdk

— прийняти ліцензію

та вибрати саме цей варіант як основний:

sudo update-alternatives --config java

вивід:

There are 2 choices for the alternative java (providing /usr/bin/java).

Selection Path Priority Status
------------------------------------------------------------
* 0 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 auto mode
1 /usr/lib/jvm/java-6-openjdk/jre/bin/java 1061 manual mode
2 /usr/lib/jvm/java-6-sun/jre/bin/java 63 manual mode

Press enter to keep the current choice[*], or type selection number: 2

== Веб-сервер Tomcat та Maven ==

sudo apt-get install tomcat6 maven2

(„ant“ включено до maven2)

== Postgresql ==

sudo apt-get install postgresql

Налаштування локального доступу до БД Postgresql. Редагуємо файл pg_hba.conf:

sudo mc -e /etc/postgresql/9.1/main/pg_hba.conf

Знаходимо наступні рядки:

закоментовуємо —

# Database administrative login by UNIX sockets
# local all postgres ident

та додаємо —

local all postgres trust

закоментовуємо —

# TYPE DATABASE USER CIDR-ADDRESS METHOD
# "local" is for Unix domain socket connections only
#local all all ident

та додаємо —

local all all trust

Перезапустити Postgresql, щоб задіяти зміни:

sudo /etc/init.d/postgresql restart

== Веб-сервер Apache ==

sudo apt-get install apache2

Оскільки 80 буде зайнятий Tomcat-ом, переналаштовуємо Apache на 8888.

Редагувати /etc/apache2/ports.conf:

#NameVirtualHost *:80
#Listen 80
NameVirtualHost *:8888
Listen 8888

та /etc/apache2/sites-enabled/000-default

<VirtualHost *:8080>
…

Перезапуск Apache:

sudo /etc/init.d/apache2 restart

== phppgadmin ==

Адмін-застосунок для доступу до БД Postgres

sudo apt-get install phppgadmin

Редагуємо /etc/phppgadmin/apache.conf, щоб додати доступ з інших IP:

allow from 10.246.28.27/255.255.255.0 ::1/128
allow from 192.168.151.246/255.255.255.0 ::1/128

(allow from 127.0.0.0/255.0.0.0 ::1/128 теж залишити)

Перезапуск веб-сервера Apache:

sudo /etc/init.d/apache2 restart

Перевіряємо доступ з вибраних IP

http://dspace.tntu.edu.ua:8888/phppgadmin/

== Користувач „dspace“ ==

sudo useradd -m dspace

(-m також створює домашню теку)

Додати до „sudoers“ ([[Встановлення ОС Debian Linux#Sudo]]).

Надалі всі дії проводити від користувача „dspace“:

su dspace

== БД „dspace“ ==

Створення користувача „dspace“ (користувач БД)

sudo createuser -U postgres -d -A -P dspace

ввести пароль 2 рази і „yes“

Створення чистої БД „dspace“ для користувача „dspace“:

sudo createdb -U dspace -E UNICODE dspace

== Звантаження DSpace 1.8.1 ==

Від користувача „dspace“

su dspace

створити теку

mkdir source;cd source

та звантажити джерельні тексти

wget http://sourceforge.net/projects/dspace/files/DSpace%20Stable/1.8.1/dspace-1.8.1-src-release.tar.bz2/download -O dspace-1.8.1-src-release.tar.bz2

й розпакувати

tar -xvjf dspace-1.8.1-src-release.tar.bz2

== Налаштування „dspace.cfg“ ==

Мінімальне початкове налаштування.

cd dspace-1.8.1-src-release/dspace/config/
mc -e dspace.cfg

Наведені лише зміни (дещо має бути закоментовано):

dspace.hostname = elartu.tntu.edu.ua

dspace.baseUrl = http://elartu.tntu.edu.ua

dspace.name = ELARTU

#db.name = ${default.db.name}
db.name = postgres

#db.url = ${default.db.url}
db.url = jdbc:postgresql://localhost:5432/dspace

#db.driver = ${default.db.driver}
db.driver = org.postgresql.Driver

#db.username = ${default.db.username}
#db.password = ${default.db.password}
db.username = dspace
db.password = abrakadabra

mail.server = smtp.tu.edu.te.ua
mail.from.address = serhij dubyk@ts tu.edu.ua
feedback.recipient = serhij dubyk@ts tu.edu.ua
mail.admin = serhij dubyk@ts tu.edu.ua
alert.recipient = serhij dubyk@ts tu.edu.ua
registration.notify = serhij dubyk@ts tu.edu.ua
mail.charset = UTF8

== Тека /dspace ==

sudo mkdir /dspace
sudo chown dspace /dspace

== Побудова maven-пакунка ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace
mvn package

При цьому звантажуються файли *.jar та *.pom, а у виводі можна побачити щось на кшталт наступного:

…
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-shared-io/1.1/maven-shared-io-1.1.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-filtering/1.0/maven-filtering-1.0.jar
Downloading: http://repo1.maven.org/maven2/org/apache/maven/shared/maven-repository-builder/1.0-alpha-2/maven-repository-builder-1.0-alpha-2.jar
[INFO] [assembly:directory-single {execution: default}]
[INFO] Reading assembly descriptor: src/assemble/assembly.xml
[WARNING] Cannot include project artifact: org.dspace:dspace:pom:1.8.1; it doesn't have an associated file or directory.
[WARNING] The following patterns were never triggered in this artifact exclusion filter:
[WARNING] NOTE: Currently, inclusion of module dependencies may produce unpredictable results if a version conflict occurs.
[INFO] Copying files to /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
[INFO]
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] ------------------------------------------------------------------------
[INFO] DSpace Addon Modules .................................. SUCCESS [1:49.420s]
[INFO] DSpace XML-UI (Manakin) :: Web Application ............ SUCCESS [3:01.210s]
[INFO] DSpace LNI :: Web Application ......................... SUCCESS [12.231s]
[INFO] DSpace OAI :: Web Application ......................... SUCCESS [6.012s]
[INFO] DSpace JSP-UI :: Web Application ...................... SUCCESS [13.066s]
[INFO] DSpace SWORD :: Web Application ....................... SUCCESS [3.177s]
[INFO] DSpace SWORDv2 :: Web Application ..................... SUCCESS [34.394s]
[INFO] DSpace SOLR :: Web Application ........................ SUCCESS [18.529s]
[INFO] DSpace Assembly and Configuration ..................... SUCCESS [56.354s]
[INFO] ------------------------------------------------------------------------
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 7 minutes 15 seconds
[INFO] Finished at: Fri Feb 17 14:02:02 EET 2012
[INFO] Final Memory: 61M/205M
[INFO] ------------------------------------------------------------------------

== Встановлення ==

cd /home/dspace/source/dspace-1.8.1-src-release/dspace/target/dspace-1.8.1-build
'''ant fresh_install'''

Частина виводу:

[echo] ====================================================================
[echo] The DSpace code has been installed, and the database initialized.
[echo]
[echo] To complete installation, you should do the following:
[echo]
[echo] * Setup your Web servlet container (e.g. Tomcat) to look for your
[echo] DSpace web applications in: /dspace/webapps/
[echo]
[echo] OR, copy any web applications from /dspace/webapps/ to
[echo] the appropriate place for your servlet container.
[echo] (e.g. '$CATALINA_HOME/webapps' for Tomcat)
[echo]
[echo] * Make an initial administrator account (an e-person) in DSpace:
[echo]
[echo] /dspace/bin/dspace create-administrator
[echo]
[echo] * Start up your servlet container (Tomcat etc.)
[echo]
[echo] You should then be able to access your DSpace's 'home page':
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui
[echo]
[echo] You should also be able to access the administrator UI:
[echo]
[echo] http://elartu.tntu.edu.ua/xmlui/dspace-admin
[echo] ====================================================================
[echo]

BUILD SUCCESSFUL
Total time: 43 seconds

== Підключення DSpace-івських webapps до Tomcat ==

Найпростіший спосіб, що рекомендують, це зкопіювати:

cp -R /dspace/webapps/* /var/lib/tomcat6/webapps/

Однак було вибрано інший спосіб через редагування

sudo mc -e /var/lib/tomcat6/conf/server.xml

Зокрема необхідно у розділ „<Service name="Catalina">“ додати

<Connector port="80".
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" redirectPort="8443" acceptCount="100"
connectionTimeout="20000" disableUploadTimeout="true"

змінити localhost на elartu.tntu.edu.ua

<Engine name="Catalina" defaultHost="elartu.tntu.edu.ua">

<Host name="elartu.tntu.edu.ua" appBase="webapps"
unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false">

та перед закриваючою ознакою „</Host>“ додати наступне

<Context path="/xmlui" docBase="/dspace/webapps/xmlui" allowLinking="true"/>
<Context path="/sword" docBase="/dspace/webapps/sword" allowLinking="true"/>
<Context path="/oai" docBase="/dspace/webapps/oai" allowLinking="true"/>
<Context path="" docBase="/dspace/webapps/jspui" allowLinking="true"/>
<Context path="/lni" docBase="/dspace/webapps/lni" allowLinking="true"/>
<Context path="/solr" docBase="/dspace/webapps/solr" allowLinking="true"/>

Перезапуск Tomcat

sudo /etc/init.d/tomcat6 restart

== Дозвіл для Tomcat-у на порт 80 ==

Система не пускає tomcat на привілейований порт (80), для цього редагуємо

sudo mc -e /etc/default/tomcat6

і включаємо AUTHBIND

# If you run Tomcat on port numbers that are all higher than 1023, then you
# do not need authbind. It is used for binding Tomcat to lower port numbers.
# NOTE: authbind works only with IPv4. Do not enable it when using IPv6.
# (yes/no, default: no)
AUTHBIND=yes

== Обліковий запис адміна DSpace ==

/dspace/bin/dspace create-administrator

Вивід:

Creating an initial administrator account
E-mail address: serhi jdubyk@ts tu.edu.ua
First name: Serhij
Last name: Dubyk
WARNING: Password will appear on-screen.
Password: ************
Again to confirm: *********
Is the above data correct? (y or n): y
Administrator account created

== Права на теки „upload“ і „assetstore“ ==

sudo chown -R tomcat6 /dspace/upload
sudo chown -R tomcat6 /dspace/assetstore

== Встановлення завершено ==

УРА!!!

Можна перевірити із середини сервера:

lynx http://localhost
lynx http://localhost/xmlui

= Налаштування =

Щодо додаткових налаштувань та адаптацій див. тут: [[Налаштування DSpace]].

= Див. також =

* [[Налаштування DSpace]]
* [[Оновлення DSpace]]
* [[Додаткові поля Dublin Core для DSpace]]
* [[Встановлення ОС Debian Linux]]

= Посилання =

* wiki.duraspace.org/ „[https://wiki.duraspace.org/display/DSDOC18/Installation#Installation-Installation DSpace 1.8 Documentation » Installation]“
* scribd.com/ „[http://www.scribd.com/doc/72991669/Dspace-Installation-on-Debian-Squeeze-6-0-3 DSpace Installation on Debian Squeeze 6.0.3]“
* linuxhalwa.blogspot.com/ „[http://linuxhalwa.blogspot.com/2011/12/installing-dspace-18-on-ubuntu-1004.html Installing Dspace 1.8 on Ubuntu 10.04]“
* oracle.com/ „[http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-downloads-javase6-419409.html#jdk-6u30-oth-JPR Java SE Development Kit 6u30]“
* lightonphiri.org/ „[http://lightonphiri.org/blog/dspace-installation-on-ubuntu-10-10 DSpace Installation on Ubuntu 10.10]“
* losisin.com/ „[http://losisin.com/blog/39-blogs/71-install-dspace-on-ubuntu-server Install Dspace on Ubuntu Server]“
* thelowedown.wordpress.com/ „[http://thelowedown.wordpress.com/2010/08/17/tomcat-6-binding-to-a-privileged-port-on-debianubuntu/ Tomcat 6: Binding to a Privileged Port on Debian/Ubuntu]“
* repositorioinstitucional.wikispaces.com/ „[http://repositorioinstitucional.wikispaces.com/Manual+de+Instalaci%C3%B3n+de+DSpace Manual de Instalación de DSpace]“
* es.scribd.com/ „[http://es.scribd.com/doc/48073504/Instalacion-DSpace-en-Ubuntu Instalacion DSpace en Ubuntu]“
* dspace.2283337.n4.nabble.com/ „[http://dspace.2283337.n4.nabble.com/Dspace-File-Upload-Problem-td3286609.html Dspace: File Upload Problem]“

[[Категорія:Бібліотека]]
[[Категорія:DSpace]]