SIU-Pilaga/version3.16.0/historicos ejercicios
Sumario
Instalación con histórico de ejercicios
Partimos de la base que vamos a trabajar con una réplica de la instalación de producción, que ya posee todos los usuarios que acceden al sistema.
Recomendamos que la base del ejercicio actual no debe agregarse en esta instalación, los mismos que se agreguen deben ser ejercicios cerrados y solo de consulta.
A esta instalación de SIU-Pilagá es posible agregarle múltiples ejercicios históricos, lo cual nos permite dentro de una misma instalación conectarnos a múltiples bases de datos de negocio de distintos ejercicios históricos manteniendo una sola base de datos con un único schema de toba, esto nos va a permitir seleccionar entre múltiples ejercicios y poder operar el sistema con el ejercicio seleccionado e ir alternando entre los distintos ejercicios existentes en la misma instalación.
Como se visualiza el esquema anterior, en una instalación con ejercicios históricos se va a contar con una sola instalación de SIU-Pilagá, una base de datos con los schemas de SIU-Toba y múltiples bases de datos para cada ejercicio con el schema de negocio.
En próximas versiones se agregaran los script de conversiones para versiones anteriores a la mencionada.
Requerimientos
Para poder comenzar con la instalación debe tener instalado el servidor web Apache (http://httpd.apache.org/) con capacidad de interpretar scripts PHP.
Si tiene dudas sobre la instalación y/o configuración de alguno de estos servicios, puede comunicarse con el soporte técnico del SIU en http://portal.comunidad.siu.edu.ar.
Requisitos LINUX
Los requerimientos para instalación/actualización en un servidor GNU/Linux son las siguientes: Instalación manual en GNU/Linux
Tabla de requerimientos de versiones
| Requisito | Versión |
|---|---|
| PostgreSQL | 11.x |
| Apache | 2.4.x |
| PHP | 7.3.x (con las extensiones: xml, gd, pdo_pgsql, curl, zip). |
| Graphviz | 2.9.x o superior |
| Java Runtime Environment | 1.8.x (se requiere tener instalado JRE debido a que se utiliza la tecnología JasperReports para realizar la generación de todos los documentos/comprobantes emitidos por el sistema). |
| Composer | 1.10.x |
| Yarn |
Generar ejercicio histórico
Comando para la generación de un nuevo ejercicio histórico
El comando se ejecuta por cada ejercicio histórico que se quiere agregar a la instalación, podemos ejecutar mas de una vez el comando para un mismo ejercicio y el sistema controlara si ya se configuró y tiene aplicado todas las conversiones o que conversión falta aplicar.
En el caso de que ocurra un error en la ejecución de un archivo de conversión, el proceso se detiene y como esta en un esquema transaccional no aplica el script sql que contiene la falla sobre la base de negocios informando el error ocurrido y mostrando la información mas detallada en el archivo instalador.log.
Es posible corregir el error del script de conversión y volver a ejecutar el comando y este verifica en la tabla par_version cual fue la última versión convertida exitosamente procediendo a ejecutar el script correspondiente a la próxima versión a convertir.
Para obtener la ayuda del comando ejecutar el siguiente comando
- ./bin/instalador ayuda pilaga:iniciar-ejercicio-historico
En el caso de que necesitemos reconfigurar los parámetros de conexión para un ejercicio ya iniciado se puede hacer editando directamente en el archivo bases.ini o ejecutando el siguiente comando.
- ./bin/instalador pilaga:iniciar-ejercicio-historico --ejercicio-nombre=2015 --reconfigurar-ejercicio
Si quisiéramos eliminar los schemas que son innecesarios luego de iniciar el histórico estos son los schemas de (toba_pilaga, toba_pilaga_logs, toba_pilaga_backups) se debe agregar el siguiente argumento al comando
- ./bin/instalador pilaga:iniciar-ejercicio-historico --ejercicio-nombre=2015 --limpiar-schemas
Ejecutar comando de inicio de ejercicio histórico
En el ejemplo vamos a iniciar un ejercicio histórico para el año 2015. Ir a la terminal de comando y ejecutar el siguiente comando en la raíz del directorio de SIU-Pilagá
- ./bin/instalador pilaga:iniciar-ejercicio-historico --ejercicio-nombre=2015
Luego de ejecutar nos consulta si deseamos continuar, en el caso que sea si, presionar ENTER o escribir yes
- 2) Iniciar nuevo ejercicio
==========================
[NOTA] Esta por iniciar el proceso de creación de histórico de ejercicio para el ejercicio con el nombre '2015'
¿Desea continuar? (yes/no) [yes]:
En este momento el sistema queda en estado de modo mantenimiento activado.
- [NOTA] El sistema fue configurado para quedar en modo mantenimiento.
Luego en el caso de que no exista una configuración para el ejercicio en el archivo bases.ini, se solicita que se ingrese los datos de conexión.
- === Ingrese los datos de conexión para el ejercicio "2015" ===
----------------------------------------------------------------
- host: [localhost]:
>
- port: [5432]:
>
- usuario: [postgres]:
>
- clave: [postgres]:
>
- base: [2015]:
> hist_2015
Luego nos lista los parámetros de conexión configurado para confirmar en el caso de que sean correctos.
- CONFIG DE BASE DE DATOS DE NEGOCIO PARA EL EJERCICIO 2015
---------------------------------------------------------
----------- -------------
Parametro Valor
----------- -------------
Host 'localhost'
Port '5432'
Usuario 'postgres'
Clave 'postgres'
Base 'hist_2015'
----------- -------------
¿desea continuar? (yes/no) [yes]:
>
Luego procede a configurar los archivos bases.ini y bases_historicos.ini con los datos de configuración del ejercicio
Una vez cargado los datos de conexión el comando procede a si no existe la entrada en el bases.ini la crea.
- [produccion pilaga 2015]
motor = "postgres7"
profile = "localhost"
usuario = "postgres"
clave = "postgres"
puerto = "5432"
encoding = "LATIN1"
schema = "public"
base = "hist_2015"
Y ademas se crea una archivo en el directorio de instalación llamado bases_historico.ini con un parámetro que indica si la instalación utiliza histórico de ejercicios o no.
En el caso de querer desactivar la instalación en modo de históricos de ejercicios se debe configurar el parámetro "iniciada = no"
- iniciada = si
[2015]
fuente = 'produccion pilaga 2015'
- === Configurando bases.ini ===
--------------------------------
[ OK ] El archivo bases.ini fue configurado con los datos de la base de datos del nuevo ejercicio histórico.
=== Configurando bases_historicos.ini ===
-------------------------------------------
[ OK ] El archivo bases_historico.ini fue configurado con los datos de la base de datos del nuevo ejercicio histórico.
Una vez configurado los archivos ini procede a aplicar los script de conversión que son necesarios para transformar la base de datos de negocios del ejercicio y llevarlo a la versión actual del sistema, para llevar a cabo estas conversiones toma como referencia las versiones aplicadas en la tabla par_version.
- === Generando conversión de base de datos ===
-----------------------------------------------
-Generando conversión de base de datos de negocio del ejercicio
1/1 [▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100%
Si se indico que se quiere limpiar schemas nos pedirá una confirmación para continuar.
- === Limpiando schemas innecesarios del ejercicio "2015" ===
-------------------------------------------------------------
Esta por eliminar los schemas de [toba_pilaga, toba_pilaga_backup, toba_pilaga_logs] del ejercicio "2015", ¿desea continuar? (yes/no) [yes]:
> yes
-Eliminando schema toba_pilaga
1/1 [▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100%
-Eliminando schema toba_pilaga_backup
1/1 [▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100%
-Eliminando schema toba_pilaga_logs
1/1 [▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓] 100%
Una vez finalizado el proceso se informa que es necesesario sacar del modo mantenimiento el sistema en el caso de que este en su correcto funcionamiento.
- === Se ha finalizado el proceso de creación de base de inicio de ejercicio ===
--------------------------------------------------------------------------------
[NOTA] Por defecto, el sistema se configura en modo mantenimiento, para desactivar el modo mantenimiento ejecutar el
siguiente comando:
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
Para chequear que no hubo ningún error o en el caso de que ocurra algún error es recomendable ir al archivo de log instalador.log y al final de este archivo estará en detalle todo lo ocurrido durante el proceso.
- less instalador.log
Tener en cuenta que una vez que se actualiza la versión de la instalación con ejercicios históricos se debe ejecutar ese comando para que realice la conversión y actualice a la ultima versión cada base de datos de ejercicios anteriores
Al ingresar al sistema nos desplegara una pantalla de selección de ejercicios, donde estarán disponibles todos los ejercicios históricos que iniciamos en nuestra instalación.
Dentro del sistema una vez que estamos operando sobre un ejercicio en el encabezado al lado del logo nos indica el ejercicio que estamos operando y si quisiéramos cambiar a otro ejercicio ir al botón que se muestra arriba en la pantalla y este nos llevara al selector de ejercicios históricos.
Actualizar ejercicio histórico
Para la actualización del sistema del ejercicio histórico se siguen exactamente los mismos pasos que para una actualización en modo producción del sistema, siguiendo detalladamente cada una de las
Recomendaciones previas y Pasos previos para la misma.
Ejecutar comando de actualización de ejercicios históricos
Una vez actualizada la instalación de ejercicios históricos se procederá a ejecutar el comando que realiza la actualización de cada una de las bases registradas en sistema de ejercicios históricos:
- ./bin/instalador pilaga:migrar-ejercicios-historico
En el caso de que ocurra un error en la ejecución de un archivo de conversión para cualquiera de las bases de negocio registradas, el proceso se detiene y como esta en un esquema transaccional no aplica el script sql que contiene la falla sobre la base de negocios informando el error ocurrido y mostrando la información mas detallada en el archivo instalador.log.
Es posible corregir el error del script de conversión y volver a ejecutar el comando ya que este verifica en la tabla par_version cual fue la última versión convertida exitosamente procediendo a ejecutar el script correspondiente a la próxima versión a convertir.
