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 63 ediciones intermedias de 6 usuarios)
Línea 1: Línea 1:
 
+
== Instalación desde cero de SIU-Guaraní Gestión 3.11.x en entorno de Desarrollo o Producción ==
__TOC__
 
== Instalación del Sistema de Gestión Académica SIU-Guaraní 3 ==
 
  
 
{| 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:'''
=== Instalación en Linux – Distribuciones Debian o derivados ===
+
* <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
#Crear la carpeta del proyecto, por ejemplo:
+
* En caso de estar instalando la versión en '''entorno de Desarrollo''':
#:<code>sudo mkdir /usr/local/proyectos/guarani</code>
+
** 3.11.x: por la versión que se va a instalar
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como <path proyecto Guaraní>.
+
* En caso de estar instalando la versión en '''entorno de Producción''':
#Hacer un SVN checkout desde el repositorio colab en la carpeta creada:
+
** 3.11.x.y: por la versión propia que se va a instalar
#:<pre>sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.10.x /usr/local/proyecto/guarani</pre>
+
=== Pasos para la migración ===
#:'''Nota''': reemplazar <siglas institución> por las siglas correspondientes a la institución que realiza la instalación.<br>
+
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:  
 +
#:<source lang="php" enclose="div">sudo mkdir /usr/local/proyectos/guarani</source>
 +
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como <tt><path proyecto Guaraní></tt>.
 +
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
 +
#* Si se está instalando en '''entorno de Desarrollo''':
 +
#:<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:
#:<pre>sudo <path proyecto Guaraní>/lib/toba/bin/instalar</pre>
+
#:<source lang="php" enclose="div">
#:Por favor, ingrese su número de desarrollador (ENTER utilizará 0): <span style="color: red;">ID personal enviado por correo electrónico</span>
+
sudo <path proyecto Guaraní>/lib/toba/bin/instalar
#:Se trata de una instalacion de producción? (Si o No) (s/n): <span style="color: red;">n</span>
+
</source>
#:PostgreSQL - Ubicación (ENTER utilizará localhost): <span style="color: red;">localhost</span>
+
#:y completar
#:PostgreSQL - Puerto (ENTER utilizará: 5432): <span style="color: red;">5432 (ejemplo)</span>
+
#:<source lang="php" enclose="div">
#:PostgreSQL - Usuario (ENTER utilizará postgres): <span style="color: red;">postgres (ejemplo)</span>
+
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): ID personal enviado por correo electrónico
#:PostgreSQL - Clave  (ENTER para usar sin clave): <span style="color: red;">xxxxxxxxxx</span>
+
Se trata de una instalacion de producción? (Si o No) (s/n): n
#:PostgreSQL - Base de datos (ENTER utilizará toba_2_6): <span style="color: red;">toba_2_6</span>
+
PostgreSQL - Ubicación (ENTER utilizará localhost): localhost
#:Toba - Clave (usuario "toba"): <span style="color: red;">toba (ejemplo)</span>
+
PostgreSQL - Puerto (ENTER utilizará: 5432): 5432 (ejemplo)
#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'.
+
PostgreSQL - Usuario (ENTER utilizará postgres): postgres (ejemplo)
#:Existe un comando que acomoda los permisos luego de la instalación (requiere ejecutarse como usuario privilegiado):
+
PostgreSQL - Clave  (ENTER para usar sin clave): xxxxxxxxxx
#:<pre>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)></pre>
+
PostgreSQL - Base de datos (ENTER utilizará toba_2_6): toba_2_6
#: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)
+
Toba - Clave (usuario "toba"): toba (ejemplo)
#Agregar los parámetros en el archivo de inicialización de la instalación Toba (<path proyecto Guaraní>/lib/toba/instalacion/instalacion.ini):
+
</source>
#:<code>chequea_sincro_svn = 1<br>[xslfo]<br>fop=<path proyecto Guaraní>/php/3ros/fop/fop</code>
+
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario Apache pueda escribir:
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación. <br>
+
#*<path proyecto Guaraní>/www
#Para cargar el proyecto, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
+
#*<path proyecto Guaraní>/temp
#:<pre>sudo ./guarani cargar -d <path proyecto Guaraní></pre>
+
#*<path proyecto Guaraní>/metadatos_compilados
#:'''Nota:''' ante la pregunta "¿Desea agregar el alias de apache al archivo toba.conf? (Si o No)" responder "Si".  
+
#*<path proyecto Guaraní>/lib/toba/www
#Para crear la base de datos de negocio, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
+
#*<path proyecto Guaraní>/lib/toba/instalacion
#:<pre>sudo ./guarani instalar</pre>
+
#*<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
 +
[xslfo]
 +
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.
 +
#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>
 +
#:'''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í (<tt><path proyecto Guaraní>/bin</tt>) ejecutar:
 +
#:<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:
#:<pre>sudo ./guarani crear_auditoria </pre>
+
#:<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:
#:<pre>java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</pre>
+
#:<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:
#:<pre>http://localhost/guarani/3.10</pre>
+
#:<source lang="php" enclose="div">http://localhost/guarani/3.11</source>
 
#: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.
 
#: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:
 
#Para editar el proyecto navegar hacia:
#:<pre>http://localhost/toba_editor/2.6</pre>
+
#:<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