SIU - Contribuciones del usuario [es]

SIU-Diaguita/Version4.3.0/Novedades funcionales

2026-06-25T10:36:05Z

Pboyko: /* Principales novedades de la versión */

=Principales novedades de la versión=
- Resumen de oferta para presentaciones de Ofertas Electrónicas.
 
- Mejoras en paginados y listado baja de bienes patrimoniales.
 
- Mejores en reportes por proveedor.
 
- Agregado de filtros en reportes y órdenes de compra.
 
- Mejoras en carga de proveedores
 
- Correcciones filtros de listado de bienes patrimoniales.
 
- Mejoras en históricos de cambios de circulares
 
- Se eleva requerimiento versión mínima de PostgreSQL 14.
 
-----
[[SIU-Diaguita/version4.3.0|<Volver]]

SIU-Diaguita

2026-05-14T21:12:24Z

Pboyko: /* Documentación */

__NOTOC__

[[Archivo:siu-diaguita.png|derecha|link=]]

La administración patrimonial y los procesos de compra, más allá de sus particularidades, resultan complejos para cualquier tipo de institución. Ante la necesidad de gestionar ambos procedimientos, se desarrolló el sistema SIU-Diaguita, que cuenta con una estructura en dos módulos: Compras y Patrimonio, los cuales pueden utilizarse tanto en forma conjunta o por separado, según las necesidades de cada institución.

== Trabajemos juntos para poner en marcha el sistema ==

La implementación del sistema es una etapa vital para asegurar su correcto funcionamiento a futuro, es el proceso que sienta las bases y, por lo tanto, requiere de una especial atención. Es muy importante que prestes atención a las recomendaciones y realices todas las consultas que consideres necesarias para asegurarte que vas en el camino correcto. Acá podes ver los distintos canales en los que podés interactuar con el equipo de implementación y demás miembros de la comunidad.

== Primeros pasos... todo lo que tenés que saber para poner el sistema en marcha ==

===== [[SIU-Diaguita/roles|Conformación del equipo de implementación]] =====

===== [[SIU-Diaguita/requerimientos|Requerimientos Mínimos de Equipamiento]] =====

===== [[SIU-Diaguita/plan de implementacion|Plan de Implementación]] =====

== Documentación ==

{| class="wikitable"
!SIU-Diaguita
!App
Colector
!Migrador de
Bienes Patrimoniales
|-
|'''[[SIU-Diaguita/version4.2.0|Versión 4.2.0]]'''
|'''[[SIU-Diaguita/appcolector|Versión 1.3]]'''
|'''[[SIU-Diaguita/migrador/version1.0.0|Versión 1.0.x]]'''
|-

|-
|'''[[SIU-Diaguita/version4.1.0|Versión 4.1.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version4.0.0|Versión 4.0.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version3.6.0|Versión 3.6.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version3.5.0|Versión 3.5.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version3.4.0|Versión 3.4.0]]'''
|
|
|-

SIU-Diaguita

2026-05-14T21:12:12Z

Pboyko: /* Documentación */

__NOTOC__

[[Archivo:siu-diaguita.png|derecha|link=]]

La administración patrimonial y los procesos de compra, más allá de sus particularidades, resultan complejos para cualquier tipo de institución. Ante la necesidad de gestionar ambos procedimientos, se desarrolló el sistema SIU-Diaguita, que cuenta con una estructura en dos módulos: Compras y Patrimonio, los cuales pueden utilizarse tanto en forma conjunta o por separado, según las necesidades de cada institución.

== Trabajemos juntos para poner en marcha el sistema ==

La implementación del sistema es una etapa vital para asegurar su correcto funcionamiento a futuro, es el proceso que sienta las bases y, por lo tanto, requiere de una especial atención. Es muy importante que prestes atención a las recomendaciones y realices todas las consultas que consideres necesarias para asegurarte que vas en el camino correcto. Acá podes ver los distintos canales en los que podés interactuar con el equipo de implementación y demás miembros de la comunidad.

== Primeros pasos... todo lo que tenés que saber para poner el sistema en marcha ==

===== [[SIU-Diaguita/roles|Conformación del equipo de implementación]] =====

===== [[SIU-Diaguita/requerimientos|Requerimientos Mínimos de Equipamiento]] =====

===== [[SIU-Diaguita/plan de implementacion|Plan de Implementación]] =====

== Documentación ==

| class="wikitable"
!SIU-Diaguita
!App
Colector
!Migrador de
Bienes Patrimoniales
|-
|'''[[SIU-Diaguita/version4.2.0|Versión 4.2.0]]'''
|'''[[SIU-Diaguita/appcolector|Versión 1.3]]'''
|'''[[SIU-Diaguita/migrador/version1.0.0|Versión 1.0.x]]'''
|-

|-
|'''[[SIU-Diaguita/version4.1.0|Versión 4.1.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version4.0.0|Versión 4.0.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version3.6.0|Versión 3.6.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version3.5.0|Versión 3.5.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version3.4.0|Versión 3.4.0]]'''
|
|
|-
}

SIU-Diaguita/version4.2.0/imagen docker

2026-04-17T19:22:47Z

Pboyko:

[[Archivo:siu-diaguita.png|derecha|link=SIU-Diaguita/version4.2.0]] 
{{TOClimit|1}}

== Uso de imágenes docker en SIU-Diaguita ==
=== '''Acceso a imágenes docker SIU-Diaguita desde hub.siu.edu.ar''' ===
Para poder descargar la imagen de docker de SIU-Diaguita se debe contar con un usuario en hub.siu.edu.ar. Se debe realizar una solicitud de vinculación por nota. La explicación, detalle y enlace a una nota modelo la pueden obtener desde este link:

<nowiki>https://www.siu.edu.ar/solicitud/</nowiki>

----

[[SIU-Diaguita/version4.2.0|<Volver]]

SIU-Diaguita/version4.3.0/imagen docker

2026-04-17T19:22:47Z

Pboyko:

[[Archivo:siu-diaguita.png|derecha|link=SIU-Diaguita/version4.3.0]] 
{{TOClimit|1}}

== Uso de imágenes docker en SIU-Diaguita ==
=== '''Acceso a imágenes docker SIU-Diaguita desde hub.siu.edu.ar''' ===
Para poder descargar la imagen de docker de SIU-Diaguita se debe contar con un usuario en hub.siu.edu.ar. Se debe realizar una solicitud de vinculación por nota. La explicación, detalle y enlace a una nota modelo la pueden obtener desde este link:

<nowiki>https://www.siu.edu.ar/solicitud/</nowiki>

----

[[SIU-Diaguita/version4.3.0|<Volver]]

SIU-Diaguita/version4.2.0instalacion actualizacion/instalador env vars

2026-01-15T16:35:23Z

Pboyko: /* Configuración de conexión a Araí-Documentos */

= Variables de entorno para la instalación =

A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación. Éstas están en el archivo [[../instalador.env.dist|''instalador.env.dist'']].

Los parámetros comentados con <code>#</code> son parámetros opcionales, la configuración de la base de datos de negocio es obligatoria y es opcional definir una configuración separada para la base de datos de Toba, por defecto ambas bases de datos están en una misma base en distintos schemas.

También opcionalmente se puede personalizar las rutas de <code>TOBA_PROYECTO_DIR</code> y <code>TOBA_INSTALACION_DIR</code>, esto es útil para casos especiales.

Opcionalmente podemos definir si el entorno es de producción <code>ENTORNO_PRODUCCION="1"</code> o desarrollo <code>ENTORNO_PRODUCCION="0"</code> por defecto asume que el ambiente es producción.

== Configuración del instalador ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="16%"| Descripción
|-
| INSTALADOR_TIMEOUT
| tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 1200 segundos
|-
| ENTORNO_PRODUCCION
| indica si la instalación es un entorno de producción. El valor <code>1</code> es producción, <code>0</code> solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==

{| class="wikitable"
!width="38%"| Variable de entorno
!width="24%"| Descripción
!width="0%"| Valor por defecto
|-
| TOBA_URL_BASE
| La url base pública de acceso al sistema, sin alias del proyecto. Ej: <code>https://diaguita.institucion.edu.ar</code>
| <code>http://localhost</code>
|-
| TOBA_URL_PORT
| Opcional, el puerto de la url definida en la variable anterior
| <code>80</code>
|-
| TOBA_USUARIO
| El usuario administrador del proyecto, en caso de actualización dejar valor por defecto
| <code>toba</code>
|-
| TOBA_PASSWORD
| El password del usuario administrador, en caso de actualización dejar valor por defecto
| <code>toba123*-a</code>
|-
| TOBA_INSTALACION_DIR
| Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.
| <code>diaguita/instalacion</code>
|-
| TOBA_PROYECTO_DIR
| Opcional, el directorio donde está el proyecto toba
|

|-
| TOBA_ALIAS_PROYECTO
| El alias Apache para el acceso al proyecto
| <code>/diaguita</code>
|-
| TOBA_ALIAS_NUCLEO
| Opcional, el alias Apache para acceso al núcleo de Toba
| <code>/toba_diaguita</code>
|-
| TOBA_ALIAS_TOBA_USUARIOS
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-usuarios</code>
| <code>/toba_usuarios</code>
|-
| TOBA_ALIAS_TOBA_EDITOR
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-editor</code>
| <code>/toba_editor</code>
|-
| TOBA_ALIAS_TOBA_REFERENCIA
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-referencia</code>
| <code>/toba_referencia</code>
|-
| TOBA_ID_DESARROLLADOR
| Opcional, el id desarrollador toba.
| <code>0</code>
|-
| TOBA_SESSION_NAME
| Opcional, el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
| <code>TOBA_DIAGUITA</code>
|-
| TOBA_FORZAR_HTTPS
| Opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser <code>off</code> u <code>on</code>
| <code>Off</code>
|-
| TOBA_SALT
| Opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba
| Caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="16%"| Descripción
!width="23%"| Valor por defecto
|-
| PROYECTO_DB_HOST
| el host/ip del equipo donde corre la base de datos
| <code>localhost</code>
|-
| PROYECTO_DB_PORT
| el puerto donde corre la base de datos
| <code>5432</code>
|-
| PROYECTO_DB_DBNAME
| el nombre de la base de datos de negocio
| <code>db_proyecto</code>
|-
| PROYECTO_DB_USERNAME
| el usuario para la conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
| <code>public</code>
|-
| PROYECTO_DB_ENCODING
| la codificación de caracteres de la base de datos
| <code>LATIN1</code>
|}

== Configuración de la base de datos de Toba ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="16%"| Descripción
|-
| TOBA_DB_HOST
| el host o dirección ip del equipo donde corre la base de datos
|-
| TOBA_DB_PORT
| el puerto donde corre la base de datos
|-
| TOBA_DB_DBNAME
| el nombre de la base de datos
|-
| TOBA_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| TOBA_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| TOBA_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| TOBA_DB_ENCODING
| la codificación de caracteres de la base de datos. Debe ser <code>LATIN1</code>
|}

<blockquote>Esta configuración es opcional, solo requerida para separar la db de negocios de la del proyecto Toba.
</blockquote>

== Configuración de la base de datos de Arai Proveedores ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="16%"| Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}
<blockquote>Esta configuración es opcional, genera la base de datos central de Arai Proveedores.
</blockquote>
<blockquote>El usuario para conectarse a la base de datos requiere de permisos de creación de base de datos y tablas durante el proceso de instalación/actualización.</blockquote>

== Configuración para envío de mails ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| SMTP_ENTRADA
| nombre de configuración en el smtp.ini de Toba.
|-
| SMTP_HELO
| nombre HELO del host del servicio SMTP
|-
| SMTP_HOST
| host del servicio SMTP
|-
| SMTP_PORT
| puerto del servicio SMTP
|-
| SMTP_FROM
| dirección que envía el mail
|-
| SMTP_SEGURIDAD
| el tipo de seguridad SMPT. Puede ser <code>ssl</code> o <code>tls</code>
|-
| SMTP_AUTH
| si requiere autenticación. Puede ser <code>1</code> o <code>0</code>
|-
| SMTP_USUARIO
| el usuario con el cual autenticar en el SMTP
|-
| SMTP_CLAVE
| la clave del usuario
|}

<blockquote>Esta configuración es opcional, se utiliza para validar conexión al smtp y configurar en el sistema.
</blockquote>

== Configuración para uso de RestHooks ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| REST_HOOKS_REDIS_HOST
| Host del servicio Redis
|-
| REST_HOOKS_REDIS_PORT
| Puerto del servicio Redis
|}

<blockquote>Esta configuración es opcional, se utiliza para validar conexión al servidor redis y configurar en el sistema el uso de RestHooks.
</blockquote>

== Configuración para uso de SSO vía IDP ==

{| class="wikitable"
!width="61%"| Variable de entorno
!width="38%"| Descripción
|-
| SSO_SP_IDP_METADATA_URL
| URL del IDP donde estén accesibles los metadatos
|-
| SSO_SP_IDP_URL_SERVICE
| URL del IDP donde esté accesible el servicio
|-
| SSO_SP_IDP_SINGLE_LOGOUT_URL_SERVICE
| URL para cerrar sesión en el IDP
|-
| SSO_SP_IDP_PUBLIC_KEY_FILE
| Ruta al archivo donde está el certificado usado para contactar al IDP
|-
| SSO_SP_ATRIBUTO_USUARIO
| El atributo del IDP que contiene el identificador de usuario
|-
| SSO_SP_PERMITE_LOGIN_TOBA
| Si se activa el login interno del proyecto vía Toba. Posibles valores <code>0</code> y <code>1</code>
|-
| SSO_SP_AUTH_SOURCE
| El auth source del SP, por defecto suele ser <code>default-sp</code>
|-
| SSO_SP_COOKIE_NAME
| Nombre de la cookie manejada por OneLogin, por ej. <code>TOBA_SESSID</code>
|-
| SSO_SP_IDP_NAME
| Nombre del IDP
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el uso de autenticación centralizada vía un IDP.
</blockquote>

== Configuración para uso de API REST ==

{| class="wikitable"
!width="61%"| Variable de entorno
!width="38%"| Descripción
|-
| REST_CLIENTE_USUARIO
| El usuario con el cual autenticar como cliente a una api REST.
|-
| REST_CLIENTE_CLAVE
| La clave del usuario
|-
| REST_CLIENTE_AUTH
| El tipo de autenticación del cliente REST <code>basic</code> o <code>digest</code>
|-
| REST_SERVIDOR_AUTH
| El tipo de autenticación del servidor REST <code>basic</code> o <code>digest</code>
|-
| REST_ARAI_SYNC_KEY_FILE
| Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí <code>arai-sync.key</code>
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso de apis tipo REST.
</blockquote>

== Configuración para uso de la API de AFIP ==

{| class="wikitable"
!width="61%"| Variable de entorno
!width="38%"| Descripción
|-
| AFIP_WS_CUIT
| CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| Ruta absoluta donde se encuentra almacenado el certificado.
|-
| AFIP_WS_KEY
| Ruta absoluta donde se encuentra almacenado el archivo de clave.
|-
| AFIP_WS_TOKEN_DIR
| Ruta absoluta donde la librería generará el token (requiere permisos de escritura).
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

== Configuración de conexión a Araí-Documentos ==

{| class="wikitable"
!width="61%"| Variable de entorno
!width="38%"| Descripción
|-
| DOCUMENTOS_HOST
| Es la url de conexión a Arai-Documentos. Ej: http://url.api.arai.documentos/docs/rest/backend/v1/
|-
| DOCUMENTOS_USUARIO
| Usuario de la API de Arai-Documentos.
|-
| DOCUMENTOS_CLAVE
| Contraseña de la API de Arai-Documentos
|-
| URL_NOTIFICACIONES
| URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini. Este parámetro NO es obligatorio, si NO se define el instalador.env, la URL se construye utilizando las variables de entorno existentes de la sgte forma:

'''TOBA_URL_BASE . TOBA_ALIAS_PROYECTO . /rest/v1/notificaciones/documento'''

|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de Araí-Documentos.
</blockquote>

SIU-Diaguita/version4.3.0instalacion actualizacion/instalador env vars

2026-01-15T16:35:23Z

Pboyko:

SIU-Diaguita/version4.2.0

2026-01-15T16:34:03Z

Pboyko:

__NOTOC__

[[Archivo:siu-diaguita.png|derecha|link=]]
 
 
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
Número de versión: 4.2.0
Fecha de publicación: '''15/01/2026'''
 [[SIU-Diaguita/Version4.2.0/Novedades_funcionales | Principales novedades]] 

</div>

{|
|-
! http://portal.comunidad.siu.edu.ar//images/iconos/boton_funcional_2.png Documentación Funcional !!                               !! http://portal.comunidad.siu.edu.ar//images/iconos/boton_tecnico_2.png Documentación Técnica
|-
| [[SIU-Diaguita/version4.2.0/glosario_de_conceptos|Glosario de conceptos]] ||                               || [[SIU-Diaguita/version4.2.0/instalacion_actualizacion|Instalación y Actualización de SIU-Diaguita]]
|-
| [[SIU-Diaguita/version4.2.0/primeros_pasos|Primeros pasos]] ||                              ||[[SIU-Diaguita/version4.2.0/post_instalacion|Post Instalación]]
|-
| [[SIU-Diaguita/version4.2.0/configuracion_del_sistema|Configuración de la aplicación]] ||                              ||[[SIU-Diaguita/version4.2.0/consideraciones_tecnicas| Otras consideraciones técnicas]]
|-
| [[SIU-Diaguita/version4.2.0/aspectos_generales_de_las_operaciones|Aspectos generales de las operaciones]] ||                              ||[[SIU-Diaguita/version4.2.0/personalizacion|Personalización]]
|-

| [[SIU-Diaguita/version4.2.0/principales_circuitos_funcionales|Principales circuitos funcionales]] ||                              ||[[SIU-Diaguita/version4.2.0/preguntas_frecuentes|Preguntas frecuentes]]
|-
| [[SIU-Diaguita/version4.2.0/documentacion_de_las_operaciones|Documentación de las operaciones]] ||                               ||[[SIU-Diaguita/version4.2.0/contactanos|Contactanos]]
|-

|-

| [[SIU-Diaguita/version4.2.0/interoperabilidad sistema expediente|'''Interoperabilidad con el Ecosistema SIU''']] ||                              ||[[SIU-Diaguita/version4.2.0/links de interes|Links de interés]]
|-
| [[SIU-Diaguita/version4.2.0/integracion_diaguita|Integración con otros sistemas]]
||                              || [[SIU-Diaguita/version4.2.0/guia_rapida_diaguita_eei|Guía Rápida Diaguita EEI]]
|-
| [[SIU-Diaguita/version4.2.0/preguntas_frecuentes_funcional|Preguntas frecuentes]] ||                              ||
|-
|[[SIU-Diaguita/version4.2.0/links de interes_funcional|Links de interés]]
||                              ||
|-
|[[SIU-Diaguita/version4.2.0/contactanos|Contactanos]]
|
|
|}

SIU-Diaguita/version4.3.0

2026-01-15T16:34:03Z

Pboyko:

__NOTOC__

[[Archivo:siu-diaguita.png|derecha|link=]]
 
 
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
Número de versión: 4.3.0
Fecha de publicación: '''15/01/2026'''
 [[SIU-Diaguita/Version4.3.0/Novedades_funcionales | Principales novedades]] 

</div>

{|
|-
! http://portal.comunidad.siu.edu.ar//images/iconos/boton_funcional_2.png Documentación Funcional !!                               !! http://portal.comunidad.siu.edu.ar//images/iconos/boton_tecnico_2.png Documentación Técnica
|-
| [[SIU-Diaguita/version4.3.0/glosario_de_conceptos|Glosario de conceptos]] ||                               || [[SIU-Diaguita/version4.3.0/instalacion_actualizacion|Instalación y Actualización de SIU-Diaguita]]
|-
| [[SIU-Diaguita/version4.3.0/primeros_pasos|Primeros pasos]] ||                              ||[[SIU-Diaguita/version4.3.0/post_instalacion|Post Instalación]]
|-
| [[SIU-Diaguita/version4.3.0/configuracion_del_sistema|Configuración de la aplicación]] ||                              ||[[SIU-Diaguita/version4.3.0/consideraciones_tecnicas| Otras consideraciones técnicas]]
|-
| [[SIU-Diaguita/version4.3.0/aspectos_generales_de_las_operaciones|Aspectos generales de las operaciones]] ||                              ||[[SIU-Diaguita/version4.3.0/personalizacion|Personalización]]
|-

| [[SIU-Diaguita/version4.3.0/principales_circuitos_funcionales|Principales circuitos funcionales]] ||                              ||[[SIU-Diaguita/version4.3.0/preguntas_frecuentes|Preguntas frecuentes]]
|-
| [[SIU-Diaguita/version4.3.0/documentacion_de_las_operaciones|Documentación de las operaciones]] ||                               ||[[SIU-Diaguita/version4.3.0/contactanos|Contactanos]]
|-

|-

| [[SIU-Diaguita/version4.3.0/interoperabilidad sistema expediente|'''Interoperabilidad con el Ecosistema SIU''']] ||                              ||[[SIU-Diaguita/version4.3.0/links de interes|Links de interés]]
|-
| [[SIU-Diaguita/version4.3.0/integracion_diaguita|Integración con otros sistemas]]
||                              || [[SIU-Diaguita/version4.3.0/guia_rapida_diaguita_eei|Guía Rápida Diaguita EEI]]
|-
| [[SIU-Diaguita/version4.3.0/preguntas_frecuentes_funcional|Preguntas frecuentes]] ||                              ||
|-
|[[SIU-Diaguita/version4.3.0/links de interes_funcional|Links de interés]]
||                              ||
|-
|[[SIU-Diaguita/version4.3.0/contactanos|Contactanos]]
|
|
|}

SIU-Diaguita/version4.2.0instalacion actualizacion/instalador env vars

2026-01-15T16:33:06Z

Pboyko: /* Variables de entorno para la instalación */

= Variables de entorno para la instalación =

A continuación, se describen las variables de entorno que son utilizadas para realizar la instalación. Éstas están en el archivo [[../instalador.env.dist|''instalador.env.dist'']].

Los parámetros comentados con <code>#</code> son parámetros opcionales, la configuración de la base de datos de negocio es obligatoria y es opcional definir una configuración separada para la base de datos de Toba, por defecto ambas bases de datos están en una misma base en distintos schemas.

También opcionalmente se puede personalizar las rutas de <code>TOBA_PROYECTO_DIR</code> y <code>TOBA_INSTALACION_DIR</code>, esto es útil para casos especiales.

Opcionalmente podemos definir si el entorno es de producción <code>ENTORNO_PRODUCCION="1"</code> o desarrollo <code>ENTORNO_PRODUCCION="0"</code> por defecto asume que el ambiente es producción.

== Configuración del instalador ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="16%"| Descripción
|-
| INSTALADOR_TIMEOUT
| tiempo de ejecución de los comandos internos que tiene el instalador. Por defecto 1200 segundos
|-
| ENTORNO_PRODUCCION
| indica si la instalación es un entorno de producción. El valor <code>1</code> es producción, <code>0</code> solo en casos de ambientes de desarrollo
|}

== Configuración interna de Toba ==

{| class="wikitable"
!width="38%"| Variable de entorno
!width="24%"| Descripción
!width="0%"| Valor por defecto
|-
| TOBA_URL_BASE
| La url base pública de acceso al sistema, sin alias del proyecto. Ej: <code>https://diaguita.institucion.edu.ar</code>
| <code>http://localhost</code>
|-
| TOBA_URL_PORT
| Opcional, el puerto de la url definida en la variable anterior
| <code>80</code>
|-
| TOBA_USUARIO
| El usuario administrador del proyecto, en caso de actualización dejar valor por defecto
| <code>toba</code>
|-
| TOBA_PASSWORD
| El password del usuario administrador, en caso de actualización dejar valor por defecto
| <code>toba123*-a</code>
|-
| TOBA_INSTALACION_DIR
| Opcional, el directorio donde va a quedar los archivos de la instalacion del proyecto toba.
| <code>diaguita/instalacion</code>
|-
| TOBA_PROYECTO_DIR
| Opcional, el directorio donde está el proyecto toba
|

|-
| TOBA_ALIAS_PROYECTO
| El alias Apache para el acceso al proyecto
| <code>/diaguita</code>
|-
| TOBA_ALIAS_NUCLEO
| Opcional, el alias Apache para acceso al núcleo de Toba
| <code>/toba_diaguita</code>
|-
| TOBA_ALIAS_TOBA_USUARIOS
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-usuarios</code>
| <code>/toba_usuarios</code>
|-
| TOBA_ALIAS_TOBA_EDITOR
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-editor</code>
| <code>/toba_editor</code>
|-
| TOBA_ALIAS_TOBA_REFERENCIA
| Opcional, el alias Apache para el acceso al proyecto <code>Toba-referencia</code>
| <code>/toba_referencia</code>
|-
| TOBA_ID_DESARROLLADOR
| Opcional, el id desarrollador toba.
| <code>0</code>
|-
| TOBA_SESSION_NAME
| Opcional, el nombre de cookie donde se almacena las sesiones en el navegador. Si se tiene multiples instalaciones en el mimso dominio, deben ser distintas
| <code>TOBA_DIAGUITA</code>
|-
| TOBA_FORZAR_HTTPS
| Opcional, si se desea utilizar https, o un proxy reverso y forzar que la aplicación opere con HTTPS. Puede ser <code>off</code> u <code>on</code>
| <code>Off</code>
|-
| TOBA_SALT
| Opcional, la semilla o sal para ser utilizada en los algoritmos de encriptación internos de SIU-Toba
| Caracteres aleatorios
|}

== Configuración de la base de datos de negocio ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="16%"| Descripción
!width="23%"| Valor por defecto
|-
| PROYECTO_DB_HOST
| el host/ip del equipo donde corre la base de datos
| <code>localhost</code>
|-
| PROYECTO_DB_PORT
| el puerto donde corre la base de datos
| <code>5432</code>
|-
| PROYECTO_DB_DBNAME
| el nombre de la base de datos de negocio
| <code>db_proyecto</code>
|-
| PROYECTO_DB_USERNAME
| el usuario para la conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
| <code>postgres</code>
|-
| PROYECTO_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
| <code>public</code>
|-
| PROYECTO_DB_ENCODING
| la codificación de caracteres de la base de datos
| <code>LATIN1</code>
|}

== Configuración de la base de datos de Toba ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="16%"| Descripción
|-
| TOBA_DB_HOST
| el host o dirección ip del equipo donde corre la base de datos
|-
| TOBA_DB_PORT
| el puerto donde corre la base de datos
|-
| TOBA_DB_DBNAME
| el nombre de la base de datos
|-
| TOBA_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| TOBA_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| TOBA_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| TOBA_DB_ENCODING
| la codificación de caracteres de la base de datos. Debe ser <code>LATIN1</code>
|}

<blockquote>Esta configuración es opcional, solo requerida para separar la db de negocios de la del proyecto Toba.
</blockquote>

== Configuración de la base de datos de Arai Proveedores ==

{| class="wikitable"
!width="25%"| Variable de entorno
!width="16%"| Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}
<blockquote>Esta configuración es opcional, genera la base de datos central de Arai Proveedores.
</blockquote>
<blockquote>El usuario para conectarse a la base de datos requiere de permisos de creación de base de datos y tablas durante el proceso de instalación/actualización.</blockquote>

== Configuración para envío de mails ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| SMTP_ENTRADA
| nombre de configuración en el smtp.ini de Toba.
|-
| SMTP_HELO
| nombre HELO del host del servicio SMTP
|-
| SMTP_HOST
| host del servicio SMTP
|-
| SMTP_PORT
| puerto del servicio SMTP
|-
| SMTP_FROM
| dirección que envía el mail
|-
| SMTP_SEGURIDAD
| el tipo de seguridad SMPT. Puede ser <code>ssl</code> o <code>tls</code>
|-
| SMTP_AUTH
| si requiere autenticación. Puede ser <code>1</code> o <code>0</code>
|-
| SMTP_USUARIO
| el usuario con el cual autenticar en el SMTP
|-
| SMTP_CLAVE
| la clave del usuario
|}

