Diferencia entre revisiones de «SIU-Guarani/version3.11.0/instalacion desde cero/instalacion/gestion/linux»

De SIU
Saltar a: navegación, buscar
 
(No se muestran 26 ediciones intermedias de 4 usuarios)
Línea 1: Línea 1:
−
== Instalación del Sistema de Gestión Académica SIU-Guaraní 3 en Linux - Distribución Debian o derivados ==
+
== Instalación desde cero de SIU-Guaraní Gestión 3.11.x en entorno de Desarrollo o Producción ==
  
 
{| border=1 class="simple"
 
{| border=1 class="simple"
−
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio colab para la institución.
+
! Solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.
 
|}
 
|}
−
 
+
'''A lo largo de los pasos se deberá reemplazar:'''
−
#Crear la carpeta del proyecto, por ejemplo:
+
* <path proyecto Guaraní>: por el path donde está instalado el proyecto
 +
* <siglas institución>: por las siglas correspondientes a la institución que realiza la instalación
 +
* En caso de estar instalando la versión en '''entorno de Desarrollo''':
 +
** 3.11.x: por la versión que se va a instalar
 +
* En caso de estar instalando la versión en '''entorno de Producción''':
 +
** 3.11.x.y: por la versión propia que se va a instalar
 +
=== Pasos para la migración ===
 +
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:  
 
#:<source lang="php" enclose="div">sudo mkdir /usr/local/proyectos/guarani</source>
 
#:<source lang="php" enclose="div">sudo mkdir /usr/local/proyectos/guarani</source>
−
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como <path proyecto Guaraní>.
+
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como <tt><path proyecto Guaraní></tt>.
−
#Hacer un SVN checkout desde el repositorio colab en la carpeta creada:
+
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
−
#:<source lang="php" enclose="div">sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.11.x /usr/local/proyecto/guarani</source>
+
#* Si se está instalando en '''entorno de Desarrollo''':
−
#:'''Nota''': reemplazar <siglas institución> por las siglas correspondientes a la institución que realiza la instalación.
+
#:<source lang="php" enclose="div">
 +
sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.11.x <path proyecto Guaraní>
 +
</source>
 +
#* Si se está instalando en '''entorno de Producción''':
 +
#:<source lang="php" enclose="div">
 +
sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.11.x.y <path proyecto Guaraní>
 +
</source>
 
#:'''Nota''': el usuario y clave a utilizar son los recibidos por correo electrónico.
 
#:'''Nota''': el usuario y clave a utilizar son los recibidos por correo electrónico.
−
#Ejecutar y seguir las instrucciones:
+
#Instalar el proyecto, para ello, ejecutar:
−
#:<source lang="php" enclose="div">sudo <path proyecto Guaraní>/lib/toba/bin/instalar
+
#:<source lang="php" enclose="div">
 +
sudo <path proyecto Guaraní>/lib/toba/bin/instalar
 +
</source>
 +
#:y completar
 +
#:<source lang="php" enclose="div">
 
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): ID personal enviado por correo electrónico
 
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
 
Se trata de una instalacion de producción? (Si o No) (s/n): n
Línea 23: Línea 40:
 
Toba - Clave (usuario "toba"): toba (ejemplo)
 
Toba - Clave (usuario "toba"): toba (ejemplo)
 
</source>
 
</source>
−
#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'.
+
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario Apache pueda escribir:
−
#:Existe un comando que acomoda los permisos luego de la instalación (requiere ejecutarse como usuario privilegiado):
+
#*<path proyecto Guaraní>/www
−
#:<source lang="php" enclose="div">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)></source>
+
#*<path proyecto Guaraní>/temp
−
#:Además, se deben otorgar permisos de escritura al usuario de Apache sobre la carpeta 'temp' de Toba (<path proyecto Guaraní>/lib/toba/temp)<br>y a la carpeta 'temp' de guarani (<path proyecto Guaraní>/temp)
+
#*<path proyecto Guaraní>/metadatos_compilados
−
#Agregar los parámetros en el archivo de inicialización de la instalación Toba (<path proyecto Guaraní>/lib/toba/instalacion/instalacion.ini):
+
#*<path proyecto Guaraní>/lib/toba/www
 +
