Instalación en Ubuntu Server 18.04 LTS

Todas las instrucciones de este documento se deben ejecutar con permisos elevados

Preparando el Entorno

El primer paso es preparar un entorno de desarrollo Python en nuestro sistema, para ello instalamos los siguientes paquetes:

apt-get update && apt-get install python-virtualenv python-pip libxml2-dev libxslt-dev python-libxml2 python-dev lib32z1-dev git

Entre otras cosas se ha instalado el paquete python-virtualenv ya que la instalación la haremos sobre un entorno virtual de Python, si tienes curiosidad sobre esto, visita este enlace.

Nos colocamos en el directorio donde instalaremos la aplicación y clonamos el repositorio del proyecto.

cd /opt && sudo git clone https://github.com/ctrl-alt-d/django-aula.git djau2018 && cd djau2018

Es recomendable que la carpeta contenga el año del curso, ya que la aplicación esta diseñada para ser instalada de nuevo en cada curso (Decisión de diseño).

El siguiente paso es montar nuestro entorno virtual Python sobre la carpeta del proyecto, este comando creará un entorno virtual en un directorio llamado venv.

djau@djau:/opt/djau2018#  virtualenv --python=/usr/bin/python2.7 venv

Una vez creado el entorno virtual debemos activarlo, para ello ejecutamos:

djau@djau:/opt/djau2018# source venv/bin/activate

Si todo ha ido bien el prompt debería haber cambiado a algo parecido a:

(venv) djau@djau:/opt/djau2018$

Ahora que ya tenemos el entorno virtual el siguiente paso es instalar las dependencias del proyecto, para ello utilizaremos el gestor de dependencias pip

(venv) djau@djau:/opt/djau2018# pip install -r requirements.txt

Instalación de Apache y Base de datos

Antes de seguir con la aplicación, instalaremos Apache y el módulo wsgi para que pueda servir nuestra aplicación Python a través de él.

Además instalaremos la base de datos que usará django-aula y su conector python correspondiente, se recomienda instalar la aplicación sobre postgresql pero también es posible hacerlo sobre Mysql.

Postgresql:

apt-get install apache2 libapache2-mod-wsgi python-psycopg2 postgresql

Mysql:

apt-get install apache2 libapache2-mod-wsgi python-mysqldb mysql-server

Una vez elegido el motor de base de datos, hay que crear la base de datos de la aplicación, y crear un usuario que la pueda administrar.

 passwd postgres
 su postgres
 psql
 CREATE DATABASE djau2018;
 
CREATE USER djau2018 WITH PASSWORD 'XXXXXXXXXX';
 
GRANT ALL PRIVILEGES ON DATABASE djau2018 TO djau2018;

Configurando Aplicación

Django Aula tiene 3 archivos principales de configuración

  • settings_local.py (Aquí esta la configuración principal)

  • settings.py (Aquí se encuentra la parametrización Custom de la app) más info. aqui

  • wsgi.py (Es el script que se encargará de levantar la aplicación, Apache utilizará este archivo para servir la app a través de él).

A continuación dejo una configuración válida para los 3 archivos citados anteriormente, simplemente copia, pega y adáptalo a tus necesidades.

Los archivos están comentados para entenderlos mejor.

# This Python file uses the following encoding: utf-8
# Django settings for aula project.

from settings_dir.common import *

#En Producion dejar en False
DEBUG = False

#Informacion del Centro
NOM_CENTRE = 'Institut Badia'
LOCALITAT = u"Badia Del Valles"

#URL Por donde contestara la apliacion (Cambiar schema a https si se activa el trafico TSL)
URL_DJANGO_AULA = r'http://djau.local'

#HOSTS que tendran acceso a la Aplicacion (Por defecto '*' permite a todos los equipos con acceso a la maquina,usar la aplicacion)
#Puedes colocar direciones en formato CIDR o dominios, tambien se aceptan Wildcards
ALLOWED_HOSTS = [ '*', ]


ACCES_RESTRINGIT_A_GRUPS = None

#Datos del usuario administrador
ADMINS = (
    ('admin', 'juan@xtec.cat'),
)

