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

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.13

SIU-Pilagá 3.0.1

Instalación

Creación del entorno

1. Posicionarse en la ubicación deseada para la instalación del entorno de testing:

1. 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

1. Ahora tenemos el path:

   /usr/local/proyectos/sanaviron_quilmes/testing/

   Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto TESTING>.

Crear archivo de configuración

cp <path proyecto TESTING>entorno.env.template <path proyecto TESTING>entorno.env

Una vez descargado, ejecutar en la carpeta 'bin' del mismo:

<path proyecto TESTING>/bin/bash sq_crear_entorno_testing

Configuración

Agente de cobranzas

• Mercado Pago

Entorno SQ

Editar el archivo <path proyecto TESTING>entorno.env y definir los siguientes valores:

# Configuraciones
#=======================================
export DISPOSITIVO_RED='eth0';
export DISPATCHER_ACTIVO=true;
export DISPATCHER_URL='http://IP_PUBLICA/dispatcher_notificacion_mp.php?sender=';

# Pilaga
#=======================================
export API_PILAGA_URL='http://127.0.0.1/pilaga/rest/';
export API_PILAGA_USUARIO='toba';
export API_PILAGA_PASSWORD='toba';
export API_PILAGA_METHOD='digest';

# Guarani
#=======================================
export API_GUARANI_URL='http://127.0.0.1/guarani/3.13/rest/';
export API_GUARANI_USUARIO='toba';
export API_GUARANI_PASSWORD='toba';
export API_GUARANI_METHOD='digest';

# MercadoPago
#=======================================
export MP_CLIENT_ID=1111111111111111;
export MP_CLIENT_SECRET=AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA;

SIU-Guaraní

El módulo SIU-Guaraní deberá tener configurados los siguientes archivos para la comunicación con los módulos SQ:

# Gestión
<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

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:

# Opcionalmente podemos iniciar con una versión especifica, por ejemplo la versión 1.0.8
<path proyecto TESTING>/bin/bash sq_iniciar_entorno 1.0.8

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

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)
<path proyecto TESTING>/datos/nucleo/
<path proyecto 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:

<path proyecto TESTING>/bin/bash 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
<path proyecto TESTING>/bin/sh 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:

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