Skip to content

Latest commit

 

History

History
205 lines (133 loc) · 11.4 KB

README.rst

File metadata and controls

205 lines (133 loc) · 11.4 KB
Raw

Требования к программному обеспечению

Операционная система - Debian GNU/linux 6.0 («Squeeze»)

Установленное ПО:

  • веб-сервер Apache
  • СУБД PostgreSQL
  • Интерпретатор Python версии 2.6

1. Подготовка

  1. Для установки системы «Электронная очередь в ДОУ» потребуется наличие следующих системных пакетов:

    • postgresql-8.4-postgis
    • proj
    • libpq-dev
    • python-psycopg2
    • python-crypto
    • python-reportlab
    • python-imaging
    • python-gdal
    • libapache2-mod-wsgi
    • python-setuptools
    • wkhtmltopdf
    • Команду buildout лучше устанавливать не из дистрибутива, а командой sudo easy_install zc.buildout так как Debian пакет python-zc.buildout работает с python 2.5. Для корректной работы системы нужен python 2.6*

  2. Создайте нового системного пользователя и группы sadiki3 без указания пароля с домашней директорией /srv/www/eturn/:

    adduser --system --group --disabled-password --home=/srv/www/eturn/ --shell /bin/bash sadiki3

  3. Необходимо настроить географические расширения для СУБД. Для этого необходимо от имени пользователя postgres выполнить команды:

    $ POSTGIS_SQL_PATH=`pg_config --sharedir`/contrib/postgis-1.5
$ createdb -E UTF8 template_postgis
$ createlang -d template_postgis plpgsql
$ psql -d postgres -c "UPDATE pg_database SET datistemplate='true' WHERE datname='template_postgis';"
$ psql -d template_postgis -f $POSTGIS_SQL_PATH/postgis.sql
$ psql -d template_postgis -f $POSTGIS_SQL_PATH/spatial_ref_sys.sql
$ psql -d template_postgis -c "GRANT ALL ON geometry_columns TO PUBLIC;"
$ psql -d template_postgis -c "GRANT ALL ON geography_columns TO PUBLIC;"
$ psql -d template_postgis -c "GRANT ALL ON spatial_ref_sys TO PUBLIC;"

  4. От имени пользоателя postgres cоздайте нового пользователя СУБД с паролем, без прав создания пользователей и баз, и принадлежащую ему пустую базу данных в PostgreSQL. Важно указать шаблон базы данных template_postgis. Например:

    createuser -SRDP sadiki3
createdb sadiki3 -T template_postgis -O sadiki3

2. Установка дистрибутива

Установка дистрибутива выполняется под учётной записью sadiki3.

  1. Скачайте дистрибутив sadiki3.tar.gz и распакуйте его содержимое в папку /srv/www/eturn/sadiki3/.

  2. Создайте рабочее окружение buildout с помощью команды buildout в каталоге sadiki3:

    sadiki3@server:/srv/www/eturn/sadiki3$ buildout
Выполнение команды может занять длительное время (до 10 минут).

  1. Переименуйте файл в проекте sadiki/production.py.example в sadiki/production.py.

  2. Настройте параметры соединения с СУБД. Для этого укажите параметры соединения с сервером баз данных в файле /srv/www/eturn/sadiki3/eturn-django-settings.ini следующим образом:

    [database]
DATABASE_USER: sadiki3
DATABASE_PASSWORD: topsecret
DATABASE_HOST: localhost
DATABASE_PORT: 5432
DATABASE_NAME: sadiki3
Пароль должен совпадать с паролем, который был задан при создании пользователя СУБД

  1. Настройка параметров системы. Необходимо добавить в конфигурационный файл /srv/www/eturn/sadiki3/eturn-django-settings.ini следующие строки:

    [secrets]
SECRET_KEY:

[email]
DEFAULT_FROM_EMAIL: [email protected]
SERVER_EMAIL: [email protected]

[admin mail]
webmaster: [email protected]

[options]
MUNICIPALITY_OCATO: 75401376000
EMAIL_KEY_VALID: 3
MAX_CHILD_AGE: 7
NEW_YEAR_START: 31 12
APPEAL_DAYS: 30

