Установка

Установку и первоначальную настройку ELiS по коммерческой лицензии производит поставщик.

Администратору заказчика требуется подготовить системное окружение и согласовать архитектуру (насколько система будет распределенной).

При бесплатной лицензии организация занимается установкой и настройкой самостоятельно.

Альтернативная инструкция с записью видео установки ELiS в Hyper-V есть здесь: http://demo.elibsystem.ru/node/37631

Выбор архитектуры

Количество серверов, их производительность, объем оперативной памяти, размер и тип дисковой подсистемы выбираются исходя из типичной нагрузки на ELiS (количество запросов в секунду), количества и типов документов для хранения.

При минимальной конфигурации можно использовать один сервер.

В конфигурация с большой нагрузкой или всплесками трафика, рекомендуется разносить сервер приложений, сервер СУБД, кеширующий сервер.

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

Установка ОС

На все типы нод требуется установить CentOS8 x64 или RHEL8 x64 (желательно без GUI). В связи с использованием ПО не из репозитариев RHEL, приобретение лицензий на Red Hat Enterprise Linux существенных выгод не несет.

В целях упрощения создания резервных копий, рекомендуется разварачивать ELiS на виртуальных машинах корпоративного уровня (VMware vSphere, KVM, Xen, Hyper-V).

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

Разбиение дисков для электронной библиотеки:

  • /boot/efi 200 MБ (раздел обязателен).
  • / > 50 ГБ (раздел обязателен).
  • /var/www/files/ > (объем всех загруженных файлов)x1.3 (рекомендуется). Во избежания длительного резервного копирования не рекомендуется делать этот раздел слишком большим на физических серверах.
  • /var/cache/elis > 100 ГБ (рекомендуется). Данный раздел предназначен для кеширования отрендеренных материалов книг и презентаций и обложек. Кеш при заполнении можно чистить, все что в нем есть может быть автоматически регенерировано. Максимальный объем для книг будет равен размеру всех книг x4. Если отдельный раздел не создать, кеш может заполнить всё доступное пространство на корневом диске и вызвать сбои в работе системы.
  • /tmp > 30 ГБ (опционально).
  • /var/cache/elis/short > 4 ГБ (опционально) на SSD или tmpfs.
  • /var/log > 5 ГБ (опционально).
  • /var/lib/manticore > 10 ГБ (опционально) на SSD для поискового индекса.

При использовании модуля видеохостинга требуется добавить диск и смонтировать его:

/var/www/vh/library/sites/default/files/myvideo > (объем исходных загруженных файлов видео)

После установки ОС, требуется предоставить root-доступ к системе по SSH.

Пример простейшего разбиения дисков для небольших библиотек

  • /boot/efi 200 МБ, SSD.
  • / 50 ГБ, SSD, XFS.
  • /var/www/files 100 ГБ, HDD, XFS.
  • /var/cache/elis 30 ГБ, SSD, XFS.

Пример простейшего разбиения дисков для средних библиотек

  • /boot/efi 200 МБ, SSD.
  • / 100 ГБ, SSD, XFS.
  • /var/www/files 500 ГБ, HDD, XFS.
  • /var/cache/elis 100 ГБ, SSD, XFS.

Разбиение при наличии SSD и HDD

Разместите на SSD:

  • операционную систему;
  • базу данных;
  • временную папку.

Желательно на SSD разместить также:

  • краткосрочный кеш /var/cache/elis/short.
  • поисковый индекс /var/lib/manticore.

На HDD можно разместить:

  • файлы для долгосрочного хранения /var/www/files;
  • публичные файлы /var/www/vh/library/sites/default/files;

В примерах простейшего разбиения (см. выше) корневая директория размещается на SSD, вместе с ней на SSD оказываются база данных, сайт, временная папка, поисковый индекс.

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

Отдельный диск HDD в примерах выделен для размещения исходных файлов, которые, обычно, занимают много места.

Установка ELiS в рамках техподдержки

Поставщик выполняет установку библиотеки удаленно. Администратор обязан предоставить root-доступ ко всем серверам по SSH и открыть HTTP/HTTPS-порты, а сами сервера должны иметь подключение к интернету.

При самостоятельной установке следуйте следующей инструкции

Доступ в интернет

В процессе установки проще всего открыть все исходящие соединения. Если по политикам безопасности это невозможно, то откройте HTTP/HTTPS-доступ к следующим доменам:

  • repo.elibsystem.ru
  • elibsystem.ru
  • mirror.yandex.ru
  • repo.manticoresearch.com
  • download.postgresql.org
  • dl.fedoraproject.org
  • github.com
  • yum.oracle.com
  • nginx.org
  • packages.drupal.org
  • ftp.drupal.org
  • www.drupal.org
  • updates.drupal.org
  • drupal.org

Копирование установочных файлов

Warning

Установку следует производить на выделенном сервере или виртуальной машине.

Серверу необходимо выделить статический ip-адрес. Посмотреть текущие ip-адреса сервера можно командой ip add.