<blockquote>Esta configuración es opcional, se utiliza para validar conexión al smtp y configurar en el sistema.
</blockquote>

== Configuración para uso de RestHooks ==

{| class="wikitable"
! Variable de entorno
! Descripción
|-
| REST_HOOKS_REDIS_HOST
| Host del servicio Redis
|-
| REST_HOOKS_REDIS_PORT
| Puerto del servicio Redis
|}

<blockquote>Esta configuración es opcional, se utiliza para validar conexión al servidor redis y configurar en el sistema el uso de RestHooks.
</blockquote>

== Configuración para uso de SSO vía IDP ==

{| class="wikitable"
!width="61%"| Variable de entorno
!width="38%"| Descripción
|-
| SSO_SP_IDP_METADATA_URL
| URL del IDP donde estén accesibles los metadatos
|-
| SSO_SP_IDP_URL_SERVICE
| URL del IDP donde esté accesible el servicio
|-
| SSO_SP_IDP_SINGLE_LOGOUT_URL_SERVICE
| URL para cerrar sesión en el IDP
|-
| SSO_SP_IDP_PUBLIC_KEY_FILE
| Ruta al archivo donde está el certificado usado para contactar al IDP
|-
| SSO_SP_ATRIBUTO_USUARIO
| El atributo del IDP que contiene el identificador de usuario
|-
| SSO_SP_PERMITE_LOGIN_TOBA
| Si se activa el login interno del proyecto vía Toba. Posibles valores <code>0</code> y <code>1</code>
|-
| SSO_SP_AUTH_SOURCE
| El auth source del SP, por defecto suele ser <code>default-sp</code>
|-
| SSO_SP_COOKIE_NAME
| Nombre de la cookie manejada por OneLogin, por ej. <code>TOBA_SESSID</code>
|-
| SSO_SP_IDP_NAME
| Nombre del IDP
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el uso de autenticación centralizada vía un IDP.
</blockquote>

== Configuración para uso de API REST ==

{| class="wikitable"
!width="61%"| Variable de entorno
!width="38%"| Descripción
|-
| REST_CLIENTE_USUARIO
| El usuario con el cual autenticar como cliente a una api REST.
|-
| REST_CLIENTE_CLAVE
| La clave del usuario
|-
| REST_CLIENTE_AUTH
| El tipo de autenticación del cliente REST <code>basic</code> o <code>digest</code>
|-
| REST_SERVIDOR_AUTH
| El tipo de autenticación del servidor REST <code>basic</code> o <code>digest</code>
|-
| REST_ARAI_SYNC_KEY_FILE
| Opcional, ruta al archivo donde está el certificado usado para sincronizar apis REST con Araí <code>arai-sync.key</code>
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso de apis tipo REST.
</blockquote>

== Configuración para uso de la API de AFIP ==

{| class="wikitable"
!width="61%"| Variable de entorno
!width="38%"| Descripción
|-
| AFIP_WS_CUIT
| CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| Ruta absoluta donde se encuentra almacenado el certificado.
|-
| AFIP_WS_KEY
| Ruta absoluta donde se encuentra almacenado el archivo de clave.
|-
| AFIP_WS_TOKEN_DIR
| Ruta absoluta donde la librería generará el token (requiere permisos de escritura).
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

== Configuración de conexión a Araí-Documentos ==

{| class="wikitable"
!width="61%"| Variable de entorno
!width="38%"| Descripción
|-
| DOCUMENTOS_HOST
| Es la url de conexión a Arai-Documentos. Ej: http://url.api.arai.documentos/docs/rest/backend/v1/
|-
| DOCUMENTOS_USUARIO
| Usuario de la API de Arai-Documentos.
|-
| DOCUMENTOS_CLAVE
| Contraseña de la API de Arai-Documentos
|-
| URL_NOTIFICACIONES
| URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini. Este parámetro NO es obligatorio, si NO se define el instalador.env, la URL se construye utilizando las variables de entorno existentes
|}

<blockquote>Esta configuración es opcional, se utiliza para configurar en el sistema el acceso a la api de AFIP.
</blockquote>

SIU-Diaguita/version4.2.0/post instalacion

2026-01-15T16:28:51Z

Pboyko: /* Configurar los parámetros para Araí-Documentos en SIU-Diaguita */

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.2.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.2.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.25 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.26 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.2.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.2.0, se debe modificar la url de conexión a Araí-Documentos y colocar la url completa de la sgte forma en el instalador.env:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/
</source>

A partir de la version 1.8.0 de Araí-Documentos se puede utilizar la version de la API en la url. Si bien en la version 1.8.0 funciona con y sin la version, es recomendable colocarla porque será requerido en versiones posteriores.

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/v1/
</source>

Hasta la version 4.1.0 de SIU-Diaguita se definía de esta forma:
:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
</source>

A partir de la versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini. Este parámetro NO es obligatorio, si NO se define el instalador.env, la URL se construye utilizando las variables de entorno existentes de la sgte forma:

TOBA_URL_BASE . TOBA_ALIAS_PROYECTO . /rest/v1/notificaciones/documento
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.2.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.2.0 | < Volver]]

SIU-Diaguita/version4.3.0/post instalacion

2026-01-15T16:28:51Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.3.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.3.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.3.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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.3. 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.3.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.35 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.36 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.3.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.3.0, se debe modificar la url de conexión a Araí-Documentos y colocar la url completa de la sgte forma en el instalador.env:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/
</source>

A partir de la version 1.8.0 de Araí-Documentos se puede utilizar la version de la API en la url. Si bien en la version 1.8.0 funciona con y sin la version, es recomendable colocarla porque será requerido en versiones posteriores.

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/v1/
</source>

Hasta la version 4.1.0 de SIU-Diaguita se definía de esta forma:
:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
</source>

A partir de la versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini. Este parámetro NO es obligatorio, si NO se define el instalador.env, la URL se construye utilizando las variables de entorno existentes de la sgte forma:

TOBA_URL_BASE . TOBA_ALIAS_PROYECTO . /rest/v1/notificaciones/documento
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.3.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.3.0 | < Volver]]

SIU-Diaguita/version4.2.0/post instalacion

2026-01-15T16:28:02Z

Pboyko: /* Configurar los parámetros para Araí-Documentos en SIU-Diaguita */

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.2.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.2.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.25 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.26 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.2.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.2.0, se debe modificar la url de conexión a Araí-Documentos y colocar la url completa de la sgte forma en el instalador.env:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/
</source>

A partir de la version 1.8.0 de Araí-Documentos se puede utilizar la version de la API en la url. Si bien en la version 1.8.0 funciona con y sin la version, es recomendable colocarla porque será requerido en versiones posteriores.

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/v1/
</source>

Hasta la version 4.1.0 de SIU-Diaguita se definía de esta forma:
:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
</source>

A partir de la versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini. Este parametro NO es obligatorio, si NO se define el instalador.env, la URL se construye utilizando las variables de entorno existentes de la sgte forma:

'''ENV['TOBA_URL_BASE']''' . ENV['TOBA_ALIAS_PROYECTO'].'/rest/v1/notificaciones/documento'
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.2.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.2.0 | < Volver]]

SIU-Diaguita/version4.2.0/post instalacion

2026-01-15T16:27:31Z

Pboyko: /* Configurar los parámetros para Araí-Documentos en SIU-Diaguita */

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.2.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.2.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.25 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.26 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.2.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.2.0, se debe modificar la url de conexión a Araí-Documentos y colocar la url completa de la sgte forma en el instalador.env:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/
</source>

A partir de la version 1.8.0 de Araí-Documentos se puede utilizar la version de la API en la url. Si bien en la version 1.8.0 funciona con y sin la version, es recomendable colocarla porque será requerido en versiones posteriores.

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/v1/
</source>

Hasta la version 4.1.0 de SIU-Diaguita se definía de esta forma:
:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
</source>

A partir de la versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini. Este parametro NO es obligatorio, si NO se define el instalador.env, la URL se construye utilizando las variables de entorno existentes de la sgte forma: ENV['TOBA_URL_BASE'] . ENV['TOBA_ALIAS_PROYECTO'].'/rest/v1/notificaciones/documento'
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.2.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.2.0 | < Volver]]

SIU-Diaguita/Version4.2.0/Novedades funcionales

2026-01-15T15:41:43Z

Pboyko: /* Principales novedades de la versión */

=Principales novedades de la versión=
- Importación de documentos adjuntos en Oferta Electrónica a partir de la v2.2. de Huarpe Proveedores.
 
- Vinculación de adjuntos de oferta electrónica a EEI (Expediente Electrónico Integrado)
 
- Soporte para QR en etiquetas de bienes patrimoniales
 
- Mejoras de seguridad
 
- Mejoras en carga de proveedores
 
- Ajustes en solicitudes de bajas de bienes en estado borrador
 

 
-----
[[SIU-Diaguita/version4.2.0|<Volver]]

SIU-Diaguita/Version4.3.0/Novedades funcionales

2026-01-15T15:41:43Z

Pboyko:

SIU-Diaguita/Version4.2.0/Novedades funcionales

2026-01-15T15:37:54Z

Pboyko:

=Principales novedades de la versión=
- Soporte a versión 2.2.0 del Portal del Proveedor para permitir adjuntar documentos a las ofertas electrónicas.
 
- A
 

 
-----
[[SIU-Diaguita/version4.2.0|<Volver]]

SIU-Diaguita/Version4.2.0/Novedades funcionales

2026-01-15T15:37:27Z

Pboyko: /* Principales novedades de la versión */

=Principales novedades de la versión=
- Soporte a versión 2.2.0 del Portal del Proveedor.
 
- A
 

 
-----
[[SIU-Diaguita/version4.2.0|<Volver]]

SIU-Diaguita/version4.2.0/post instalacion

2026-01-15T15:36:46Z

Pboyko: /* Configurar los parámetros para Araí-Documentos en SIU-Diaguita */

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.2.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.2.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.25 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.26 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.2.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.2.0, se debe modificar la url de conexión a Araí-Documentos y colocar la url completa de la sgte forma en el instalador.env:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/
</source>

A partir de la version 1.8.0 de Araí-Documentos se puede utilizar la version de la API en la url. Si bien en la version 1.8.0 funciona con y sin la version, es recomendable colocarla porque será requerido en versiones posteriores.

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/v1/
</source>

Hasta la version 4.1.0 de SIU-Diaguita se definía de esta forma:
:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
</source>

A partir de la versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.2.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.2.0 | < Volver]]

SIU-Diaguita/version4.2.0/instalacion actualizacion

2026-01-15T15:33:26Z

Pboyko: /* Instalación/Actualización del sistema SIU-Diaguita */

= Instalación/Actualización del sistema SIU-Diaguita =

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sgte sección antes de comenzar con la instalación/actualización: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__

Se recomienda realizar dos instalaciones del sistema, una para los usuarios y otra para el equipo informático, tanto durante el período de testeo como durante la etapa de producción del sistema, de manera de independizar las pruebas que se realizan.
Considere la instalación del navegador en cada estación de trabajo, el sistema SIU-Diaguita fue desarrollado para funcionar en forma óptima en el Mozilla Firefox, las últimas versiones del mismo tienen un manejo optimizado de la memoria.

== Esquema ==

El siguiente esquema muestra en detalle los pasos para una instalación y actualización del sistema SIU-Diaguita, en este esquema se contempla el procedimiento según se necesite personalizar o no.

[http://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version4.2.0/instalacion_actualizacion/esquema Esquema]

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

Las versiones recomendadas son las siguientes:

[http://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version4.2.0/instalacion_actualizacion/requisitos Tabla de requerimientos]

== Instalación ==

La instalación del sistema SIU-Diaguita se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.

=== Pasos previos a un proceso de instalación ===

#Antes de realizar la instalación verificar [http://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version4.2.0/instalacion_actualizacion/requisitos Tabla de requerimientos]
#Descargar el sistema de SIU-Diaguita desde el sitio http://portal.comunidad.siu.edu.ar/ cuyo nombre es '<nowiki/>'''SIU-Diaguita_4.2.X.zip''''.
#Descomprimir el archivo y copiar el directorio SIU-Diaguita en la máquina destino en el directorio donde se desea instalar el sistema.
#Luego, para descargar las librerías del proyecto ingresar al directorio recién descomprimido de SIU-Diaguita (ultima versión) y ejecutar:
#:<source lang="bash" enclose="div">
composer install --no-dev
</source>
#Nota: Si por algún motivo no puede utilizarse el comando composer install ver sección [[#Instalación de librerías sin usar composer]]
#Copiar el archivo instalador.env.dist y renombrar a instalador.env, en linux se puede utilizar el siguiente comando:
#:<source lang="bash" enclose="div">
cp instalador.env.dist instalador.env
</source>
#Configurar el archivo '''instalador.env''' con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador se debe configurar para que la base de datos de negocio de Diaguita y la de Toba queden dentro de una misma base de datos (como es la opción por defecto). Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link: [http://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
#:<source lang="bash" enclose="div">
chmod +x bin/instalador
</source>

=== Instalación de librerías sin usar composer ===
Si por algún motivo no puede utilizarse el comando composer install para descargar las librerias necesarias, por ejemplo por no tener acceso a internet en el servidor donde se esta instalando, se debe seguir los sgtes pasos para reemplazar el uso de de composer install:

# Descargar el archivo vendor.7z y descomprimirlo en el directorio raiz del proyecto
# Crear un enlace simbolico del binario de toba en el directorio bin del proyecto.
Dentro del directorio bin ejecutar:
<source lang="bash" enclose="div">
ln -s ../vendor/siu-toba/framework/bin/toba toba
ln -s ../vendor/siu/arai-cli/bin/arai-cli arai-cli
ln -s ../vendor/robmorgan/phinx/bin/phinx phinx
</source>

=== Instalación desde cero sin personalizaciones ===

Para realizar una instalación de cero sin personalizaciones, es necesario iniciar una instalación en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de producción con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>
Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post instalación]]

