Diferencia entre revisiones de «SIU-Guarani/version3.11.0/actualizacion/3w»

De SIU
Saltar a: navegación, buscar
(→‎Instalación de SIU-Guaraní 3w versión 3.11.x en entorno de Desarrollo o Producción)
 
(No se muestran 39 ediciones intermedias de 3 usuarios)
Línea 1: Línea 1:
−
== Actualización de G3W3 a la versión 3.11.x en entorno de desarrollo ==
+
__NOTOC__
 +
== Instalación de SIU-Guaraní 3w versión 3.11.x en entorno de Desarrollo o Producción ==
 
{| border=1 class="simple"
 
{| border=1 class="simple"
−
! Es necesario tener instalada la versión 3.11.x de Guaraní 3 Gestión para poder proceder con esta versión de G3W3
+
! Es necesario tener instalada la versión 3.11.x de SIU-Guaraní Gestión para poder proceder con esta versión de SIU-Guaraní 3w y solicitar en forma previa, mediante una solicitud en el Gestor de Solicitudes (GdS), una carpeta en el repositorio Colab para la institución.
 
|}
 
|}
  
−
#Backup de las personalizaciones
+
'''A lo largo de los pasos se deberá reemplazar:'''
−
#:Asegurarse que no queden cambios locales sin commitear en la carpeta src/pers/
+
* <path proyecto 3w>: por el path donde está instalado el proyecto
−
#:Hacer una copia de todas las personalizaciones dentro de la nueva versión (este paso reemplaza el merge que se hacía anteriormente). <br>
+
* <siglas institución>: por las siglas correspondientes a la institución que realiza la instalación
−
#:Ejemplo:
+
* 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">
 
#:<source lang="php" enclose="div">
−
svn copy http://colab.siu.edu.ar/svn/guarani3/nodos/<Branch uunn>/3w/trunk/3.10.0/src/pers/<pers_xxx> http://colab.siu.edu.ar/svn/guarani3/nodos/<Branch uunn>/3w/trunk/3.11.x/src/pers/<pers_xxx> -m
+
sudo mkdir /usr/local/proyectos/g3w3
−
"<Branch uunn> trunk 3.11.x: se Agregan las personalizaciones a la versión 3.11.x"
+
</source>  
−
</source>
+
#:'''Nota:''' en lo sucesivo denominaremos esta carpeta como <tt><path proyecto 3w></tt>.
−
#:Con esta operación se realiza la copia directamente en el repositorio y se mantiene la historia de las personalizaciones.
+
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
−
#Instalar la versión 3.11.x en ambiente de desarrollo
+
#* Si se está actualizando en '''entorno de Desarrollo''':
−
##Crear la carpeta del proyecto
+
#:<source lang="php" enclose="div">
−
##:Por ejemplo:
+
svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/trunk/3.11.x <path proyecto 3w>
−
##:<source lang="php" enclose="div">
 
−
  /home/<USUARIO>/proyectos/guarani/g3w3_3110$
 
 
</source>  
 
</source>  
−
##Bajada del proyecto del SVN
+
#* Si se está actualizando en '''entorno de Producción''':
−
###'''Solicitar al SIU una URL específica''' para la institución preparada para personalizar. Realizar la solicitud mediante un GDS.<br>
+
#:<source lang="php" enclose="div">
−
###Efectuar un svn checkout desde la URL:
+
svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/versiones/3.11.x.y <path proyecto 3w>
−
###:<source lang="php" enclose="div">
 
−
svn co http://colab.siu.edu.ar/svn/guarani3/nodos/<Branch uunn>/3w/trunk/3.11.X /home/<USUARIO>/proyectos/guarani/g3w3_3110
 
 
</source>  
 
</source>  
−
###Darle permisos a las siguientes carpetas para que el usuario apache puede escribir
+
#Darle permisos a las siguientes carpetas '''de manera recursiva''' para que el usuario Apache pueda escribir
−
####instalacion/log
+
#*<path proyecto 3w>/instalacion/log
−
####instalacion/cache
+
#*<path proyecto 3w>/instalacion/cache
−
####instalacion/temp
+
#*<path proyecto 3w>/instalacion/temp
−
####instalacion/operaciones_inactivas
+
#*<path proyecto 3w>/instalacion/operaciones_inactivas
−
####src/siu/www/js/escalas/
+
#*<path proyecto 3w>/src/siu/www/js/escalas/
−
##Editar archivos de configuración
+
#Editar los archivos de configuración
−
##:Armar los archivos de configuración a partir de los templates. Dentro de la carpeta instalación: <br>
+
#:Armar los archivos de configuración a partir de los templates. Dentro de la carpeta 'instalación' (<tt><path proyecto 3w>/instalacion</tt>):
−
##:<source lang="php" enclose="div">
+
#:<source lang="php" enclose="div">
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/instalacion$ cp alias_template.conf alias.conf
+
cp alias_template.conf alias.conf
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/instalacion$ cp config_template.php config.php
+
cp config_template.php config.php
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/instalacion$ cp login_template.php login.php
+
cp login_template.php login.php
 
