SIU-Sanaviron-Quilmes/version2.1.0/instalar sq test

Esquema de instalación del entorno de testing de SIU-Sanavirón-Quilmes

En esta sección se va a encontrar información sobre:

• Requisitos para la instalación.
• Configuración para inicializar el entorno.

Enlace de youtube: https://www.youtube.com/watch?v=spcWheegx9M&feature=youtu.be

Requisitos

Git: apt-get install git-core

Docker CE: https://docs.docker.com/engine/installation/

Docker Compose: https://docs.docker.com/compose/install/

Administrar el usuario que utilizará Docker

sudo groupadd docker

sudo usermod -a -G docker $USER

Luego reiniciar la sesión para que tome los cambios.

Instalación

Creación del entorno

1. Descarga de fuentes.
   Posicionarse en la ubicación deseada para la instalación del proyecto:
   cd /usr/local/proyectos/sanaviron_quilmes/
   El proyecto está disponible en https://hub.siu.edu.ar
   git clone -b master https://hub.siu.edu.ar/sanaviron-quilmes/testing.git
2. Creación del entorno.
   
   cd bin
   ./sq_crear_entorno_testing
   Este proceso generará las carpetas y archivos básicos para el entorno de test
3. Agente de cobranzas (MercadoPago) Es necesario generar usuarios de prueba en Mercado Pago para ingresarlo en el siguiente punto.
4. Configuración.
   En este punto configuraremos varias opciones como las credenciales para acceder a las API-Rest, si vamos a bajar los fuentes para una versión estable o desarrollo y también configuraciones para el gestor de pagos.
   Para ello editaremos el archivo instalacion.env.
   Es importante no saltear este paso ya que no podremos recibir las notificaciones del gestor de pago para dar aviso del cobro de las ventas.
   Existe un documento para validar este comportamiento si no se actualiza el estado de las ventas.
   
5. Configuración SIU-Guaraní
   El módulo SIU-Guaraní deberá tener configurados los siguientes archivos para la comunicación con los módulos SQ:
   # Gestión<br />
   <path gestion>/lib/toba/instalacion/i__desarrollo/p__guarani/rest/sanaviron/cliente.ini
   
   
   # Autogestión
   <path autogestion>/instalacion/servicios_web_config.php (apartado 'consumidos')
   <path autogestion>/instalacion/config.php ('url_sq_pagos')
   Para mayor informacion consultar la documentacion de SIU-Guarani en:
   http://documentacion.siu.edu.ar/wiki/SIU-Guarani/[version de SIU-Guarani]/interfaces/sanaviron
   Por ejemplo: http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/interfaces/sanaviron

Uso

Iniciación del entorno

La inicialización del entorno supone una instalación completa del entorno Sanavirón-Quilmes (Núcleo, Académico, G.C.O y SQ-Pagos). Por ello cada vez que iniciemos el entorno se eliminaran las instalaciones y datos existentes para dar lugar a una nueva instalación.

Para iniciar el entorno ejecutamos:

cd bin
./sq_iniciar_entorno

Luego de iniciado el entorno puede verificar el funcionamiento de los módulos ingresando en las siguientes urls:
Núcleo: http://127.0.0.1:4001/sq_nucleo/
Académico: http://127.0.0.1:4002/sq_academico/

Para conectarse a la base de datos el usuario y password es postgres:
Núcleo: puerto 4431
Académico: puerto 4433

Para ingresar a los componentes Núcleo y Académico el usuario es admin y password admin (para modo desarrollo usuario toba password toba123*-a)

Carga de datos

La inicialización del entorno se genera con los datos básicos de los componentes Núcleo y Académico. Si se desean cargar datos de una base existente, por ejemplo, de producción se pueden agregar en la siguiente estructura de directorios:

# En la siguientes carpetas puede agregar un dump sql de una base de datos (la carpeta solo admite un solo archvio sql)
testing/datos/nucleo/
testing/datos/academico/

# Dentro de las carpetas existe un directorio 'bases' que puede utilizarlo para almacenar dump's que no serán utilizados en la carga de datos.

Nota: Recuerde que al cargar los dump's de datos estos deberán se consistentes con los de los módulos SIU-Guaraní y SIU-Pilagá

Para cargar los datos ejecutamos:

cd bin
./sq_cargar_datos

Terminal de los contenedores

Para ingresar a una terminal en los contenedores puede hacerlo de la siguiente forma:

# Para listar los contenedores activos
docker ps
# En la columna NAMES se describe el nombre del contenedor

# Para ingresar a la terminal de un contenedor
cd bin
./docker-connect <nombre-contenedor>

Backup de bases de datos

Si desea guardar el estado actual de las bases de datos de SQ-Núcleo y SQ-Académico de venta puede hacerlo ejecutando el siguiente comando:

cd bin
./bash sq_bkp_datos.sh

Nota: Este comando generará dos archivos, uno en la carpeta "<path proyecto TESTING>/datos/nucleo" y otro en "<path proyecto TESTING>/datos/academico". Verifique que no exista mas de un archivo SQL en cada carpeta.