[map]
TILES_URL: http://{s}.somedomain.com/{z}/{x}/{y}.png
TILES_SUBDOMAINS: subdomain1 subdomain2
  • SECRET_KEY секретный ключ, можно получить запустив в консоли команду bin/django get_secret_key
  • DEFAULT_FROM_EMAIL адрес с которого будут отсылаться электронные сообщения
  • SERVER_EMAIL адрес с которого будут отсылаться сообщения об ошибках
  • webmaster адрес на который будут высылаться сообщения об ошибках
  • MUNICIPALITY_OCATO номер окато муниципалитета
  • EMAIL_KEY_VALID количество дней в течении которых активна ссылка для подтверждения почты или сброса пароля
  • MAX_CHILD_AGE максимальный возратс ребенка в годах
  • NEW_YEAR_START дата с коротой можно начать учебный год в формате "ДД ММ"
  • APPEAL_DAYS количество дней на обжалование при неявке на зачисление
  • TILES_URL - шаблон url сервера карт, {s}-подомен, выбираемый произвольным образом из списка TILES_SUBDOMAINS, {x},{y}-координаты,{z}-масштаб
  • TILES_SUBDOMAINS - список поддоменов, разделенных пробелом

Если вы не хотите указывать свой сервер карт, то нужно удалить раздел map, при этом будет использоваться стандартный сервер tile.openstreetmap.org

3. Настройка веб-сервера

Ниже приведены инструкции для настройки сервера Apache. Для других веб-серверов настройки выполняются аналогично, согласно документации веб-сервера.

  1. В директории /srv/www/eturn/sadiki3/ от имени пользователя sadiki3 выполните команду:

    sadiki3@server:/srv/www/eturn/sadiki3$ bin/django collectstatic -l --noinput
В результате в текущей директории должна появиться папка /static/ с символическими ссылками для статичных файлов проекта (каскадные таблицы стилей, файлы Javascript).

  1. Скопируйте в папку Apache конфигурационный файл apache_sample_conf, если Вы хотите, чтобы система была доступна по доменному имени или apache_sample_conf_local, если ваш сайт будет доступен только на локальном компьютере пользователя. Переименуйте скопированный конфигурационный файл в sadiki3 В конфигурационном файле необходимо заменить <site.tld> на ваш домен и <name> на имя пользователя("sadiki3").

    root@server: cp apache_sample_conf /etc/apache2/sites-available/sadiki3

  2. Создайте папку для хранения логов, которая указана в конфигурационном файле(по умолчанию каталог с логами /var/log/apache2/). Владельцм должен быть root и у файла дожны быть установлены права 740.

  3. От имени пользователя sadiki3 cоздайте папку public_html в домашней папке пользователя sadiki3 и создайте символьные ссылки на sadiki3/bin/django.wsgi, sadiki3/static/ и sadiki/media/upload:

    sadiki3@server:/srv/www/eturn/$ mkdir public_html
sadiki3@server:/srv/www/eturn/$ ln -s /srv/www/eturn/sadiki3/bin/django.wsgi public_html/django.wsgi
sadiki3@server:/srv/www/eturn/$ mkdir public_html/media
sadiki3@server:/srv/www/eturn/$ ln -s /srv/www/eturn/sadiki3/media/upload public_html/media/upload
sadiki3@server:/srv/www/eturn/$ ln -s /srv/www/eturn/sadiki3/static/ public_html/static

  4. От имени пользователя sadiki3 cоздайте папку для загружаемых файлов /srv/www/eturn/sadiki3/media/upload

  5. Для выполнения фоновых задач системы задайте расписание для команд.

    Пример файла cron:

    crontab -lu sadiki3

# m h  dom mon dow   command
  1 *       *   *   *    /srv/www/eturn/sadiki3/bin/django <command>

Описание команд см. ниже.

4. Начальное наполнение базы данных

  1. В директории /srv/www/eturn/sadiki3/ от имени пользователя sadiki3 выполните команды:

    sadiki3@server:/srv/www/eturn/sadiki3$ bin/django syncdb --noinput --migrate
sadiki3@server:/srv/www/eturn/sadiki3$ bin/django loaddata sadiki/core/fixtures/deploy_data.json
sadiki3@server:/srv/www/eturn/sadiki3$ bin/django updatepermissions

  2. Создайте суперпользователя с помощью команды:

    sadiki3@server:/srv/www/eturn/sadiki3$ bin/django create_administrator

  3. Активируйте созданную конфигурацию Apache.:

    root@server:/home/root$ a2ensite sadiki3

  4. Активируйте модуль mod_rewrite и перезапустите Apache

    root@server:/home/root$ a2enmod rewrite
root@server:/home/root$ apachectl restart

  5. Откройте в браузере страницу: http://example.com/adm, где вместо example.com указанный вами домен для системы. Должна появиться форма входа в административный раздел.

6. Описание системных команд

confirmation_expire

Команда удаления заявок без документального подтверждения. Запуск - ежедневно.

/srv/www/eturn/sadiki3/bin/django confirmation_expire

auto_change_status

Команда автоматического отслеживания сроков явки. Запуск - ежедневно.

/srv/www/eturn/sadiki3/bin/django auto_change_status

create_reports

Команда создания отчётов. Запуск - ежеквартально.

/srv/www/eturn/sadiki3/bin/django create_reports