Manual de instalación en Ubuntu

Prerrequisitos

Para poder usar Graph Log Education se necesita tener instalado Python 3, esto viene de serie en las últimas versiones de Ubuntu, pero se recomienda usar un gestor como es Anaconda https://www.anaconda.com/download/.

Una vez instalado el gestor, se ejecuta el entorno grafico “Anaconda Navigator” que permite crear un Enviroment para todos los paquetes de la herramienta. Debido a lo anterior en partes posteriores de este manual se hace referencia al Enviroment por el nombre de TFG.

Otro requisito previo es tener instalado un sistema de base de datos SQL. Se recomienda usar PostgreSQL https://www.postgresql.org/download/ por ser la opción configurada en esta herramienta. No obstante si ya dispone de un sistema de base de datos SQL, puede usarlo si es compatible con Django, https://docs.djangoproject.com/en/2.0/ref/databases/ cambiando la configuración de la herramienta que se indica en la sección Opciones y ejecución de este manual.

Descarga

Para descargar el código fuente se visita el repositorio del proyecto, https://github.com/Yyandrakk/GraphLogEducation/releases donde se debe descarga la versión 1.0 “Primera Versión”. Una vez descargado se descomprime el código fuente en una carpeta.

En esa carpeta se abre una terminal y se ejecutan los siguientes comandos:

$ source activate TFG

(TFG) $ pip install -r requirements.txt

El primer comando activa el Enviromente y el segundo descargara todos los paquetes necesarios para el funcionamiento de la herramienta.

Opciones y ejecución

Antes de poder ejecutar nada hay que cambiar las opciones de Graph Log Education para poder conectarnos a la base de datos antes instalada y la Secret Key. Pero antes de modificar la configuración hay que tener en cuenta la visibilidad del código que vamos a modificar.

En el caso de que el código con los cambios, vaya a alojarse en un servidor de acceso público se recomienda el uso de variables de entorno o si el servidor es de acceso es privado, se pueden poner directamente.

Para modificar las opciones se abre el fichero GraphLogEducation/settings.py, donde se localizara las variables DATABASES y SECRET_KEY como se puede observar en la Figura: Opciones a cambiar.

La variable DATABASES se rellena con los datos de instalación de PostgreSQL o del gestor de base de datos SQL que tenga instalado.

Para obtener una nueva secret Key usaremos la terminal:

(TFG) $ python

>> from django.core.management.utils import get_random_secret_key

>> print(get_random_secret_key())

Se copia la combinación de caracteres que sale en pantalla y se asigna a la variable SECRET_KEY.

Por último, se ejecutan los siguientes comandos:

(TFG) $ python manage.py makemigrations

(TFG) $ python manage.py migrate

(TFG) $ python manage.py runsslserver {IP de la maquina}

Este último comando nos da un enlace para poder ingresar en el navegador.