#*<path proyecto Guaraní>/lib/toba/instalacion
 +
#*<path proyecto Guaraní>/lib/toba/temp
 +
#Tal como se indica en la consola al instalar, se debe crear el link simbólico al toba.conf
 +
#:<source lang="php" enclose="div">
 +
ln -s <path proyecto Guaraní>/lib/toba/instalacion/toba.conf /etc/apache2/sites-enabled/toba_2_6.conf
 +
</source>
 +
#:y luego reiniciar Apache
 +
#Agregar los parámetros en el archivo de inicialización de la instalación Toba (<tt><path proyecto Guaraní>/lib/toba/instalacion/instalacion.ini</tt>):
 
#:<source lang="php" enclose="div">chequea_sincro_svn = 1
 
#:<source lang="php" enclose="div">chequea_sincro_svn = 1
 
[xslfo]
 
[xslfo]
 
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source>
 
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source>
−
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación. <br>
+
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.
−
#Para cargar el proyecto, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
+
#Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto (<tt><path proyecto Guaraní)</tt>) ejecutar:
 +
#:<source lang="php" enclose="div">
 +
cp menu.ini.tmpl menu.ini
 +
</source>
 +
#:Completar el archivo [[SIU-Guarani/Version3.11.0/personalizaciones/formas_de_menu| menu.ini]]
 +
#Para cargar el proyecto, dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
 
#:<source lang="php" enclose="div">sudo ./guarani cargar -d <path proyecto Guaraní></source>
 
#:<source lang="php" enclose="div">sudo ./guarani cargar -d <path proyecto Guaraní></source>
−
#:'''Nota:''' ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder "Si".  
+
#:'''Nota:''' ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder '''s'''.  
−
#Para crear la base de datos de negocio, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
+
#Para crear la base de datos de negocio, dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
 
#:<source lang="php" enclose="div">sudo ./guarani instalar</source>
 
#:<source lang="php" enclose="div">sudo ./guarani instalar</source>
 
#:'''Nota''': en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador '''-j''' a la sentencia anterior.
 
#:'''Nota''': en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador '''-j''' a la sentencia anterior.
−
#Para activar el esquema de auditoría, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
+
#Para activar el esquema de auditoría, dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
 
#:<source lang="php" enclose="div">sudo ./guarani crear_auditoria </source>
 
#:<source lang="php" enclose="div">sudo ./guarani crear_auditoria </source>
 
#Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:
 
#Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:
−
#:<source lang="php" enclose="div">java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</source>
+
#:<source lang="php" enclose="div">java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET_LOCAL:8081</source>
 
#Para ejecutar el proyecto navegar hacia:
 
#Para ejecutar el proyecto navegar hacia:
 
#:<source lang="php" enclose="div">http://localhost/guarani/3.11</source>
 
#:<source lang="php" enclose="div">http://localhost/guarani/3.11</source>
Línea 47: Línea 77:
 
#Para editar el proyecto navegar hacia:
 
#Para editar el proyecto navegar hacia:
 
#:<source lang="php" enclose="div">http://localhost/toba_editor/2.6</source>
 
#:<source lang="php" enclose="div">http://localhost/toba_editor/2.6</source>
−
#:El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.
+
#:El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.
 +
 
 +
=== Terminar de configurar - sólo si se está instalando en entorno de Producción ===
 +
# Seguir los pasos de: [[SIU-Guarani/version3.11.0/instalacion_desde_cero/configuracion_produccion_gestion|Configuración del servidor de producción]]
 +
#Compilar metadatos
 +
##Dentro de la carpeta 'bin' de Guaraní (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
 +
##:<source lang="php" enclose="div">
 +
