Instalación de Guaraní 3 desde cero
Descripción de los pasos:
- Requisitos
- Esquema de personalizaciones
- Publicar URL con recursos personalizados
- Iniciar el esquema de personalizaciones
Requisitos
- Solicitar al SIU una URL específica para la institución, dentro de colab. Realizar la solicitud mediante un GDS.
Instalación en Windows
• Crear una carpeta en una unidad de disco local, por ejemplo:
C:\Guaraní
• Hacer un SVN checkout desde el repositorio de Colab en la carpeta creada.
Puede utilizar alguno de estos clientes SVN:
TortoiseSVN [[BR]] Cliente línea de comandos. Descargar utilizando el comando svn checkout
La URL de descarga es:
https://colab.siu.edu.ar/svn/guarani3/nodos/SIU/gestion/ Se debe reemplazar SIU por la Institución que se encuentra realizando la instalación.
Ejemplo:
• Seguir las instrucciones que se van indicando para la creación de la base de datos. En los sucesivos ejemplos denominaremos a la nueva base toba_2_4
• En la carpeta ‘bin’ de la instalación Toba '<path proyecto Guaraní>/lib/toba/bin', ejecutar el comando
instalar
y completar:
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <ID personal enviado por mail>
PostgreSQL - Ubicación (ENTER utilizará localhost): localhost (ejemplo)
PostgreSQL - Puerto (ENTER utilizará: 5432): 5432 (ejemplo)
PostgreSQL - Usuario (ENTER utilizará postgres): postgres (ejemplo)
PostgreSQL - Clave (ENTER para usar sin clave): xxxxxxxxxx
PostgreSQL - Base de datos (ENTER utilizará toba_2_3): toba_2_4
Toba - Clave (usuario "toba"): toba (ejemplo)
• Al finalizar la instalación no cerrar la ventana sin antes leer las instrucciones de cómo configurar Apache. Una vez configurado reiniciar Apache.
• Agregar los parámetros en el archivo de inicialización de la instalación Toba (<path proyecto Guaraní>/lib/toba/instalacion/instalacion.ini):
chequea_sincro_svn = 1 [xslfo] fop=<path proyecto Guaraní>/php/3ros/fop/fop.bat
Nota: verificar que la ruta al archivo ‘fop.bat’ sea la correcta de acuerdo al path de la instalación Toba.
• Cargar el proyecto
Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
guarani cargar -d <path proyecto Guaraní>
Nota: ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder "Si".
• Instalar la BD de negocios y sus configuraciones
En caso de que se quieran cargar los datos de prueba se deberá crear nuevamente la base de datos de negocio, agregando el modificador -j a la siguiente sentencia. Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
guarani instalar
• En caso de que se quiera usar el esquema de auditoría, posicionarse en la misma carpeta que la indicada en el punto anterior y ejecutar:
guarani crear_auditoria
• Dentro de las variables de entorno del sistema operativo, editar la variable del sistema Path y agregar la ruta a la carpeta bin de PostgreSQL (por defecto C:\Archivos de programa\PostgreSQL\9.1\bin\).
• Descargar el siguiente archivo .ZIP:
http://toba.siu.edu.ar/downloads/toba/JasperReports_JavaBridge.zip
Descomprimirlo en el directorio ‘php\3ros’ de la instalación (<path proyecto Guaraní>\lib\toba\php\3ros).
Luego, para ejecutar el servidor de reportes para la impresión en Guaraní 3 ejecutar el siguiente comando (reemplazando la variable $guarani_dir por el path del proyecto Guaraní)
java -jar $guarani_dir\lib\toba\php\3ros\JavaBridge\WEB-INF\lib\JavaBridge.jar SERVLET:8081
• Para ejecutar el proyecto navegar hacia
http://localhost/guarani/3.8
El usuario-clave para el primer acceso es: toba-toba. Una vez dentro del sistema ingresar a la operación “Matrícula > Personas > Administrar Personas”, elegir la persona de apellido “Toba”, dirigirse a la solapa ”Acceso al Sistema” y modificar la clave.
• Para editar el proyecto navegar hacia
http://localhost/toba_editor/2.4
El usuario-clave para el primer acceso es: toba - <clave ingresada durante la ejecución del comando instalar.bat>.
• Para editar el acceso al proyecto
Editar el archivo toba.conf (<path proyecto Guaraní>\lib\toba\instalacion) y definir:
- El/los alias.
Ejemplo:
#Proyecto: guarani Alias /guarani/3.8 "E:/Guarani38/www" <Directory "E:/Guarani38/www/"> SetEnv TOBA_DIR "E:/Guarani38/lib/toba" SetEnv TOBA_PROYECTO "guarani" SetEnv TOBA_INSTALACION_DIR "E:/Guarani38/lib/toba/instalacion" DirectoryIndex aplicacion.php Options MultiViews AllowOverride None <IfModule !mod_authz_core.c> Order allow,deny Allow from all </IfModule> <IfModule mod_authz_core.c> Require all granted </IfModule> <Files aplicacion.php> SetEnv TOBA_INSTANCIA "desarrollo" </Files> <Files servicios.php> SetEnv TOBA_INSTANCIA "desarrollo" </Files> </Directory>
- La sección Alias /guarani/3.8 "E:/Guarani38/www"
Ejemplo:
#Proyecto: guarani Alias /sistemaguarani "E:/Guarani38/www" <Directory "E:/Guarani38/www/"> SetEnv TOBA_DIR "E:/Guarani38/lib/toba" SetEnv TOBA_PROYECTO "guarani" SetEnv TOBA_INSTALACION_DIR "E:/Guarani38/lib/toba/instalacion" DirectoryIndex aplicacion.php Options MultiViews AllowOverride None <IfModule !mod_authz_core.c> Order allow,deny Allow from all </IfModule> <IfModule mod_authz_core.c> Require all granted </IfModule> <Files aplicacion.php> SetEnv TOBA_INSTANCIA "desarrollo" </Files> <Files servicios.php> SetEnv TOBA_INSTANCIA "desarrollo" </Files> </Directory>
Instalación en Linux – Distribuciones Debian o derivados
1. En caso de que los repositorios no tengan una versión actualizada de PHP (5.3.x) cambiar las fuentes de los paquetes.
2. Ejecutar como superusuario:
apt-get install apache2 libapache2-mod-php5 php5-cli php5-pgsql php5-gd php5-curl
3. Ejecutar
php -m
En caso de no encontrar los paquetes pdo y pdo_pgsql en el listado, se necesita instalarlos manualmente:
3.1. Descargar y compilar las extensiones utilizando el comando pecl:
apt-get install php5-dev php-pear postgresql-server-dev-8.1 build-essential pecl install pdo pecl install pdo_pgsql3.2. Agregar a los archivos:
/etc/php5/cli/php.ini y /etc/php5/apache2/php.ini
extension=pdo.so extension=pdo_pgsql.so
4. Para instalar servidor y cliente de PostgreSQL (en caso de no contar con un servidor aparte) ejecutar:
apt-get install postgresql
5. Para instalar el cliente Subversion ejecutar:
apt-get install subversion
6. Para instalar graphviz ejecutar:
apt-get install graphviz
7. Editar el archivo:
/etc/php5/apache2/php.ini y /etc/php5/cli/php.ini
#Mínimos [[BR]] magic_quotes_gpc = Off magic_quotes_runtime = Off output_buffering = On #Recomendados memory_limit = 128M post_max_size = 8 M upload_max_filesize = 8 M
8. Crear la carpeta del proyecto.
sudo mkdir /usr/local/proyectos/guarani
Hacer un SVN checkout sobre la misma desde el repositorio de Guaraní 3 con el usuario y password enviado por mail.
sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/SIU/gestion/trunk/3.X.X /usr/local/proyectos/guarani
Donde 3.X.X es la versión liberada y SIU el nombre de la Institución que está instalando.
9. Instalar postgresql
sudo apt-get install postgresql-contrib-9.1
10. Ejecutar y seguir las instrucciones:
sudo /usr/local/proyectos/guarani/lib/toba/bin/instalar
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <ID personal enviado por mail>
PostgreSQL - Ubicación (ENTER utilizará localhost): localhost (ejemplo)
PostgreSQL - Puerto (ENTER utilizará: 5432): 5432 (ejemplo)
PostgreSQL - Usuario (ENTER utilizará postgres): postgres (ejemplo)
PostgreSQL - Clave (ENTER para usar sin clave): xxxxxxxxxx
PostgreSQL - Base de datos (ENTER utilizará toba_2_4): toba_2_4
Toba - Clave (usuario "toba"): toba (ejemplo)
10. Tener en cuenta el esquema de permisos de UNIX. Apache necesita acceso a las carpetas ‘www’ de Toba y del Proyecto. Si se quieren guardar los logs (opción por defecto) también necesita acceso de escritura a la carpeta ‘instalacion’. Existe un comando que acomoda los permisos luego de la instalación (requiere ejecutarse como usuario privilegiado):
sudo ./bin/toba instalacion cambiar_permisos –u <mi_usuario> -g <Usuario Apache generalmente es www-data>
11. Agregar los parámetros en el archivo de inicialización de la instalación actual de Toba (por defecto /usr/local/proyectos/guarani/lib/toba/instalacion/instalacion.ini):
chequea_sincro_svn = 1 [xslfo] fop=/usr/local/proyectos/guarani/php/3ros/fop/fop (verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación)
12. Cargar el proyecto
Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
guarani cargar -d <path proyecto Guaraní>
Nota: ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder "Si".
13. Instalar la BD de negocios y sus configuraciones
Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
guarani instalar
14. Exportar los datos de la instancia
Dentro de la carpeta 'bin' del proyecto Guaraní (<path proyecto Guaraní>/bin) ejecutar:
guarani instancia_exp_local
15. Regenerar la instancia
Dentro de la carpeta 'bin' de Toba (<path proyecto Guaraní>/lib/toba/bin) ejecutar:
toba instancia regenerar -i desarrollo
Nota: ante la pregunta "Desea conservar datos locales como usuarios y logs? (Si o No)" responder "No".
16. En el caso de que se quieran cargar los datos de prueba se deberá crear nuevamente la base de datos de negocio, agregando el modificador '-j' a la siguiente sentencia:
sudo /usr/local/proyectos/guarani/bin instalar
17. En caso de que se quiera usar el esquema de auditoría, ejecutar el comando:
sudo /usr/local/proyectos/toba/proyectos/guarani/bin/guarani crear_auditoria
18. Descargar el siguiente archivo .ZIP
http://toba.siu.edu.ar/downloads/toba/JasperReports_JavaBridge.zip
Descomprimirlo en el directorio /usr/local/proyectos/guarani/lib/toba/php/3ros.
Luego, para ejecutar el servidor de reportes para la impresión en Guaraní 3 ejecutar el siguiente comando (reemplazando la variable $guarani_dir por el path correspondiente, por defecto /usr/local/proyectos/guarani):
java -jar $guarani_dir/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081
19. Para ejecutar el proyecto navegar hacia
http://localhost/guarani/3.8
El par usuario-clave para el primer acceso es: toba-toba.
Una vez dentro del sistema ingresar a la operación "Matrícula > Personas > Administrar Personas", elegir la persona de apellido "Toba", dirigirse a la solapa "Acceso al Sistema" y modificar la clave.
20. Para editar el proyecto navegar hacia
http://localhost/toba_editor/2.4
El par usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.
21. Si tiene habilitado el sistema de protección Suhosin deberá configurar los siguientes parámetros (Generalmente en /etc/php5/conf.d/suhosin.ini):
1. suhosin.request.max_varname_length = 128 2. suhosin.post.max_name_length = 128
22. Para editar el alias
Editar el archivo toba.conf (<path proyecto Guaraní>\lib\toba\instalacion) y definir:
- El/los alias.
Ejemplo:
#Proyecto: guarani Alias /guarani/3.8 "E:/Guarani38/www" <Directory "E:/Guarani38/www/"> SetEnv TOBA_DIR "E:/Guarani38/lib/toba" SetEnv TOBA_PROYECTO "guarani" SetEnv TOBA_INSTALACION_DIR "E:/Guarani38/lib/toba/instalacion" DirectoryIndex aplicacion.php Options MultiViews AllowOverride None <IfModule !mod_authz_core.c> Order allow,deny Allow from all </IfModule> <IfModule mod_authz_core.c> Require all granted </IfModule> <Files aplicacion.php> SetEnv TOBA_INSTANCIA "desarrollo" </Files> <Files servicios.php> SetEnv TOBA_INSTANCIA "desarrollo" </Files> </Directory>
- La sección Alias /guarani/3.8 "E:/Guarani38/www"
Ejemplo:
#Proyecto: guarani Alias /sistemaguarani "E:/Guarani38/www" <Directory "E:/Guarani38/www/"> SetEnv TOBA_DIR "E:/Guarani38/lib/toba" SetEnv TOBA_PROYECTO "guarani" SetEnv TOBA_INSTALACION_DIR "E:/Guarani38/lib/toba/instalacion" DirectoryIndex aplicacion.php Options MultiViews AllowOverride None <IfModule !mod_authz_core.c> Order allow,deny Allow from all </IfModule> <IfModule mod_authz_core.c> Require all granted </IfModule> <Files aplicacion.php> SetEnv TOBA_INSTANCIA "desarrollo" </Files> <Files servicios.php> SetEnv TOBA_INSTANCIA "desarrollo" </Files> </Directory>
Esquema de personalizaciones
Luego de ejecutar todos los comandos previamente mencionados se acaba de realizar la correcta instalación de la versión 3.8.0.
Si se desean realizar personalizaciones sobre el sistema, se deben correr los dos comandos que se detallan a continuación.
La ejecución de los mismos es opcional si aún no se van a realizar personalizaciones. Se puede postergar hasta el momento en el que se desee realizarlas.
Se debe tener en cuenta que una vez que se inicia el esquema de personalizaciones, luego hay que realizar un mantenimiento del mismo con un par de comandos extras cada vez que se realicen cambios en el sistema. Sin embargo estos comandos se deben correr para comenzar con el proceso de personalizaciones de cualquier tipo en Guaraní 3.
Publicar URL con recursos personalizados
Publicar la URL en apache de los recursos personalizados que se incluirán.
Dentro de la carpeta 'bin' del proyecto en la instalación Toba ejecutar:
guarani publicar_pers
Iniciar el esquema de personalizaciones
Este paso es fundamental y usualmente demora varios minutos. Genera un nuevo esquema en la BD para incorporar los metadatos que se personalizaran en el proyecto.
Dentro de la carpeta 'bin' del proyecto en la instalación Toba ejecutar toba.bat para cargar el entorno (si no fue ejecutado previamente) y a continuación:
guarani esquema_pers iniciar