NotasTecnicas/Guarani3/Instalacion/DesdeCero/Linux

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 

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. 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/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/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/guarani):

           java -jar $guarani_dir/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