./guarani compilar
 +
</source>
 +
##:Al compilar los metadatos se generará la carpeta <tt><path proyecto Guaraní>/metadatos_compilados</tt> que no debe versionarse (svn commit) ya que se regenerará cada vez que se actualice el servidor.
 +
##Editar el archivo 'aplicacion.php' (<tt><path proyecto Guaraní>/www/aplicacion.php</tt>) y descomentar la siguiente línea:
 +
##:<source lang="php" enclose="div">
 +
define('apex_pa_metadatos_compilados', 1);
 +
</source>
 +
<br><br>
 +
[[SIU-Guarani/Version3.11.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]

Revisión actual del 17:24 22 mar 2018

Instalación desde cero de SIU-Guaraní Gestión 3.11.x en entorno de Desarrollo o Producción

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

A lo largo de los pasos se deberá reemplazar:

  • <path proyecto Guaraní>: por el path donde está instalado el proyecto
  • <siglas institución>: por las siglas correspondientes a la institución que realiza la instalación
  • En caso de estar instalando la versión en entorno de Desarrollo:
    • 3.11.x: por la versión que se va a instalar
  • En caso de estar instalando la versión en entorno de Producción:
    • 3.11.x.y: por la versión propia que se va a instalar

Pasos para la migración

  1. Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:
    sudo mkdir /usr/local/proyectos/guarani
    Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto Guaraní>.
  2. Bajar el proyecto del SVN desde la URL correspondiente en Colab:
    • Si se está instalando en entorno de Desarrollo:
    sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.11.x <path proyecto Guaraní>
    • Si se está instalando en entorno de Producción:
    sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.11.x.y <path proyecto Guaraní>
    Nota: el usuario y clave a utilizar son los recibidos por correo electrónico.
  3. Instalar el proyecto, para ello, ejecutar:
    sudo <path proyecto Guaraní>/lib/toba/bin/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
    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. Darle permisos a las siguientes carpetas de manera recursiva para que el usuario Apache pueda escribir:
    • <path proyecto Guaraní>/www
    • <path proyecto Guaraní>/temp
    • <path proyecto Guaraní>/metadatos_compilados
    • <path proyecto Guaraní>/lib/toba/www
    • <path proyecto Guaraní>/lib/toba/instalacion
    • <path proyecto Guaraní>/lib/toba/temp
  5. Tal como se indica en la consola al instalar, se debe crear el link simbólico al toba.conf
    ln -s <path proyecto Guaraní>/lib/toba/instalacion/toba.conf /etc/apache2/sites-enabled/toba_2_6.conf
    y luego reiniciar Apache
  6. 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.
  7. Configurar de qué manera se desea ver el menú de la aplicación. Dentro de la carpeta del proyecto (<path proyecto Guaraní)) ejecutar:
    cp menu.ini.tmpl menu.ini
    Completar el archivo menu.ini
  8. 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 s.
  9. 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.
  10. Para activar el esquema de auditoría, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
    sudo ./guarani crear_auditoria
  11. 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_LOCAL:8081
  12. Para ejecutar el proyecto navegar hacia:
    http://localhost/guarani/3.11
    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.
  13. 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>.

Terminar de configurar - sólo si se está instalando en entorno de Producción

  1. Seguir los pasos de: Configuración del servidor de producción
  2. Compilar metadatos
    1. Dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
      ./guarani compilar
      Al compilar los metadatos se generará la carpeta <path proyecto Guaraní>/metadatos_compilados que no debe versionarse (svn commit) ya que se regenerará cada vez que se actualice el servidor.
    2. Editar el archivo 'aplicacion.php' (<path proyecto Guaraní>/www/aplicacion.php) y descomentar la siguiente línea:
      define('apex_pa_metadatos_compilados', 1);



Ir al esquema de instalación y actualización de la versión

Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Guarani/version3.11.0/instalacion_desde_cero/instalacion/gestion/linux&oldid=40096»