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

De SIU
Saltar a: navegación, buscar
 
 
(No se muestran 4 ediciones intermedias de 2 usuarios)
Línea 1: Línea 1:
== Instalación desde cero de SIU-Guaraní Gestión 3.13.x en entorno de Desarrollo o Producción ==
+
<span style="float: right; margin: 0 0 15px 15px;">__TOC__</span>
 +
 
 +
= Instalación desde cero de SIU-Guaraní Gestión 3.13 en entorno de Desarrollo =
  
 
{| border=1 class="simple"
 
{| border=1 class="simple"
Línea 6: Línea 8:
 
'''A lo largo de los pasos se deberá reemplazar:'''
 
'''A lo largo de los pasos se deberá reemplazar:'''
 
* <path proyecto Guaraní>: por el path donde está instalado el proyecto
 
* <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
+
* <siglas institución>: por las siglas correspondientes al nodo de Colab de la institución que realiza la instalación
* En caso de estar instalando la versión en '''entorno de Desarrollo''':
 
 
** 3.13.x: por la versión que se va a instalar
 
** 3.13.x: por la versión que se va a instalar
* En caso de estar instalando la versión en '''entorno de Producción''':
+
 
** 3.13.x.y: por la versión propia que se va a instalar
+
== Pasos para la actualización ==
=== Pasos para la migración ===
 
 
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:  
 
#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 <tt><path proyecto Guaraní></tt>.
 
#:'''Nota''': en lo sucesivo denominaremos esta carpeta como <tt><path proyecto Guaraní></tt>.
 
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
 
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
#* Si se está instalando en '''entorno de Desarrollo''':
 
 
#:<source lang="php" enclose="div">
 
#:<source lang="php" enclose="div">
 
sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.13.x <path proyecto Guaraní>
 
sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.13.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.13.x.y <path proyecto Guaraní>
 
 
</source>
 
</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.
Línea 29: Línea 24:
 
sudo <path proyecto Guaraní>/lib/toba/bin/instalar
 
sudo <path proyecto Guaraní>/lib/toba/bin/instalar
 
</source>
 
</source>
#:y completar
+
#:y completar:
 
#:<source lang="php" enclose="div">
 
#:<source lang="php" enclose="div">
Por favor, ingrese su número de desarrollador (ENTER utilizará 0): ID personal enviado por correo electrónico
+
Nombre del Alias (por defecto "toba"): <alias de los recursos navegables de Toba. Sugerencia: toba_guarani3>
 +
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
PostgreSQL - Ubicación (ENTER utilizará localhost): localhost
+
Nombre de la instalación (ej: Andromeda): <ej: guarani3>
PostgreSQL - Puerto (ENTER utilizará: 5432): 5432 (ejemplo)
+
PostgreSQL - Ubicación (ENTER utilizará localhost): <ip servidor Postgres>
PostgreSQL - Usuario (ENTER utilizará postgres): postgres (ejemplo)
+
PostgreSQL - Puerto (ENTER utilizará: 5432): <puerto servidor Postgres>
PostgreSQL - Clave  (ENTER para usar sin clave): xxxxxxxxxx
+
PostgreSQL - Usuario (ENTER utilizará postgres): <usuario servidor Postgres>
PostgreSQL - Base de datos (ENTER utilizará toba_2_6): toba_2_6
+
PostgreSQL - Clave  (ENTER para usar sin clave): <clave servidor Postgres>
Toba - Clave (usuario "toba"): toba (ejemplo)
+
PostgreSQL - Base de datos (ENTER utilizará toba_2_7): <nombre de la base, sugerencia: guarani3>
 +
Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)>
 +
Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción>
 +
</source>
 +
#A partir de la versión 3.13.0, es necesario registrar manualmente la fuente de datos del proyecto '''toba_usuarios''', usado para el manejo de perfiles y auditoría. Para ello, en el archivo '''<path proyecto Guaraní>/lib/toba/instalacion/bases.ini''', ''si no existe'' una entrada con el encabezado '''[desarrollo toba_usuarios toba_usuarios]''', agregarla, con idéndica configuración a la instancia de Toba (primera entrada de ese archivo). Ejemplo:
 +
#:<source lang="ini" enclose="div">
 +
[desarrollo toba_usuarios toba_usuarios]
 +
motor = "postgres7"
 +
profile = "localhost"
 +
usuario = "postgres"
 +
clave = "**********"
 +
base = "guarani3"
 +
puerto = "5432"
 +
encoding = "LATIN1"
 +
schema = "desarrollo"
 
</source>
 
</source>
 
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario con el que se ejecuta Apache pueda escribir:
 
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario con el que se ejecuta Apache pueda escribir:
Línea 47: Línea 57:
 
#*<path proyecto Guaraní>/lib/toba/instalacion
 
#*<path proyecto Guaraní>/lib/toba/instalacion
 
#*<path proyecto Guaraní>/lib/toba/temp
 
#*<path proyecto Guaraní>/lib/toba/temp
 +
#:Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es ''www-data'', debería ejecutarse:
 +
#:<source lang="php" enclose="div">
 +
chown -R www-data:www-data <path proyecto Guaraní>/www
 +
chown -R www-data:www-data <path proyecto Guaraní>/temp
 +
chown -R www-data:www-data <path proyecto Guaraní>/metadatos_compilados
 +
chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/www
 +
chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/instalacion
 +
chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/temp
 +
</source>
 
#Tal como se indica en la consola al instalar, se debe crear el link simbólico al toba.conf e indicarle Apache que recargue los archivos de configuración
 
#Tal como se indica en la consola al instalar, se debe crear el link simbólico al toba.conf e indicarle Apache que recargue los archivos de configuración
 
#:<source lang="php" enclose="div">
 
#:<source lang="php" enclose="div">
Línea 72: Línea 91:
 
#:<source lang="php" enclose="div">sudo ./guarani crear_auditoria -f guarani</source>
 
#:<source lang="php" enclose="div">sudo ./guarani crear_auditoria -f guarani</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 la URL definida en ''toba.conf'', por defecto:
 
#:<source lang="php" enclose="div">http://localhost/guarani/3.13</source>
 
#:<source lang="php" enclose="div">http://localhost/guarani/3.13</source>
 
#:El usuario-clave para el primer acceso es: toba-toba. Se recomienda luego del primer acceso modificar la clave.
 
#:El usuario-clave para el primer acceso es: toba-toba. Se recomienda luego del primer acceso modificar la clave.
#Para editar el proyecto navegar hacia:
+
#Para editar el proyecto navegar hacia la URL definida en ''toba.conf'', por defecto:
#:<source lang="php" enclose="div">http://localhost/toba_editor/2.6</source>
+
#:<source lang="php" enclose="div">http://localhost/toba_editor/2.7</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.13.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>
 
##:Este comando crea la carpeta <tt><path proyecto Guaraní>/metadatos_compilados</tt>, se le deben dar los permisos arriba detallados.
 
##:Esta carpeta 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.13.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]
 
[[SIU-Guarani/Version3.13.0/instalacion_actualizacion_gestion|Ir al esquema de instalación y actualización de la versión]]

Revisión actual del 17:25 22 mar 2018

Instalación desde cero de SIU-Guaraní Gestión 3.13 en entorno de Desarrollo

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 al nodo de Colab de la institución que realiza la instalación
    • 3.13.x: por la versión que se va a instalar

Pasos para la actualizació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:
    sudo svn checkout https://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/gestion/trunk/3.13.x <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:
    Nombre del Alias (por defecto "toba"): <alias de los recursos navegables de Toba. Sugerencia: toba_guarani3>
    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
    Nombre de la instalación (ej: Andromeda): <ej: guarani3>
    PostgreSQL - Ubicación (ENTER utilizará localhost): <ip servidor Postgres>
    PostgreSQL - Puerto (ENTER utilizará: 5432): <puerto servidor Postgres>
    PostgreSQL - Usuario (ENTER utilizará postgres): <usuario servidor Postgres>
    PostgreSQL - Clave  (ENTER para usar sin clave): <clave servidor Postgres>
    PostgreSQL - Base de datos (ENTER utilizará toba_2_7): <nombre de la base, sugerencia: guarani3>
    Nombre del schema a usar (ENTER utilizará desarrollo): <usar el por defecto (desarrollo)>
    Toba - Clave (usuario "toba"): <clave del superusuario toba. No usar un password débil en producción>
  4. A partir de la versión 3.13.0, es necesario registrar manualmente la fuente de datos del proyecto toba_usuarios, usado para el manejo de perfiles y auditoría. Para ello, en el archivo <path proyecto Guaraní>/lib/toba/instalacion/bases.ini, si no existe una entrada con el encabezado [desarrollo toba_usuarios toba_usuarios], agregarla, con idéndica configuración a la instancia de Toba (primera entrada de ese archivo). Ejemplo:
    [desarrollo toba_usuarios toba_usuarios]
    motor = "postgres7"
    profile = "localhost"
    usuario = "postgres"
    clave = "**********"
    base = "guarani3"
    puerto = "5432"
    encoding = "LATIN1"
    schema = "desarrollo"
  5. Darle permisos a las siguientes carpetas de manera recursiva para que el usuario con el que se ejecuta Apache pueda escribir:
    • <path proyecto Guaraní>/www
    • <path proyecto Guaraní>/temp
    • <path proyecto Guaraní>/metadatos_compilados (esta carpeta se crea al ejecutar ./guarani compilar en la configuración del entorno de Producción)
    • <path proyecto Guaraní>/lib/toba/www
    • <path proyecto Guaraní>/lib/toba/instalacion
    • <path proyecto Guaraní>/lib/toba/temp
    Por ejemplo, en ambientes Debian, donde el usuario y grupo Apache es www-data, debería ejecutarse:
    chown -R www-data:www-data <path proyecto Guaraní>/www
    chown -R www-data:www-data <path proyecto Guaraní>/temp
    chown -R www-data:www-data <path proyecto Guaraní>/metadatos_compilados
    chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/www
    chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/instalacion
    chown -R www-data:www-data <path proyecto Guaraní>/lib/toba/temp
  6. Tal como se indica en la consola al instalar, se debe crear el link simbólico al toba.conf e indicarle Apache que recargue los archivos de configuración
    sudo ln -s <path proyecto Guaraní>/lib/toba/instalacion/toba.conf /etc/apache2/sites-available/gestion.conf
    sudo a2ensite gestion.conf
    sudo service apache2 reload
  7. Agregar los parámetros en el archivo de inicialización de la instalación Toba (<path proyecto Guaraní>/lib/toba/instalacion/instalacion.ini):
    [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.
  8. 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
  9. 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.
  10. 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.
  11. Para activar el esquema de auditoría, dentro de la carpeta 'bin' de Guaraní (<path proyecto Guaraní>/bin) ejecutar:
    sudo ./guarani crear_auditoria -f guarani
  12. 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
  13. Para ejecutar el proyecto navegar hacia la URL definida en toba.conf, por defecto:
    http://localhost/guarani/3.13
    El usuario-clave para el primer acceso es: toba-toba. Se recomienda luego del primer acceso modificar la clave.
  14. Para editar el proyecto navegar hacia la URL definida en toba.conf, por defecto:
    http://localhost/toba_editor/2.7
    El usuario-clave para el primer acceso es: toba-<clave ingresada durante la ejecución del comando instalar>.

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