=== Instalación desde cero en entorno de desarrollo ===

Para realizar una instalación de cero con personalizaciones, es necesario iniciar una instalación en modo desarrollo ya que es necesario requerir de los proyectos Toba Editor y Toba Referencia.

<source lang="bash" enclose="div">
No se recomienda realizar una instalación de un entorno de desarrollo para producción, ya que al contar con un sistema instalado en modo desarrollo cualquier usuario puede tener acceso al proyecto Toba-Editor y podría realizar modificaciones sobre el sistema vulnerando la seguridad del mismo.
Otro factor a tener en cuenta es que un sistema instalado en entorno de desarrollo no utiliza metadatos compilados, los cuales si se manejan en una instalación en entorno de producción y sin esto disminuye significativamente la performance del sistema.
</source>

Una vez realizado lo explicado en el ítem de [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para realizar una instalación en entorno de desarrollo se debe configurar en el archivo de parámetros del instalador, '''instalador.env''', el parámetro '''ENTORNO_PRODUCCION''' con el valor 0.

:<source lang="bash" enclose="div">
ENTORNO_PRODUCCION="0"
</source>

Para instalar en entorno de desarrollo con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>

Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:

:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>

Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:

:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post instalación]]

== Actualización ==
=== Recomendaciones previas a la actualización ===

'''IMPORTANTE:'''
<source lang="bash" enclose="div">
La versión 4.2.0 de SIU-Diaguita incrementa la versión mínima soportada de Postgres a la versión 12. Por lo tanto, previo a la actualización, es necesario que el Backup realizado de la Base de Datos sea importado en una de las versiones de Postgres soportada (12, 13 o 14). Luego de esto, los parámetros de conexión indicados en el instalador.env de la versión 4.2.0 deben ser los de la nueva versión de Postgres donde ya se encuentra la Base de Datos operativa.
</source>

Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.

<source lang="bash" enclose="div">
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.
</source>

===== Verificar configuración del entorno de la instalación anterior =====

Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''SIU-Diaguita-anterior/instalacion/entorno_toba.env''''

Para el caso de una instalación en un sistema operativo Linux la estructura del archivo sera la siguiente, verificar si se encuentra correctamente configurado nuestra ruta de instalación a SIU-Diaguita

<source lang="bash" enclose="div">
export TOBA_DIR=/ruta_instalacion_a_diaguita/vendor/siu-toba/framework
export TOBA_INSTANCIA=produccion
export TOBA_INSTALACION_DIR=/ruta_instalacion_a_diaguita/instalacion
export PATH="$TOBA_DIR/bin:$PATH"
</source>

Para el caso de una instalación en un servidor con sistema operativo Windows, se debe validar la existencia del archivo '<nowiki/>'''entorno_toba_4.2.bat'''' dentro del directorio del usuario del sistema. Se debe tener en cuenta que si se tienen múltiples instalaciones en el mismo servidor, este archivo tendrá los valores de la ultima instalación realizada por lo tanto es necesario verificar que se encuentre con los valores de la instalación de SIU-Diaguita que se desea actualizar.

<source lang="bash" enclose="div">
set TOBA_PROYECTO=diaguita
set TOBA_INSTANCIA=produccion
set TOBA_INSTALACION_DIR=/ruta_instalacion_a_diaguita/instalacion

set toba_dir=/ruta_instalacion_a_diaguita/vendor/siu-toba/framework

set diaguita_dir=/ruta_instalacion_a_diaguita
</source>

Otra aclaración para instalaciones en SO Windows, es que en los comandos php -como el caso del comando instalador- requieren que se agregue explicitamente php previo al comando, ejemplo:

<source lang="bash" enclose="div">
php instalador proyecto:instalar
</source>

===== Verificar configuración de la instancia de la instalación anterior =====

Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '<nowiki/>'''SIU-Diaguita/instalacion/i__produccion/instancia.ini'<nowiki/>''' y dentro de este verificar si esta configurado el parámetro '<nowiki/>'''usar_perfiles_propios = "1"'''' el cual es
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.

<source lang="bash" enclose="div">
[diaguita]
path = "/ruta_instalacion_a_diaguita"
url = "/diaguita"
full_url = "http://localhost/diaguita"
url_pers = "/diaguita_pers/"
usar_perfiles_propios = "1"
</source>

===== Verificar permisos de lectura y escritura de la instalación anterior =====

Durante el proceso de actualización es necesario que el usuario del sistema el cual ejecuta el instalador tenga permisos de lectura y escritura sobre el SIU-Diaguita anterior.

<source lang="bash" enclose="div">
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.
</source>

=== Configuración del archivo instalador.env ===
Para la actualización, es necesario abrir y editar las siguientes entradas del archivo instalador.env
<source lang="bash" enclose="div">
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_DBNAME="nombre de base de datos actualizar"
###### CONFIG DE TOBA ######
TOBA_ALIAS_PROYECTO="/XXXXXX"
TOBA_ALIAS_NUCLEO="/XXXXXX"( cambiarlo para que utilize versiones la versión anterior)
</source>

=== Actualización de entradas al archivo instalador.env ===
El comando proyecto:definir-variables se encarga de crear el archivo instalador.env cuando no existe, también puede agregar las variables faltantes en un archivo existente.

:<source lang="bash" enclose="div">
./bin/instalador proyecto:definir-variables
</source>

=== Importante: Instalaciones que utilicen sincronización con araí proveedores ===
Para actualizaciones, cuando se utiliza sincronización de proveedores mediante araí proveedores es necesario realizar las configuraciones que se encuentran a continuación
[[SIU-Diaguita/version4.2.0/consideraciones_tecnicas#Configuraci.C3.B3n_de_la_base_de_datos_de_Arai_Proveedores|Configuración de la base de datos de Arai Proveedores]]

=== Actualización de una instalación sin personalizaciones ===

Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Para realizar una actualización sin personalizaciones, es necesario iniciar una instalación en modo producción. El instalador no soporta actualizaciones de instalaciones en entorno de desarrollo.

Una vez realizado lo explicado en el ítem de [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], y luego de chequear los requerimientos previos a la actualización, el instalador nos proporciona el siguiente comando para ejecutar el
proceso de actualización:

Para actualizar en entorno de producción se ejecuta el siguiente comando:
<source lang="bash" enclose="div">
./bin/instalador proyecto:actualizar -d /RUTA_INSTALACION_ANTERIOR/
</source>

Una vez ejecutado el comando de actualización, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post actualización]]

=== Actualización de una instalación con personalizaciones ===

Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Cada vez que para el SIU-Diaguita este disponible una nueva versión (versión original generada por el equipo de SIU), se deberá migrar manualmente desde un entorno de desarrollo previo. El procedimiento de trabajo implica migrar la personalización desde la versión anterior a la siguiente sin saltearse ninguna versión intermedia. Para ello, desde un repositorio se tendrá que descargar la nueva versión y realizar la instalación nueva en modo desarrollo.

Es recomendable no utilizar el entorno de desarrollo anterior, así este puede ser utilizado para realizar bugfixes y correcciones que sean necesarios para la actual versión en producción. Procediendo sobre una nueva instalación de SIU-Diaguita, realizar:

:<source lang="bash" enclose="div">
# Descarga la nueva version
svn checkout https://repositorio/svn/diaguita/nodos/<sigla institucion>/trunk/4.2.0/

# En la nueva versión realiza una instalación en desarrollo con base de datos de negocio existente
./bin/instalador proyecto:instalar --db-negocio-existente

# Mezcla los cambios hechos en la version 4.2.0 hacia esta nueva version
svn merge https://repositorio/svn/diaguita/nodos/<sigla institucion>/trunk/4.2.0/personalizacion carpeta_proyecto/personalizacion

# Inicia la personalizacion
toba personalizacion iniciar

# Chequea si hay posibles conflictos
toba personalizacion conflictos

# Toma los archivos .xml de la carpeta personalización y los carga a metadatos en la base
toba personalizacion importar

# Exporta los metadatos como archivos .sql en la carpeta metadatos
toba proyecto exportar

svn commit
</source>

== Post Instalación/Actualización ==

Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.

=== Verificar archivo de log del instalador ===
El instalador durante el proceso de ejecución de cada comando genera un archivo de log en la raíz del proyecto, dentro de este archivo se encuentra detallado toda la historia de ejecución de procesos y
en el podemos detectar cualquier tipo de error o advertencia que pueda ocurrir durante su ejecución, por eso es de mucha utilidad verificar este archivo y ayuda a entender cualquier falla.

Una de las alternativas para visualizar el archivo de log es de la siguiente manera:
:<source lang="bash" enclose="div">
less instalador.log
</source>

=== Modificar permisos ===
Permite modificar los permisos del proyecto, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración.

Al ejecutar el comando intentara identificar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache, con la posibilidad de definir ambos parámetros en el caso de que sean distintos a los sugeridos.

Ejecute el siguiente comando como superusuario:

:<source lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</source>

Como parámetros opcionales se puede enviar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache como argumentos mediante el siguiente parámetro:

:<source lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple -U usuario -W www-data
</source>

=== Configuración del servidor de aplicaciones ===

Para la configuración del servidor web les proponemos las siguientes opciones.

Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:

<source lang="bash" enclose="div">
ln -s /ruta_instalacion/diaguita/instalacion/toba.conf /etc/apache2/sites-enabled/SIU-Diaguita.conf
</source>

Para servidores windows, agregar la siguiente linea al archivo de configuración de Apache (httpd.conf)

<source lang="apache" enclose="div">
Include /ruta_instalacion/diaguita/instalacion/toba.conf
</source>

Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Otra opción de configuración, independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre Diaguita con el siguiente contenido:

<source lang="apache" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual accederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-available del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea).

Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

=== Chequear requerimientos web ===
Antes de activar el sistema sacándolo del modo mantenimiento es recomendable que ejecute el link que le proporciona el instalador al finalizar la instalación en un navegador web de modo que se pueda hacer un chequeo de los requerimientos en el servidor web y de esa forma asegurarnos que tenemos configurado correctamente el php.ini que corre el apache y luego sacarlo del modo mantenimiento.

<source lang="apt_sources" enclose="div">

### AL FINALIZAR LA INSTALACIÓN EL INSTALADOR LE GENERA UN LINK AL CHEQUEO WEB CON LA URL CONFIGURADA EN LA INSTALACIÓN ###

http://servidor.universidad.edu.ar/diaguita/check.php

</source>

El chequeo web no permite ejecutar remotamente desde un navegador, para el caso que el servidor no disponga una interfaz gráfica para ejecutar de forma local el chequeo en el navegador web, una alternativa puede ser
instalar la aplicación '''lynx''' para poder ejecutar un navegador web desde linea de comando de la siguiente manera:

<source lang="bash" enclose="div">

### Chequeo web desde un navegador web por consola de comandos

lynx http://servidor.universidad.edu.ar/diaguita/check.php

</source>

=== Activar el sistema ===
Al finalizar el proceso el sistema queda configurado en modo mantenimiento, para desactivar el modo mantenimiento ejecutar el siguiente comando:
<source lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
</source>

== Personalizaciones ==

En el sistema SIU-Diaguita se ha implementado el esquema de personalizaciones ofrecido por el SIU-Toba. Este esquema permite que se realicen cambios sobre un sistema entregado por el SIU y que estos cambios se persistan a través de diferentes versiones.

Para poder implementar este esquema de personalizaciones y mantenerlo en un espacio de desarrollo colaborativo se debe contar con un sistema de control de versiones y tener versionado la versión propia del sistema con las personalizaciones.

A continuación se describe el mecanismo que permite desarrollar una personalización completa del SIU-Diaguita, basándonos en una instalación pre-existente de SIU-Diaguita versión 4.2.x realizada mediante el uso del instalador de proyectos del SIU.

En este esquema se recomienda que exista una persona que denominaremos concentrador, quien será el único que utilice los comandos de personalización y proveerá así al resto del grupo, de mayor flexibilidad en el entorno de trabajo diario. El resto del equipo trabaja de manera normal con Toba sin percatarse de que existe una personalización vigente, excepto a la hora de guardar archivos PHP.

=== Activar esquema de personalizaciones ===

Para iniciar la personalización, se recomienda que únicamente la persona que cumpla el rol de concentrador ejecute los siguientes comandos. El concentrador debe definir el esquema de PostgreSQL temporal a ser usado por el proceso de cálculo de diferencias en la personalización, en el archivo /SIU-Diaguita/personalizacion/personalizacion.ini:

:<source lang="bash" enclose="div">
iniciada = "no"
schema_personalizado = "<schema_personalizado>"
</source>

Y por último, inicializar propiamente la personalización. Es obligatorio que este cambio se suba al repositorio para mantener la configuración del ambiente de desarrollo. Para finalizar, el concentrador realiza el commit de los cambios realizados.

:<source lang="bash" enclose="div">
bin/toba personalizacion iniciar -p diaguita -i desarrollo
svn commit
</source>

A partir de este momento, todas las personas que participen del equipo de desarrollo deben descargarse la versión del sistema con personalizaciones que se mantiene versionada en un repositorio de la universidad, y luego pueden seguir los pasos de la [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n_desde_cero_en_entorno_de_desarrollo|Instalación desde cero en entorno de desarrollo]]. Estas personas podrán ejecutar todas las tareas relacionadas con el proyecto, excepto aquellas que se indican explícitamente a ser ejecutadas por el concentrador.

=== Desarrollar nuevas personalizaciones ===

La siguiente guía es un ejemplo [[SIU-Diaguita/version4.2.0/personalizacion|paso a paso]] para desarrollar una personalización de SIU-Diaguita, mediante el uso del toba-editor para la extensión y modificación de las funciones y características del mismo. Esto puede ser desarrollado de forma individual o en forma colaborativa con un equipo de desarrollo.

== Crear una versión propia con personalizaciones ==



== Instalación de cero de un ambiente de producción con personalizaciones ==

Para realizar una instalación de un ambiente de producción con personalizaciones se debe partir de una instalación en modo desarrollo con personalizaciones.

Una vez que se migraron las personalizaciones a una nueva versión del sistema en modo desarrollo y estas fueron testeadas y ya esta en condiciones para llevar a producción, a la versión de SIU-Diaguita en desarrollo con personalizaciones ejecutar los siguientes comandos:

:<source lang="bash" enclose="div">
# Exportar metadatos del proyecto
toba proyecto exportar

# Exportar personalización del proyecto
toba personalizacion exportar

# Subir los metadatos exportados al repositorio
svn commit
</source>

Una vez realizado los pasos anteriores, luego descargar la versión propia de SIU-Diaguita con personalizaciones para realizar una instalación en producción.
Antes de instalar realizar lo explicado en el ítem de [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]].

:<source lang="bash" enclose="div">
# Descarga la nueva versión propia con personalizaciones
svn checkout https://repositorio/svn/diaguita/nodos/<sigla institucion>/trunk/4.2.0/

# Realiza una instalación en producción del SIU-Diaguita con personalizaciones versión 4.2.0
./bin/instalador proyecto:instalar
</source>

== Actualización del ambiente de producción con personalizaciones ==

Para llevar a cabo una actualización de un ambiente de producción con personalizaciones se debe partir de una instalación en modo produccion con personalizaciones de la ultima versión del sistema.

Para esto previamente se debe realizar [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n_de_cero_de_un_ambiente_de_producci.C3.B3n_con_personalizaciones|Instalación de cero de un ambiente de producción con personalizaciones]].

Luego de tener instalada la versión en producción con personalizaciones, para migrar los usuarios y perfiles de acceso de la instalación en producción anterior se debe realizar una actualización sobre esta nueva instalación en producción configurando correctamente el archivo de parámetros del instalador y luego ejecutando el siguiente comando:

:<source lang="bash" enclose="div">
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
</source>

= Verificar Configuración SIU-Diaguita =
Esta configuración Visual es una ayuda que se encuentra dentro del Menú Administración => [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.2/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

----
[[SIU-Diaguita/version4.2.0|<Volver]]

SIU-Diaguita/version4.3.0/instalacion actualizacion

2026-01-15T15:33:26Z

Pboyko:

= Instalación/Actualización del sistema SIU-Diaguita =

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sgte sección antes de comenzar con la instalación/actualización: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.3.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__

Se recomienda realizar dos instalaciones del sistema, una para los usuarios y otra para el equipo informático, tanto durante el período de testeo como durante la etapa de producción del sistema, de manera de independizar las pruebas que se realizan.
Considere la instalación del navegador en cada estación de trabajo, el sistema SIU-Diaguita fue desarrollado para funcionar en forma óptima en el Mozilla Firefox, las últimas versiones del mismo tienen un manejo optimizado de la memoria.

== Esquema ==

El siguiente esquema muestra en detalle los pasos para una instalación y actualización del sistema SIU-Diaguita, en este esquema se contempla el procedimiento según se necesite personalizar o no.

[http://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version4.3.0/instalacion_actualizacion/esquema Esquema]

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

Las versiones recomendadas son las siguientes:

[http://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version4.3.0/instalacion_actualizacion/requisitos Tabla de requerimientos]

== Instalación ==

La instalación del sistema SIU-Diaguita se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.

=== Pasos previos a un proceso de instalación ===

#Antes de realizar la instalación verificar [http://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version4.3.0/instalacion_actualizacion/requisitos Tabla de requerimientos]
#Descargar el sistema de SIU-Diaguita desde el sitio http://portal.comunidad.siu.edu.ar/ cuyo nombre es '<nowiki/>'''SIU-Diaguita_4.3.X.zip''''.
#Descomprimir el archivo y copiar el directorio SIU-Diaguita en la máquina destino en el directorio donde se desea instalar el sistema.
#Luego, para descargar las librerías del proyecto ingresar al directorio recién descomprimido de SIU-Diaguita (ultima versión) y ejecutar:
#:<source lang="bash" enclose="div">
composer install --no-dev
</source>
#Nota: Si por algún motivo no puede utilizarse el comando composer install ver sección [[#Instalación de librerías sin usar composer]]
#Copiar el archivo instalador.env.dist y renombrar a instalador.env, en linux se puede utilizar el siguiente comando:
#:<source lang="bash" enclose="div">
cp instalador.env.dist instalador.env
</source>
#Configurar el archivo '''instalador.env''' con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador se debe configurar para que la base de datos de negocio de Diaguita y la de Toba queden dentro de una misma base de datos (como es la opción por defecto). Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link: [http://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.3.0instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
#:<source lang="bash" enclose="div">
chmod +x bin/instalador
</source>

=== Instalación de librerías sin usar composer ===
Si por algún motivo no puede utilizarse el comando composer install para descargar las librerias necesarias, por ejemplo por no tener acceso a internet en el servidor donde se esta instalando, se debe seguir los sgtes pasos para reemplazar el uso de de composer install:

# Descargar el archivo vendor.7z y descomprimirlo en el directorio raiz del proyecto
# Crear un enlace simbolico del binario de toba en el directorio bin del proyecto.
Dentro del directorio bin ejecutar:
<source lang="bash" enclose="div">
ln -s ../vendor/siu-toba/framework/bin/toba toba
ln -s ../vendor/siu/arai-cli/bin/arai-cli arai-cli
ln -s ../vendor/robmorgan/phinx/bin/phinx phinx
</source>

=== Instalación desde cero sin personalizaciones ===

Para realizar una instalación de cero sin personalizaciones, es necesario iniciar una instalación en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de producción con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>
Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post instalación]]

=== Instalación desde cero en entorno de desarrollo ===

Para realizar una instalación de cero con personalizaciones, es necesario iniciar una instalación en modo desarrollo ya que es necesario requerir de los proyectos Toba Editor y Toba Referencia.

<source lang="bash" enclose="div">
No se recomienda realizar una instalación de un entorno de desarrollo para producción, ya que al contar con un sistema instalado en modo desarrollo cualquier usuario puede tener acceso al proyecto Toba-Editor y podría realizar modificaciones sobre el sistema vulnerando la seguridad del mismo.
Otro factor a tener en cuenta es que un sistema instalado en entorno de desarrollo no utiliza metadatos compilados, los cuales si se manejan en una instalación en entorno de producción y sin esto disminuye significativamente la performance del sistema.
</source>

Una vez realizado lo explicado en el ítem de [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para realizar una instalación en entorno de desarrollo se debe configurar en el archivo de parámetros del instalador, '''instalador.env''', el parámetro '''ENTORNO_PRODUCCION''' con el valor 0.

:<source lang="bash" enclose="div">
ENTORNO_PRODUCCION="0"
</source>

Para instalar en entorno de desarrollo con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>

Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:

:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>

Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:

:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post instalación]]

== Actualización ==
=== Recomendaciones previas a la actualización ===

'''IMPORTANTE:'''
<source lang="bash" enclose="div">
La versión 4.3.0 de SIU-Diaguita incrementa la versión mínima soportada de Postgres a la versión 12. Por lo tanto, previo a la actualización, es necesario que el Backup realizado de la Base de Datos sea importado en una de las versiones de Postgres soportada (12, 13 o 14). Luego de esto, los parámetros de conexión indicados en el instalador.env de la versión 4.3.0 deben ser los de la nueva versión de Postgres donde ya se encuentra la Base de Datos operativa.
</source>

Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.

<source lang="bash" enclose="div">
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.
</source>

===== Verificar configuración del entorno de la instalación anterior =====

Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''SIU-Diaguita-anterior/instalacion/entorno_toba.env''''