</source>
 
</source>
−
##:Editar los archivos alias.conf y config.php [[G3/3w/3.11.0/DocTecnica/Configuracion| Configuración]]
+
#:Editar los archivos alias.conf y config.php (ver [[SIU-Guarani/Version3.11.0/3w/configuracion|Configuración]])
−
##:Una vez configurado hacer un test de conexión: <br>
+
#Configurar el servidor web
−
##:<source lang="php" enclose="div">
+
#:Incluir el archivo <tt>instalacion/alias.conf</tt> en la configuración del servidor web. Ejecutar el siguiente comando como superusuario para realizar el link simbólico a la instalación:
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/bin#  ./guarani test_conexion ua_01 
+
#:<source lang="php" enclose="div">
−
Donde ua_01 es el ID del bloque de acceso a testear la conexión
+
ln -s <path proyecto 3w>/instalacion/alias.conf /etc/apache2/sites-enabled/<nombre del alias>.conf
 
</source>
 
</source>
−
##:Realizar el link simbólico a la instalación:
+
#:Reiniciar el servidor web y verificar el acceso al alias configurado, por ejemplo: <nowiki>http://localhost/<nombre del alias> </nowiki>
−
##:<source lang="php" enclose="div">
+
<!--
−
ln -s /home/<USUARIO>/proyectos/guarani/g3w3_031100/instalacion/alias.conf /etc/apache2/sites-enabled/g3w3_031100.conf
+
#Configurar las operaciones
−
</source>
+
#:Esta versión incluye la posibilidad de configurar operaciones mediante el perfil administrativo. De esta manera es posible que personal no técnico active o deshabilite operaciones.
−
##:Reiniciar el servidor web y verificar el acceso al alias configurado, por ejemplo: http://localhost/g3w3_031100.
+
#:Internamente, esta información se guarda en archivos dentro de la carpeta instalación.
−
##:'''Cambios importantes de la versión'''
+
#:<source lang="php" enclose="div">
−
##:Esta versión incluye la posibilidad de configurar operaciones, mediante el perfil Administrativo. De esta manera es posible que personal no técnico active o deshabilite operaciones.
+
+-- instalacion
−
##:Internamente, esta información se guarda en archivos dentro de la carpeta instalación.
+
    +-- operaciones_inactivas
−
##:<source lang="php" enclose="div">
+
        +-- des_01.json
−
└── instalacion
 
−
   └── operaciones_inactivas
 
−
       ├── des_01.json
 
 
         . . .
 
         . . .
−
         └── <PUNTO_ACCESO>.json
+
         +-- <PUNTO_ACCESO>.json
 
</source>
 
</source>
−
##:Es importante notar que el usuario de Apache debe tener permisos de escritura sobre esta carpeta.
+
#:Es importante notar que el usuario de Apache debe tener permisos de escritura sobre esta carpeta.
−
##:También debe tenerse en cuenta que los archivos de acceso para cada perfil son modificados en esta versión y deben [[G3/3w/3.11.0/DocTecnica/Personalizaciones/Acceso| personalizarse]].
+
#:También debe tenerse en cuenta que los archivos de acceso para cada perfil son modificados en esta versión y deben [[SIU-Guarani/Version3.11.0/personalizaciones/personalizacion_de_acceso| personalizarse]].
−
##:<source lang="php" enclose="div">
+
#:<source lang="php" enclose="div">
−
└── siu
+
+-- siu
−
   └── conf
+
    +-- conf
−
       └── acceso
+
        +-- acceso
−
           └── acc_<PERFIL>.php
+
            +-- acc_<PERFIL>.php
 
</source>
 
</source>
−
#Finalizar la configuración de las personalizaciones
+
-->
−
##Verificar personalizaciones de G3W3
+
#Verificar la aplicación
−
##:Una vez instalada la versión 3.11.X probar todas las personalizaciones realizadas para garantizar su funcionamiento.  
+
#:Realizar un test de conexión a la base de datos. Dentro de la carpeta 'bin' (<tt><path proyecto 3w>/bin</tt>) ejecutar:
−
##Controlar la instalación en modo Producción
+
#:<source lang="php" enclose="div">
−
##:Compilar los recursos:
+
./guarani test_conexion <bloque de acceso></source>
−
##:<source lang="php" enclose="div">
+
#:Donde <bloque de acceso> es el ID del bloque de acceso a testear la conexión
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/bin$  ./guarani compilar_recursos
+
#:'''Nota''': si al correr el comando '''test_conexion''' o al ingresar a la aplicación muestra el mensaje "La extensión de php 'mcrypt' no está instalada." correr el siguiente comando '''sudo php5enmod mcrypt''' y luego reiniciar apache.
 +
<br>
 +
=== Terminar de configurar - sólo si se está instalando el entorno de Producción ===
 +
#Compilar los recursos en el servidor de producción:
 +
