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

De SIU
Saltar a: navegación, buscar
 
(Uso)
 
(No se muestran 10 ediciones intermedias de 2 usuarios)
Línea 14: Línea 14:
  
 
Git: <code>apt-get install git-core</code>
 
Git: <code>apt-get install git-core</code>
 
Svn: >= 1.9 <code>apt-get install subversion</code>
 
  
 
Docker CE: https://docs.docker.com/engine/installation/
 
Docker CE: https://docs.docker.com/engine/installation/
Línea 21: 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
  
== Instalación ==
+
'''Administrar  el usuario que utilizará  Docker'''
'''Creación del entorno'''
 
#Posicionarse en la ubicación deseada para la instalación del entorno de testing:
 
 
 
#:<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
 
</syntaxhighlight>
 
#:Ahora tenemos el path:
 
#:<source lang="php" enclose="div">/usr/local/proyectos/sanaviron_quilmes/testing/</source>
 
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como <tt><path proyecto TESTING></tt>.
 
 
 
Crear archivo de configuración
 
<syntaxhighlight lang="bash" enclose="div">
 
cp <path proyecto TESTING>entorno.env.template <path proyecto TESTING>entorno.env
 
</syntaxhighlight>
 
  
Una vez descargado, ejecutar en la carpeta 'bin' del mismo:
+
<code>sudo groupadd docker</code>
  
<source lang="php" enclose="div">
+
<code>sudo usermod -a -G docker $USER</code>
<path proyecto TESTING>/bin/bash sq_crear_entorno_testing
 
</source>
 
  
== Configuración ==
+
Luego reiniciar la sesión para que tome los cambios.
  
=== Agente de cobranzas ===
+
== Instalación ==
 
+
'''Creación del entorno'''
:* [[SIU-Sanaviron-Quilmes/version1.1.0/mercado.pago|Mercado Pago]]
+
#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
=== Entorno SQ ===
 
 
 
Editar el archivo <path proyecto TESTING>entorno.env y definir los siguientes valores:
 
<syntaxhighlight lang="bash" enclose="div">
 
# Configuraciones
 
#=======================================
 
export DISPOSITIVO_RED='eth0';
 
export DISPATCHER_ACTIVO=true;
 
export DISPATCHER_URL='http://IP_PUBLICA/dispatcher_notificacion_mp.php?sender=';
 
export DISPATCHER_BACK_URL='http://IP_PUBLICA/dispatcher_back_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;
 
 
</syntaxhighlight>
 
</syntaxhighlight>
 
+
#Creación del entorno.<br /><source lang="php" enclose="div">
=== SIU-Guaraní ===
+
cd bin
 
+
./sq_crear_entorno_testing
El módulo SIU-Guaraní deberá tener configurados los siguientes archivos para la comunicación con los módulos SQ:
+
</source>Este proceso generará las carpetas y archivos básicos para el entorno de test
<syntaxhighlight lang="bash" enclose="div">
+
#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.
# Gestión
+
#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í<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<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 97: Línea 50:
 
<path autogestion>/instalacion/servicios_web_config.php (apartado 'consumidos')
 
<path autogestion>/instalacion/servicios_web_config.php (apartado 'consumidos')
 
<path autogestion>/instalacion/config.php ('url_sq_pagos')
 
<path autogestion>/instalacion/config.php ('url_sq_pagos')
</syntaxhighlight>
+
</syntaxhighlight>Para mayor informacion consultar la documentacion de SIU-Guarani en:<syntaxhighlight lang="bash" enclose="div">
 
 
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>
+
</syntaxhighlight>Por ejemplo: [[SIU-Guarani/version3.15.0/interfaces/sanaviron|http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.15.0/interfaces/sanaviron]]
Por ejemplo: [[SIU-Guarani/version3.13.0/interfaces/sanaviron|http://documentacion.siu.edu.ar/wiki/SIU-Guarani/version3.13.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">
# Opcionalmente podemos iniciar con una versión especifica, por ejemplo la versión 1.1.8
+
cd bin
<path proyecto TESTING>/bin/bash sq_iniciar_entorno 1.1.8
+
./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 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)
<path proyecto TESTING>/datos/nucleo/
+
testing/datos/nucleo/
<path proyecto 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 140: Línea 91:
 
Para cargar los datos ejecutamos:
 
Para cargar los datos ejecutamos:
 
<syntaxhighlight lang="bash" enclose="div">
 
<syntaxhighlight lang="bash" enclose="div">
<path proyecto TESTING>/bin/bash sq_cargar_datos
+
cd bin
 +
./sq_cargar_datos
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Línea 148: 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
<path proyecto 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">
<path proyecto 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.