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

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

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

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

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

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

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

   sadiki3@server:/srv/www/eturn/sadiki3$ buildout

Выполнение команды может занять длительное время (до 10 минут).

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

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

   [database]
   DATABASE_USER: sadiki3
   DATABASE_PASSWORD: topsecret
   DATABASE_HOST: localhost
   DATABASE_PORT: 5432
   DATABASE_NAME: sadiki3

Пароль должен совпадать с паролем, который был задан при создании пользователя СУБД

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

   [secrets]
   SECRET_KEY:
   
   [email]
   DEFAULT_FROM_EMAIL: noreply@example.com
   SERVER_EMAIL: webmaster@example.com
   
   [admin mail]
   webmaster: webmaster@example.com
   
   [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

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

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

   sadiki3@server:/srv/www/eturn/sadiki3$ bin/django collectstatic -l --noinput

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

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

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

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

4. От имени пользователя 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

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

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

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

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

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

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 указанный вами домен для системы. Должна появиться форма входа в административный раздел.

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