SIU-Sanaviron-Quilmes/version1.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/

SIU-Guaraní 3.15

SIU-Pilagá 3.0.1

Administrar el usuario que utilizará Docker

sudo groupadd docker

sudo usermod -a -G docker $USER

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 https://hub.siu.edu.ar/sanaviron-quilmes/testing.git
2. Creación del entorno.
   
   cd bin
   sudo ./sq_crear_entorno_testing
   Este proceso generará las carpetas y archivos básicos para el entorno de test
3. 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.
4. Agente de cobranzas (MercadoPago)
   Mercado Pago
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.13.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, Unidad de venta, 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
./bash 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/
Unidad de venta: http://127.0.0.1:4002/sq_uv/

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

Para ingresar a los componentes Núcleo y Unidad de venta 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 Unidad de venta. 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/unidad-venta/

# 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
sudo ./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
sudo 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-Unidad de venta puede hacerlo ejecutando el siguiente comando:

cd bin
sudo ./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/unidad-venta". Verifique que no exista mas de un archivo SQL en cada carpeta.