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

De SIU
Saltar a: navegación, buscar
(Página creada con «== Actualización de G3W3 a la versión 3.11.X == __TOC__ ES NECESARIO TENER INSTALADA LA VERSIÓN 3.11.X DE <u>'''GUARANÍ 3 Gestión'''</u> PARA PODER PROCEDER CON ESTA...»)
 
(→‎Instalación de SIU-Guaraní 3w versión 3.11.x en entorno de Desarrollo o Producción)
 
(No se muestran 46 ediciones intermedias de 3 usuarios)
Línea 1: Línea 1:
−
== Actualización de G3W3 a la versión 3.11.X  ==
+
__NOTOC__
−
__TOC__
+
== 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 <u>'''GUARANÍ 3 Gestión'''</u> PARA PODER PROCEDER CON ESTA VERSIÓN DE G3W3.
+
{| border=1 class="simple"
 +
! 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.
 +
|}
  
−
=== 1 Backup de las personalizaciones ===
+
'''A lo largo de los pasos se deberá reemplazar:'''
−
 
+
* <path proyecto 3w>: por el path donde está instalado el proyecto
−
Asegurarse que no queden cambios locales sin commitear en la carpeta src/pers/
+
* <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''':
−
Hacer una copia de todas las personalizaciones dentro de la nueva versión (este paso reemplaza el merge que se hacía anteriormente). <br>
+
** 3.11.x: por la versión que se va a instalar
−
Ejemplo: <br>
+
* 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 ===
−
<pre>
+
#Crear la carpeta del proyecto en la ubicación deseada, por ejemplo:
−
svn copy http://colab.siu.edu.ar/svn/guarani3/nodos/<Branch uunn>/3w/trunk/3.11.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
+
#:<source lang="php" enclose="div">
−
"<Branch uunn> trunk 3.11.X: se Agregan las personalizaciones a la versión 3.11.X"
+
sudo mkdir /usr/local/proyectos/g3w3
−
</pre>
+
</source>  
−
 
+
#:'''Nota:''' en lo sucesivo denominaremos esta carpeta como <tt><path proyecto 3w></tt>.
−
 
+
#Bajar el proyecto del SVN desde la URL correspondiente en Colab:
−
Con esta operación se realiza la copia directamente en el repositorio y se mantiene la historia de las personalizaciones. <br>
+
#* Si se está actualizando en '''entorno de Desarrollo''':
 +
#:<source lang="php" enclose="div">
 +
svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/trunk/3.11.x <path proyecto 3w>
 +
</source>
 +
#* Si se está actualizando en '''entorno de Producción''':
 +
#:<source lang="php" enclose="div">
 +
svn checkout http://colab.siu.edu.ar/svn/guarani3/nodos/<siglas institución>/3w/versiones/3.11.x.y <path proyecto 3w>
 +
</source>
 +
#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/
 +
#Editar los archivos de configuración
 +
#: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">
 +
cp alias_template.conf alias.conf
 +
cp config_template.php config.php
 +
cp login_template.php login.php
 +
</source>
 +
#:Editar los archivos alias.conf y config.php (ver [[SIU-Guarani/Version3.11.0/3w/configuracion|Configuración]])
 +
#Configurar el servidor web
 +
#: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:
 +
#:<source lang="php" enclose="div">
 +
ln -s <path proyecto 3w>/instalacion/alias.conf /etc/apache2/sites-enabled/<nombre del alias>.conf
 +
</source>
 +
#:Reiniciar el servidor web y verificar el acceso al alias configurado, por ejemplo: <nowiki>http://localhost/<nombre del alias> </nowiki>
 +
<!--
 +
#Configurar las operaciones
 +
#: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.
 +
#:Internamente, esta información se guarda en archivos dentro de la carpeta instalación.
 +
#:<source lang="php" enclose="div">
 +
+-- instalacion
 +
    +-- operaciones_inactivas
 +
        +-- des_01.json
 +
        . . .
 +
        +-- <PUNTO_ACCESO>.json
 +
</source>
 +
#: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 [[SIU-Guarani/Version3.11.0/personalizaciones/personalizacion_de_acceso| personalizarse]].
 +
#:<source lang="php" enclose="div">
 +
+-- siu
 +
    +-- conf
 +
        +-- acceso
 +
            +-- acc_<PERFIL>.php
 +
</source>
 +
-->
 +
#Verificar la aplicación
 +
#:Realizar un test de conexión a la base de datos. Dentro de la carpeta 'bin' (<tt><path proyecto 3w>/bin</tt>) ejecutar:
 +
#:<source lang="php" enclose="div">
 +
./guarani test_conexion <bloque de acceso></source>
 +
#: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.
 
<br>
 
<br>
−
 
+
=== Terminar de configurar - sólo si se está instalando el entorno de Producción ===
−
 
+
#Compilar los recursos en el servidor de producción:
−
=== 2 Instalar la versión 3.11.X en ambiente de desarrollo ===
+
#:Dentro de la carpeta 'bin' (<tt><path proyecto 3w>/bin</tt>)
−
 
+
#:<source lang="php" enclose="div">
−
==== 2.1 Crear Carpeta del Proyecto ====
+
./guarani compilar_recursos
−
 
+
</source>
−
Crear una carpeta para el proyecto, por ejemplo:
+
#Activar el modo producción en el archivo de configuración (<tt><path proyecto 3w>/instalacion/config.php</tt>).
−
 
+
#:<source lang="php" enclose="div">
−
<pre>
+
produccion: true
−
  /home/<USUARIO>/proyectos/guarani/g3w3_3110$
+
</source>
−
</pre>  
 
−
 
 
−
==== 2.2 Bajada del proyecto del svn ====
 
−
 
 
−
*<u>'''solicitar al SIU una URL específica'''</u> para la institucion preparada para personalizar. Realizar la solicitud mediante un GDS.<br>
 
−
 
 
−
*Efectuar un svn checkout desde la URL:
 
−
 
 
−
<pre>
 
−
svn co http://colab.siu.edu.ar/svn/guarani3/nodos/<Branch uunn>/3w/trunk/3.11.X /home/<USUARIO>/proyectos/guarani/g3w3_3110
 
−
</pre>  
 
−
 
 
−
*Darle permisos a las siguientes carpetas para que el usuario apache puede escribir
 
−
**instalacion/log
 
−
**instalacion/cache
 
−
**instalacion/temp
 
−
**instalacion/operaciones_inactivas
 
−
**src/siu/www/js/escalas/
 
−
 
 
−
 
 
−
==== 2.3 Editar archivos de configuración ====   
 
−
 
 
−
Armar los archivos de configuración a partir de los templates. Dentro de la carpeta instalación: <br>
 
−
 
 
−
 
 
−
<pre>
 
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/instalacion$ cp alias_template.conf alias.conf
 
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/instalacion$ cp config_template.php config.php
 
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/instalacion$ cp login_template.php login.php
 
−
</pre>
 
−
 
 
−
Editar los archivos alias.conf y config.php [[G3/3w/3.11.0/DocTecnica/Configuracion| Configuración]]
 
−
 
 
−
Una vez configurado hacer un test de conexión: <br>
 
−
 
 
−
<pre>
 
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/bin#  ./guarani test_conexion ua_01 
 
−
 
 
−
Donde ua_01 es el ID del bloque de acceso a testear la conexión
 
−
</pre>
 
 
<br>
 
<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]]
−
Realizar el link simbólico a la instalación: <br>
 
−
 
 
−
<pre>
 
−
ln -s /home/<USUARIO>/proyectos/guarani/g3w3_031100/instalacion/alias.conf /etc/apache2/sites-enabled/g3w3_031100.conf
 
−
</pre>
 
−
 
 
−
 
 
−
Reiniciar el servidor web y verificar el acceso al alias configurado, por ejemplo:  http://localhost/g3w3_031100.
 
−
<br>
 
−
 
 
−
==== Cambios importantes de la versión ====
 
−
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.
 
−
Internamente, esta información se guarda en archivos dentro de la carpeta instalación.
 
−
 
 
−
<pre>
 
−
└── instalacion
 
−
   └── operaciones_inactivas
 
−
       ├── des_01.json
 
−
        . . .
 
−
        └── <PUNTO_ACCESO>.json
 
−
</pre>
 
−
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]].
 
−
 
 
−
<pre>
 
−
└── siu
 
−
   └── conf
 
−
       └── acceso
 
−
           └── acc_<PERFIL>.php
 
−
</pre>
 
−
 
 
−
 
 
−
 
 
−
=== 3 Finalizar la configuración de las personalizaciones: ===
 
−
 
 
−
==== 3.1 Verificar personalizaciones de G3W3 ====
 
−
 
 
−
Una vez instalada la versión 3.11.X probar todas las personalizaciones realizadas para garantizar su funcionamiento.
 
−
 
 
−
==== 3.2 Controlar la instalación en modo Producción ====
 
−
 
 
−
Compilar los recursos:
 
−
 
 
−
<pre>
 
−
/home/<USUARIO>/proyectos/guarani/g3w3_031100/bin$  ./guarani compilar_recursos
 
−
</pre>
 
−
 
 
−
Pasar a true el valor 'produccion' en el archivo config.php. [[G3/3w/3.11.0/DocTecnica/Produccion| Pasar a Producción]]
 
−
 
 
−
==== 3.3 Subir cambios ====
 
−
 
 
−
Realizar un commit:
 
−
 
 
−
<pre>
 
−
svn commit
 
−
</pre>
 
−
 
 
−
  ==== 3.4 Generar la versión estable ====
 
−
 
 
−
Para generar la versión estable ejecutar el siguiente comando: <br>
 
−
 
 
−
Ejemplo:
 
−
<pre>
 
−
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
 
−
</pre>
 
−
 
 
−
 
 
−
 
 
−
<pre>
 
−
#comment
 
−
 
 
−
  ==== 3.5 Modificar svn ====
 
−
Apuntar el servidor de producción a la versión indicada en el punto anterior, con svn switch.<br>
 
−
 
 
−
 
 
−
  ==== 3.6 Compilar recursos ====
 
−
 
 
−
Compilar los recursos en el servidor de producción:
 
−
 
 
−
<pre>
 
−
/home/<USUARIO>/proyectos/guarani/g3w3/bin$  ./guarani compilar_recursos
 
−
</pre>
 
−
 
 
−
Pasar a true el valor 'produccion' en el archivo config.php. [[G3/3w/3.11.0/DocTecnica/Produccion| Pasar a Producción]]
 
−
</pre>
 

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»