Para el caso de una instalación en un sistema operativo Linux la estructura del archivo sera la siguiente, verificar si se encuentra correctamente configurado nuestra ruta de instalación a SIU-Diaguita

<source lang="bash" enclose="div">
export TOBA_DIR=/ruta_instalacion_a_diaguita/vendor/siu-toba/framework
export TOBA_INSTANCIA=produccion
export TOBA_INSTALACION_DIR=/ruta_instalacion_a_diaguita/instalacion
export PATH="$TOBA_DIR/bin:$PATH"
</source>

Para el caso de una instalación en un servidor con sistema operativo Windows, se debe validar la existencia del archivo '<nowiki/>'''entorno_toba_4.3.bat'''' dentro del directorio del usuario del sistema. Se debe tener en cuenta que si se tienen múltiples instalaciones en el mismo servidor, este archivo tendrá los valores de la ultima instalación realizada por lo tanto es necesario verificar que se encuentre con los valores de la instalación de SIU-Diaguita que se desea actualizar.

<source lang="bash" enclose="div">
set TOBA_PROYECTO=diaguita
set TOBA_INSTANCIA=produccion
set TOBA_INSTALACION_DIR=/ruta_instalacion_a_diaguita/instalacion

set toba_dir=/ruta_instalacion_a_diaguita/vendor/siu-toba/framework

set diaguita_dir=/ruta_instalacion_a_diaguita
</source>

Otra aclaración para instalaciones en SO Windows, es que en los comandos php -como el caso del comando instalador- requieren que se agregue explicitamente php previo al comando, ejemplo:

<source lang="bash" enclose="div">
php instalador proyecto:instalar
</source>

===== Verificar configuración de la instancia de la instalación anterior =====

Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '<nowiki/>'''SIU-Diaguita/instalacion/i__produccion/instancia.ini'<nowiki/>''' y dentro de este verificar si esta configurado el parámetro '<nowiki/>'''usar_perfiles_propios = "1"'''' el cual es
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.

<source lang="bash" enclose="div">
[diaguita]
path = "/ruta_instalacion_a_diaguita"
url = "/diaguita"
full_url = "http://localhost/diaguita"
url_pers = "/diaguita_pers/"
usar_perfiles_propios = "1"
</source>

===== Verificar permisos de lectura y escritura de la instalación anterior =====

Durante el proceso de actualización es necesario que el usuario del sistema el cual ejecuta el instalador tenga permisos de lectura y escritura sobre el SIU-Diaguita anterior.

<source lang="bash" enclose="div">
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.
</source>

=== Configuración del archivo instalador.env ===
Para la actualización, es necesario abrir y editar las siguientes entradas del archivo instalador.env
<source lang="bash" enclose="div">
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_DBNAME="nombre de base de datos actualizar"
###### CONFIG DE TOBA ######
TOBA_ALIAS_PROYECTO="/XXXXXX"
TOBA_ALIAS_NUCLEO="/XXXXXX"( cambiarlo para que utilize versiones la versión anterior)
</source>

=== Actualización de entradas al archivo instalador.env ===
El comando proyecto:definir-variables se encarga de crear el archivo instalador.env cuando no existe, también puede agregar las variables faltantes en un archivo existente.

:<source lang="bash" enclose="div">
./bin/instalador proyecto:definir-variables
</source>

=== Importante: Instalaciones que utilicen sincronización con araí proveedores ===
Para actualizaciones, cuando se utiliza sincronización de proveedores mediante araí proveedores es necesario realizar las configuraciones que se encuentran a continuación
[[SIU-Diaguita/version4.3.0/consideraciones_tecnicas#Configuraci.C3.B3n_de_la_base_de_datos_de_Arai_Proveedores|Configuración de la base de datos de Arai Proveedores]]

=== Actualización de una instalación sin personalizaciones ===

Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Para realizar una actualización sin personalizaciones, es necesario iniciar una instalación en modo producción. El instalador no soporta actualizaciones de instalaciones en entorno de desarrollo.

Una vez realizado lo explicado en el ítem de [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], y luego de chequear los requerimientos previos a la actualización, el instalador nos proporciona el siguiente comando para ejecutar el
proceso de actualización:

Para actualizar en entorno de producción se ejecuta el siguiente comando:
<source lang="bash" enclose="div">
./bin/instalador proyecto:actualizar -d /RUTA_INSTALACION_ANTERIOR/
</source>

Una vez ejecutado el comando de actualización, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post actualización]]

=== Actualización de una instalación con personalizaciones ===

Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Cada vez que para el SIU-Diaguita este disponible una nueva versión (versión original generada por el equipo de SIU), se deberá migrar manualmente desde un entorno de desarrollo previo. El procedimiento de trabajo implica migrar la personalización desde la versión anterior a la siguiente sin saltearse ninguna versión intermedia. Para ello, desde un repositorio se tendrá que descargar la nueva versión y realizar la instalación nueva en modo desarrollo.

Es recomendable no utilizar el entorno de desarrollo anterior, así este puede ser utilizado para realizar bugfixes y correcciones que sean necesarios para la actual versión en producción. Procediendo sobre una nueva instalación de SIU-Diaguita, realizar:

:<source lang="bash" enclose="div">
# Descarga la nueva version
svn checkout https://repositorio/svn/diaguita/nodos/<sigla institucion>/trunk/4.3.0/

# En la nueva versión realiza una instalación en desarrollo con base de datos de negocio existente
./bin/instalador proyecto:instalar --db-negocio-existente

# Mezcla los cambios hechos en la version 4.3.0 hacia esta nueva version
svn merge https://repositorio/svn/diaguita/nodos/<sigla institucion>/trunk/4.3.0/personalizacion carpeta_proyecto/personalizacion

# Inicia la personalizacion
toba personalizacion iniciar

# Chequea si hay posibles conflictos
toba personalizacion conflictos

# Toma los archivos .xml de la carpeta personalización y los carga a metadatos en la base
toba personalizacion importar

# Exporta los metadatos como archivos .sql en la carpeta metadatos
toba proyecto exportar

svn commit
</source>

== Post Instalación/Actualización ==

Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.

=== Verificar archivo de log del instalador ===
El instalador durante el proceso de ejecución de cada comando genera un archivo de log en la raíz del proyecto, dentro de este archivo se encuentra detallado toda la historia de ejecución de procesos y
en el podemos detectar cualquier tipo de error o advertencia que pueda ocurrir durante su ejecución, por eso es de mucha utilidad verificar este archivo y ayuda a entender cualquier falla.

Una de las alternativas para visualizar el archivo de log es de la siguiente manera:
:<source lang="bash" enclose="div">
less instalador.log
</source>

=== Modificar permisos ===
Permite modificar los permisos del proyecto, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración.

Al ejecutar el comando intentara identificar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache, con la posibilidad de definir ambos parámetros en el caso de que sean distintos a los sugeridos.

Ejecute el siguiente comando como superusuario:

:<source lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</source>

Como parámetros opcionales se puede enviar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache como argumentos mediante el siguiente parámetro:

:<source lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple -U usuario -W www-data
</source>

=== Configuración del servidor de aplicaciones ===

Para la configuración del servidor web les proponemos las siguientes opciones.

Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:

<source lang="bash" enclose="div">
ln -s /ruta_instalacion/diaguita/instalacion/toba.conf /etc/apache2/sites-enabled/SIU-Diaguita.conf
</source>

Para servidores windows, agregar la siguiente linea al archivo de configuración de Apache (httpd.conf)

<source lang="apache" enclose="div">
Include /ruta_instalacion/diaguita/instalacion/toba.conf
</source>

Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Otra opción de configuración, independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre Diaguita con el siguiente contenido:

<source lang="apache" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual accederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-available del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea).

Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

=== Chequear requerimientos web ===
Antes de activar el sistema sacándolo del modo mantenimiento es recomendable que ejecute el link que le proporciona el instalador al finalizar la instalación en un navegador web de modo que se pueda hacer un chequeo de los requerimientos en el servidor web y de esa forma asegurarnos que tenemos configurado correctamente el php.ini que corre el apache y luego sacarlo del modo mantenimiento.

<source lang="apt_sources" enclose="div">

### AL FINALIZAR LA INSTALACIÓN EL INSTALADOR LE GENERA UN LINK AL CHEQUEO WEB CON LA URL CONFIGURADA EN LA INSTALACIÓN ###

http://servidor.universidad.edu.ar/diaguita/check.php

</source>

El chequeo web no permite ejecutar remotamente desde un navegador, para el caso que el servidor no disponga una interfaz gráfica para ejecutar de forma local el chequeo en el navegador web, una alternativa puede ser
instalar la aplicación '''lynx''' para poder ejecutar un navegador web desde linea de comando de la siguiente manera:

<source lang="bash" enclose="div">

### Chequeo web desde un navegador web por consola de comandos

lynx http://servidor.universidad.edu.ar/diaguita/check.php

</source>

=== Activar el sistema ===
Al finalizar el proceso el sistema queda configurado en modo mantenimiento, para desactivar el modo mantenimiento ejecutar el siguiente comando:
<source lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
</source>

== Personalizaciones ==

En el sistema SIU-Diaguita se ha implementado el esquema de personalizaciones ofrecido por el SIU-Toba. Este esquema permite que se realicen cambios sobre un sistema entregado por el SIU y que estos cambios se persistan a través de diferentes versiones.

Para poder implementar este esquema de personalizaciones y mantenerlo en un espacio de desarrollo colaborativo se debe contar con un sistema de control de versiones y tener versionado la versión propia del sistema con las personalizaciones.

A continuación se describe el mecanismo que permite desarrollar una personalización completa del SIU-Diaguita, basándonos en una instalación pre-existente de SIU-Diaguita versión 4.3.x realizada mediante el uso del instalador de proyectos del SIU.

En este esquema se recomienda que exista una persona que denominaremos concentrador, quien será el único que utilice los comandos de personalización y proveerá así al resto del grupo, de mayor flexibilidad en el entorno de trabajo diario. El resto del equipo trabaja de manera normal con Toba sin percatarse de que existe una personalización vigente, excepto a la hora de guardar archivos PHP.

=== Activar esquema de personalizaciones ===

Para iniciar la personalización, se recomienda que únicamente la persona que cumpla el rol de concentrador ejecute los siguientes comandos. El concentrador debe definir el esquema de PostgreSQL temporal a ser usado por el proceso de cálculo de diferencias en la personalización, en el archivo /SIU-Diaguita/personalizacion/personalizacion.ini:

:<source lang="bash" enclose="div">
iniciada = "no"
schema_personalizado = "<schema_personalizado>"
</source>

Y por último, inicializar propiamente la personalización. Es obligatorio que este cambio se suba al repositorio para mantener la configuración del ambiente de desarrollo. Para finalizar, el concentrador realiza el commit de los cambios realizados.

:<source lang="bash" enclose="div">
bin/toba personalizacion iniciar -p diaguita -i desarrollo
svn commit
</source>

A partir de este momento, todas las personas que participen del equipo de desarrollo deben descargarse la versión del sistema con personalizaciones que se mantiene versionada en un repositorio de la universidad, y luego pueden seguir los pasos de la [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Instalaci.C3.B3n_desde_cero_en_entorno_de_desarrollo|Instalación desde cero en entorno de desarrollo]]. Estas personas podrán ejecutar todas las tareas relacionadas con el proyecto, excepto aquellas que se indican explícitamente a ser ejecutadas por el concentrador.

=== Desarrollar nuevas personalizaciones ===

La siguiente guía es un ejemplo [[SIU-Diaguita/version4.3.0/personalizacion|paso a paso]] para desarrollar una personalización de SIU-Diaguita, mediante el uso del toba-editor para la extensión y modificación de las funciones y características del mismo. Esto puede ser desarrollado de forma individual o en forma colaborativa con un equipo de desarrollo.

== Crear una versión propia con personalizaciones ==



== Instalación de cero de un ambiente de producción con personalizaciones ==

Para realizar una instalación de un ambiente de producción con personalizaciones se debe partir de una instalación en modo desarrollo con personalizaciones.

Una vez que se migraron las personalizaciones a una nueva versión del sistema en modo desarrollo y estas fueron testeadas y ya esta en condiciones para llevar a producción, a la versión de SIU-Diaguita en desarrollo con personalizaciones ejecutar los siguientes comandos:

:<source lang="bash" enclose="div">
# Exportar metadatos del proyecto
toba proyecto exportar

# Exportar personalización del proyecto
toba personalizacion exportar

# Subir los metadatos exportados al repositorio
svn commit
</source>

Una vez realizado los pasos anteriores, luego descargar la versión propia de SIU-Diaguita con personalizaciones para realizar una instalación en producción.
Antes de instalar realizar lo explicado en el ítem de [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]].

:<source lang="bash" enclose="div">
# Descarga la nueva versión propia con personalizaciones
svn checkout https://repositorio/svn/diaguita/nodos/<sigla institucion>/trunk/4.3.0/

# Realiza una instalación en producción del SIU-Diaguita con personalizaciones versión 4.3.0
./bin/instalador proyecto:instalar
</source>

== Actualización del ambiente de producción con personalizaciones ==

Para llevar a cabo una actualización de un ambiente de producción con personalizaciones se debe partir de una instalación en modo produccion con personalizaciones de la ultima versión del sistema.

Para esto previamente se debe realizar [[SIU-Diaguita/version4.3.0/instalacion_actualizacion#Instalaci.C3.B3n_de_cero_de_un_ambiente_de_producci.C3.B3n_con_personalizaciones|Instalación de cero de un ambiente de producción con personalizaciones]].

Luego de tener instalada la versión en producción con personalizaciones, para migrar los usuarios y perfiles de acceso de la instalación en producción anterior se debe realizar una actualización sobre esta nueva instalación en producción configurando correctamente el archivo de parámetros del instalador y luego ejecutando el siguiente comando:

:<source lang="bash" enclose="div">
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
</source>

= Verificar Configuración SIU-Diaguita =
Esta configuración Visual es una ayuda que se encuentra dentro del Menú Administración => [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.3/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

----
[[SIU-Diaguita/version4.3.0|<Volver]]

SIU-Diaguita/version4.2.0/post instalacion

2026-01-15T15:33:11Z

Pboyko: /* Configurar los parámetros para Araí-Documentos en SIU-Diaguita */

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.2.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.2.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.25 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.26 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.2.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.2.0, se debe modificar la url de conexión a Araí-Documentos y colocar la url completa de la sgte forma:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/
</source>

A partir de la version 1.8.0 de Araí-Documentos se puede utilizar la version de la API en la url. Si bien en la version 1.8.0 funciona con y sin la version, es recomendable colocarla porque será requerido en versiones posteriores.

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/v1/
</source>

Hasta la version 4.1.0 de SIU-Diaguita se definía de esta forma:
:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
</source>

A partir de la versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.2.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.2.0 | < Volver]]

SIU-Diaguita

2026-01-15T15:32:35Z

Pboyko: /* Documentación */

SIU-Diaguita

2026-01-15T15:32:24Z

Pboyko: /* Documentación */

SIU-Diaguita/version4.2.0/instalacion actualizacion

2026-01-15T15:26:52Z

Pboyko: /* Instalación/Actualización del sistema SIU-Diaguita */

= Instalación/Actualización del sistema SIU-Diaguita =

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sgte sección antes de comenzar con la instalación: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__

Se recomienda realizar dos instalaciones del sistema, una para los usuarios y otra para el equipo informático, tanto durante el período de testeo como durante la etapa de producción del sistema, de manera de independizar las pruebas que se realizan.
Considere la instalación del navegador en cada estación de trabajo, el sistema SIU-Diaguita fue desarrollado para funcionar en forma óptima en el Mozilla Firefox, las últimas versiones del mismo tienen un manejo optimizado de la memoria.

== Esquema ==

El siguiente esquema muestra en detalle los pasos para una instalación y actualización del sistema SIU-Diaguita, en este esquema se contempla el procedimiento según se necesite personalizar o no.

[http://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version4.2.0/instalacion_actualizacion/esquema Esquema]

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

Las versiones recomendadas son las siguientes:

[http://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version4.2.0/instalacion_actualizacion/requisitos Tabla de requerimientos]

== Instalación ==

La instalación del sistema SIU-Diaguita se realiza mediante el instalador de proyectos y aplicaciones SIU integrado dentro del código fuente del sistema que distribuye el SIU. El cual brinda los mecanismos mínimos necesarios para realizar una instalación de forma estandarizada, homogénea y controlable.

=== Pasos previos a un proceso de instalación ===

#Antes de realizar la instalación verificar [http://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Diaguita/version4.2.0/instalacion_actualizacion/requisitos Tabla de requerimientos]
#Descargar el sistema de SIU-Diaguita desde el sitio http://portal.comunidad.siu.edu.ar/ cuyo nombre es '<nowiki/>'''SIU-Diaguita_4.2.X.zip''''.
#Descomprimir el archivo y copiar el directorio SIU-Diaguita en la máquina destino en el directorio donde se desea instalar el sistema.
#Luego, para descargar las librerías del proyecto ingresar al directorio recién descomprimido de SIU-Diaguita (ultima versión) y ejecutar:
#:<source lang="bash" enclose="div">
composer install --no-dev
</source>
#Nota: Si por algún motivo no puede utilizarse el comando composer install ver sección [[#Instalación de librerías sin usar composer]]
#Copiar el archivo instalador.env.dist y renombrar a instalador.env, en linux se puede utilizar el siguiente comando:
#:<source lang="bash" enclose="div">
cp instalador.env.dist instalador.env
</source>
#Configurar el archivo '''instalador.env''' con los datos correspondientes al proyecto y a toba. Los datos que están comentados con el símbolo numeral # no son datos obligatorios, los demás datos son requeridos que se completen. Dentro del archivo de parámetros del instalador se debe configurar para que la base de datos de negocio de Diaguita y la de Toba queden dentro de una misma base de datos (como es la opción por defecto). Para obtener mayor información sobre cada parámetro de configuración del instalador abrir el siguiente link: [http://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0instalacion_actualizacion/instalador_env_vars Variables de entorno para la instalación]
#El archivo binario de instalación debe tener permisos de ejecución para esto ejecutar:
#:<source lang="bash" enclose="div">
chmod +x bin/instalador
</source>

=== Instalación de librerías sin usar composer ===
Si por algún motivo no puede utilizarse el comando composer install para descargar las librerias necesarias, por ejemplo por no tener acceso a internet en el servidor donde se esta instalando, se debe seguir los sgtes pasos para reemplazar el uso de de composer install:

# Descargar el archivo vendor.7z y descomprimirlo en el directorio raiz del proyecto
# Crear un enlace simbolico del binario de toba en el directorio bin del proyecto.
Dentro del directorio bin ejecutar:
<source lang="bash" enclose="div">
ln -s ../vendor/siu-toba/framework/bin/toba toba
ln -s ../vendor/siu/arai-cli/bin/arai-cli arai-cli
ln -s ../vendor/robmorgan/phinx/bin/phinx phinx
</source>

=== Instalación desde cero sin personalizaciones ===

Para realizar una instalación de cero sin personalizaciones, es necesario iniciar una instalación en modo producción ya que no es necesario requerir de los proyectos Toba Editor y Toba Referencias.

Una vez realizado lo explicado en el ítem de [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para instalar en entorno de producción con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>
Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>
Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post instalación]]

=== Instalación desde cero en entorno de desarrollo ===

Para realizar una instalación de cero con personalizaciones, es necesario iniciar una instalación en modo desarrollo ya que es necesario requerir de los proyectos Toba Editor y Toba Referencia.

<source lang="bash" enclose="div">
No se recomienda realizar una instalación de un entorno de desarrollo para producción, ya que al contar con un sistema instalado en modo desarrollo cualquier usuario puede tener acceso al proyecto Toba-Editor y podría realizar modificaciones sobre el sistema vulnerando la seguridad del mismo.
Otro factor a tener en cuenta es que un sistema instalado en entorno de desarrollo no utiliza metadatos compilados, los cuales si se manejan en una instalación en entorno de producción y sin esto disminuye significativamente la performance del sistema.
</source>

Una vez realizado lo explicado en el ítem de [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], el instalador nos proporciona distintas opciones de ejecución del comando de instalación dependiendo de la configuración:

Para realizar una instalación en entorno de desarrollo se debe configurar en el archivo de parámetros del instalador, '''instalador.env''', el parámetro '''ENTORNO_PRODUCCION''' con el valor 0.

:<source lang="bash" enclose="div">
ENTORNO_PRODUCCION="0"
</source>

Para instalar en entorno de desarrollo con una base de datos existente vacía ejecutar:
:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar
</source>

Como parámetros opcionales podemos agregar el siguiente argumento el cual permite crear desde el instalador una base de datos de negocio vacía:

:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --crear-db
</source>

Otro parametro opcional es el siguiente el cual permite realizar una instalación usando una base de datos de negocio existente:

:<source lang="bash" enclose="div">
./bin/instalador proyecto:instalar --db-negocio-existente
</source>

Una vez ejecutado el comando de instalación, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post instalación]]

== Actualización ==
=== Recomendaciones previas a la actualización ===

'''IMPORTANTE:'''
<source lang="bash" enclose="div">
La versión 4.2.0 de SIU-Diaguita incrementa la versión mínima soportada de Postgres a la versión 12. Por lo tanto, previo a la actualización, es necesario que el Backup realizado de la Base de Datos sea importado en una de las versiones de Postgres soportada (12, 13 o 14). Luego de esto, los parámetros de conexión indicados en el instalador.env de la versión 4.2.0 deben ser los de la nueva versión de Postgres donde ya se encuentra la Base de Datos operativa.
</source>

Antes de iniciar el proceso de actualización se recomienda verificar las configuraciones de la instalación anterior del sistema.

<source lang="bash" enclose="div">
Es importante no renombrar ni mover la carpeta de instalación anterior hasta que se haya terminado el proceso de actualización.
</source>

===== Verificar configuración del entorno de la instalación anterior =====

Se debe abrir el archivo que se encuentra dentro del directorio de instalación anterior '<nowiki/>'''SIU-Diaguita-anterior/instalacion/entorno_toba.env''''

Para el caso de una instalación en un sistema operativo Linux la estructura del archivo sera la siguiente, verificar si se encuentra correctamente configurado nuestra ruta de instalación a SIU-Diaguita

<source lang="bash" enclose="div">
export TOBA_DIR=/ruta_instalacion_a_diaguita/vendor/siu-toba/framework
export TOBA_INSTANCIA=produccion
export TOBA_INSTALACION_DIR=/ruta_instalacion_a_diaguita/instalacion
export PATH="$TOBA_DIR/bin:$PATH"
</source>

Para el caso de una instalación en un servidor con sistema operativo Windows, se debe validar la existencia del archivo '<nowiki/>'''entorno_toba_4.2.bat'''' dentro del directorio del usuario del sistema. Se debe tener en cuenta que si se tienen múltiples instalaciones en el mismo servidor, este archivo tendrá los valores de la ultima instalación realizada por lo tanto es necesario verificar que se encuentre con los valores de la instalación de SIU-Diaguita que se desea actualizar.

<source lang="bash" enclose="div">
set TOBA_PROYECTO=diaguita
set TOBA_INSTANCIA=produccion
set TOBA_INSTALACION_DIR=/ruta_instalacion_a_diaguita/instalacion

set toba_dir=/ruta_instalacion_a_diaguita/vendor/siu-toba/framework

set diaguita_dir=/ruta_instalacion_a_diaguita
</source>

Otra aclaración para instalaciones en SO Windows, es que en los comandos php -como el caso del comando instalador- requieren que se agregue explicitamente php previo al comando, ejemplo:

<source lang="bash" enclose="div">
php instalador proyecto:instalar
</source>

===== Verificar configuración de la instancia de la instalación anterior =====

Para verificar si se encuentra correctamente configurada la instancia del proyecto, se debe abrir el archivo '<nowiki/>'''SIU-Diaguita/instalacion/i__produccion/instancia.ini'<nowiki/>''' y dentro de este verificar si esta configurado el parámetro '<nowiki/>'''usar_perfiles_propios = "1"'''' el cual es
necesario para poder realizar la migración de perfiles de la instalación anterior a la nueva instalación.

<source lang="bash" enclose="div">
[diaguita]
path = "/ruta_instalacion_a_diaguita"
url = "/diaguita"
full_url = "http://localhost/diaguita"
url_pers = "/diaguita_pers/"
usar_perfiles_propios = "1"
</source>

===== Verificar permisos de lectura y escritura de la instalación anterior =====

Durante el proceso de actualización es necesario que el usuario del sistema el cual ejecuta el instalador tenga permisos de lectura y escritura sobre el SIU-Diaguita anterior.

<source lang="bash" enclose="div">
El directorio de instalación del proyecto anterior a actualizar debe poder ser accesible para la lectura y escritura de los archivos y directorios.
</source>

=== Configuración del archivo instalador.env ===
Para la actualización, es necesario abrir y editar las siguientes entradas del archivo instalador.env
<source lang="bash" enclose="div">
###### CONFIG DE BASE DE DATOS DE NEGOCIO ######
PROYECTO_DB_DBNAME="nombre de base de datos actualizar"
###### CONFIG DE TOBA ######
TOBA_ALIAS_PROYECTO="/XXXXXX"
TOBA_ALIAS_NUCLEO="/XXXXXX"( cambiarlo para que utilize versiones la versión anterior)
</source>

=== Actualización de entradas al archivo instalador.env ===
El comando proyecto:definir-variables se encarga de crear el archivo instalador.env cuando no existe, también puede agregar las variables faltantes en un archivo existente.

:<source lang="bash" enclose="div">
./bin/instalador proyecto:definir-variables
</source>

=== Importante: Instalaciones que utilicen sincronización con araí proveedores ===
Para actualizaciones, cuando se utiliza sincronización de proveedores mediante araí proveedores es necesario realizar las configuraciones que se encuentran a continuación
[[SIU-Diaguita/version4.2.0/consideraciones_tecnicas#Configuraci.C3.B3n_de_la_base_de_datos_de_Arai_Proveedores|Configuración de la base de datos de Arai Proveedores]]

=== Actualización de una instalación sin personalizaciones ===

Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Para realizar una actualización sin personalizaciones, es necesario iniciar una instalación en modo producción. El instalador no soporta actualizaciones de instalaciones en entorno de desarrollo.

Una vez realizado lo explicado en el ítem de [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]], y luego de chequear los requerimientos previos a la actualización, el instalador nos proporciona el siguiente comando para ejecutar el
proceso de actualización:

Para actualizar en entorno de producción se ejecuta el siguiente comando:
<source lang="bash" enclose="div">
./bin/instalador proyecto:actualizar -d /RUTA_INSTALACION_ANTERIOR/
</source>

Una vez ejecutado el comando de actualización, el propio instalador nos proporciona los pasos a seguir, para mas información ver el apartado [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Post_Instalaci.C3.B3n.2FActualizaci.C3.B3n|Post actualización]]

=== Actualización de una instalación con personalizaciones ===

Antes de realizar el proceso de actualización es necesario verificar si se cumplen los requerimientos previos a una actualización en [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Recomendaciones_previas_a_la_actualizaci.C3.B3n|Recomendaciones previas actualización]]

Cada vez que para el SIU-Diaguita este disponible una nueva versión (versión original generada por el equipo de SIU), se deberá migrar manualmente desde un entorno de desarrollo previo. El procedimiento de trabajo implica migrar la personalización desde la versión anterior a la siguiente sin saltearse ninguna versión intermedia. Para ello, desde un repositorio se tendrá que descargar la nueva versión y realizar la instalación nueva en modo desarrollo.

Es recomendable no utilizar el entorno de desarrollo anterior, así este puede ser utilizado para realizar bugfixes y correcciones que sean necesarios para la actual versión en producción. Procediendo sobre una nueva instalación de SIU-Diaguita, realizar:

:<source lang="bash" enclose="div">
# Descarga la nueva version
svn checkout https://repositorio/svn/diaguita/nodos/<sigla institucion>/trunk/4.2.0/

# En la nueva versión realiza una instalación en desarrollo con base de datos de negocio existente
./bin/instalador proyecto:instalar --db-negocio-existente

# Mezcla los cambios hechos en la version 4.2.0 hacia esta nueva version
svn merge https://repositorio/svn/diaguita/nodos/<sigla institucion>/trunk/4.2.0/personalizacion carpeta_proyecto/personalizacion

# Inicia la personalizacion
toba personalizacion iniciar

# Chequea si hay posibles conflictos
toba personalizacion conflictos

# Toma los archivos .xml de la carpeta personalización y los carga a metadatos en la base
toba personalizacion importar

# Exporta los metadatos como archivos .sql en la carpeta metadatos
toba proyecto exportar

svn commit
</source>

== Post Instalación/Actualización ==

Una vez finalizado un proceso de instalación o actualización se procede a ejecutar un conjunto de configuraciones finales.

=== Verificar archivo de log del instalador ===
El instalador durante el proceso de ejecución de cada comando genera un archivo de log en la raíz del proyecto, dentro de este archivo se encuentra detallado toda la historia de ejecución de procesos y
en el podemos detectar cualquier tipo de error o advertencia que pueda ocurrir durante su ejecución, por eso es de mucha utilidad verificar este archivo y ayuda a entender cualquier falla.

Una de las alternativas para visualizar el archivo de log es de la siguiente manera:
:<source lang="bash" enclose="div">
less instalador.log
</source>

=== Modificar permisos ===
Permite modificar los permisos del proyecto, el usuario que corre el servidor web tiene que ser capaz de escribir sobre los directorios de archivos navegables, temporales y de configuración.

Al ejecutar el comando intentara identificar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache, con la posibilidad de definir ambos parámetros en el caso de que sean distintos a los sugeridos.

Ejecute el siguiente comando como superusuario:

:<source lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple
</source>

Como parámetros opcionales se puede enviar el usuario que sera dueño de los archivos y el grupo de usuario bajo el cual se ejecuta el servidor web Apache como argumentos mediante el siguiente parámetro:

:<source lang="bash" enclose="div">
sudo ./bin/instalador permisos:simple -U usuario -W www-data
</source>

=== Configuración del servidor de aplicaciones ===

Para la configuración del servidor web les proponemos las siguientes opciones.

Para servidores linux, utilizar la configuración generada por el instalador ejecutando la siguiente sentencia como superusuario:

<source lang="bash" enclose="div">
ln -s /ruta_instalacion/diaguita/instalacion/toba.conf /etc/apache2/sites-enabled/SIU-Diaguita.conf
</source>

Para servidores windows, agregar la siguiente linea al archivo de configuración de Apache (httpd.conf)

<source lang="apache" enclose="div">
Include /ruta_instalacion/diaguita/instalacion/toba.conf
</source>

Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Otra opción de configuración, independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejándolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre Diaguita con el siguiente contenido:

<source lang="apache" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual accederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-available del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea).

Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

=== Chequear requerimientos web ===
Antes de activar el sistema sacándolo del modo mantenimiento es recomendable que ejecute el link que le proporciona el instalador al finalizar la instalación en un navegador web de modo que se pueda hacer un chequeo de los requerimientos en el servidor web y de esa forma asegurarnos que tenemos configurado correctamente el php.ini que corre el apache y luego sacarlo del modo mantenimiento.

<source lang="apt_sources" enclose="div">

### AL FINALIZAR LA INSTALACIÓN EL INSTALADOR LE GENERA UN LINK AL CHEQUEO WEB CON LA URL CONFIGURADA EN LA INSTALACIÓN ###

http://servidor.universidad.edu.ar/diaguita/check.php

</source>

El chequeo web no permite ejecutar remotamente desde un navegador, para el caso que el servidor no disponga una interfaz gráfica para ejecutar de forma local el chequeo en el navegador web, una alternativa puede ser
instalar la aplicación '''lynx''' para poder ejecutar un navegador web desde linea de comando de la siguiente manera:

<source lang="bash" enclose="div">

### Chequeo web desde un navegador web por consola de comandos

lynx http://servidor.universidad.edu.ar/diaguita/check.php

</source>

=== Activar el sistema ===
Al finalizar el proceso el sistema queda configurado en modo mantenimiento, para desactivar el modo mantenimiento ejecutar el siguiente comando:
<source lang="bash" enclose="div">
./bin/instalador instalacion:modo-mantenimiento --sin-mantenimiento
</source>

== Personalizaciones ==

En el sistema SIU-Diaguita se ha implementado el esquema de personalizaciones ofrecido por el SIU-Toba. Este esquema permite que se realicen cambios sobre un sistema entregado por el SIU y que estos cambios se persistan a través de diferentes versiones.

Para poder implementar este esquema de personalizaciones y mantenerlo en un espacio de desarrollo colaborativo se debe contar con un sistema de control de versiones y tener versionado la versión propia del sistema con las personalizaciones.

A continuación se describe el mecanismo que permite desarrollar una personalización completa del SIU-Diaguita, basándonos en una instalación pre-existente de SIU-Diaguita versión 4.2.x realizada mediante el uso del instalador de proyectos del SIU.

En este esquema se recomienda que exista una persona que denominaremos concentrador, quien será el único que utilice los comandos de personalización y proveerá así al resto del grupo, de mayor flexibilidad en el entorno de trabajo diario. El resto del equipo trabaja de manera normal con Toba sin percatarse de que existe una personalización vigente, excepto a la hora de guardar archivos PHP.

=== Activar esquema de personalizaciones ===

Para iniciar la personalización, se recomienda que únicamente la persona que cumpla el rol de concentrador ejecute los siguientes comandos. El concentrador debe definir el esquema de PostgreSQL temporal a ser usado por el proceso de cálculo de diferencias en la personalización, en el archivo /SIU-Diaguita/personalizacion/personalizacion.ini:

:<source lang="bash" enclose="div">
iniciada = "no"
schema_personalizado = "<schema_personalizado>"
</source>

Y por último, inicializar propiamente la personalización. Es obligatorio que este cambio se suba al repositorio para mantener la configuración del ambiente de desarrollo. Para finalizar, el concentrador realiza el commit de los cambios realizados.

:<source lang="bash" enclose="div">
bin/toba personalizacion iniciar -p diaguita -i desarrollo
svn commit
</source>

A partir de este momento, todas las personas que participen del equipo de desarrollo deben descargarse la versión del sistema con personalizaciones que se mantiene versionada en un repositorio de la universidad, y luego pueden seguir los pasos de la [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n_desde_cero_en_entorno_de_desarrollo|Instalación desde cero en entorno de desarrollo]]. Estas personas podrán ejecutar todas las tareas relacionadas con el proyecto, excepto aquellas que se indican explícitamente a ser ejecutadas por el concentrador.

=== Desarrollar nuevas personalizaciones ===

La siguiente guía es un ejemplo [[SIU-Diaguita/version4.2.0/personalizacion|paso a paso]] para desarrollar una personalización de SIU-Diaguita, mediante el uso del toba-editor para la extensión y modificación de las funciones y características del mismo. Esto puede ser desarrollado de forma individual o en forma colaborativa con un equipo de desarrollo.

== Crear una versión propia con personalizaciones ==



== Instalación de cero de un ambiente de producción con personalizaciones ==

Para realizar una instalación de un ambiente de producción con personalizaciones se debe partir de una instalación en modo desarrollo con personalizaciones.

Una vez que se migraron las personalizaciones a una nueva versión del sistema en modo desarrollo y estas fueron testeadas y ya esta en condiciones para llevar a producción, a la versión de SIU-Diaguita en desarrollo con personalizaciones ejecutar los siguientes comandos:

:<source lang="bash" enclose="div">
# Exportar metadatos del proyecto
toba proyecto exportar

# Exportar personalización del proyecto
toba personalizacion exportar

# Subir los metadatos exportados al repositorio
svn commit
</source>

Una vez realizado los pasos anteriores, luego descargar la versión propia de SIU-Diaguita con personalizaciones para realizar una instalación en producción.
Antes de instalar realizar lo explicado en el ítem de [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n|Pasos previos a un proceso de instalación]].

:<source lang="bash" enclose="div">
# Descarga la nueva versión propia con personalizaciones
svn checkout https://repositorio/svn/diaguita/nodos/<sigla institucion>/trunk/4.2.0/

# Realiza una instalación en producción del SIU-Diaguita con personalizaciones versión 4.2.0
./bin/instalador proyecto:instalar
</source>

== Actualización del ambiente de producción con personalizaciones ==

Para llevar a cabo una actualización de un ambiente de producción con personalizaciones se debe partir de una instalación en modo produccion con personalizaciones de la ultima versión del sistema.

Para esto previamente se debe realizar [[SIU-Diaguita/version4.2.0/instalacion_actualizacion#Instalaci.C3.B3n_de_cero_de_un_ambiente_de_producci.C3.B3n_con_personalizaciones|Instalación de cero de un ambiente de producción con personalizaciones]].

Luego de tener instalada la versión en producción con personalizaciones, para migrar los usuarios y perfiles de acceso de la instalación en producción anterior se debe realizar una actualización sobre esta nueva instalación en producción configurando correctamente el archivo de parámetros del instalador y luego ejecutando el siguiente comando:

:<source lang="bash" enclose="div">
./bin/instalador proyecto:actualizar --instalacion-anterior /RUTA_INSTALACION_ANTERIOR
</source>

= Verificar Configuración SIU-Diaguita =
Esta configuración Visual es una ayuda que se encuentra dentro del Menú Administración => [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.2/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

----
[[SIU-Diaguita/version4.2.0|<Volver]]

SIU-Diaguita/version4.2.0/post instalacion

2026-01-14T19:06:19Z

Pboyko: /* Configurar los parámetros para Araí-Documentos en SIU-Diaguita */

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.2.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.2.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.25 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.26 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.2.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.2.0, se debe modificar la url de conexión a Araí-Documentos y colocar la url completa de la sgte forma:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/
</source>

A partir de la version 1.8.0 de Araí-Documentos se puede utilizar la version de la API en la url. Si bien en la version 1.8.0 funciona con y sin la version, es recomendable colocarla porque será requerido en versiones posteriores.

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/v1/
</source>

Hasta la version 4.1.0 de SIU-Diaguita se definía de esta forma:
:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
</source>

A partir de la versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.2.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.2.0 | < Volver]]

SIU-Diaguita/version4.2.0/post instalacion

2026-01-14T19:06:01Z

Pboyko: /* Configurar los parámetros para Araí-Documentos en SIU-Diaguita */

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.2.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.2.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.25 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.26 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.2.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.2.0, se debe modificar la url de conexión a Araí-Documentos y colocar la url completa de la sgte forma:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/
</source>

A partir de la version 1.8.0 de Araí-Documentos se puede utilizar la version de la API en la url. Si bien en la version 1.8.0 funciona con y sin la version, es recomendable colocarla porque será requerido en versiones posteriores.

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/v1/
</source>

:<source lang="bash" enclose="div">
Hasta la version 4.1.0 de SIU-Diaguita se definía de esta forma:
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
</source>

A partir de la versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.2.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.2.0 | < Volver]]

SIU-Diaguita/version4.2.0/post instalacion

2026-01-14T19:05:30Z

Pboyko: /* Configurar los parámetros para Araí-Documentos en SIU-Diaguita */

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.2.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.2.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.25 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.26 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.2.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.2.0, se debe modificar la url de conexión a Araí-Documentos y colocar la url completa de la sgte forma:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/
</source>

A partir de la version 1.8.0 de Araí-Documentos se puede utilizar la version de la API en la url. Si bien en la version 1.8.0 funciona con y sin la version, es recomendable colocarla porque será requerido en versiones posteriores.

##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs/rest/backend/v1/
</source>

Hasta la version 4.1.0 de SIU-Diaguita se definía de esta forma:
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
</source>

A partir de la versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.2.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.2.0 | < Volver]]

SIU-Arai/proveedores

2025-06-19T20:28:34Z

Pboyko:

[[Archivo:siu-arai_iso.png|derecha|link=SIU-Arai]]

= SIU-Arai Proveedores =

SIU-Arai permite sincronizar catálogos (en esta primera instancia trabaja sobre el catálogo de proveedores) entre distintos clientes (aplicaciones) ya sean SIU o no SIU. Su mecanismo permite que los clientes puedan modificar los catálogos, recibir las novedades, y trabajar en modo desconectado y luego volver a sincronizar.

== Como instalarlo ==

A partir de las versiones 3.2 de SIU Pilaga y 2.6 de SIU Diaguita se puede instalar SIU Arai Proveedores utilizando el instalador o actualizador de dichos sistemas, si las versiones de los sistemas que se encuentra utilizando (tanto de SIU Diaguita como SIU Pilaga) son inferiores a las mencionadas, debe continuar con el punto siguiente de este instructivo (Configuración de la Base Arai Proveedores), caso contrario solo debe realizar el paso a continuación:

- Desde SIU Pilaga (a partir de la versión 3.2) ver http://documentacion.siu.edu.ar/wiki/SIU-Pilaga/version3.4.2/consideraciones_tecnicas#Conectar_SIU-Pilag.C3.A1_con_SIU-Arai_Proveedores

- Desde SIU Diaguita (a partir de la versión 2.6) ver http://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version2.7.0/consideraciones_tecnicas#Configuraci.C3.B3n_de_la_base_de_datos_de_Arai_Proveedores

Completar las variables de entorno que se encuentran en el archivo ''instalador.env''

Instalación:

<source lang="bash" enclose="div">
./bin/instalador arai-proveedores:crear-base
</source>
Actualización:
<source lang="bash" enclose="div">
./bin/instalador arai-proveedores:actualizar-base
</source>Para ver el estado de las migraciones de la base SIU Arai Proveedores:<source lang="bash" enclose="div">
./bin/instalador arai-proveedores:estado-base
</source>

Y luego continuar con los pasos que se encuentran debajo

== Configuración de la Base Arai Proveedores==
En principio, tenemos que cargar una nueva fuente de datos vinculando la base que utiliza el sistema SIU ARAI en los dos sistemas (este paso sirve tanto para Pilagá como para Diaguita), lo podemos hacer desde el archivo bases.ini de SIU Toba en la instalación de los sistemas 

Modificando el bases.ini 

Vamos a observar el archivo bases.ini para ver cómo queda configurado. En caso de hacerlo directamente en este archivo, ingresar estos datos (cambiado obviamente el detalle de las variables que están entre comillas). Ejemplo para instalación de SIU Pilagá en producción: 

<source lang="php" enclose="div">

[produccion pilaga arai]
motor = "postgres7"
profile = "localhost"
usuario = "postgres"
clave = "postgres"
puerto = "5432"
encoding = "LATIN1"
schema = "public"
base = "pilaga_arai_trunk"
</source>

Si fuera una base Diaguita en producción, quedaría de la siguiente manera:

<source lang="php" enclose="div">
[produccion diaguita siu_arai]
motor = "postgres7"
profile = "localhost"
usuario = "postgres"
clave = "postgres"
puerto = "5432"
encoding = "LATIN1"
schema = "catalogos"
base = "arai"
</source>

'''NOTA:''' Si la base del sistema SIU-Arai se encuentra en otro servidor, recordar que puede ser necesario editar el archivo '''pg_hba.conf''' para configurar los permisos de acceso a la base desde el/los servidor/es donde se encuentren SIU-Pilagá y SIU-Diaguita. 

== Requisitos previos ==
1 - Preparar datos de proveedores extranjeros: En el apartado '''PREGUNTAS FRECUENTES''' del instructivo ver sección '''¿Como sincronizo los datos de proveedores extranjeros?'''. 
2 - Datos de tablas maestras de ubicación geográfica, conceptos, condiciones y rubros deben ser los mismos en las tres bases (Ver comando '''Sincroniza_datos_satelites''' en el instructivo)

== Cómo sincronizar por primera vez ==
En principio tenemos que sincronizar las dos bases con Arai
Lo hacemos desde el comando de consola:

==='''''Pilagá'''''===
Vamos a nuestra instalación de toba, dentro de la carpeta bin de toba:

===='''Con Windows'''====

Definimos el valor de la variable de entorno '''TOBA_INSTALACION_DIR''' indicando la ruta de instalación (ejemplo C:\SIU-Pilaga\instalacion)

'''set TOBA_INSTALACION_DIR=C:\SIU-Pilaga\instalacion'''

Ejecutamos el siguiente comando (que se encuentra en la carpeta bin de la instalación de Pilagá): 

'''pilaga.bat arai sincronizacion_inicial '''

===='''Con Linux'''====
Ejecutamos el siguiente comando (que se encuentra en la carpeta bin de la instalación de Pilagá): 

'''sudo sh pilaga.sh arai sincronizacion_inicial'''

==='''''Diaguita'''''===
===='''Con Windows'''====
Definimos el valor de la variable de entorno '''TOBA_INSTALACION_DIR''' indicando la ruta de instalación (ejemplo C:\SIU-Diaguita\instalacion)

'''set TOBA_INSTALACION_DIR=C:\SIU-Diaguita\instalacion'''

En nuestra instalación de toba, carpeta bin (ejemplo C:\siu\diaguita\toba\bin) , ejecutamos los comandos: 

'''entorno_toba_x.y.bat ''' (reemplazar x.y por la versión de toba que se esté utilizando, por ejemplo, si se trata de Toba 2.6 sería entorno_toba_x.y.bat)

'''toba proyecto arai_sinc_inicial -pdiaguita -iproduccion '''

===='''Con Linux'''====
En nuestra instalación de toba, carpeta bin (ejemplo /usr/local/siu/diaguita/toba/bin) , ejecutamos los comandos:

'''. ./entorno_toba.env '''

'''toba proyecto arai_sinc_inicial -pdiaguita -iproduccion '''

Aclaración: en la variable -p estamos indicando el proyecto y en la variable -i indicamos la instancia(generalmente es producción o desarrollo) 

===Programar la ejecución de la sincronización:===
El proceso de sincronización se debe ejecutar por cada x minutos (OPCIONAL), también se ejecuta cada vez que se entra a la operación de abm de proveedores y cuando se modifica un proveedor. 

Ejemplo de script para la ejecución de la sincronización inicial en SIU Diaguita

<source lang="bash" enclose="div">
#!/bin/sh

#script que carga el entorno de toba y ejecuta una sincronizacion con ARAI. Es para llamarlo desde el CRON.
#tiene que ir en DIAGUITA_DIR/toba/bin

cd `dirname $0`"/../../instalacion"
export TOBA_INSTALACION_DIR=`pwd`

# cargo el entorno
$TOBA_INSTALACION_DIR/entorno_toba.env

# ejecuto la sincronizacion
$TOBA_INSTALACION_DIR/../toba/bin/toba proyecto arai_sincronizacion -i produccion -p diaguita
</source>

==== Linux ====

Para configurar las tareas de sincronización a incluir en el cron (nota: el usuario con el que se realizan estos pasos debe tener permisos de sudo, en el ejemplo se ejecuta cada 20 minutos). Seguir estos pasos: 

'''sudo su '''
'''crontab -e '''

Agregar estas líneas y guardar:

<source lang="php" enclose="div">
*/20 * * * * sh /PATH_DE_PILAGA/bin/pilaga.sh arai sincronizacion > /dev/null

*/20 * * * * sh /PATH_DE_DIAGUITA/bin/toba proyecto arai_sincronizacion -i produccion -p diaguita > /dev/null

</source>

==== Windows ====

Dependiendo de la versión de Windows utilizada se puede configurar como tarea programada o programar un servicio.

==Funciones por linea de Comando==

==='''''sincronizacion_inicial'''''===
Sincroniza absolutamente todo, hay que correrlo al utilizar por primera vez arai, además lo pide cada vez que se cambie de modo desconectado a conectado (tanto Pilagá como Diaguita informan cuando se debe hacer una sincronización inicial). 

Recorre las tablas comunes del catálogo proveedores de la instalación local , obtiene los registros sin id arai asociado en '''anx_personas''' y '''anx_domicilios''', si el registro no existe en arai, lo da de alta y asigna el id_arai en la instalación local, si el registro existe (usa la clave lógica de tipo_documento_numero por prioridad) en arai solo asigna el id_arai en la instalación local. 

'''''Lógica para los domicilios/documentos:''''' Se actualizan como parte de la entidad proveedor.
 Domicilio: si existen domicilios en arai para el proveedor prevalecen estos (si hay domicilios en Diaguita se actualizan estos domicilios en Arai). Si no existen domicilios en Arai para el proveedor y existen en Diaguita se actualizan estos domicilios en Arai.
 Documento: si el proveedor no existe en Arai se toman los documentos de Diaguita y se actualizan en Arai. Si existen documentos en Arai para el proveedor prevalecen éstos. 

==='''''sincronizacion'''''===
Se ejecuta cada vez que haya algún cambio, es decir, se procesan todas las novedades pendientes (altas, bajas y modificaciones en registros de tabla asociadas al catálogo proveedores). También se configura para ejecutarlo en forma programada (CRON) cada 10 minutos (se puede modificar la frecuencia). 

==='''''actualizar_secuencias'''''===
Actualiza las secuencias de las tablas del catálogo proveedores. 

==='''''sincroniza_datos_satelites'''''===
El catálogo de proveedores involucra otros catálogos (rubros, conceptos, condiciones, localidades, provincias, países, etc) y estos catálogos aún no cuentan con un mecanismo de sincronización, es por ello que en ciertos casos pueden existir diferencias de datos entre la base de datos del proyecto y la base de arai proveedores. Este comando intenta sincronizar los datos de conceptos, condiciones y rubros. Para usar este comando es requerido contar con la librería dblink de Postgresql instalada (comando disponible en SIU Pilaga a partir de la versión 3.0.2 y próximamente en la versión 2.5 de SIU Diaguita) 

==='''''resincroniza_base'''''===
Resetea el estado de la sincronización de la base del proyecto, y se vuelve a sincronizar de 0 con la base del servidor. Este comando suele utilizarse cuando se realizan cambios en los datos de la base del proyecto o del servidor por fuera del circuito de sincronización (comando disponible en SIU Pilaga a partir de la versión 3.0.2 y SIU Diaguita a partir de la versión 2.4.0) 

==='''''estado'''''===
Muestra el estado de la BD Arai Proveedores y Pilaga, comando útil para saber si las bases se encuentran sincronizadas correctamente (disponible en las próximas versiones de SIU Diaguita y SIU Pilaga)

==Estados de Sincronización==
El cambio de los estados se puede hacer manualmente desde los parámetros del sistema, para modificarlo vamos a: 

==='''''Pilagá'''''===
Administración/Configuración de Parámetros ('''aplicar_sincronizacion_arai_prov''')

[[Archivo:ARAI conf.png|marco|centro]]

'''''Modo conectado (valor sí):''''' cada cambio que se realice se sincroniza automáticamente con la base. En Pilagá si se utiliza este estado, solo se podrá cargar personas por la operación ABM - Personas ARAI y no por ABM - Personas 

'''''Modo desconectado (valor desconectado):''''' si por algún motivo se cae la conexión con la red, se tendrá que poner este estado para poder cargar proveedores y seguir operando. Una vez que se restablezca la conexión, pedirá que se realice una sincronización inicial 

'''''(Valor no):''''' no se utiliza la funcionalidad Arai (en Pilagá), se carga personas, proveedores por ABM - Personas y ABM – Proveedores 

==='''''Diaguita'''''===

Administración/Parámetros

[[Archivo:Arai 2.png|marco|centro]]

==Configuración de servicio de AFIP==
AFIP tiene una API tipo REST para obtener datos a partir de una CUIT, lo cual es muy útil para evitar demoras al cargar clientes o proveedores 

Solo hay que configurar una carpeta (AFIP) y un archivo (cliente.ini) 

'''Directorio genérico:''' instalacion\instancia\proyecto\rest\AFIP\cliente.ini 

'''Ejemplo de directorio:'''
<source lang="php" enclose="div">
C:\SIU-Pilaga\instalacion\i__produccion\p__pilaga\rest\afip\cliente.ini
</source>

Dentro del archivo cliente.ini , deberán copiar textual los siguientes 3 renglones:

<source lang="php" enclose="div">
[conexion]
;Recuerde dejar una barra (/) al finalizar la URL
to = "https://soa.afip.gob.ar/"
</source>

==Librería PHP==

Para utilizar este servicio, tenemos que habilitar la librerías de PHP php_curl y php_pgsql 

'''ACLARACION IMPORTANTE!'''
Para que funcione correctamente la sincronización, las tablas países,provincias,departamentos, localidades y códigos postales, deberán tener los mismos datos, caso contrario no se podrá efectuar el 100% de la sincronización de los registros. 

==Requisitos a tener en cuenta==

Los requisitos para utilizar SIU Arai Proveedores con SIU Diaguita y SIU Pilagá son los siguientes:

Versión Diaguita: 2.2.3 o superior

Version Pilaga: 2.3.4 o superior

Version Postgres: 9.5 o superior

Version PHP: 7.2 o superior

==Pasos a seguir para pasar a producción==

Se detallan los pasos recomendados para el pasaje a producción, esta guía detalla solo una opción posible. 

1 - Se asume que ya se cuenta con la sincronización funcionando en un entorno de desarrollo, habiendo realizado las pruebas con copias de las BDs tomadas de producción. 
2 - De la puesta en marcha en el paso 1 seguramente existan scripts SQLs que generan INSERTs de datos como conceptos, condiciones, rubros, y tablas de ubicación geográfica, para hacer que estas tablas tengan los mismos datos en las bases SIU Pilaga, SIU Diaguita y SIU Arai Proveedores. 
3 - Poner en modo mantenimiento SIU Diaguita y SIU Pilaga (poner en 1 el parámetro '''modo_mantenimiento''' en el archivo '''proyecto.ini'''). Esto significa que a partir de este paso los sistemas no estarán disponibles en producción hasta la finalización de los pasos que siguen a continuación. 
4 - Realizar backups de las bases SIU Diaguita y SIU Pilaga. 
5 - Crear una base SIU Arai Proveedores de cero en producción, ya sea utilizando el instalador o restaurando el backup. 
6 - En las instalación de producción de SIU Pilaga y SIU Diaguita, configurar los archivos bases.ini tal como lo indica la sección del instructivo '''Configuración de la Base Arai Proveedores'''. 
7 - Correr los scripts mencionados en el punto 2. 
8 - Seguir los pasos de la sección del instructivo '''Cómo sincronizar por primera vez'''. 
9 - Activar los parámetros siguiendo la sección del instructivo '''Estados de Sincronización'''.

== '''API SIU ARAI Proveedores''' ==

Se encuentra disponible una API que brinda servicio sobre la funcionalidad que se encuentra disponible en SIU Arai Proveedores, esto facilita la interacción de cualquier sistema que ya contenga información de proveedores, o que necesite consultar información de proveedores.

URL del repositorio: https://gitlab.siu.edu.ar/siu-arai/proveedores-api/-/tree/v1.0.0-beta

Para ver mas información relacionada a la instalación y configuración: https://gitlab.siu.edu.ar/siu-arai/proveedores-api/-/blob/v1.0.0-beta/doc/install/INSTALACION_MANUAL.md

Para ver la definición de la API: https://gitlab.siu.edu.ar/siu-arai/proveedores-api/-/blob/v1.0.0-beta/specs/README.md

=='''PREGUNTAS FRECUENTES'''==

===¿Que debo hacer si reinstalo Arai o regenero la BD Arai?===

Se puede realizar de dos maneras: 

Opción 1 ('''RECOMENDADA'''): A través del comando administrativo '''Resincronización''' que resetea el estado de la sincronización de la base del proyecto, y se vuelve a sincronizar de 0 con la base del servidor. Este comando suele utilizarse cuando se realizan cambios en los datos de la base del proyecto o del servidor por fuera del circuito de sincronización (comando disponible en SIU Pilaga a partir de la versión 3.0.2 y en SIU Diaguita a partir de la versión 2.4.0). 

Opción 2: Manualmente, se deben borrar las referencias en las bases de los sistemas cliente conectado a dicha BD Arai, y volver a realizar una sincronización inicial. 

Dichas referencias se guardan en el campo persona_arai de la tabla anx_personas y domicilio_arai de la tabla anx_domicilios.
Las consultas SQL a ejecutar en las BDs de los sistemas clientes entonces serían: 

En Diaguita
<source lang="php" enclose="div">
update diaguita.anx_personas set persona_arai=NULL;
update diaguita.anx_domicilios set domicilio_arai=NULL;
</source>
En Pilaga
<source lang="php" enclose="div">
update anx_personas set persona_arai=NULL;
update anx_domicilios set domicilio_arai=NULL;
</source>

También deben borrarse los datos de sincronización de los sistemas clientes, desde los cuales se actualizan las secuencias:
<source lang="php" enclose="div">
delete from catalogos.modo_desconectado;
delete from catalogos.logs_sincronizacion;
delete from catalogos.sincronizacion;
</source>

Para borrar los datos cargados en la Base de Datos Arai ('''ESTO BORRA TODOS LOS DATOS SINCRONIZADOS EN LA BASE ARAI PROVEEDORES''')
<source lang="php" enclose="div">
set search_path to catalogos;
delete from catalogos.mdp_personas_domicilios;
delete from catalogos.mdp_personas_x_documentos;
delete from catalogos.sau_pr_proveedor_rubro;
delete from catalogos.sau_rt_conceptos_proveedor;

delete from catalogos.sau_pr_proveedores;
delete from catalogos.mdp_personas;
delete from catalogos.mdp_domicilios;

set search_path to sincronizador;
delete from sincronizador.operacion_x_tabla;
delete from sincronizador.logs_errores;
delete from sincronizador.log_cambios;

</source>

===¿Como sincronizo los datos de proveedores extranjeros?===

Para que los proveedores extranjeros sean sincronizados deben tener un tipo y nro de documento que no se trate de un CUIT comenzado en 50, 51 o 55 (ya que estos códigos son asignados por AFIP para un país en particular y pueden existir proveedores que compartan el mismo código). 

Es recomendado realizar este proceso previo a sincronizar los datos con Arai Proveedores, en dicho caso los pasos serían: 

''Si SIU-Diaguita y SIU-Pilagá aún NO se encuentran sincronizados con Arai-Proveedores:''

1 - Agregar un segundo tipo y número de documento a los proveedores extranjeros en SIU Pilaga (usando operación '''ABM - Personas, proveedores y clientes'''). 
2 - Agregar un segundo tipo y número de documento a los proveedores extranjeros en SIU Diaguita (usando operación '''Catálogo de Proveedores'''). 
3 - Es necesario que el segundo tipo y nro de documento asignado a cada proveedor extranjero coincidan en las bases Diaguita y Pilagá, caso contrario al sincronizar se generarán duplicados.

''Si SIU-Diaguita y SIU-Pilagá YA se encuentran sincronizados con Arai-Proveedores:''

1- Modificar el valor del parámetro '''aplicar_sincronizacion_arai_prov''' y setearlo en NO en SIU-Diaguita y SIU-Pilaga

2 - Agregar un segundo tipo y número de documento a los proveedores extranjeros en SIU Pilaga (usando operación '''ABM - Personas, proveedores y clientes'''). 
3 - Agregar un segundo tipo y número de documento a los proveedores extranjeros en SIU Diaguita (usando operación '''Catálogo de Proveedores'''). 
4 - Es necesario que el segundo tipo y nro de documento asignado a cada proveedor extranjero coincidan en las bases Diaguita y Pilagá, caso contrario al sincronizar se generarán duplicados.

5- Modificar el valor del parámetro '''aplicar_sincronizacion_arai_prov''' y setearlo en SI en SIU-Diaguita y SIU-Pilaga

6- Realizar una sincronización inicial en SIU-Diaguita y SIU-Pilaga

===Tengo que agregar, modificar o borrar datos de proveedores a través de un script ¿como hago?===

Una vez sincronizados, todas las modificaciones deben realizarse sobre la base Arai Proveedores, y estos cambios serán replicados en las bases de las aplicaciones clientes.
Al script que uno desea ejecutar sobre la base se le debe agregar siempre una linea que incrementa una secuencia de la base, sin dicha línea las aplicaciones clientes no detectan estas novedades.

Por ejemplo, si quisiéramos borrar un proveedor el script debería ser:

<source lang="php" enclose="div">
SELECT nextval('sincronizador.sq_sincronizacion_catalogo');

DELETE FROM catalogos.sau_pr_proveedor_rubro where persona = ???;
DELETE FROM catalogos.sau_rt_conceptos_proveedor where proveedor = ???;
DELETE FROM catalogos.sau_pr_proveedores where persona = ???;
DELETE FROM catalogos.mdp_personas_x_documentos where persona = ???;
DELETE FROM catalogos.mdp_personas_domicilios where persona = ???;
DELETE FROM catalogos.mdp_personas where persona = ???;
</source>

Los cambios serán replicados en las aplicaciones cliente cuando realicen una sincronización.

===¿Como instalo la extensión de postgresql dblink para poder utilizar el comando administrativo que sincroniza los datos satélites?===

Los pasos para instalar la extensión dblink:

1-apt-update 
2-apt-get install postgresql-contrib 
3-Buscar archivo dblink--1.0.sql 
4-Ejecutar psql basede_datos_x < /usr/share/postgresql/9.x/extension/dblink--1.0.sql 
 
Ejecutar este script en las bases Diaguita, Pilaga y Arai:

<source lang="php" enclose="div">
DROP extension dblink;
SET search_path to auxiliar_catalogos;
CREATE extension dblink;
</source>

Para mas información https://mermamerma.wordpress.com/2013/05/30/crear-dblink-en-postgresql/

=== Ajustes de datos frecuentes al momento de sincronizar por primera vez ===

1 - Valores en null en columna estado_proveedor de sau_pr_proveedores 
'''Resolución:''' se toma en el estado que tiene en anx_personas. Ejemplo de resolución (SIU Pilagá), ejecutar el query:

<source lang="php" enclose="div">
UPDATE sau_pr_proveedores pr
SET estado_proveedor = (SELECT pe.estado FROM anx_personas pe WHERE pe.persona=pr.persona)
WHERE pr.estado_proveedor is NULL;
</source>

----2 - Corregir casos en donde existen proveedores activos y personas inactivas (SIU Pilagá)

Resolución: si el proveedor se encuentra activo, la persona asociada también debe estarlo, ejecutar:

En la base de SIU Pilaga:

<source lang="php" enclose="div">
UPDATE anx_personas SET estado = 'AC' FROM sau_pr_proveedores as pr WHERE pr.persona = anx_personas.persona and estado_proveedor = 'AC';
</source>

En la base de SIU Arai Proveedores:

<source lang="php" enclose="div">
SELECT nextval('sincronizador.sq_sincronizacion_catalogo');

UPDATE catalogos.mdp_personas SET estado = 'AC' FROM catalogos.sau_pr_proveedores as pr WHERE pr.persona = anx_personas.persona and estado_proveedor = 'AC';
</source>

=== Al agregar una condición en Pilaga genera un error al grabar un proveedor con esa nueva condición ===

Esto se debe a que el catálogo de condiciones aún no se sincroniza automáticamente y se requiere insertar manualmente la condición agregada en las bases de Diaguita y Arai Proveedores, se debe realizar el INSERT (ver ejemplo debajo) completando los datos de la nueva condición

<source lang="php" enclose="div">
-- En base Diaguita
INSERT INTO TABLE diaguita.sau_rt_condiciones (concepto, condicion, codigo_afip, nombre, descripcion, retiene, resta_iva) VALUES (VALORES DE LA CONDICION AGREGADA)
-- En base Arai Proveedores
INSERT INTO TABLE catalogos.sau_rt_condiciones (concepto, condicion, codigo_afip, nombre, descripcion, retiene, resta_iva) VALUES (VALORES DE LA CONDICION AGREGADA)
</source>

=== En Diaguita o Pilagá me aparece una ventana con el mensaje ''Existen datos de proveedores extranjeros que no pueden sincronizarse'' ===

Este mensaje indica que existen proveedores extranjeros que no tienen un tipo y número de documento único (el CUIT asociado a proveedores extranjeros corresponde a su país y puede encontrarse mas de un proveedor con dicho tipo/nro de documento).
Esta validación advierte sobre dicha situación y realiza dos acciones:

* Inhabilita las altas/bajas/modificaciones hasta que el problema quede resuelto.
* Guarda en el log de la aplicación (ubicado en ../instalacion/i__produccion/p__{diaguita o pilaga}/logs) la lista de proveedores a los cuales hay que agregarle un tipo/nro documento único.

A continuación se explica una secuencia manual para corregir estos proveedores (también se puede realizar el ajuste realizando un script):

* Mientras se realiza esta secuencia no se pueden agregar/modificar/eliminar proveedores en SIU Diaguita y SIU Pilaga (tomar los recaudos necesarios para garantizar esta situación).
* Poner el parámetro aplicar_sincronizacion_arai_prov en No tanto en SIU Diaguita como en SIU Pilagá.
* Ingresar a SIU Diaguita y a SIU Pilagá (el orden de ingreso es indistinto) e ir modificando cada uno de los proveedores listados en el log y agregarle un segundo tipo y número de documento (se recomienda usar los tipos NIF o PAS), y guardar los cambios de cada modificación.
* Es fundamental que al momento de agregar el segundo tipo/nro de documento al proveedor,el mismo coincida tanto en SIU Diaguita y SIU Pilagá, caso contrario se generará un duplicado (ejemplo: si al proveedor ABC S.A se le agregó un segundo tipo de documento del tipo NIF con el número 331 en SIU Pilagá, en SIU Diaguita agregarle al mismo proveedor ese mismo tipo y número de documento).
* Poner el parámetro aplicar_sincronizacion_arai_prov en Si tanto en SIU Diaguita como en SIU Pilagá.
* Realizar una sincronización inicial en SIU Diaguita y SIU Pilagá.

=== Consulta para obtener la lista de proveedores extranjeros ===

'''-- En base Diaguita'''

SELECT p.* FROM diaguita.anx_tipos_documento_identidad tdi

INNER JOIN diaguita.anx_personas_x_documentos pd2 ON tdi.tipo_de_documento_de_identidad = pd2.tipo_de_documento_de_identidad

INNER JOIN diaguita.anx_personas p ON pd2.persona = p.persona

WHERE (substring(pd2.numero,1,2) = '50' OR substring(pd2.numero,1,2) = '55' OR substring(pd2.numero,1,2) = '51')

'''-- En base Pilaga'''

SELECT p.* FROM anx_tipos_documento_identidad tdi

INNER JOIN anx_personas_x_documentos pd2 ON tdi.tipo_de_documento_de_identidad = pd2.tipo_de_documento_de_identidad

INNER JOIN anx_personas p ON pd2.persona = p.persona

WHERE (substring(pd2.numero,1,2) = '50' OR substring(pd2.numero,1,2) = '55' OR substring(pd2.numero,1,2) = '51')

'''-- En base Arai Proveedores'''

SELECT p.* FROM catalogos.mdp_tipos_documento_identidad tdi

INNER JOIN catalogos.mdp_personas_x_documentos pd2 ON tdi.tipo_de_documento_de_identidad = pd2.tipo_de_documento_de_identidad

INNER JOIN catalogos.mdp_personas p ON pd2.persona = p.persona

WHERE (substring(pd2.numero,1,2) = '50' OR substring(pd2.numero,1,2) = '55' OR substring(pd2.numero,1,2) = '51')

=== Consulta para obtener la lista de proveedores duplicados ===
'''-- En base Diaguita'''

SELECT replace(pd.numero, '-', <nowiki>''</nowiki>), tdi.tipo_de_documento_de_identidad, count(*) as repeticiones FROM diaguita.anx_tipos_documento_identidad tdi

INNER JOIN diaguita.anx_personas_x_documentos pd ON tdi.tipo_de_documento_de_identidad = pd.tipo_de_documento_de_identidad

INNER JOIN diaguita.anx_personas p ON pd.persona = p.persona

WHERE (substring(pd.numero,1,2) <> '50' AND substring(pd.numero,1,2) <> '55' AND substring(pd.numero,1,2) <> '51')

GROUP BY replace(pd.numero, '-', <nowiki>''</nowiki>), tdi.tipo_de_documento_de_identidad HAVING COUNT(*) > 1

'''-- En base Pilaga'''

SELECT replace(pd.numero, '-', <nowiki>''</nowiki>), tdi.tipo_de_documento_de_identidad, count(*) as repeticiones FROM anx_tipos_documento_identidad tdi

INNER JOIN anx_personas_x_documentos pd ON tdi.tipo_de_documento_de_identidad = pd.tipo_de_documento_de_identidad

INNER JOIN anx_personas p ON pd.persona = p.persona

WHERE (substring(pd.numero,1,2) <> '50' AND substring(pd.numero,1,2) <> '55' AND substring(pd.numero,1,2) <> '51')

GROUP BY replace(pd.numero, '-', <nowiki>''</nowiki>), tdi.tipo_de_documento_de_identidad HAVING COUNT(*) > 1

'''-- En base Arai Proveedores'''

SELECT replace(pd.numero, '-', <nowiki>''</nowiki>), tdi.tipo_de_documento_de_identidad, count(*) as repeticiones FROM catalogos.mdp_tipos_documento_identidad tdi

INNER JOIN catalogos.mdp_personas_x_documentos pd ON tdi.tipo_de_documento_de_identidad = pd.tipo_de_documento_de_identidad

INNER JOIN catalogos.mdp_personas p ON pd.persona = p.persona

WHERE (substring(pd.numero,1,2) <> '50' AND substring(pd.numero,1,2) <> '55' AND substring(pd.numero,1,2) <> '51')

GROUP BY replace(pd.numero, '-', <nowiki>''</nowiki>), tdi.tipo_de_documento_de_identidad HAVING COUNT(*) > 1

[[SIU-Arai|<Volver]]

SIU-Diaguita/Version4.1.0/Novedades funcionales

2025-05-21T13:46:02Z

Pboyko:

=Principales novedades de la versión=
- Soporte a versión 2.1.0 del Portal del Proveedor para permitir retirar Ofertas electrónicas.
 
- Aviso ante el cierre de una convocatoria habilitada con OE, antes de la fecha de cierre establecida
 
- Invitación a proveedores inscriptos a través del portal, coincidentes con el rubro de la convocatoria.
 
- Se incrementa las versiones soportadas de PostgreSQL
 
- Corrección de problema que se generaba al modificar datos de un oferente cuando se abría un acta.
 
- Se corrige el inconveniente al exportar a SUDOCU actas de recepción provisorias y definitivas cuando la orden de compra es del año anterior.
 
- Corrección al invitar proveedores que NO están en catálogo de proveedores a una convocatoria.
 
- Mejoras en la función Duplicar convocatoria/renglones, cuando se tiene un documento adjunto al pliego.
 

 
-----
[[SIU-Diaguita/version4.1.0|<Volver]]

SIU-Diaguita/Version4.2.0/Novedades funcionales

2025-05-21T13:46:02Z

Pboyko:

SIU-Diaguita/version4.1.0

2025-05-21T13:43:45Z

Pboyko:

__NOTOC__

[[Archivo:siu-diaguita.png|derecha|link=]]
 
 
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
Número de versión: 4.1.0
Fecha de publicación: '''21/05/2025'''
 [[SIU-Diaguita/Version4.1.0/Novedades_funcionales | Principales novedades]] 

</div>

{|
|-
! http://portal.comunidad.siu.edu.ar//images/iconos/boton_funcional_2.png Documentación Funcional !!                               !! http://portal.comunidad.siu.edu.ar//images/iconos/boton_tecnico_2.png Documentación Técnica
|-
| [[SIU-Diaguita/version4.1.0/glosario_de_conceptos|Glosario de conceptos]] ||                               || [[SIU-Diaguita/version4.1.0/instalacion_actualizacion|Instalación y Actualización de SIU-Diaguita]]
|-
| [[SIU-Diaguita/version4.1.0/primeros_pasos|Primeros pasos]] ||                              ||[[SIU-Diaguita/version4.1.0/post_instalacion|Post Instalación]]
|-
| [[SIU-Diaguita/version4.1.0/configuracion_del_sistema|Configuración de la aplicación]] ||                              ||[[SIU-Diaguita/version4.1.0/consideraciones_tecnicas| Otras consideraciones técnicas]]
|-
| [[SIU-Diaguita/version4.1.0/aspectos_generales_de_las_operaciones|Aspectos generales de las operaciones]] ||                              ||[[SIU-Diaguita/version4.1.0/personalizacion|Personalización]]
|-

| [[SIU-Diaguita/version4.1.0/principales_circuitos_funcionales|Principales circuitos funcionales]] ||                              ||[[SIU-Diaguita/version4.1.0/preguntas_frecuentes|Preguntas frecuentes]]
|-
| [[SIU-Diaguita/version4.1.0/documentacion_de_las_operaciones|Documentación de las operaciones]] ||                               ||[[SIU-Diaguita/version4.1.0/contactanos|Contactanos]]
|-

|-

| [[SIU-Diaguita/version4.1.0/interoperabilidad sistema expediente|'''Interoperabilidad con el Ecosistema SIU''']] ||                              ||[[SIU-Diaguita/version4.1.0/links de interes|Links de interés]]
|-
| [[SIU-Diaguita/version4.1.0/integracion_diaguita|Integración con otros sistemas]]
||                              || [[SIU-Diaguita/version4.1.0/guia_rapida_diaguita_eei|Guía Rápida Diaguita EEI]]
|-
| [[SIU-Diaguita/version4.1.0/preguntas_frecuentes_funcional|Preguntas frecuentes]] ||                              ||
|-
|[[SIU-Diaguita/version4.1.0/links de interes_funcional|Links de interés]]
||                              ||
|-
|[[SIU-Diaguita/version4.1.0/contactanos|Contactanos]]
|
|
|}

SIU-Diaguita/version4.2.0

2025-05-21T13:43:45Z

Pboyko:

__NOTOC__

[[Archivo:siu-diaguita.png|derecha|link=]]
 
 
<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
Número de versión: 4.2.0
Fecha de publicación: '''21/05/2025'''
 [[SIU-Diaguita/Version4.2.0/Novedades_funcionales | Principales novedades]] 

</div>

{|
|-
! http://portal.comunidad.siu.edu.ar//images/iconos/boton_funcional_2.png Documentación Funcional !!                               !! http://portal.comunidad.siu.edu.ar//images/iconos/boton_tecnico_2.png Documentación Técnica
|-
| [[SIU-Diaguita/version4.2.0/glosario_de_conceptos|Glosario de conceptos]] ||                               || [[SIU-Diaguita/version4.2.0/instalacion_actualizacion|Instalación y Actualización de SIU-Diaguita]]
|-
| [[SIU-Diaguita/version4.2.0/primeros_pasos|Primeros pasos]] ||                              ||[[SIU-Diaguita/version4.2.0/post_instalacion|Post Instalación]]
|-
| [[SIU-Diaguita/version4.2.0/configuracion_del_sistema|Configuración de la aplicación]] ||                              ||[[SIU-Diaguita/version4.2.0/consideraciones_tecnicas| Otras consideraciones técnicas]]
|-
| [[SIU-Diaguita/version4.2.0/aspectos_generales_de_las_operaciones|Aspectos generales de las operaciones]] ||                              ||[[SIU-Diaguita/version4.2.0/personalizacion|Personalización]]
|-

| [[SIU-Diaguita/version4.2.0/principales_circuitos_funcionales|Principales circuitos funcionales]] ||                              ||[[SIU-Diaguita/version4.2.0/preguntas_frecuentes|Preguntas frecuentes]]
|-
| [[SIU-Diaguita/version4.2.0/documentacion_de_las_operaciones|Documentación de las operaciones]] ||                               ||[[SIU-Diaguita/version4.2.0/contactanos|Contactanos]]
|-

|-

| [[SIU-Diaguita/version4.2.0/interoperabilidad sistema expediente|'''Interoperabilidad con el Ecosistema SIU''']] ||                              ||[[SIU-Diaguita/version4.2.0/links de interes|Links de interés]]
|-
| [[SIU-Diaguita/version4.2.0/integracion_diaguita|Integración con otros sistemas]]
||                              || [[SIU-Diaguita/version4.2.0/guia_rapida_diaguita_eei|Guía Rápida Diaguita EEI]]
|-
| [[SIU-Diaguita/version4.2.0/preguntas_frecuentes_funcional|Preguntas frecuentes]] ||                              ||
|-
|[[SIU-Diaguita/version4.2.0/links de interes_funcional|Links de interés]]
||                              ||
|-
|[[SIU-Diaguita/version4.2.0/contactanos|Contactanos]]
|
|
|}

SIU-Diaguita

2025-05-21T13:41:41Z

Pboyko:

__NOTOC__

[[Archivo:siu-diaguita.png|derecha|link=]]

La administración patrimonial y los procesos de compra, más allá de sus particularidades, resultan complejos para cualquier tipo de institución. Ante la necesidad de gestionar ambos procedimientos, se desarrolló el sistema SIU-Diaguita, que cuenta con una estructura en dos módulos: Compras y Patrimonio, los cuales pueden utilizarse tanto en forma conjunta o por separado, según las necesidades de cada institución.

== Trabajemos juntos para poner en marcha el sistema ==

La implementación del sistema es una etapa vital para asegurar su correcto funcionamiento a futuro, es el proceso que sienta las bases y, por lo tanto, requiere de una especial atención. Es muy importante que prestes atención a las recomendaciones y realices todas las consultas que consideres necesarias para asegurarte que vas en el camino correcto. Acá podes ver los distintos canales en los que podés interactuar con el equipo de implementación y demás miembros de la comunidad.

== Primeros pasos... todo lo que tenés que saber para poner el sistema en marcha ==

===== [[SIU-Diaguita/roles|Conformación del equipo de implementación]] =====

===== [[SIU-Diaguita/requerimientos|Requerimientos Mínimos de Equipamiento]] =====

===== [[SIU-Diaguita/plan de implementacion|Plan de Implementación]] =====

== Documentación ==

{| class="wikitable"
!SIU-Diaguita
!App
Colector
!Migrador de
Bienes Patrimoniales
|-
|'''[[SIU-Diaguita/version4.1.0|Versión 4.1.0]]'''
|'''[[SIU-Diaguita/appcolector|Versión 1.3]]'''
|'''[[SIU-Diaguita/migrador/version1.0.0|Versión 1.0.x]]'''
|-

|-
|'''[[SIU-Diaguita/version4.0.0|Versión 4.0.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version3.6.0|Versión 3.6.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version3.5.0|Versión 3.5.0]]'''
|
|
|-

|-
|'''[[SIU-Diaguita/version3.4.0|Versión 3.4.0]]'''
|
|
|-
|'''[[SIU-Diaguita/version3.3.0|Versión 3.3.0]]'''
|
|
|-
|'''[[SIU-Diaguita/version3.2.0|Versión 3.2.0]]'''
|
|
|-
|'''[[SIU-Diaguita/version3.1.0|Versión 3.1.0]]'''
|
|
|-
|'''[[SIU-Diaguita/version3.0.0|Versión 3.0.0]]'''
|
|
|}

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:30:53Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.1.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.1.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.2.0/post instalacion

2025-05-20T14:30:53Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.2.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.2.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.2.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.25 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.26 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.2.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.2.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.2.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.2.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:30:27Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.1.0//post_instalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita Configurar los parámetros para Araí-Documentos en SIU-Diaguita]

</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version4.1.0/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:27:47Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

<div style="clear: both; display: block; float: left; border-left: 3px solid #3399ff; padding: 10px; background-color: #eee; width: 565px;font-size: 13px;">
 '''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [[Configurar los parámetros para Araí-Documentos en SIU-Diaguita]] 
