G3/gestion/3.10.0/DocTecnica/Instalacion

Instalación del Sistema de Gestión Académica SIU-Guaraní 3

Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio colab para la institución.

Instalación en Windows

1. Crear una carpeta en una unidad de disco local, por ejemplo:

 C:\guarani

Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto Guaraní>.

2. Hacer un SVN checkout desde el repositorio colab en la carpeta creada.
Puede utilizar alguno de estos clientes SVN:

 TortoiseSVN [[BR]]
 Cliente línea de comandos (svn checkout)

La URL de descarga es:

 https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.10.x

Nota: reemplazar <siglas institución> por las siglas correspondientes a la institución que realiza la instalación.
Nota: el usuario y clave a utilizar son los recibidos por correo electrónico.

Ejemplo:

source:/trunk/img/InstalaciónG31.png

source:/trunk/img/3.9.0/InstalaciónG3.png

3. En la carpeta 'bin' de 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 correo electrónico
Se trata de una instalacion de producción? (Si o No) (s/n):n
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_6):toba_2_6
Toba - Clave (usuario "toba"):toba (ejemplo)

source:/trunk/img/3.9.0/InstalaciónG3III.png

Al finalizar la instalación no cerrar la ventana sin antes leer las instrucciones de cómo configurar Apache. Una vez configurado reiniciar Apache.

source:/trunk/img/3.9.0/InstalaciónG3IV.png

4. 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.

source:/trunk/img/3.9.0/InstalaciónG3V.png

5. Para cargar el proyecto, dentro de la carpeta 'bin' de 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".

6. Para crear la base de datos de negocio, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 guarani instalar

Nota: en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador -j a la sentencia anterior.

7. 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\).

8. Para activar el esquema de auditoría, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 guarani crear_auditoria 

9. Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:

 java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081

10. Para ejecutar el proyecto navegar hacia:

 http://localhost/guarani/3.10

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.

11. Para editar el proyecto navegar hacia:

 http://localhost/toba_editor/2.6

El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.

Instalación en Linux – Distribuciones Debian o derivados

1. Crear la carpeta del proyecto, por ejemplo:

 sudo mkdir /usr/local/proyectos/guarani 

Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto Guaraní>.

2. Hacer un SVN checkout desde el repositorio colab en la carpeta creada:

 sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.10.x /usr/local/proyectos/guarani 

Nota: reemplazar <siglas institución> por las siglas correspondientes a la institución que realiza la instalación.
Nota: el usuario y clave a utilizar son los recibidos por correo electrónico.

3. Ejecutar y seguir las instrucciones:

 sudo <path proyecto Guaraní>/lib/toba/bin/instalar

Por favor, ingrese su número de desarrollador (ENTER utilizará 0):ID personal enviado por correo electrónico
Se trata de una instalacion de producción? (Si o No) (s/n): n
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_6): toba_2_6
Toba - Clave (usuario "toba"): toba (ejemplo)

4. Tener en cuenta el esquema de permisos de UNIX. Apache necesita acceso a las carpetas 'www' de Guaraní y Toba: '<path proyecto Guaraní>/www' y '<path proyecto Guaraní>/lib/toba/www', respectivamente. Si se quieren guardar los logs (opción por defecto) también necesita acceso de escritura a la carpeta 'instalacion': '<path proyecto Guaraní>/lib/toba/instalacion'. Existe un comando que acomoda los permisos luego de la instalación (requiere ejecutarse como usuario privilegiado):

 sudo ./<path proyecto Guaraní>/lib/toba/bin/toba instalacion cambiar_permisos -u <usuario apache (se asume www-data)> -g <grupo de usuarios (no se asume ninguno)>

Además, se deben otorgar permisos de escritura al usuario de Apache sobre la carpeta 'temp' de Toba (<path proyecto Guaraní>/lib/toba/temp)
y a la carpeta 'temp' de guarani (<path proyecto Guaraní>/temp)

5. 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

Nota: verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.

6. Para cargar el proyecto, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 sudo ./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".

7. Para crear la base de datos de negocio, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 sudo ./guarani instalar

Nota: en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador -j a la sentencia anterior.

8. Para activar el esquema de auditoría, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:

 sudo ./guarani crear_auditoria 

9. Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:

 java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081

10. Para ejecutar el proyecto navegar hacia:

 http://localhost/guarani/3.10

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.

11. Para editar el proyecto navegar hacia:

 http://localhost/toba_editor/2.6

El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.