SIU-Guarani/version3.15.0/instalacion desde cero/instalacion/gestion/linux
Instalación desde cero de SIU-Guaraní Gestión 3.15 en entorno de Desarrollo
Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución. |
---|
A lo largo de los pasos se deberá reemplazar:
- : por el path donde está instalado el proyecto
- <siglas institución>: por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación
- 3.15.x: por la versión que se va a instalar
Pasos para la actualización
- Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:
- sudo mkdir /usr/local/proyectos/guarani
- Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto Guaraní>.
- Bajar el proyecto del SVN desde la URL correspondiente en Colab:
- sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.15.x <path proyecto Guaraní>
- Instalar vía Composer las dependencias del proyecto. Posicionados en la raíz <path proyecto Guaraní>, ejecutar:
- composer install
- Nota: el usuario y clave a utilizar son los recibidos por correo electrónico.
- Instalar el framework SIU-Toba, para ello, posicionados en <path proyecto Guaraní>/bin ejecutar:
- export TOBA_INSTANCIA=desarrollo
export TOBA_INSTALACION_DIR=<path proyecto Guaraní>
./toba instalacion instalar - y completar:
- Nombre del Alias (por defecto "toba"): <alias de los recursos navegables de Toba. Sugerencia: toba_guarani3>
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <ID personal enviado por correo electrónico>
Se trata de una instalacion de producción? (Si o No) (s/n): n
Nombre de la instalación (ej: Andromeda): <ej: guarani3>
PostgreSQL - Ubicación (ENTER utilizará localhost): <ip servidor Postgres>
PostgreSQL - Puerto (ENTER utilizará: 5432): <puerto servidor Postgres>
PostgreSQL - Usuario (ENTER utilizará postgres): <usuario servidor Postgres>
PostgreSQL - Clave (ENTER para usar sin clave): <clave servidor Postgres>
PostgreSQL - Base de datos (ENTER utilizará toba_2_7): <nombre de la base, sugerencia: guarani3>
Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)>
Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción>
- Registrar manualmente la fuente de datos del proyecto toba_usuarios, usado para el manejo de perfiles y auditoría. Para ello, en el archivo <path proyecto Guaraní>/instalacion/bases.ini, agregar al final una entrada con el encabezado [desarrollo toba_usuarios toba_usuarios], con idéntica configuración a la instancia de Toba (primera entrada de ese archivo). Ejemplo:
- [desarrollo toba_usuarios toba_usuarios]
motor = "postgres7"
profile = "localhost"
usuario = "postgres"
clave = "**********"
base = "guarani3"
puerto = "5432"
encoding = "LATIN1"
schema = "desarrollo"
- Darle permisos a las siguientes carpetas de manera recursiva para que el usuario con el que se ejecuta Apache pueda escribir:
- <path proyecto Guaraní>/www
- <path proyecto Guaraní>/temp
- <path proyecto Guaraní>/instalacion
- <path proyecto Guaraní>/metadatos_compilados (esta carpeta se crea al ejecutar ./guarani compilar en la configuración del entorno de Producción)
- <path proyecto Guaraní>/vendor/siu-toba/framework/www
- <path proyecto Guaraní>/vendor/siu-toba/framework/temp
- Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es www-data, debería ejecutarse:
- chown -R www-data:www-data <path proyecto Guaraní>/www
chown -R www-data:www-data <path proyecto Guaraní>/temp
chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/instalacion
chown -R www-data:www-data <path proyecto Guaraní>/metadatos_compilados
chown -R www-data:www-data <path proyecto Guaraní>/vendor/siu-toba/framework/www
chown -R www-data:www-data <path proyecto Guaraní>/vendor/siu-toba/framework/temp
- Tal como se indica en la consola al instalar, se debe crear el link simbólico al toba.conf e indicarle Apache que recargue los archivos de configuración
Idioma no válido.
Necesita especificar un idioma como esto: <source lang="html4strict">...</source>
lenguajes soportados para sintaxis remarcada:
4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript, actionscript3, ada, algol68, apache, applescript, apt_sources, arm, asm, asp, asymptote, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcl, dcpu16, dcs, delphi, diff, div, dos, dot, e, ecmascript, eiffel, email, epc, erlang, euphoria, f1, falcon, fo, fortran, freebasic, freeswitch, fsharp, gambas, gdb, genero, genie, gettext, glsl, gml, gnuplot, go, groovy, gwbasic, haskell, haxe, hicest, hq9plus, html4strict, html5, icon, idl, ini, inno, intercal, io, j, java, java5, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, ldif, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, mmix, modula2, modula3, mpasm, mxml, mysql, nagios, netrexx, newlisp, nsis, oberon2, objc, objeck, ocaml, ocaml-brief, octave, oobas, oorexx, oracle11, oracle8, oxygene, oz, parasail, parigp, pascal, pcre, per, perl, perl6, pf, php, php-brief, pic16, pike, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, pys60, python, q, qbasic, rails, rebol, reg, rexx, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, spark, sparql, sql, stonescript, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, upc, urbi, uscript, vala, vb, vbnet, vedit, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic
sudo ln -s <path proyecto Guaraní>/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf
sudo a2ensite gestion.conf
sudo service apache2 reload- Agregar los parámetros en el archivo de inicialización de la instalación Toba (<path proyecto Guaraní>/lib/toba/instalacion/instalacion.ini):
- [xslfo]
fop=<path proyecto Guaraní>/php/3ros/fop/fop - Nota: verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.
- Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto (<path proyecto Guaraní)) ejecutar:
- cp menu.ini.tmpl menu.ini
- Completar el archivo menu.ini
- Para cargar el proyecto, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- sudo ./guarani cargar -d <path proyecto Guaraní>
- Nota: ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder s.
- Para crear la base de datos de negocio, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- sudo ./guarani instalar
- Nota: en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador -j a la sentencia anterior.
- Para activar el esquema de auditoría, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
- sudo ./guarani crear_auditoria -f guarani
- Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:
- java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081
- Para ejecutar el proyecto navegar hacia la URL definida en toba.conf, por defecto:
- http://localhost/guarani/3.15
- El usuario-clave para el primer acceso es: toba-toba. Se recomienda luego del primer acceso modificar la clave.
- Para editar el proyecto navegar hacia la URL definida en toba.conf, por defecto:
- http://localhost/toba_editor/2.7
- El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.
Configuración de cron o tarea programada para el envío de emails
Un cron o tarea programada es un programa que permite ejecutar automáticamente comandos o scripts (grupos de comandos) a una hora o fecha específica. Es usado normalmente para comandos de tareas administrativas, como respaldos, pero puede ser usado para ejecutar cualquier cosa. Es un demonio que ejecuta programas agendados.
- Con un sistema GNU/Linux:
- En una consola ejecutar el comando:sudo crontab -e
- Agregar la siguiente linea:(ejecutará el comando cada 10 minutos) Para otros ejemplos consultar https://geekytheory.com/programar-tareas-en-linux-usando-crontab/*/10 * * * * <path proyecto Guaraní>/bin/guarani enviar_emails_notificador
- Guardar y salir del editor
- Con un sistema Windows:
- Crear un archivo .bat (ej: C:\guarani_enviar_emails_bat.bat) con el siguiente contenido:@echo off
<path proyecto Guaraní>\bin\guarani enviar_emails_notificador
exit - Ir a Inicio, buscar y ejecutar el programa "Programador de tareas".
- Ir a Acciones -> Crear tarea, en la solapa "General" poner un Nombre a la tarea (ej: guarani_cron_enviar_emails), una descripción (opcional) y tildar la opción "Oculta".
- En la solapa "Acciones" crear una nueva acción, donde dice "Programa o Script" seleccionar el path hasta el .bat (ej: C:\guarani_enviar_emails_bat.bat).
- En la solapa "Desencadenadores" crear un nuevo desencadenador, en inicio poner una hora posterior a la actual (ej: 10 minutos mas tarde) en Configuración avanzada poner Repetir cada 10 minutos repetir indefinidamente.
- Aceptar para crear la tarea.
(Para más detalles del envío de emails consulte la documentación del notificador)