Не следует на этом сервере или виртуальной машине держать другие сайты т.к. в процессе установки будет автоматически настроен веб-сервер и база данных. Если перед установкой ELiS на сервере уже будет настроен веб-сервер или база данных под другие задачи, настройки и данные сайтов могут быть удалены.

Поставщик должен вам передать лицензионный ключ, зная который можно скачать установщик.

Во время установки и активации сервер должен быть подключен к интернету. Для дальнейшей эксплуатации интернет не требуется.

Скачайте а запустите, введя вместо XXXX-XXXX-XXXX-XXXX-XXXX-XXXX ваш лицензионный ключ.

curl https://elibsystem.ru/elisLicense/key/XXXX-XXXX-XXXX-XXXX-XXXX-XXXX/installer/install.sh | bash

Danger

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

Danger

Не запускайте повторно процедуру установки, если ранее ELiS уже была успешно установлена на сервер. Повторная установка удалит все данные предыдущей установки ELiS.

Вам потребуется один или несколько раз подтвердить выполнение операций, введя на клавиатуре y.

При установке на сервер будет скачаны, установлены, настроены PostgreSQL, nginx, php-fpm.

После установки перейдите на сайт http://hostname/ и введите логин admin и пароль, который вам выведет скрипт установки в терминал: ********.

Смените пароль пользователю admin, пройдя на сайте по URI user/1/edit.

Если вы забудете пароль администратора, его можно сбросить командой cd /var/www/vh/library; sudo -u elis /home/elis/drush/vendor/bin/drush upwd --password="NewPassword" admin

Прежде чем вы сможете использовать ELiS, её необходимо активировать с помощью лицензионного ключа по URI admin/config/content/activation, введя лицензионный ключ.

Установка завершена. Можно приступить к настройке и тестированию.

Настройка после установки

По URI admin/config/content/activation активируйте лицензию.

По URI admin/config/system/site-information укажите название сайта, введите почтовый ящик робота, от имени которого будет делаться рассылка. Вам следует настроить сервер на отправку писем, сделать это можно как штатными средствами Linux, так и с помощью внешнего модуля к Drupal SMTP (пример настройки SMTP: https://elibsystem.ru/node/307).

Необходимо принять решение как пользователи будут себя регистрировать. Штатная политика регистрации Drupal настраивается по URI admin/config/people/accounts. При использовании ELiS в организации можно разрешить регистрацию только из сети организации admin/config/content/elis (при этом надо создать в словаре Организации нужную вам организацию по URI admin/structure/taxonomy/organization и назначить ей диапазоны IP-адресов) и указать URL с инструкцией по регистрации.

Если у вас есть опция генерации подсайтов, укажите базовый домен на котором размещена библиотека по URI admin/config/content/elis_site

Заведите счётчики Яндекс.Метрики и Google Analytics и укажите идентификаторы счётчиков по URI admin/config/content/elis_stats

Если у вас есть опция книг в PDF, вы можете выбрать рендерер по-умолчанию по URI admin/config/content/ebooks

Настроить текстовый редактор и его функционал можно по URI admin/config/content/wysiwyg

Если у вас есть опция видео, вам надо добавить ноды транскодера и ноды хранения по URI admin/config/media/myvideo. Обратитесь к поставщику за консультациями.

В настройках поиска по URI admin/config/search/setting необходиму деактивировать поиск по нодам (Node) и включить поиск ELiS с помощью Sphinx (ELiSsearch). Дополнительно можно включить поиск по терминам (Term Search) и пользователям (User).

В качестве модуля поиска по-умолчанию выберите ELiSsearch.

Транслитерацию поискового индекса можно отключить.

Настройте региональные настройки по URI admin/config/regional/settings. Выберите страну по-умолчанию “Россия” и в качестве первого дня недели “понедельник”. Выберите часовой пояс по-умолчанию вашего города. Запретите пользователям выбирать часовой пояс.

Выберите формат отображения даты и времени по URI admin/config/regional/date-time

Для автоматического переключения языка между русским и английским интерфейсом можно по URI admin/config/regional/language/configure включить определение по сессии и браузеру.

Отключите тему Bartik по URI admin/appearance

На странице admin/appearance отключите переключение на административную тему при редактировании или создании материалов.

Перейдите к настройке оформления темы ELiS по URI admin/appearance/settings/elis. Отключите отображение названия сайта, слогана сайта, аватаров в сообщениях, аватаров в комментариях. В качестве настройки COLORS можно указать необходимый вам цвет фона (General theme color) и текста (General theme text color). Загрузите изображение логотипа в виде файла с высотой 144 пиксела. Лучше выбрать файл PNG с прозрачным фоном. Загрузите иконку (favicon.ico). Иконкой может быть файл PNG.

Перейдите к настройке прав пользователей по URI admin/people.

На странице admin/people/permissions/roles добавьте роль ‘librarian’ для пользователя, который будет загружать ресурсы на сайт (не рекомендуется использовать сайт от имени администратора для повседневной загрузки ресурсов).

На странице прав доступа admin/people/permissions настройте права для всех ролей. Права настраиваются индивидуально, в зависимости от ваших задач.

Посмотрите какие модули уже установлены на сайте по URI admin/modules, возможно вы захотите включить ещё какие-то модули.