|
|
| (No se muestra una edición intermedia del mismo usuario) |
| Línea 2: |
Línea 2: |
| | <br><br><br> | | <br><br><br> |
| | | | |
| − | === Instalación del sistema === | + | === Realizar personalizaciones del sistema SIU-Diaguita === |
| | | | |
| | __TOC__ | | __TOC__ |
| | | | |
| − |
| |
| − | Es conveniente 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.
| |
| − |
| |
| − | ----
| |
| − |
| |
| − | ==== Requerimientos mínimos ====
| |
| − |
| |
| − | 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://comunidad.siu.edu.ar. Las versiones recomendadas son las siguientes:
| |
| − | *Apache 2.2.x. a 2.4.x
| |
| − | *PostgresSQL 9.1.x a 9.4.x.
| |
| − | *PHP 5.4.x a 5.6.x, recomendable 5.6.x (con las extensiones: xml, gd, pdo_pgsql, curl).
| |
| − | *Librería Graphviz 2.26.x o superior.
| |
| − | *Librería cURL 7.19 o superior.
| |
| − | *Java Runtime Environment 1.7.x (se requiere tener instalado JRE debido a que se utiliza la tecnología JasperReports para realizar la generación de todos los documentos/comprobantes emitidos por el sistema).
| |
| − |
| |
| − | ----
| |
| − |
| |
| − | ==== Instalación inicial del sistema SIU-Diaguita ====
| |
| − |
| |
| − | ==== Instalación del servidor de aplicaciones bajo Linux ====
| |
| − |
| |
| − | Para un entorno SIU-Diaguita, es recomendable el uso de algún sistema operativo Linux. En este ejemplo, se muestra los pasos para instalar bajo un sistema Debian GNU/Linux versión 8.
| |
| − |
| |
| − | El primer paso es instalar un servidor web apache2 con soporte a php:
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | # instalar PHP y sus modulos
| |
| − | apt-get install php5 php5-cli php5-apcu php5-pgsql php5-xsl php5-xml php5-gd php5-curl
| |
| − | # instalar Apache como servidor web
| |
| − | apt-get install apache2 libapache2-mod-php5
| |
| − | # instalar dependencias extras
| |
| − | apt-get install graphviz openjdk-7-jre openjdk-7-jre-headless curl
| |
| − | </source>
| |
| − |
| |
| − | Una vez instalado el servidor web, se deberá instalar un servidor de bases de datos PostgreSQL:
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | # instalar servidor PostgreSQL
| |
| − | apt-get install postgresql
| |
| − | </source>
| |
| − |
| |
| − | Tener en cuenta que todos estos servicios se deberán configurar, adaptar y proteger de acuerdo a las necesidades del entorno y/o el tipo de protección que requieran. Las configuraciones por defecto no suelen ser adecuadas para los entornos de producción, ni se espera que los pasos ofrecidos inicialmente sean los únicos para tener correctamente configurado un entorno de producción.
| |
| − |
| |
| − | ----
| |
| − |
| |
| − | ==== Instalación del sistema ====
| |
| − |
| |
| − | Descargar desde el servicio Repositorio http://comunidad.siu.edu.ar/ el archivo SIU-Diaguita-2.xx.x.zip correspondiente a la última versión. La instalación del sistema SIU-Diaguita se realiza utilizando un asistente web, el cual funciona ingresando a una dirección en el navegador dependiendo de cómo tenga configurado su plataforma web.
| |
| − |
| |
| − | A continuación se describen los pasos a seguir para lograr una instalación correcta y segura del sistema SIU-Diaguita para un servidor de producción. Tener en cuenta que un sistema incorrectamente configurado puede exponerlo a riesgos de seguridad y dejarlo vulnerable a diversos tipos de ataques o amenazas.
| |
| − |
| |
| − | Descomprimir dicho archivo en el directorio raíz del servidor web (por lo general es un directorio llamado htdocs o www, definido como DocumentRoot en el servidor de aplicaciones apache). Ingresar mediante un navegador a la dirección http://direccion_servidor/SIU-Diaguita-2.XX.X y seguir los pasos indicados en la primera pantalla que muestra el instalador haciendo clic en Instalar.
| |
| − |
| |
| − | En el transcurso de la instalación, uno de los datos solicitados se refiere a la ruta de instalación del sistema. En esta guía se menciona dicha ruta mediante la referencia <tt>/ruta_instalacion</tt>.
| |
| − |
| |
| − | Es posible que el instalador produzca la siguiente advertencia:
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | El Directorio Destino se encuentra en el document root de Apache. Escoja otro directorio y vuelva a intentarlo.
| |
| − | </source>
| |
| − |
| |
| − | En este caso, se deberá elegir otra ubicación para la ruta de instalación debido a que no se puede instalar SIU-Diaguita en un directorio raiz o DocumentRoot del servidor de aplicaciones apache.
| |
| − |
| |
| − |
| |
| − | Nota: En el transcurso de la instalación, uno de los datos solicitados se refiere a la ruta de instalación del sistema. En esta guía se menciona dicha ruta mediante la referencia <tt>/ruta_instalacion</tt>.
| |
| − |
| |
| − | ----
| |
| − |
| |
| − | ==== 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>
| |
| − |
| |
| − | ----
| |
| − |
| |
| − | ==== Configuración del módulo de consultas para Convocatorias ====
| |
| − |
| |
| − | 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 '''Convocatorias publicadas en la web''' 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 proporciona los pasos necesarios para 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.
| |
| − |
| |
| − |
| |
| − | '''Instalación'''
| |
| − |
| |
| − | Para correr el servidor proxy existen varias alternativas, entre ellas el servidor ''nginx''. Para realizar la instalación en Debian GNU/Linux versión 8, se debe ejecutar:
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | apt-get install nginx
| |
| − | </source>
| |
| − |
| |
| − | En general, la recomendación es instalar este servidor proxy separado del servidor de aplicaciones apache, o dicho de otra forma, en un servidor individual y dedicado a ello.
| |
| − |
| |
| − | '''Configuración en el servidor'''
| |
| − |
| |
| − | Una vez que se dispone del servidor proxy ''nginx'', es necesario configurar un virtualhost para el acceso, creando el archivo:
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | nano /etc/nginx/sites-enabled/diaguita
| |
| − | </source>
| |
| − |
| |
| − | Este archivo deberá tener el contenido disponible en attachment:diaguita-nginx.conf. Permite a un subdominio público acceder al servidor interno donde corre SIU-Diaguita, sin necesidad de exponer a este último.
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | root@host:/# # podemos verificar que la configuracion sea correcta
| |
| − | root@host:/# service nginx configtest
| |
| − | root@host:/# # ahora si reiniciar
| |
| − | root@host:/# service nginx restart
| |
| − | </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 Linux 6.0 y PHP 5.3 con parche suhosin. Se debe editar el archivo <tt>/etc/php5/apache2/php.ini</tt> y agregar o modificar los siguientes valores:
| |
| − |
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | max_input_vars = 15000
| |
| − | memory_limit = 1024M
| |
| − | </source>
| |
| − |
| |
| − |
| |
| − | A partir de la versión 5.4 de PHP, el parche de seguridad suhosin dejó de ser soportado. Si bien se retomó su desarrollo, ya no se encuentra empaquetado oficialmente en la distribución Debian GNU/Linux versión 8. Además, muchas de sus características fueron incluidas y/o corregidas en el mismo núcleo de PHP. Por lo tanto, creemos que no es necesario mantener activo esta configuración. Si a pesar de ello lo utilizan, tendrán que tener en cuenta las diversas restricciones que se aplican sobre las variables GET/POST/REQUEST pertinentes.
| |
| − |
| |
| − | ----
| |
| − |
| |
| − | ==== Verificación del funcionamiento del sistema SIU-Diaguita ====
| |
| − |
| |
| − | ==== Verificar configuración y requerimientos mínimos ====
| |
| − |
| |
| − | Se incorpora a partir de la versión 2.4.0 una operación que permite verificar la '''Configuración de SIU-Diaguita'''. Para ello, deberán dirigirse a la operación:
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | Administración => Configuración de SIU-Diaguita
| |
| − | </source>
| |
| − |
| |
| − | 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<u>produccion/p</u>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).
| |
| − |
| |
| − | JasperReports requiere para funcionar la instalación de determinadas librerías, las cuales tendrá que descargar desde el repositorio de descargas de para SIU-Diaguita (dentro de directorio JasperReports/Versiones). Una vez obtenido el archivo JasperReports-5.1.0.tar.gz, se debe descomprimir su contenido (dos carpetas llamadas JasperReports y JavaBridge) en el directorio <tt>/ruta_instalacion/diaguita/toba/php/3ros/</tt> de la aplicación SIU-Diaguita.
| |
| − |
| |
| − | El próximo paso es configurar para que se ejecute de forma contínua el servidor local de reportes.
| |
| − |
| |
| − |
| |
| − | ''Configuración bajo Linux''
| |
| − |
| |
| − | Mediante la utilidad init.d del sistema Debian Linux, configurar la ejecución del archivo diaguita_reportes.sh que se encuentra ubicado dentro del directorio <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 * * * 1 /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 ====
| |
| − |
| |
| − | ==== '''Conectar SIU-Diaguita con SIU-Pilagá''' ====
| |
| − |
| |
| − | Nota: la versión 2.4.0 de SIU-Diaguita requiere al menos contar con la versión 2.4.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<u>produccion/p</u>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>
| |
| − |
| |
| − |
| |
| − |
| |
| − | ''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<u>produccion/p</u>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<ED>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<u>produccion/p</u>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 la AFIP''' ====
| |
| − |
| |
| − | Los pasos que se describen a continuación permiten configurar el acceso a recursos de la AFIP expuestos mediante servicios web.
| |
| − |
| |
| − | ''En SIU-Diaguita''
| |
| − |
| |
| − | Para permitir que SIU-Diaguita acceda a recursos de la AFIP, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguente ruta
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | ruta_instalacion/diaguita/instalacion/i<u>produccion/p</u>diaguita/rest/afip/cliente.ini
| |
| − | </source>
| |
| − |
| |
| − | El contenido de dicho archivo debe ser '''exactamente''' lo siguiente
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | [conexion]
| |
| − | to = "https://soa.afip.gob.ar/"
| |
| − | </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: "24/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>
| |
| − |
| |
| − | ----
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | #comment
| |
| − | COMENTARIOS DE CONFIGURACION QUE AL FINAL NO ENTRA PARA LA 2.4.0 PERO QUE ESTA BUENO YA TENERLO...
| |
| − |
| |
| − | Para permitir que SIU-Pilaga acceda a recursos de SIU-Diaguita, se debe crear la carpeta conteniendo el archivo ´cliente.ini´ en la siguente ruta
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | ruta_instalacion/pilaga/instalacion/i<u>produccion/p</u>pilaga/rest/diaguita/cliente.ini
| |
| − | </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/diaguita/rest/"
| |
| − | auth_tipo = digest
| |
| − | auth_usuario = pilaga_rest
| |
| − | auth_password = ingrese_clave_segura
| |
| − | </source>
| |
| − |
| |
| − | ----------------------------------------------------
| |
| − |
| |
| − | Para permitir el acceso externo a recursos de SIU-Diaguita, se debe configurar el archivo ´servidor.ini´ ubicado en la siguiente ruta
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | ruta_instalacion/diaguita/instalacion/i<u>produccion/p</u>diaguita/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<ED>a - > rest/rest.php
| |
| − | ;
| |
| − | [settings]
| |
| − | formato_respuesta = json
| |
| − | url_protegida = /.*/
| |
| − | </source>
| |
| − |
| |
| − | Se debe configurar el archivo ´servidor_usuarios.ini´ ubicado en la siguiente ruta
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | ruta_instalacion/diaguita/instalacion/i<u>produccion/p</u>diaguita/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-Pilaga (configurado en el ´cliente.ini´ de Pilaga).
| |
| − |
| |
| − | <source lang="php" enclose="div">
| |
| − | [pilaga_rest]
| |
| − | password = ingrese_clave_segura
| |
| − |
| |
| − | [admin]
| |
| − | password = ingrese_clave_segura
| |
| − | </source>
| |
| − |
| |
| − |
| |
| − | </source>
| |
| − |
| |
| − |
| |
| − |
| |
| − | === Realizar personalizaciones del sistema SIU-Diaguita ===
| |
| | | | |
| | El sistema SIU-Diaguita permite realizar personalizaciones de sus funciones (código php y metadatos) así como de las salidas y visualización de los datos que ofrece. Cada una de ellas se realiza de forma independiente y se enfocan a diferentes actividades, aunque algunas veces es necesario combinarlas para cubrir una necesidad de la organización. | | El sistema SIU-Diaguita permite realizar personalizaciones de sus funciones (código php y metadatos) así como de las salidas y visualización de los datos que ofrece. Cada una de ellas se realiza de forma independiente y se enfocan a diferentes actividades, aunque algunas veces es necesario combinarlas para cubrir una necesidad de la organización. |
