SIU-Diaguita/version2.4.0/postinstalacion

De SIU
Revisión del 16:09 9 may 2017 de Fkorol (discusión | contribuciones) (Configuración para uso de la aplicación móvil)
Saltar a: navegación, buscar


Post-Instalación del sistema SIU-Diaguita

Una vez instalado el sistema, existen ciertas configuraciones a realizar en el entorno en el que se integra. A continuación se describen pasos necesarios para la interconexión con otros sistemas, puesta a punto, ejecución de tareas en segundo plano, servicios varios, etc.


Nota: hasta la versión 2.2.x de SIU-Diaguita, el motor de reportes XSL-FO estaba soportado. Sin embargo, en versiones posteriores solo se soporta a JasperReports.


Salidas mediante JasperReports

El uso de esta tecnología permite realizar personalizaciones de los reportes y salidas de la aplicación SIU-Diaguita, logrando adaptarlos a las necesidades de cada Organización. Para hacer uso de esta tecnología, es necesario tener instalado el entorno Java (JRE como mínimo la versión 7) y el soporte de tipografías de java respectivo (mas información https://wiki.debian.org/Fonts).

JasperReports requiere para funcionar la instalación de determinadas librerías, las cuales tendrá que descargar desde el repositorio de descargas de para SIU-Diaguita (dentro de directorio JasperReports/Versiones). Una vez obtenido el archivo JasperReports-5.1.0.tar.gz, se debe descomprimir su contenido (dos carpetas llamadas JasperReports y JavaBridge) en el directorio /ruta_instalacion/diaguita/toba/php/3ros/ de la aplicación SIU-Diaguita.

El próximo paso es configurar para que se ejecute de forma contínua el servidor local de reportes.


Configuración bajo Linux

Mediante la utilidad init.d del sistema Debian Linux, configurar la ejecución del archivo diaguita_reportes.sh que se encuentra ubicado dentro del directorio /ruta_instalacion/diaguita/aplicacion/bin/ de la aplicación SIU-Diaguita.

Para configurar que JasperReports inicie en el arranque del servidor, es necesario realizar los siguientes pasos:

root@host:/# cd /etc/init.d
root@host:/# cp /ruta_instalacion/diaguita/aplicacion/bin/diaguita_reportes.sh .
root@host:/# chmod +x diaguita_reportes.sh
root@host:/# update-rc.d diaguita_reportes.sh defaults


Además, dentro del archivo diaguita_reportes.sh deberá configurar la variable PATH_DIAGUITA para que apunte al directorio /ruta_instalacion indicado previamente.


Configuración bajo Windows

Mediante la utilidad de tareas programadas proporcionada por Windows, configurar la ejecución del archivo diaguita_reportes.bat ubicado en el directorio /ruta_instalacion/diaguita/aplicacion/bin/ de la aplicación SIU-Diaguita.

Tener en cuenta que para poder ejecutar dicho archivo, deberán tener incluida en la variable de entorno PATH la ruta hacia la instalación de java. Esto permite a Windows ubicar correctamente el comando java.


Detección y evaluación de errores

Si por algún motivo el servidor local de reportes JasperReports no esta corriendo, la aplicación SIU-Diaguita mostrará indefectiblemente un mensaje de error similar a:

Could not connect to the J2EE server 127.0.0.1:8081. Please start it, for example with the command: "java -jar JavaBridge.jar SERVLET:8080 3 JavaBridge.log" or, if the back end has been compiled to native code, with "modules/java SERVLET:8080 3 JavaBridge.log". Error message: Connection refused (111)


Se deberá chequear que no hayan mayores errores con dicho servicio (consumo de memoria, permisos de ejecución, etc) y si se encuentra corriendo efectivamente. Para ello, el script de inicio para el servidor local de reportes JasperReports utiliza un archivo de log ubicado en /var/log/diaguita_reportes.log que permite auditar en todo momento su funcionamiento.


Limpieza de archivos temporales

SIU-Diaguita proporciona un comando para automatizar la limpieza de los archivos temporales que genera al realizar ciertas tareas que son parte de su funcionamiento. Para realizar la limpieza de los archivos temporales, SIU-Diaguita proporciona un comando que se encarga de eliminarlos y permite al administrador “programar” su ejecución. Se recomienda programar su ejecución en un horario que el sistema no esté en uso, para evitar comportamientos no deseados.


Configuración bajo Linux

Mediante la utilidad cron proporcionada por Linux, configurar la ejecución del archivo limpieza_temporales.sh ubicado dentro del directorio /ruta_instalacion/diaguita/aplicacion/bin/ de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:


0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh


Configuración bajo Windows

Mediante la utilidad de tareas programadas proporcionada por Windows, configurar la ejecución del archivo limpieza_temporales.bat ubicado dentro del directorio /ruta_instalacion/diaguita/aplicacion/bin/ de la aplicación SIU-Diaguita.


Conectar Diaguita con MCC

Conectar Diaguita con MCC (SO de Diaguita Linux Debian)

Los pasos que se describen a continuación permiten configurar el acceso a un sistema MCC que cuente con una base de datos Adaptive Server Anywhere 6.0 (Sybase ASA) en un sistema Debian GNU/Linux.

Requerimientos

Para que Diaguita sea capaz de conectarse a la base de datos Sybase ASA de MCC hay que asegurarse de que el servicio de networking se encuentre correctamente configurado. En el documento adjunto, attachment:ConnectionTroubleshooting.pdf, se puede observar los pasos necesarios para verificar dicha configuración.

Nota: la versión del MCC soportada actualmente es la 4.2. No es posible trabajar con versiones previas o descentralizadas.

Instalación

Para que Diaguita se conecte efectivamente, es necesario instalar el controlador odbc para acceso a bases de datos Sybase ASA y el módulo para php que permita realizar conexiones utilizando odbc.

Para realizar la instalación en Debian Linux, se debe ejecutar:

apt-get install php5-odbc tdsodbc unixodbc


Configuración en el servidor

Una vez que se dispone del controlador odbc para bases de datos Sybase ASA, es necesario copiar un archivo al directorio de configuraciones del servidor Linux:


cp /usr/share/tdsodbc/odbcinst.ini /etc/


El último paso consite en definir los parámetros de conexión a la base de datos Sybase ASA. Se debe editar el archivo odbc.ini como sigue:


nano /etc/odbc.ini


Se detalla a continuación el contenido de un archivo odbc.ini de ejemplo:


[catalogo]
Driver          = FreeTDS
Description     = MCC DB
Server          = 192.168.1.209
Port            = 2638
Database        = catalogo
TDS_Version     = 5.0


En los parámetros Description, Server, Port y Database debe completar los valores pertinentes a la instalación del MCC vigente. El identificador de la conexión o DSN es [catalogo] y debe corresponderse indefectiblemente al nombre de la base de datos proporcionada en el parámetro Database.


Prueba de la conexión

Una vez finalizada las configuraciones, es posible verificar si todo se encuentra en orden ejecutando el siguiente comando y proporcionandole el identificador DSN (catalogo), el usuario (dba) y la contraseña (sql) adecuados:


isql catalogo dba sql


Si la configuración es correcta, debe verse el texto Connected! y estar conectados con el cliente para la ejecución de comandos SQL. Para salir del cliente usar la sentencia quit.


Depuración de la conexión

Es posible activar el modo depuración de la conexión ODBC configurando en el archivo odbcinst.ini la siguente entrada:


[ODBC]
Trace               = Yes
TraceFile           = /tmp/diaguita-odbc.log



Conectar Diaguita con MCC (SO de Diaguita Windows XP)

Requerimientos

Se da por sentado que se encuentra en funcionamiento el sistema MCC y además que el servidor en donde se encuentra Diaguita tiene configurado el ODBC según indica el instructivo de instalación del MCC (tener en cuenta que para que funcione correctamente el ODBC, se debe configurar la conexión en el DSN de sistema y no en el DSN de usuario ya que no funcionará).

Instalación

Para que Diaguita se conecte efectivamente, es necesario incorporar la extensión php_pdo_odbc al archivo de configuración de php.ini.


Configuración en la aplicación Diaguita

Una vez que se dispone del DSN para bases de datos Sybase ASA, es necesario configurar los parámetros en el archivo bases.ini de la siguiente forma:


[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql

Se define una nueva sección, conteniendo el parámetro dsn_odbc con el nombre que tiene nuestro DSN, el parámetro usuario y clave que deben coincidir con los datos de acceso a la base de datos Sybase ASA.


Configuración en la aplicación MCC

La implementación actual del mecanismo de interconexión entre Diaguita y MCC require que cada usuario del sistema diaguita que tenga los permisos de exportar al MCC tenga creada una cuenta de usuario equivalente en el sistema MCC. Dicha cuenta de usuario debe cumplir los siguiente requerimientos:

  1. el identificador de acceso debe coincidir con el de diaguita
  2. debe ser del tipo "Usuario" y no "Administrador"
  3. tiene que ser un usuario activo (no poseer fecha de baja)

Enviar notificaciones

SIU-Diaguita proporciona un comando para automatizar el envío de las notificaciones que genera al realizar ciertas tareas que son parte de su funcionamiento (para observar las notificaciones pendientes, revisar Administración -> Notificaciones -> Cola de notificación) . Para realizar el envío de las notificaciones, el comando se encarga de enviar por correo electrónico la notificación y registrar la fecha en que sucedió, permitiendo al administrador “programar” su ejecución. Se recomienda programar la periodicidad de su ejecución en función de las capacidades del servidor de correo electrónico, políticas de seguridad y de modo tal que no se demore demasiado el envío a sus receptores.


Configuración envío bajo Linux

Mediante la utilidad cron proporcionada por Linux, configurar la ejecución del archivo diaguita_notificaciones.sh ubicado dentro del directorio /ruta_instalacion/diaguita/aplicacion/bin/ de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:


*/5 * * * 1 /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh


Configuración envío bajo Windows

Mediante la utilidad de tareas programadas proporcionada por Windows, configurar la ejecución del archivo diaguita_notificaciones.bat ubicado dentro del directorio /ruta_instalacion/diaguita/aplicacion/bin/ de la aplicación SIU-Diaguita.


Configurar correo electrónico

El correo electrónico se puede configurar al momento de realizar la instalación/actualización del sistema, mediante el instalador web. Además, es posible configurarlo manualmente de acuerdo a los pasos descritos en la wiki de SIU-Toba.

Para una configuración manual, se debe crear el archivo ´smtp.ini´ en la siguente ruta

ruta_instalacion/diaguita/instalacion/smtp.ini

El contenido de dicho archivo debe ser similar a lo siguiente

[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=

Luego, en el archivo ´instalacion.ini´ ubicado en la ruta

ruta_instalacion/diaguita/instalacion/instalacion.ini

El archivo se debe agregar lo siguiente

...
smtp=correo_testing

Servicios Web

Para utilizar los servicios web de SIU-Diaguita debe incorporar al toba.conf de Diaguita la siguiente configuración.

#API REST
RewriteEngine On
RewriteBase /diaguita
Options FollowSymLinks SymLinksIfOwnerMatch
RewriteRule ^rest/(.*)$ rest.php/$1 [PT,L,QSA]
RewriteRule ^rest$      rest.php/   [PT,L,QSA]
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

Conectar SIU-Diaguita con SIU-Pilagá

Nota 1: La versión 2.4.0 de SIU-Diaguita requiere al menos contar con la versión 3.0.0 de SIU-Pilagá si se desea utilizar los servicios web.

Nota 2: Para utilizar el servicio de Solicitudes de Alta de Bienes Patrimoniales se requiere al menos la versión 3.0.3 de SIU-Pilagá.

Los pasos que se describen a continuación permiten configurar el acceso a recursos expuestos mediante servicios web.

En SIU-Diaguita

Para permitir que SIU-Diaguita acceda a recursos de SIU-Pilaga, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguente ruta

ruta_instalacion/diaguita/instalacion/i<u>produccion/p</u>diaguita/rest/pilaga/cliente.ini

El contenido de dicho archivo debe ser similar a lo siguiente, manteniendo en la configuración del parámetro "to" el final de la url "/rest/"

[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura


En SIU-Pilaga

Para permitir el acceso externo a recursos de SIU-Pilaga, se debe configurar el archivo ´servidor.ini´ ubicado en la siguiente ruta

/ruta_instalacion/pilaga/instalacion/i<u>produccion/p</u>pilaga/rest/servidor.ini

El contenido de dicho archivo debe ser similar a lo siguiente, quedando descomentadas todas las opciones

autenticacion = digest
;
;Opciones que recibe la librer<ED>a - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/

También se debe configurar el archivo ´servidor_usuarios.ini´ ubicado en la siguiente ruta

ruta_instalacion/pilaga/instalacion/i<u>produccion/p</u>pilaga/rest/servidor_usuarios.ini

El contenido de dicho archivo debe ser similar a lo siguiente, quedando configurados los usuarios que se utilizarán desde SIU-Diaguita (configurado en el ´cliente.ini´ previo). Este archivo puede contener otros usuarios para otros sistemas.

[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura

Conectar SIU-Diaguita con la AFIP

Los pasos que se describen a continuación permiten configurar el acceso a recursos de la AFIP expuestos mediante servicios web.

En SIU-Diaguita

Para permitir que SIU-Diaguita acceda a recursos de la AFIP, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguente ruta

ruta_instalacion/diaguita/instalacion/i<u>produccion/p</u>diaguita/rest/afip/cliente.ini

El contenido de dicho archivo debe ser exactamente lo siguiente

[conexion]
to = "https://soa.afip.gob.ar/"



Errores frecuentes y/o posibles problemas de configuración

A continuación, se detallan casos típicos de problemas de configuración relacionadas con el entorno en el que se ejecuta SIU-Diaguita.

Formato de fecha incorrecto

ERROR: date/time field value out of range: "24/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.


Este error está relacionado con el formato de entrada de la fecha, por defecto espera a que sea "mes-dia-año" en vez de "dia-mes-año".

Una solución es corregir sobre la base de datos actual:

ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";

Pero también, es necesario configurar correctamente el motor, editando el archivo postgresql.conf para ello:

datestyle = 'iso, dmy'




#comment
COMENTARIOS DE CONFIGURACION QUE AL FINAL NO ENTRA PARA LA 2.4.0 PERO QUE ESTA BUENO YA TENERLO...

Para permitir que SIU-Pilaga acceda a recursos de SIU-Diaguita, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguente ruta

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i<u>produccion/p</u>pilaga/rest/diaguita/cliente.ini

El contenido de dicho archivo debe ser similar a lo siguiente, manteniendo en la configuración del parámetro "to" el final de la url "/rest/"

[conexion]
to = "http://direccion/web/hacia/diaguita/rest/"
auth_tipo = digest
auth_usuario = pilaga_rest
auth_password = ingrese_clave_segura

Para permitir el acceso externo a recursos de SIU-Diaguita, se debe configurar el archivo ´servidor.ini´ ubicado en la siguiente ruta

ruta_instalacion/diaguita/instalacion/i<u>produccion/p</u>diaguita/rest/servidor.ini

El contenido de dicho archivo debe ser similar a lo siguiente, quedando descomentadas todas las opciones

autenticacion = digest
;
;Opciones que recibe la librer<ED>a - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/

Se debe configurar el archivo ´servidor_usuarios.ini´ ubicado en la siguiente ruta

ruta_instalacion/diaguita/instalacion/i<u>produccion/p</u>diaguita/rest/servidor_usuarios.ini

El contenido de dicho archivo debe ser similar a lo siguiente, quedando configurados los usuarios que se utilizarán desde SIU-Pilaga (configurado en el ´cliente.ini´ de Pilaga).

[pilaga_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura


Configuración para uso de la aplicación móvil

Para poder utilizar la aplicación móvil de SIU-Diaguita se debe modificar el parámetro PERMITE_CONVOCATORIAS_PUBLICAS_SMARTPHONE que se encuentra en el menú Administración -> Parámetros y asignarle el valor SI

Luego de modificar el parámetro se debe ingresar a la operación Configuración reporte de convocatorias publicadas que se encuentra en el menú Administración -> Tablas maestras compras e indicar en el campo URL pública de acceso al portal cuál es la url pública de diaguita a través de la cual se accede al portal de convocatorias públicas. Por ejemplo: https://www.universidad.edu.ar/diaguita

Finalmente se debe editar el archivo servidor.ini ubicado en la siguiente ruta

ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/servidor.ini

En dicho archivo se debe modificar el atributo url_protegida debiendo quedar de la siguiente forma:

autenticacion = digest

[settings]
formato_respuesta = json

url_protegida = '(areas|catalogos|mapa-tramite|oficinas-contratacion|patrimonio)'

Nota: Se debe tener en cuenta que en al parámetro autenticacion se debe indicar el mecanismo de autenticación seleccionado (digest, basic, ssl).

Realizar personalizaciones del sistema SIU-Diaguita

El sistema SIU-Diaguita permite realizar personalizaciones de sus funciones (código php y metadatos) así como de las salidas y visualización de los datos que ofrece. Cada una de ellas se realiza de forma independiente y se enfocan a diferentes actividades, aunque algunas veces es necesario combinarlas para cubrir una necesidad de la organización.


Personalizar php y metadatos


Personalizar salidas JasperReports


< Volver