3. Actualización

Es importante:

El proceso de actualización consta de dos partes: primero actualizar las fuentes y después ejecutar la herramienta de actualización actualiza.php.

3.1. Actualización de fuentes

Para actualizar fuentes de un SIVeL genérico o con personalizaciones simples (módulos, tablas básicas, interfaz y reinterpretaciones, ver Capítulo 6, Personalización) la actualización puede hacerla un administrador de red siguiendo las instrucciones de esta sección.

Para actualizar fuentes con personalizaciones profundas (más que uso de módulos existentes, refinamiento de tablas básicas y de variables de configuración) es necesario que un desarrollador (con conocimientos de PHP, SQL y seguridad informática) mezcle actualizaciones del SIVeL genérico a las fuentes personalizadas.

3.1.1. Actualización de versiones menores (e.g 1.1b1 a 1.1b2)

Descargue fuentes de la versión 1.1 más recientes con uno de los siguientes métodos:

  1. Descargue las fuentes más recientes desde http://sivel.sourceforge.net/1.1/, ubiquelas en el servidor y descomprímalas. Si las descarga con Firefox desde el servidor posiblemente quedaran en el directorio Desktop de su cuenta personal por lo que puede descomprimir y remplazar fuentes anteriores. Usando OpenBSD adJ sería con:

    cd ~/Desktop
    tar xvfz sivel-1.1.7.tar.gz
    sudo chown $USER:$USER /var/www/htdocs/sivel/
    cp -rf sivel-1.1.7/* /var/www/htdocs/sivel/
    

  2. Si desea emplear las fuentes de desarrollo descárguelas y cópielas con

    cd ~
    mkdir tmp2
    cd tmp2
    cvs -d:pserver:anonymous@sivel.cvs.sourceforge.net:/cvsroot/sivel login
    cvs -z3 -d:pserver:anonymous@sivel.cvs.sourceforge.net:/cvsroot/sivel co -rSIVEL1_1 -P sivel
    sudo chown $USER:$USER /var/www/htdocs/sivel
    cp -rf sivel/* /var/www/htdocs/sivel
    

    Cuando le solicite clave presione ENTER.

  3. Si ya tiene unas fuentes que tengan control de versiones (con el directorio CVS), actualicelas asi:

    cd /var/www/htdocs/sivel
    cvs -d:pserver:anonymous@sivel.cvs.sourceforge.net:/cvsroot/sivel login
    cvs -z3 -d:pserver:anonymous@sivel.cvs.sourceforge.net:/cvsroot/sivel update -rSIVEL1_1 -Pd
    

Después debe asegurarse de tener configurado Apache para acceder a SIVeL en su nueva ubicación /var/www/htdocs/sivel/. Para esto edite el archivo de configuración con:

sudo xfw /var/www/conf/httpd.conf

Busque una línea con:

DocumentRoot "/var/www/users/sivel"

y si la encuentra remplázela por:

DocumentRoot "/var/www/htdocs/sivel"

Complete reiniciando Apache con

sudo apachectl stop; sleep 1
sudo sh /etc/rc.local

3.1.2. Actualización de la versión 1.0 a la versión 1.1

Esta actualización es bastante compleja, se recomienda dejar su versión 1.0 utilizable con propósitos de auditoria y respaldo.

  1. Actualice a la versión más reciente de SIVeL 1.0 (1.0.6 en el momento de este escrito), siguiendo las instrucciones de http://sivel.sourceforge.net/1.0/actualizacion-sivel.html

  2. Valide sus datos desde el menú Otros->Validar. Examine el reporte y corrija las inconsistencias en su base, puede ejecutar varias veces el procedimiento de validación hasta asegurarse de tener datos consistentes. Esto es muy importante porque para la conversión a 1.1 sólo esperamos que se conviertan datos correctos en datos correctos.

    [Aviso]Aviso

    Los datos incorrectos o inconsistentes pueden perderse al convertirlos a la versión 1.1.

  3. Respalde y mueva su sistema 1.0 a otro URL. En general debe bastar para el usuario que administra SIVeL ejecutar desde una terminal:

    cd /var/www/htdocs/sivel
    bin/mueve.sh
    

    Que dejará las fuentes en /var/www/htdocs/sivel10 usando la base de datos sivel10 con copia de sus datos y permite ingresar agregando sivel10/ al URL base. Por ejemplo http://127.0.0.1/sivel10/ desde el mismo servidor.

    Si requiere reubicar en otro sitio consulte http://sivel.sourceforge.net/1.0/admin2.html#copias-respaldo

    Este script al terminar la reubicación, le sugerirá revisar el nuevo URL y borrar las fuentes de la versión 1.0 de su ubicación anterior, presionando la tecla 's' y 'RETORNO'. Es recomendable que realice esta acción.

  4. Instale la versión de desarrollo de SIVeL 1.1, siguiendo los mismos pasos descritos en: Sección 3.1.1, “Actualización de versiones menores (e.g 1.1b1 a 1.1b2)”.

  5. Configúrela para que use la base legada de SIVeL 1.0. Si movió su sistema 1.0 como se describió en esta sección y dejo las ubicaciones por defecto, basta que ejecute:

    	cd /var/www/htdocs/sivel/
    	./conf.sh -i
    

    En caso de que no tenga respaldo de su sistema 1.0 en las ubicaciones por defecto, configure manualmente.

    cd /var/www/htdocs/sivel/
    ./nuevo.sh sivel
    

    Si requiere conocer la clave del usuario SIVeL ubiquese en el directorio con fuentes de la versión 1.0 y ejecute:

    sudo grep "dbclave *=" aut/conf.php
    

    Y ponga esa clave en el archivo de la nueva versión, que puede editar con:

    sudo xfw /var/www/htdocs/sivel/sitios/sivel/conf.php
    

    buscando dbclave y remplazando xyz por la clave que anotó. Salve y salga.

  6. Haga utilizable su sitio con todas las formas de conexión que tenga a su base por ejemplo si típicamente desde la red local emplea: https://192.168.44.10 para ingresar a SIVeL ejecute:

    cd /var/www/htdocs/sivel/sitios/
    ln -s sivel 192.168.44.10
    			

    Haga lo mismo con otras ubicaciones, el nombre del enlace que debe crear lo verá al intentar abrir SIVeL.

  7. Convierta sus datos. Para esto basta que ejecute la herramienta de actualización que debería estar disponible desde el mismo servidor en https://127.0.0.1/actualiza.php. Es posible que tenga que iniciar la sesión 2 o 3 veces mientras se actualiza en cada intento la forma de cifrado de las claves[5].

  8. Audite los datos convertidos. Por ejemplo puede verificar que el número de casos coincidan, así como los conteos por víctimas individuales.

    Para hacer una auditoria más intensiva se sugiere que genere un reporte general de todos los casos del sistema 1.0 y un reporte general en el 1.1 y los compare teniendo en cuenta que ha cambiado un poco el formato del reporte general (Si en su base ha registrado acciones bélicas active el módulo respectivo antes de realizar las comparaciones).

    Abra dos pestañas en su navegador en una realice un reporte general con todos los datos de la base anterior y en la otra el mismo reporte en la base nueva. Después:

    cd /var/www/htdocs/sivel/sitios/sivel
    mkdir compara-migra
    cd compara-migra/
    

    Pegue los datos de la base anterior en un archivo que puede iniciar con:

    xfw anterior.txt
    

    Después pegue los del nuevo SIVeL en otro archivo digamos ábralo con:

    xfw nuevo.txt
    

    A continuación compare diferencias entre ambos archivos con:

    diff anterior.txt nuevo.txt | less
    

    Verá sus resultados con el paginador less.

3.2. Herramienta de actualización

La ejecuta abriendo SIVeL con un navegador pero agregando a la dirección actualiza.php (e.g. desde el mismo servidor sería https://127.0.0.1/actualiza.php).

Este mismo procedimiento debe realizarlo si activa módulos.



[5] En caso de que tenga incoveniente reiterativos con claves asegurese que en la base de datos se esté almacenando el condensado SHA256 de la clave y no el antiguo MD5, esto lo puede hacer para el usuario juan ejecutando desde el directorio del sitio:

            ../../bin/clave_sha1.sh juan