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 34 ediciones intermedias de 5 usuarios)
Línea 1: Línea 1:
== Instalación del Sistema de Gestión Académica en Linux – Distribuciones 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
#:<nowiki><code>sudo mkdir /usr/local/proyectos/guarani</code></nowiki>
+
* <siglas institución>: por las siglas correspondientes a la institución que realiza la instalación
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como <path proyecto Guaraní>.
+
* En caso de estar instalando la versión en '''entorno de Desarrollo''':
#Hacer un SVN checkout desde el repositorio colab en la carpeta creada:
+
** 3.11.x: por la versión que se va a instalar
<code>sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.10.x /usr/local/proyecto/guarani</code>
+
* En caso de estar instalando la versión en '''entorno de Producción''':
#:'''Nota''': reemplazar <siglas institución> por las siglas correspondientes a la institución que realiza la instalación.<br>
+
** 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>
 +
#:'''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 style="overflow: auto"><nowiki>sudo <path proyecto Guaraní>/lib/toba/bin/instalar</nowiki></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></code>
+
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>
<pre style="overflow: auto"><nowiki>chequea_sincro_svn = 1<br>[xslfo]<br>fop=<path proyecto Guaraní>/php/3ros/fop/fop</nowiki></pre>
+
#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
#:<code>sudo ./guarani cargar -d <path proyecto Guaraní></code>
+
#*<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
''Nota''': en caso de que se quieran cargar los datos de prueba se deberá agregar el modificador '''-j''' a la sentencia anterior.
+
#Tal como se indica en la consola al instalar, se debe crear el link simbólico al toba.conf
Para activar el esquema de auditoría, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
+
#:<source lang="php" enclose="div">
<code>sudo ./guarani crear_auditoria </code>
+
ln -s <path proyecto Guaraní>/lib/toba/instalacion/toba.conf /etc/apache2/sites-enabled/toba_2_6.conf
Para ejecutar el servidor de reportes (Jasper Reports) ejecutar el siguiente comando:
+
</source>
<code>java -jar <path proyecto Guaraní>/lib/toba/php/3ros/JavaBridge/WEB-INF/lib/JavaBridge.jar SERVLET:8081</code>
+
#:y luego reiniciar Apache
Para ejecutar el proyecto navegar hacia:
+
#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>):
<code>http://localhost/guarani/3.10</code>
+
#:<source lang="php" enclose="div">chequea_sincro_svn = 1
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.
+
[xslfo]
Para editar el proyecto navegar hacia:
+
fop=<path proyecto Guaraní>/php/3ros/fop/fop</source>
<code>http://localhost/toba_editor/2.6</code>
+
#:'''Nota:''' verificar que la ruta al archivo 'fop' sea la correcta de acuerdo al path de la instalación.
El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.
+
#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>
<pre style="overflow: auto"><nowiki>
+
#: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.
 +
#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>
 +
#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_LOCAL:8081</source>
 +
#Para ejecutar el proyecto navegar hacia:
 +
#:<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.
 +
#Para editar el proyecto navegar hacia:
 +
#:<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>.
  
http://localhost/toba_editor/2.6
+
=== Terminar de configurar - sólo si se está instalando en entorno de Producción ===
otra linea de texto
+
# Seguir los pasos de: [[SIU-Guarani/version3.11.0/instalacion_desde_cero/configuracion_produccion_gestion|Configuración del servidor de producción]]
otra linea con un espacio adelante
+
#Compilar metadatos
  otra linea con dos espacios adelante
+
##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