Instalación de la aplicación de gestión académica Guaraní 3
Instalación en Windows
• Crear una carpeta en una unidad de disco local, por ejemplo:
C:\Toba
• Hacer un SVN checkout desde el repositorio de SIU-TOBA 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
http://repositorio.siu.edu.ar/svn/toba/trunk_versiones/2.3
Ejemplo:
• Crear una carpeta dentro de la carpeta proyectos con el nombre deseado, en este caso será ‘guarani’.
• Hacer un SVN checkout sobre la misma desde el repositorio de Guaraní 3 con el usuario y password enviado por mail.
La URL de descarga es:
http://repositorio.siu.edu.ar/svn/guarani/versiones/3.4.1
• Crear una base de datos en PostgreSQL con encoding UTF8. En los sucesivos ejemplos denominaremos a la nueva base guarani_3, colocar el nombre preferido:
CREATE DATABASE guarani_3 WITH ENCODING='UTF8' OWNER=postgres TEMPLATE=template LC_COLLATE='C' LC_CTYPE='C' CONNECTION LIMIT=-1 TABLESPACE=pg_default;
• Agregar el módulo pgcrypto a la base de datos. Conectarse a ‘guarani_3’ y ejecutar:
CREATE EXTENSION pgcrypto;
• En la carpeta ‘bin’ de la instalación Toba (por defecto C:\Toba\bin), ejecutar
instalar.bat
y seguir las instrucciones:
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): guarani_3 (ejemplo)
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 actual de Toba (por defecto C:\Toba\instalacion\instalacion.ini):
chequea_sincro_svn = 1 [xslfo] fop=C:\Toba\proyectos\guarani\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.
• 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 sentencia correspondiente. Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:
toba proyecto instalar -i desarrollo -p guarani –j
• En caso de que se quiera usar el esquema de auditoría, posicionarse en la carpeta ‘bin’ de la instalación Toba y ejecutar:
toba proyecto crear_auditoria -i desarrollo -p guarani
• 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\8.3\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 Toba (por defecto C:\Toba\php\3ros).
Luego, para ejecutar el servidor de reportes para la impresión en Guaraní 3 ejecutar el siguiente comando (reemplazando la variable
$toba_dir
por el path correspondiente, por defecto
C:\Toba)
java -jar $toba_dir/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081
• Para ejecutar el proyecto navegar hacia
http://localhost/guarani/3.0
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.3
El usuario-clave para el primer acceso es: toba - <clave ingresada durante la ejecución del comando instalar.bat>.
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-mbstring 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
[BR]]
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. Bajar el código fuente de SIU-Toba, por ejemplo en el path:
/usr/local/proyectos/toba
La URL de descarga es:
http://repositorio.siu.edu.ar/svn/toba/trunk_versiones/2.3
9. Para descargar el código:
sudo svn checkout http://repositorio.siu.edu.ar/svn/toba/trunk_versiones/2.3 /usr/local/proyectos/toba/
10. Crear la carpeta del proyecto y descargar el código utilizando el usuario y el password enviado por mail:
sudo mkdir /usr/local/proyectos/toba/proyectos/guarani
sudo svn checkout http://repositorio.siu.edu.ar/svn/guarani/branches/3.0.0_uunn /usr/local/proyectos/toba/proyectos/guarani
11. Crear una base de datos en PostgreSQL con encoding UTF8. En los sucesivos ejemplos denominaremos a la nueva base guarani_3, colocar el nombre preferido:
CREATE DATABASE guarani_3 WITH ENCODING='LATIN1' OWNER=postgres TEMPLATE=template LC_COLLATE='C' LC_CTYPE='C' CONNECTION LIMIT=-1 TABLESPACE=pg_default;
12. Agregar el módulo ‘pgcrypto’ a la base de datos. Conectarse a guarani_3 y ejecutar:
CREATE EXTENSION pgcrypto;
13. Ejecutar y seguir las instrucciones:
sudo /usr/local/proyectos/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_3): guarani_3 (ejemplo)
Toba - Clave (usuario "toba"): toba (ejemplo)
14. 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>
15. Agregar los parámetros en el archivo de inicialización de la instalación actual de Toba (por defecto /usr/local/proyectos/toba/instalacion/instalacion.ini):
chequea_sincro_svn = 1 [xslfo] fop=/usr/local/proyectos/toba/proyectos/guarani/php/3ros/fop/fop ( verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación)
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 sentencia correspondiente:
sudo ./bin/toba proyecto instalar –i desarrollo -p guarani -j
17. En caso de que se quiera usar el esquema de auditoría, ejecutar el comando:
sudo ./bin/toba proyecto crear_auditoria –i desarrollo -p guarani
18. Descargar el siguiente archivo .ZIP
http://toba.siu.edu.ar/downloads/toba/JasperReports_JavaBridge.zip
Descomprimirlo en el directorio /usr/local/proyectos/toba/php/3ros.
Luego, para ejecutar el servidor de reportes para la impresión en Guaraní 3 ejecutar el siguiente comando (reemplazando la variable $toba_dir por el path correspondiente, por defecto /usr/local/proyectos/toba):
java -jar $toba_dir/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081
19. Para ejecutar el proyecto navegar hacia
http://localhost/guarani/3.0
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.3
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:
1. suhosin.request.max_varname_length = 128 2. suhosin.post.max_name_length = 128
3 Esquema de personalizaciones
Luego de ejecutar todos los comandos previamente mencionados se acaba de realizar la correcta instalación de la versión 3.5.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.
3.1 Publicar URL con recursos personalizados
Publicar la URL en apache de los recursos personalizados que se incluirán.
Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:
toba proyecto publicar_pers –i <id_instancia> -p guarani
El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".
3.2 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' de la instalación Toba (por defecto C:\Toba\bin) ejecutar toba.bat para cargar el entorno (si no fue ejecutado previamente) y a continuación:
toba personalizacion iniciar -p guarani –i <id_instancia>
El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".