<volver>

Instalación de la aplicación de gestión académica Guaraní 3

• Instalación en Windows
• Instalación en Linux – Distribuciones Debian o derivados

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

Ejemplo:

• 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_pgsql

3.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".

<volver>