#Configuracion del Correo Relay SMTP de la Aplicacion
EMAIL_HOST='smtp.gmail.com'
EMAIL_HOST_USER='juan@xtec.cat'
EMAIL_HOST_PASSWORD='xxxx xxxx xxxx xxxx'
DEFAULT_FROM_EMAIL = 'Institut Badia <no-reply@ibadia.cat>'
EMAIL_PORT=587
EMAIL_USE_TLS=True
SERVER_EMAIL='ibadia@xtec.cat'
EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_SUBJECT_PREFIX = '[Comunicacio Institut Badia del Valles] '

#Activar si se activa el trafico HTTPS
SESSION_COOKIE_SECURE=False

SESSION_EXPIRE_AT_BROWSER_CLOSE = True
CSRF_COOKIE_SECURE=False

#Configuracion del Arbol de Prediccion (Si no eres experto no lo toques)
location = lambda x: os.path.join(PROJECT_DIR, x)
BI_DIR = '/opt/djau2018/aula/apps/BI/PMML'
__PREDICTION_TREE_TMP = os.path.join( BI_DIR, 'previsioPresencia.pmml' )
from lxml import etree
PREDICTION_TREE = etree.parse( __PREDICTION_TREE_TMP )

INSTALLED_APPS  = [] + INSTALLED_APPS

#Ruta donde almacenara los assets de la aplicacion
STATICFILES_DIRS =  STATICFILES_DIRS
STATIC_ROOT= os.path.join(PROJECT_DIR,'static/')



#Comprime los assets estaticos de la app False por defecto
COMPRESS_ENABLED = False

#Passphrase que usara la app para cifrar las credenciales
SECRET_KEY = 'changeit'
CUSTOM_RESERVES_API_KEY = 'sxxxxxxm'

#Componente que utilizara  Django para serializar los objetos
SESSION_SERIALIZER='django.contrib.sessions.serializers.PickleSerializer'

#Configuracion de la Base de datos
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2', #django.db.backends.mysql *para mysql
        'NAME': 'djau2018',
        'USER': 'djau2018',
        'PASSWORD': "secret",
        'HOST': 'localhost',
        'PORT': '5432',
    }
}

Con los archivos de configuración listos es momento de mapear los modelos del proyecto django hacia nuestra base de datos, es decir vamos a crear las tablas de la aplicación, empezaremos a ver cómo se crean todas las tablas, no debe dar ningún error.

 djau@djau:/opt/djau2018# python manage.py migrate

Ahora que tenemos las tablas creadas, hay que llenarlas con algunos datos esenciales para que la app arranque, para ello ejecutamos el siguiente script:

djau@djau:/opt/djau2018# bash scripts/fixtures.sh

Es muy posible que dé algún Warning, simplemente ignóralo, recuerda que esta aplicación aún está en desarrollo.

Ahora debemos crear un usuario administrador que pueda gestionar la app, para ello ejecutamos:

djau@djau:/opt/djau2018# python manage.py createsuperuser

Nos pedirá el nombre del usuario y su contraseña (en este ejemplo lo he llamado admin).

Para que nuestro administrador pueda iniciar sesión en la aplicación, debe de estar en el grupo de dirección,profesores y profesional de la base de datos, para ello abrimos una shell de django y escribimos línea a línea lo siguiente:

djau@djau:/opt/djau2018# python manage.py shell

from django.contrib.auth.models import User, Group
g1 = Group.objects.get( name = 'direcció' )
g2 = Group.objects.get( name = 'professors' )
g3 = Group.objects.get( name = 'professional' )
a = User.objects.get( username = 'admin' )
a.groups = [ g1,g2,g3 ]
a.save()
quit()

Como paso final de configuración, vamos a juntar todo el contenido estático (js,css..etc) del proyecto a un solo directorio, para que la instalación sea mas limpia. Más información sobre el contenido estático en django aqui.

djau@djau:/opt/djau2018# python manage.py collectstatic

Esto generará un directorio llamado static donde se alojarán todos los assets de la aplicación.

