Diferencia entre revisiones de «SIU-Sanaviron-Quilmes/version1.1.0/instalar sq test»

De SIU
Saltar a: navegación, buscar
(Uso)
 
(No se muestran 9 ediciones intermedias de 2 usuarios)
Línea 19: Línea 19:
 
Docker Compose: https://docs.docker.com/compose/install/
 
Docker Compose: https://docs.docker.com/compose/install/
  
SIU-Guaraní 3.13
+
SIU-Guaraní 3.15
  
 
SIU-Pilagá 3.0.1
 
SIU-Pilagá 3.0.1
 +
 +
'''Administrar  el usuario que utilizará  Docker'''
 +
 +
<code>sudo groupadd docker</code>
 +
 +
<code>sudo usermod -a -G docker $USER</code>
 +
 +
Luego reiniciar la sesión para que tome los cambios.
  
 
== Instalación ==
 
== Instalación ==
 
'''Creación del entorno'''
 
'''Creación del entorno'''
#Descarga de fuentes.   Posicionarse en la ubicación deseada para la instalación del proyecto:<source lang="php" enclose="div">cd /usr/local/proyectos/sanaviron_quilmes/</source>El proyecto está disponible en [https://hub.siu.edu.ar/SIU https://hub.siu.edu.ar]<syntaxhighlight lang="bash" enclose="div">
+
#Descarga de fuentes.<br />Posicionarse en la ubicación deseada para la instalación del proyecto:<source lang="php" enclose="div">cd /usr/local/proyectos/sanaviron_quilmes/</source>El proyecto está disponible en [https://hub.siu.edu.ar/SIU https://hub.siu.edu.ar]<syntaxhighlight lang="bash" enclose="div">
 
git clone https://hub.siu.edu.ar/sanaviron-quilmes/testing.git
 
git clone https://hub.siu.edu.ar/sanaviron-quilmes/testing.git
 
</syntaxhighlight>
 
</syntaxhighlight>
#Creación del entorno.<source lang="php" enclose="div">
+
#Creación del entorno.<br /><source lang="php" enclose="div">
sudo ./bin/sq_crear_entorno_testing
+
cd bin
 +
./sq_crear_entorno_testing
 
</source>Este proceso generará las carpetas y archivos básicos para el entorno de test
 
</source>Este proceso generará las carpetas y archivos básicos para el entorno de test
#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.
+
#Agente de cobranzas (MercadoPago) Es necesario generar usuarios de prueba en [[SIU-Sanaviron-Quilmes/version1.1.0/mercado.pago|Mercado Pago]] para ingresarlo en el siguiente punto.
#Agente de cobranzas (MercadoPago)  [[SIU-Sanaviron-Quilmes/version1.1.0/mercado.pago|Mercado Pago]]
+
#Configuración.<br />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.
#Configuración SIU-Guaraní El módulo SIU-Guaraní deberá tener configurados los siguientes archivos para la comunicación con los módulos SQ:<syntaxhighlight lang="bash" enclose="div">
+
#Configuración SIU-Guaraní<br />El módulo SIU-Guaraní deberá tener configurados los siguientes archivos para la comunicación con los módulos SQ:<syntaxhighlight lang="bash" enclose="div">
# Gestión
+
# Gestión<br />
 
<path gestion>/lib/toba/instalacion/i__desarrollo/p__guarani/rest/sanaviron/cliente.ini
 
<path gestion>/lib/toba/instalacion/i__desarrollo/p__guarani/rest/sanaviron/cliente.ini
  
Línea 43: Línea 52:
 
</syntaxhighlight>Para mayor informacion consultar la documentacion de SIU-Guarani en:<syntaxhighlight lang="bash" enclose="div">
 
</syntaxhighlight>Para mayor informacion consultar la documentacion de SIU-Guarani en:<syntaxhighlight lang="bash" enclose="div">
 
http://documentacion.siu.edu.ar/wiki/SIU-Guarani/[version de SIU-Guarani]/interfaces/sanaviron
 
http://documentacion.siu.edu.ar/wiki/SIU-Guarani/[version de SIU-Guarani]/interfaces/sanaviron
</syntaxhighlight>Por ejemplo: [[SIU-Guarani/version3.13.0/interfaces/sanaviron|http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.13.0/interfaces/sanaviron]]
+
</syntaxhighlight>Por ejemplo: [[SIU-Guarani/version3.15.0/interfaces/sanaviron|http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/interfaces/sanaviron]]
  
 
==Uso==
 
==Uso==
 
'''Iniciación del entorno'''
 
'''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).
+
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.
 
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:
 
Para iniciar el entorno ejecutamos:
 
<syntaxhighlight lang="bash" enclose="div">
 
<syntaxhighlight lang="bash" enclose="div">
./bin/bash sq_iniciar_entorno
+
cd bin
 +
./sq_iniciar_entorno
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
Luego de iniciado el entorno puede verificar el funcionamiento de los módulos ingresando en las siguientes urls:<br \>
 
Luego de iniciado el entorno puede verificar el funcionamiento de los módulos ingresando en las siguientes urls:<br \>
 
Núcleo: http://127.0.0.1:4001/sq_nucleo/<br \>
 
Núcleo: http://127.0.0.1:4001/sq_nucleo/<br \>
Unidad de venta: http://127.0.0.1:4002/sq_uv/<br \>
+
Académico: http://127.0.0.1:4002/sq_academico/<br \>
  
 
Para conectarse a la base de datos el usuario y password es postgres:<br \>
 
Para conectarse a la base de datos el usuario y password es postgres:<br \>
 
Núcleo: puerto 4431<br \>
 
Núcleo: puerto 4431<br \>
Unidad de venta: puerto 4433<br \>
+
Académico: puerto 4433<br \>
  
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)
+
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'''
 
'''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:
+
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:
 
<syntaxhighlight lang="bash" enclose="div">
 
<syntaxhighlight lang="bash" enclose="div">
 
# En la siguientes carpetas puede agregar un dump sql de una base de datos (la carpeta solo admite un solo archvio sql)
 
# 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/nucleo/
testing/datos/unidad-venta/
+
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.
 
# 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.
Línea 81: Línea 91:
 
Para cargar los datos ejecutamos:
 
Para cargar los datos ejecutamos:
 
<syntaxhighlight lang="bash" enclose="div">
 
<syntaxhighlight lang="bash" enclose="div">
testing/bin/bash sq_cargar_datos
+
cd bin
 +
./sq_cargar_datos
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Línea 89: Línea 100:
 
<syntaxhighlight lang="bash" enclose="div">
 
<syntaxhighlight lang="bash" enclose="div">
 
# Para listar los contenedores activos
 
# Para listar los contenedores activos
sudo docker ps
+
docker ps
 
# En la columna NAMES se describe el nombre del contenedor
 
# En la columna NAMES se describe el nombre del contenedor
  
 
# Para ingresar a la terminal de un contenedor
 
# Para ingresar a la terminal de un contenedor
testing/bin/sh docker-connect <nombre-contenedor>
+
cd bin
 +
./docker-connect <nombre-contenedor>
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
'''Backup de bases de datos'''
 
'''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:
+
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:
 
<syntaxhighlight lang="bash" enclose="div">
 
<syntaxhighlight lang="bash" enclose="div">
testing/bin/bash sq_bkp_datos.sh
+
cd bin
 +
./bash sq_bkp_datos.sh
 
</syntaxhighlight>
 
</syntaxhighlight>
:'''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.
+
:'''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.

Revisión actual del 14:46 29 jun 2018

Siu-sanaviron-quilmes.png

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

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