#:Dentro de la carpeta 'bin' (<tt><path proyecto 3w>/bin</tt>)
 +
#:<source lang="php" enclose="div">
 +
./guarani compilar_recursos
 
</source>
 
</source>
−
##:Pasar a true el valor 'produccion' en el archivo config.php. [[SIU-Guarani/Version3.11.0/Actualización de producción/3w| Pasar a Producción]]
+
#Activar el modo producción en el archivo de configuración (<tt><path proyecto 3w>/instalacion/config.php</tt>).
−
##Subir cambios
+
#:<source lang="php" enclose="div">
−
##:Realizar un commit:
+
produccion: true
−
##:<source lang="php" enclose="div">
 
−
svn commit
 
−
</source>
 
−
##Generar la versión estable
 
−
##:Para generar la versión estable ejecutar el siguiente comando:
 
−
##:<source lang="php" enclose="div">
 
−
svn copy http://colab.siu.edu.ar/svn/guarani3/nodos/<Branch uunn>/3w/trunk/3.11.X
 
−
http://colab.siu.edu.ar/svn/guarani3/nodos/<Branch uunn>/3w/versiones/3.11.X.0
 
−
</source>
 
−
##Modificar SVN
 
−
##:Apuntar el servidor de producción a la versión indicada en el punto anterior, con svn switch.<br>
 
−
##Compilar recursos
 
−
##:Compilar los recursos en el servidor de producción:
 
−
##:<source lang="php" enclose="div">
 
−
/home/<USUARIO>/proyectos/guarani/g3w3/bin$  ./guarani compilar_recursos
 
 
</source>
 
</source>
−
##:Pasar a true el valor 'produccion' en el archivo config.php.
+
<br>
 +
Si se estaba haciendo la actualización con personalizaciones, [[SIU-Guarani/version3.11.0/actualizacion_con_personalizaciones/3w|volver]] para terminar de configurar el entorno.<br><br>
 +
[[SIU-Guarani/Version3.11.0/instalacion_actualizacion_3w|Ir al esquema de instalación y actualización de la versión]]

Revisión actual del 15:22 30 sep 2016

Instalación de SIU-Guaraní 3w versión 3.11.x en entorno de Desarrollo o Producción

Es necesario tener instalada la versión 3.11.x de SIU-Guaraní Gestión para poder proceder con esta versión de SIU-Guaraní 3w y 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 3w>: 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/g3w3
    Nota: en lo sucesivo denominaremos esta carpeta como <path proyecto 3w>.
  2. Bajar el proyecto del SVN desde la URL correspondiente en Colab:
    • Si se está actualizando en entorno de Desarrollo:
    svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/trunk/3.11.x <path proyecto 3w>
    • Si se está actualizando en entorno de Producción:
    svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/versiones/3.11.x.y <path proyecto 3w>
  3. Darle permisos a las siguientes carpetas de manera recursiva para que el usuario Apache pueda escribir
    • <path proyecto 3w>/instalacion/log
    • <path proyecto 3w>/instalacion/cache
    • <path proyecto 3w>/instalacion/temp
    • <path proyecto 3w>/instalacion/operaciones_inactivas
    • <path proyecto 3w>/src/siu/www/js/escalas/
  4. Editar los archivos de configuración
    Armar los archivos de configuración a partir de los templates. Dentro de la carpeta 'instalación' (<path proyecto 3w>/instalacion):
    cp alias_template.conf alias.conf
    cp config_template.php config.php
    cp login_template.php login.php
    Editar los archivos alias.conf y config.php (ver Configuración)
  5. Configurar el servidor web
    Incluir el archivo instalacion/alias.conf en la configuración del servidor web. Ejecutar el siguiente comando como superusuario para realizar el link simbólico a la instalación:
    ln -s <path proyecto 3w>/instalacion/alias.conf /etc/apache2/sites-enabled/<nombre del alias>.conf
    Reiniciar el servidor web y verificar el acceso al alias configurado, por ejemplo: http://localhost/<nombre del alias>
  6. Verificar la aplicación
    Realizar un test de conexión a la base de datos. Dentro de la carpeta 'bin' (<path proyecto 3w>/bin) ejecutar:
    ./guarani test_conexion <bloque de acceso>
    Donde <bloque de acceso> es el ID del bloque de acceso a testear la conexión
    Nota: si al correr el comando test_conexion o al ingresar a la aplicación muestra el mensaje "La extensión de php 'mcrypt' no está instalada." correr el siguiente comando sudo php5enmod mcrypt y luego reiniciar apache.


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

  1. Compilar los recursos en el servidor de producción:
    Dentro de la carpeta 'bin' (<path proyecto 3w>/bin)
    ./guarani compilar_recursos
  2. Activar el modo producción en el archivo de configuración (<path proyecto 3w>/instalacion/config.php).
    produccion: true


Si se estaba haciendo la actualización con personalizaciones, volver para terminar de configurar el entorno.

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/actualizacion/3w&oldid=13035»