Configurando Apache para que sirva la app

Si se ha seguido al pie de la letra este manual, simplemente hay que crear un nuevo Virtualhost en Apache que sirva nuestra app por el protocolo WSGI.

El primer escenario es para servir la app por el puerto 80 (http),

El segundo escenario sirve la app por SSL (https)

<VirtualHost *:80>
        ServerAdmin juan@xtec.cat
        ServerName djau.local
        
        #Ruta del demonio WSGI (utilizamos nuestro virtualenv)
        WSGIDaemonProcess djau python-path=/opt/djau2018:/opt/djau2018/venv/lib/python2.7/sites-packages
        WSGIProcessGroup djau
        #Script que arrancara la aplicacion wsgi
        WSGIScriptAlias / /opt/djau2018/aula/wsgi.py
        
        #Alias para contenido estatico de la app
        
        Alias /site-css/admin /opt/djau2018/aula/static/admin/
        Alias /site-css /opt/djau2018/aula/static/

        ErrorLog /var/log/apache2/djau_error.log

        #Dando acceso a apache a los directorios de la app
        <Directory /opt/djau2018/aula>
                <Files wsgi.py>
                        Require all granted
                </Files>
        </Directory>

        <Directory /opt/djau2018/aula/static/>
                Require all granted
        </Directory>


        <Directory /opt/djau2018/aula/static/admin/>
                Require all granted
        </Directory>

        LogLevel warn

        CustomLog /var/log/apache2/djau_access.log combined

        BrowserMatch ".*MSIE.*" \
                nokeepalive ssl-unclean-shutdown \
                downgrade-1.0 force-response-1.0

</VirtualHost>

Una vez creado el VirtualHost, deshabilitamos el Vhost que trae por defecto Apache para que no nos de problemas y reiniciamos el servidor web

djau@djau:# a2dissite 000.default.conf
djau@djau:# service apache2 reload

Si todo ha ido bien, la aplicación ya esta desplegada en producción , si accedemos a su dominio en mi caso "http://djau.local" o "https://djau.local" según escenario, deberá abrirse el Panel de Login de Django-Aula. ¡Felicidades!

Post Instalación

Es recomendable programar los siguientes Scripts en Cron:

CronTab
0,20,40 * * * * su - djau /opt/djau2018/backup-bdd-2018.sh42 8,9,10,11,12,13,14,15,16,17,18,19,20,21 * * 1,2,3,4,5 su - www-data -c "/opt/djau2018/scripts/notifica_families.sh" >> /opt/django/log/notifica_families_`/bin/date +\%Y_\%m_\%d`.log 2>&141 00 * * 1,2,3,4,5 su - www-data -c "/opt/djau2018/scripts/preescriu_incidencies.sh" >> /opt/django/log/prescriu_incidencies_`/bin/date +\%Y_\%m_\%d`.log 2>&120,50 * * * 1,2,3,4,5 su - www-data -c "/opt/djau2018/scripts/sortides_sincronitza_presencia.sh" >>  /opt/django/log/sincro_presencia_`/bin/date +\%Y_\%m_\%d`.log 2>&1

Están creados todos los scripts menos el siguiente, créalo y dale permisos de ejecución.

/opt/django/backup-bdd-2018.sh
#!/bin/bash
ara=`/bin/date +%Y%m%d%H%M`
hora=`/bin/date +%H`
dia=`/bin/date +%d`
mes=`/bin/date +%Y%m`
directori="/opt/django/djauBK/"
copia="${directori}bdd-ara-${ara}.sql"
extensio=".bz2"
mkdir $directori
/usr/bin/pg_dump -U djau2018 djau2018 > $copia
/bin/bzip2 $copia
cat "${copia}${extensio}" > "${directori}bdd-hora-${hora}.sql${extensio}" 
cat "${copia}${extensio}" > "${directori}bdd-dia-${dia}.sql${extensio}" 
cat "${copia}${extensio}" > "${directori}bdd-mes-${mes}.sql${extensio}" 
rm $copia${extensio}

PreviousInstalaciónNextManual del Administrador

Last updated