<< Volver

Instalación de Guaraní 3 desde cero

Descripción de los pasos:

• Requisitos
  • Instalación en Windows
  • Instalación en Linux Distribuciones Debian o derivados
• Esquema de personalizaciones
• Publicar URL con recursos personalizados
• Iniciar el esquema de personalizaciones

Requisitos

- Requisitos de Instalación

- 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_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 

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

<< Volver