From c989e8e066453595f88893f836601732ca3a7ac3 Mon Sep 17 00:00:00 2001 From: Dmitry Shelepnev <mitshel@mail.ru> Date: Sun, 8 Jan 2017 16:57:41 +0300 Subject: [PATCH] Update README.md --- README.md | 30 +++++++++++++++++------------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 52d396e..e74bc5c 100644 --- a/README.md +++ b/README.md @@ -15,10 +15,11 @@ - Django 1.9 (для Python 3.3 необходимо устанавливать Django 1.8: https://code.djangoproject.com/ticket/25868) - Pillow 2.9.0 - apscheduler 3.3.0 +- django-constance[database] 1.3 Для работы проекта необходимо установить указанные зависимости: - yum install python3 # команда установки для RedHad, Fedora, CentOS + yum install python3 # команда установки для RedHad, Fedora, CentOS python3 -m pip install -r requirements.txt 1.3 Настраиваем ./sopds/settings.py (настройки в конце файла) @@ -34,14 +35,14 @@ python3 manage.py createsuperuser -1.6 Настраиваем путь к Вашему каталогу с книгами (Однако Вы можете сначала запустить sopds_server согласно п.1.8. и настроить указанный параметр через веб-интерфейс) +1.6 Настраиваем путь к Вашему каталогу с книгами python3 manage.py sopds_util setconf SOPDS_ROOT_LIB 'Путь к каталогу с книгами' -1.7 Вручную запускаем разовое сканирование коллекции книг -(Выполняется относительно долго: например, моя коллекция книг в архивах объемом 180Гб сканировалась в БД MYSQL - 1час) +1.7 Запускаем SCANNER сервер (опционально, необходим для автоматизированного периодического пересканирования коллекции) + Примите во внимание, что в настройках по умолчанию задан периодический запуск сканирования 2 раза в день 12:00 и 0:00. - python3 manage.py sopds_scanner scan --daemon + python3 manage.py sopds_scanner start --daemon 1.8 Запускаем встроенный HTTP/OPDS сервер @@ -50,15 +51,18 @@ Однако наилучшим способом, все же является настройка в качестве HTTP/OPDS серверов Apache или Nginx (точка входа ./sopds/wsgi.py) -1.9 Запускаем SCANNER сервер (опционально, необходим для автоматизированного периодического пересканирования коллекции) -Перед запуском SCANNER сервера необходимо убедится, что сканирование, запущеное в п.1.6 уже завершено, -т.к. может возникнуть ситуация с запуском параллельного процесса сканирования, что может привести к ошибкам. -Примите во внимание, что в настройках по умолчанию задан периодический запуск сканирования 2 раза -в день 12:00 и 0:00. +1.9 Чтобы не дожидаться начала сканирования по расписанию, можно сообщить процессу sopds_scanner о необходимости + немедленного сканирования. Сделать это можно, установив конфигурационный параметр SOPDS_SCAN_START_DIRECTLY = True + двумя способами: - python3 manage.py sopds_scanner start --daemon +а) из консоли при помощи команды + + python3 manage.py sopds_util setconf SOPDS_SCAN_START_DIRECTLY True + +б) При попомощи страницы администрирования Web-интерфейса http://<Ваш сервер>:8001/admin/ + (Далее CONSTANCE -> Настройки -> 1. General Options -> SOPDS_SCAN_START_DIRECTLY) -1.9 Доступ к информации +1.10 Доступ к информации Если все предыдущие шаги выполнены успешно, то к библиотеке можно получить доступ по следующим URL: > OPDS-версия: http://<Ваш сервер>:8001/opds/ @@ -66,7 +70,7 @@ Следует принять во внимание, что по умолчанию в проекте используется простая БД sqlite3, которая является одно-пользовательской. Поэтому пока не будет завершен процесс сканирования, запущенный -ранее пунктом 1.6 попытки доступа к серверу будут завершаться ошибкой +ранее попытки доступа к серверу могут завершаться ошибкой "A server error occurred. Please contact the administrator." Для устранения указанной проблемы необходимо ипользовать многопользовательские БД, Например MYSQL. -- GitLab