NotasTecnicas/ActualizG3

Actualización de Guarani3 desde la versión 3.1


Descripción de la operación:


Requisitos

Que el sistema se encuentre en la versión 3.1.0 (Revisión SVN mayor a 12131). Chequear esto en el menú:

Ayuda -> Acerca de.

Ver requisitos para la instalación:

 http://repositorio.siu.edu.ar/trac/Portal-G3/wiki/NotasTecnicas/requisitosInst


Migración a la versión 3.4.1.

Para realizar la migración a la nueva versión del sistema, antes se deben realizar unos ajustes en la BD de negocios. A partir de la versión 3.2, el sistema utiliza una librería de funciones de encriptación en PostgreSQL y además se debe migrar de esquema para que el mismo no corra sobre public. A continuación se detallan los pasos para realizar estos ajustes, finalizando con el comando para actualizar el sistema a la versión 3.4.1.

Actualizar la copia local de SIU-Toba

Usando la línea de comando, posicionados en la carpeta de la instalación Toba (por defecto C:\Toba):

svn update

Usando el cliente gráfico TortoiseSVN:

source:/trunk/img/Actualización31-2.png


Exportar el proyecto SIU-Guaraní 3

Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:

toba proyecto exportar –p guarani –i <id_instancia>

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".


Actualizar la versión de SIU-Guaraní 3

Hacer un SVN SWITCH sobre el proyecto SIU-Guaraní a la nueva versión del sistema.

Usando la línea de comando, posicionados en la carpeta del proyecto Guaraní (por defecto C:\Toba\proyectos\guarani):

svn sw  http://repositorio.siu.edu.ar/svn/guarani/versiones/3.4.1


Regenerar el proyecto SIU-Guaraní 3

Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:

toba proyecto regenerar –p guarani -i <id_instancia>

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".


Resguardo de la BD de negocios

Antes de comenzar se debe resguardar la BD de negocios para restaurarla ante cualquier error que surja en el procedimiento de actualización de la versión. Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar:

toba proyecto resguardar_base –i <id_instancia> -p guarani

Nota: si al ejecutar el comando se muestra el mensaje 'pg_dump' no se reconoce como un comando interno o externo, programa o archivo por lotes ejecutable, probablemente no se encuentre el directorio ‘bin’ de PostgreSQL en el path del sistema operativo. Agregue la carpeta al path y vuelva a intentarlo.


Cambiar los esquemas de la BD de negocios y Auditoría

Como se mencionó al comienzo de la sección, a partir de la versión 3.2 del sistema se necesita cambiar de esquema la BD de negocios para que la misma no corra sobre el esquema “public”. Si la BD está situada en un esquema distinto a “public” saltear este paso. Si no, ejecutar lo siguiente:

toba proyecto cambiar_esquema –i <id_instancia> -p guarani


Aplicar funciones de encriptación (pgcrypto) a PostgreSQL

Para realizar esto se debe ejecutar el siguiente comando:

toba proyecto aplicar_pgcrypto –i <id_instancia> -p guarani


Actualizar la base de datos de negocio a la nueva versión

Actualizar la base de negocio con los cambios introducidos entre versiones.

Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) ejecutar toba.bat para cargar el entorno y a continuación:

toba proyecto migrar_base -p guarani –i <id_instancia>

El identificador de la instancia (<id_instancia>) usualmente es "desarrollo".

Nota: si al ejecutar el comando de actualización se muestra el mensaje No pudo resguardarse la base actual. Desea continuar? (Si o No) , probablemente no se encuentre el directorio ‘bin’ de PostgreSQL en el path del sistema operativo. Responda "No", agregue la carpeta al path y vuelva a intentarlo.


Actualizar el encriptado de las Claves

Se actualizan las claves de usuarios con un encriptado más fuerte

Dentro de la carpeta 'bin' de la instalación Toba (por defecto C:\Toba\bin) Ejecutar:

toba proyecto migrar_claves -p guarani –i <id_instancia>