</div>

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:26:10Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

'''Importante:''' Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [[Configurar los parámetros para Araí-Documentos en SIU-Diaguita]]

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:25:25Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

Importante: Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la sección: [[Config|link=SIU-Diaguita/version4.1.0/postinstalacion#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita]]

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:24:41Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

Importante: Si se utiliza SIU-Diaguita integrado al EEI es necesario verificar la seccion: [[Config|link=#Configurar_los_par.C3.A1metros_para_Ara.C3.AD-Documentos_en_SIU-Diaguita]]

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:20:54Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
DOCUMENTOS_HOST: Es la url de conexión a Arai-Documentos. Es el equivalente al parámetro "host_arai" que se utilizaba en arai_documentos.ini
DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parámetro "rest_diaguita" que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:19:23Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source lang="text" enclose="div">
'''DOCUMENTOS_HOST:''' Es la url de conexion a Arai-Documentos. Es el equivalente al parametro host_arai que se utilizaba en arai_documentos.ini
'''DOCUMENTOS_USUARIO:''' Usuario de la API de Arai-Documentos
'''DOCUMENTOS_CLAVE:''' Contraseña de la API de Arai-Documentos
'''URL_NOTIFICACIONES:''' URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parametro rest_diaguita que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:18:21Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="bash" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
:<source>
'''DOCUMENTOS_HOST:''' Es la url de conexion a Arai-Documentos. Es el equivalente al parametro host_arai que se utilizaba en arai_documentos.ini
'''DOCUMENTOS_USUARIO:''' Usuario de la API de Arai-Documentos
'''DOCUMENTOS_CLAVE:''' Contraseña de la API de Arai-Documentos
'''URL_NOTIFICACIONES:''' URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parametro rest_diaguita que se utilizaba en arai_documentos.ini
</source>
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:16:39Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="php" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
'''DOCUMENTOS_HOST:''' Es la url de conexion a Arai-Documentos. Es el equivalente al parametro host_arai que se utilizaba en arai_documentos.ini
'''DOCUMENTOS_USUARIO:''' Usuario de la API de Arai-Documentos
'''DOCUMENTOS_CLAVE:''' Contraseña de la API de Arai-Documentos
'''URL_NOTIFICACIONES:''' URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parametro rest_diaguita que se utilizaba en arai_documentos.ini
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:11:56Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

=== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ===
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

:<source lang="php" enclose="div">
##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento
</source>

Detalle de cada Variable de entorno:
'''DOCUMENTOS_HOST:''' Es la url de conexion a Arai-Documentos. Es el equivalente al parametro host_arai que se utilizaba en arai_documentos.ini
'''DOCUMENTOS_USUARIO:''' Usuario de la API de Arai-Documentos
'''DOCUMENTOS_CLAVE:''' Contraseña de la API de Arai-Documentos
'''URL_NOTIFICACIONES:''' URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parametro rest_diaguita que se utilizaba en arai_documentos.ini
----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/version4.1.0/post instalacion

2025-05-20T14:10:10Z

Pboyko:

[[Archivo:siu-diaguita_iso.png|derecha|link=SIU-Diaguita/version4.1.0]]
 

__TOC__
=== Configuración y verificaciones del servidor del sistema ===

==== Configuración del servidor de aplicaciones ====

Independientemente de si se va a realizar la instalación del sistema SIU-Diaguita en un servidor Linux o Windows, es recomendable la configuración en el servidor de aplicaciones apache de un virtualhost o dominio virtual que garantice la ejecución correcta del sistema. Una de las ventajas de contar con una configuración de virtualhost es que permite realizar múltiples instalaciones del sistema SIU-Diaguita en el mismo servidor de aplicación, manejandolas de forma independiente una de la otra.

Proceder a crear un archivo de nombre diaguita con el siguiente contenido:

<source lang="php" enclose="div">
<VirtualHost *:80>
ServerAdmin webmaster@localhost
ServerName servidor.universidad.edu.ar

### INICIO INCLUSION CONTENIDO toba.conf ###

Include /ruta_instalacion/diaguita/instalacion/toba.conf

### FIN INCLUSION CONTENIDO toba.conf ###

</VirtualHost>
</source>

Tener en cuenta que se debe reemplazar servidor.universidad.edu.ar con un nombre del servidor o DNS válido y que no este siendo utilizado por otro virtualhost, ya que será por medio del cual acederá al sistema.

Una vez configurado el archivo de virtualhost, copiarlo al directorio de configuración sites-avaiable del servidor apache y crear un enlace simbólico en el directorio sites-enabled (en Linux, existe el comando a2ensite que realiza esta tarea). Para finalizar, reiniciar el servidor apache para que tome los nuevos cambios.

Finalmente, podrá acceder al sistema SIU-Diaguita abriendo en un navegador la dirección url http://servidor.universidad.edu.ar/diaguita.

Como ajuste opcional, es posible eliminar el alias /diaguita de la url de modo que no sea necesario agregarlo a la dirección al usar el navegador. Para ello deberá editar el archivo <tt>/ruta_instalacion/diaguita/instalacion/toba.conf</tt> reemplazando la línea

<source lang="php" enclose="div">
Alias /diaguita "/ruta_instalacion/diaguita/aplicacion/www"
</source>

por

<source lang="php" enclose="div">
DocumentRoot "/ruta_instalacion/diaguita/aplicacion/www"
</source>

Además, asegurarse de ajustar la condición de reescritura de url (necesaria para brindar acceso a los servicios web REST)

<source lang="php" enclose="div">
RewriteBase "/diaguita"
</source>

por

<source lang="php" enclose="div">
RewriteBase "/"
</source>

Luego editar <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/instancia.ini</tt> y reemplazar la línea

<source lang="php" enclose="div">
url="/diaguita"
</source>

por

<source lang="php" enclose="div">
url=""
</source>

----

==== Ajustes necesarios para PHP ====

Los siguientes son ajustes requeridos para la correcta ejecución de la aplicación SIU-DIaguita en un servidor Debian y PHP 8.1. Se debe editar el archivo <tt>/etc/php/8.1/apache2/php.ini</tt> y agregar o modificar los siguientes parámetros con valores igual o superiores a los sugeridos:

<source lang="php" enclose="div">
max_input_vars = 15000
memory_limit = 1025M
</source>

----

==== Verificación del funcionamiento del sistema SIU-Diaguita ====

==== Verificar configuración y requerimientos mínimos ====

Desde SIU-Diaguita se recomienda utilizar la operación '''Configuración de SIU-Diaguita''' para la revisión y cumplimiento de librerías y configuraciones. Para ello, deberán dirigirse a la operación:

<source lang="php" enclose="div">
Administración => Configuración de SIU-Diaguita
</source>

[https://documentacion.siu.edu.ar/wiki/SIU-Diaguita/version3.4.1/configuracion_del_sistema#VERIFICAR_CONFIGURACION Configuración SIU-Diaguita]

En esta operación es posible verificar las versiones de las dependencias del sistema, la configuración de los servicios y el funcionamiento de los mismos.

Nota: Con esta operación, es posible verificar (una vez instalado el sistema) las librerías, dependencias y configuraciones necesarias que requiere el sistema para su correcto funcionamiento.

==== Verificar errores del sistema ====

Siempre que estemos ante la necesidad de realizar un análisis de que es lo que ocurre con el sistema, es aconsejable recurrir a los archivos de logs que presentan cada uno de los componentes presentes y/o relacionados con el sistema SIU-Diaguita. A continuación se detallan los tres más importantes:

#El log del propio sistema SIU-Diaguita, ubicado en <tt>/ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/logs/sistema.log</tt>. Muestra toda la ejecución, tanto peticiones normales, permisos, errores del negocio, etc.
#El log del servidor web apache, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/apache2/error.log</tt>. Puede ser redefinido, y depende del sistema operativo. Muestra errores propios de apche, php, y también del sistema.
#El log del servicio JasperRepors, por defecto configurado en <tt>/var/log/diaguita_reportes.log</tt>. Muestra errores de ejecución propia de un reporte, ya dentro del ámbito de la JVM.
#El log del servidor de base de datos PostgreSQL, por lo general en Debian/Ubuntu ubicado en <tt>/var/log/postgresql/postgresql-x.x-main.log</tt>. Muestra en detalle los errores de dase de datos.

==== Verificar recursos disponibles de los Servicios web ====

Todo sistema SIU (SIU-Diaguita, SIU-Pilaga, etc) que brinde conexión de '''servicios web''' vía REST, posee una consola de verificación/pruebas/chequeo que permite la verificación y/disponiblidad de recursos. La forma por defecto de conectarse a ella es ingresando mediante la url del sistema y adicionando /rest al final.
<source lang="php" enclose="div">
http://direccion-web-sistema-siu/rest
</source>

De esta forma, se nos cargará un portal que pedirá datos de acceso. Estos datos de acceso son los que se configuraron en el archivo <tt>servidor_usuarios.ini</tt> de la [#ConectarSIU-DiaguitaconSIU-Pilagá sección de configuración] de servicios web.

----

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

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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita.

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

<source lang="php" enclose="div">

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
</source>

Además, dentro del archivo <tt>diaguita_reportes.sh</tt> deberá configurar la variable PATH_DIAGUITA para que apunte al directorio <tt>/ruta_instalacion</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">

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)
</source>

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 <tt>/var/log/diaguita_reportes.log</tt> 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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute todos los lunes a las 5am:

<source lang="php" enclose="div">
0 5 * * 1 /ruta_instalacion/diaguita/bin/limpieza_temporales.sh
</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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:

<source lang="php" enclose="div">
apt-get install php5-odbc tdsodbc unixodbc
</source>

''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:

<source lang="php" enclose="div">
cp /usr/share/tdsodbc/odbcinst.ini /etc/
</source>

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:

<source lang="php" enclose="div">
nano /etc/odbc.ini
</source>

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

<source lang="php" enclose="div">
[catalogo]
Driver = FreeTDS
Description = MCC DB
Server = 192.168.1.209
Port = 2638
Database = catalogo
TDS_Version = 5.0
</source>

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:

<source lang="php" enclose="div">
isql catalogo dba sql
</source>

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:

<source lang="php" enclose="div">
[ODBC]
Trace = Yes
TraceFile = /tmp/diaguita-odbc.log
</source>

----

==== '''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:

<source lang="php" enclose="div">
[mcc]
dsn_odbc = catalogo
usuario = dba
clave = sql
</source>

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:

#el identificador de acceso debe coincidir con el de diaguita
#debe ser del tipo "Usuario" y no "Administrador"
#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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> de la aplicación SIU-Diaguita. Ejemplo de configuración para que se ejecute cada 5 minutos, todos los días:

<source lang="php" enclose="div">
*/5 * * * * /ruta_instalacion/diaguita/bin/diaguita_notificaciones.sh

</source>

''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 <tt>/ruta_instalacion/diaguita/aplicacion/bin/</tt> 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 [http://toba.siu.edu.ar/trac/toba/wiki/Referencia/Mails wiki] de SIU-Toba.

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/smtp.ini
</source>

El contenido de dicho archivo debe ser similar a lo siguiente

<source lang="php" enclose="div">
[correo_testing]
host=127.0.0.1
auth=1
usuario=usuario
clave=*******
puerto=1254
seguridad=
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/instalacion.ini
</source>

El archivo se debe agregar lo siguiente

<source lang="php" enclose="div">
...
smtp=correo_testing
</source>

----

==== Servicios Web ====

==== '''Configuración del Portal de Compras Públicas''' ====

SIU-Diaguita dispone de un módulo especial que permite acceder de forma pública a las Convocatorias y Licitaciones de la institución. Dicho módulo se lo conoce como '''Portal de Compras Públicas''' y es parte de la estructura de SIU-Diaguita. Por lo tanto, permitir su acceso directo desde el exterior implica que el servidor de aplicaciones apache quede expuesto a la red externa de la institución.

Ya que esta práctica no es la recomendable, se recomienda la instalación y configuración de un servidor tipo proxy que permita el acceso desde internet al módulo de consultas internamente, sin exponer ni comprometer la seguridad general del servidor de aplicaciones apache.

En el siguiente [http://foro.comunidad.siu.edu.ar/index.php?topic=12711.msg55339 enlace] al foro se encuentran algunas configuraciones realizadas por distintas universidades.
----

==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====

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

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

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/pilaga/cliente.ini
</source>

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/"

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/pilaga/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

'''NOTA:''' Dependiendo la versión de SIU-Pilaga la ruta debe quedar definida de la sgte forma:

Hasta la versión '''4.1.x'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/"
</source>
Desde la versión '''3.7.0'''
<source lang="php" enclose="div">
to = "http://direccion/web/hacia/pilaga/rest/v1/"
</source>

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

<source lang="php" enclose="div">
/ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor.ini
</source>

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

<source lang="php" enclose="div">
autenticacion = digest
;
;Opciones que recibe la librería - > rest/rest.php
;
[settings]
formato_respuesta = json
url_protegida = /.*/
</source>

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

<source lang="php" enclose="div">
ruta_instalacion/pilaga/instalacion/i__produccion/p__pilaga/rest/servidor_usuarios.ini
</source>

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.

<source lang="php" enclose="div">
[diaguita_rest]
password = ingrese_clave_segura

[admin]
password = ingrese_clave_segura
</source>

----
==== '''Conectar SIU-Diaguita con SIU-Mapuche''' ====

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

'''''En SIU-Diaguita'''''

'''1-''' Habilitar el parámetro '''MAPUCHE_CONSULTA_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''Sí'''.

'''2-''' Habilitar el parámetro '''ADMINISTRACION_EMPLEADOS''' desde el menú Administración -> Parámetros. Asignarle valor institución '''SIU-Diaguita'''.

'''3-''' Para permitir que SIU-Diaguita acceda a recursos de SIU-Mapuche, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguiente ruta:

<source lang="php" enclose="div">
ruta_instalacion/diaguita/instalacion/i__produccion/p__diaguita/rest/mapuche/cliente.ini
</source>

'''4-''' 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/".

<source lang="php" enclose="div">
[conexion]
to = "http://direccion/web/hacia/mapuche/rest/"
auth_tipo = digest
auth_usuario = diaguita_rest
auth_password = ingrese_clave_segura
</source>

----

==== '''Configuración para importación de Datasets''' ====

Los pasos que se describen a continuación permiten configurar el consumo de datasets disponibles en [https://datos.gob.ar Datos Argentina].

===== Requerimientos técnicos =====

Esto requiere que configuren las siguientes variables de php para su uso.

{| class="wikitable"
! width="25%" | Parametró
! width="25%" | Valor recomendado
|-
| allow_url_fopen
| On
|-
| upload_max_filesize
| 64
|-
| post_max_size
| 64
|-
| memory_limit
| 1024
|-
| max_input_time
| 90
|}

===== Importación de proveedores SIPRO =====

Para poder importar proveedores para el catálogo de SIPRO ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de proveedores SIPRO"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.15 | (SIPRO)]

===== Importacion de Catalogo Sibys =====

Para poder importar los datos para el catálogo de SIBYS ir al menú '''"Administración" => "Tablas maestras compras" => "ABM de catálogo SIByS"'''.

Enlace directo donde se encuentra el archivo para su descarga [https://datos.gob.ar/dataset/jgm-sistema-contrataciones-electronicas/archivo/jgm_4.16 | (SIBYS)]

===== Modo de uso =====

Esto permite importar de dos modos:

'''Importación WE'''B: traé el contenido via web para su importación.

'''Importar CSV''': por medio de un archivo csv se realiza la importación.

Nota: el fuente de datos se consume o descarga de [https://datos.gob.ar | Datos Argentina]

----

==== '''Exportar garantías a SIU-Pilagá''' ====

La operación exportar garantías disponible desde la versión 4.1.0 de SIU-Diaguita permite que las garantías de los oferentes ingresadas en Acto de Apertura/Oferentes puedan ser exportadas a SIU-Pilagá.
Para utilizar este servicio, en esta versión ya no es necesario configurar la librería Rest-Hooks.
----

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

===== Uso =====

En primer lugar para poder utilizar el servicio es necesario generar un certificado y una clave desde los servicios de AFIP.

Una vez generado el certificado se debe autorizar el servicio: '''Servicio Consulta Padron A4 (ws_sr_padron_a4).'''

Para obtener información de como obtener el certificado y la clave para utilizar el servicio ir a [http://www.afip.gob.ar/ws/documentacion/default.asp | Documentación Técnica de los WS de AFIP]

===== Configuración =====

Una vez generado el certificado y la clave en Afip se debe proceder a configurar en el archivo '''instalador.env''' los parámetros de configuración de la Api.

:<source lang="php" enclose="div">
###### CONFIG AFIP WS ######
AFIP_WS_CUIT=cuit
AFIP_WS_CERT=/ruta/a/cert
AFIP_WS_KEY=/ruta/a/key
AFIP_WS_TOKEN_DIR=/ruta/a/generacion/token
</source>

===== Parámetros de configuración disponibles =====

{| class="wikitable"
! width="25%" | Parametro
! width="75%" | Descripcion
|-
| AFIP_WS_CUIT
| <code>(int)</code> CUIT con el que se ha generado los certificados para acceder a los servicios de AFIP.
|-
| AFIP_WS_CERT
| <code>(string)</code>Ruta absoluta donde se encuentra el certificado
|-
| AFIP_WS_KEY
| <code>(string)</code>Ruta absoluta donde se encuentra la clave
|-
| AFIP_WS_TOKEN_DIR
| <code>(string)</code>Ruta absoluta donde la lib genera el token (requiere permisos de escritura)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la configuración en SIU-Diaguita y una vez finalizada la instalación ya se podrá usar el servicio de Afip en el sistema.

----

==== '''Conectar SIU-Diaguita con SIU-Arai Proveedores''' ====

===== Configuración de la base de datos de Arai Proveedores =====

Para configurar el Siu - Arai Proveedores se debe configurar los parámetros de conexión a la base de datos de Arai Proveedores en el archivo '''instalador.env'''

:<source lang="php" enclose="div">
###### CONFIG DE BASE DE DATOS ARAI PROVEEDORES ######
ARAI_PROV_DB_HOST=localhost
ARAI_PROV_DB_PORT=5432
ARAI_PROV_DB_DBNAME=db_arai_proveedores
ARAI_PROV_DB_USERNAME=postgres
ARAI_PROV_DB_PASSWORD=postgres
ARAI_PROV_DB_SCHEMA=public
ARAI_PROV_DB_ENCODING=UTF8
</source>

{| class="wikitable"
! width="25%" | Variable de entorno
! width="75%" | Descripción
|-
| ARAI_PROV_DB_HOST
| el host/ip del equipo donde corre la base de datos
|-
| ARAI_PROV_DB_PORT
| el puerto donde corre la base de datos
|-
| ARAI_PROV_DB_DBNAME
| el nombre de la base de datos de proveedores
|-
| ARAI_PROV_DB_USERNAME
| el usuario para la conectarse a la base de datos
|-
| ARAI_PROV_DB_PASSWORD
| la clave del usuario para conectarse a la base de datos
|-
| ARAI_PROV_DB_SCHEMA
| el nombre del esquema dentro de la base de datos
|-
| ARAI_PROV_DB_ENCODING
| la codificación de caracteres de la base de datos. (UTF8 por defecto)
|}

Una vez configurado los parámetros, al ejecutar el proceso de instalación o actualización automáticamente genera la base de datos central de Arai Proveedores con la estructura de datos actualizada y configura la conexion en SIU-Pilagá.

Para obtener mayor información acerca de la sincronización podrán encontrar los pasos para [http://documentacion.siu.edu.ar/wiki/SIU-Arai/proveedores#Funciones_por_linea_de_Comando | ejecutar la sincronización por linea de comandos]

----

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

<source lang="php" enclose="div">
ERROR: date/time field value out of range: "6/6/2016 09:56:47"
SQL state: 22008
Hint: Perhaps you need a different "datestyle" setting.
</source>

Este error está relacionado con el [http://dba.stackexchange.com/questions/19679/how-to-set-postgresql-database-to-see-date-as-mdy-permanently?answertab=votes#tab-top 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:

<source lang="php" enclose="div">
ALTER DATABASE "nombre_db" SET datestyle TO "ISO, DMY";
</source>

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

<source lang="php" enclose="div">
datestyle = 'iso, dmy'
</source>

=== Bundles de Solicitudes de bienes y servicios ===

La configuración completa para los bundles de SBS se encuentra en el siguiente [[SIU-Diaguita/version4.1.0/post_instalacion/bundle_sbs | enlace]]

==== '''Configurar los parámetros para Araí-Documentos en SIU-Diaguita''' ====
A partir de esta versión 4.1.0, para utilizar Diaguita integrado al EEI para enviar documentos a autorizar, es necesario configurar correctamente las variables de entorno involucradas en el instalador.env.
Ya no es necesario configurar el archivo arai_documentos.ini.
Las variables de entorno necesarias para el correcto funcionamiento con Arai-Documentos son:

##### CONFIG API DOCUMENTOS #####
#DOCUMENTOS_HOST=http://url.api.arai.documentos/docs
#DOCUMENTOS_USUARIO=usuario
#DOCUMENTOS_CLAVE=clave
#URL_NOTIFICACIONES=http://url.a.diaguita/diaguita/rest/v1/notificaciones/documento

Detalle de cada Variable de entorno:
DOCUMENTOS_HOST: Es la url de conexion a Arai-Documentos. Es el equivalente al parametro host_arai que se utilizaba en arai_documentos.ini
#DOCUMENTOS_USUARIO: Usuario de la API de Arai-Documentos
#DOCUMENTOS_CLAVE: Contraseña de la API de Arai-Documentos
#URL_NOTIFICACIONES: URL del recurso de la API de SIU-Diaguita donde se reciben las notificaciones de Arai-Documentos. Es el equivalente al parametro rest_diaguita que se utilizaba en arai_documentos.ini

----------------------------------------------------

 
[[SIU-Diaguita/version4.1.0 | < Volver]]

SIU-Diaguita/Version4.0.0/Novedades funcionales

2024-10-01T19:49:43Z

Pboyko: /* Principales novedades de la versión */

=Principales novedades de la versión=
- Módulo de oferta electrónica
 
- Visualización de convocatorias vigentes en el PORTAL DEL PROVEEDOR, cuando el proveedor ha gestionado su usuario.
 
- Gestión de la carga por parte del oferente de su propia presentación.
 
- Registro automático en SIU-DIAGUITA, cuando se recibe una oferta, quedando anonimizado el valor de la misma.
 
- Carga automática del valor de las propuestas de los OFERENTES, al momento del ACTO DE APERTURA.
 
- Importación de cada uno de los renglones de las OFERTAS presentadas desde el módulo de OFERTA ELECTRÓNICA
 
 
- Ordenamiento de los firmantes en los distintos documentos.
 
- Mejoras en filtros de convocatorias.
 
- Mejoras en filtros de garantías.
 
- Validación de datos del Número de Expediente Electrónico, al duplicar una convocatoria.
 

 
-----
[[SIU-Diaguita/version4.0.0|<Volver]]

SIU-Diaguita/Version4.1.0/Novedades funcionales

2024-10-01T19:49:43Z

Pboyko:

SIU-Diaguita/Version4.0.0/Novedades funcionales

2024-10-01T19:48:00Z

Pboyko: Página creada con «=Principales novedades de la versión= Módulo de oferta electrónica Visualización de convocatorias vigentes en el PORTAL DEL PROVEEDOR, cuando el proveedor...»

=Principales novedades de la versión=
Módulo de oferta electrónica
 
Visualización de convocatorias vigentes en el PORTAL DEL PROVEEDOR, cuando el proveedor ha gestionado su usuario.
 
Gestión de la carga por parte del oferente de su propia presentación.
 
Registro automático en SIU-DIAGUITA, cuando se recibe una oferta, quedando anonimizado el valor de la misma.
 
Carga automática del valor de las propuestas de los OFERENTES, al momento del ACTO DE APERTURA.
 
Importación de cada uno de los renglones de las OFERTAS presentadas desde el módulo de OFERTA ELECTRÓNICA
 
Ordenamiento de los firmantes en los distintos documentos.
 
Mejoras en filtros de convocatorias.
 
Mejoras en filtros de garantías.
 
Validación de datos del Número de Expediente Electrónico, al duplicar una convocatoria.
 

 
-----
[[SIU-Diaguita/version4.0.0|<Volver]]