Actualización de Wialon Local

Cómo actualizar Wialon Local de la versión 1704 a la 1804

upgrading_wialon_local

En esta guía se describen los pasos que tiene que cumplir para actualizar Wialon Local de la versión 1704 a la versión 1804.

Para que Wialon Local de las versiones 1704, 1804 y 1904 funcione correctamente, se necesita el paquete Node.js 6.x. El soporte de las versiones antiguas de Node.js será parado al lanzarse Wialon Local 1804.

Los repositorios oficiales de Debian 8 y Debian 9 incluyen paquetes de las versiones más antiguas. En caso de instalación de nuestra distribución, el Node.js de la versión necesaria se instala automáticamente.

Actualice Node.js a la versión 6.x si ha recibido una notificación de que la versión de Node.js utilizada en su servidor es obsoleta. Para hacerlo, siga los pasos a continuación.
Las instrucciones de actualización de Node.js también están disponibles en la página oficial del desarrollador de Node.js.
Instale la versión 1804 de Wialon Local.

Cómo actualizar Wialon Local de la versión 1804 a la 1904

upgrading_wialon_local

Para actualizar Wialon Local de la versión 1804 a la versión 1904, siga los pasos a continuación.

Asegúrese de que el sistema operativo Debian está actualizado a la versión 9 (Stretch).

Mientras actualizar el sistema de Debian 8 a Debian 9, se necesita agregar al archivo /etc/nginx/nginx.conf una línea así: «include /etc/nginx/modules-enabled/*.conf». Un ejemplo del archivo obtenido:

user www-data;
worker_processes  2;
worker_rlimit_nofile 65535;
include /etc/nginx/modules-enabled/*.conf;

error_log  /var/log/nginx/error.log;
pid        /var/run/nginx.pid;

events {
       worker_connections  65535;
}

http {
       include       /etc/nginx/common/*;
       include       /etc/nginx/conf.d/*;
}

Agregue opciones adicionales (se indican más abajo) en los archivos de configuración nginx para el sitio del administrador (/etc/nginx/conf.d/lcm.conf). Introduzca opciones en el elemento location de la sección server del archivo lcm.conf y en la configuración de otros nginx que participan en el reenvío a través de proxy (proxying) de solicitudes. Se requiere para habilitar el trabajo usando sockets web.

proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";

Ejemplo de un archivo de configuración lcm.conf:

server {
    listen        80;
    server_name    10.10.10.10;
    client_max_body_size 10000m;
    proxy_read_timeout 500;
    location /50x.html {
        root /home/wialon/wlocal/nginx/www/nginx-default;
    }    
    location / {
        if ( $args ~* dns-test ) {
            echo 1;
        }
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";       
        proxy_pass         http://localhost:8080;
    }
    access_log /var/log/nginx/lcm.access.log;
}

Instale la utilidad ripgrep. Se requiere para leer rápido la información estadística sobre el estado del servidor.

wget --no-check-certificate http://ftp.br.debian.org/debian/pool/main/r/rust-ripgrep/ripgrep_0.10.0-2_amd64.deb -O /tmp/ripgrep.deb
dpkg -i /tmp/ripgrep.deb

Instale la versión 1904 de Wialon Local.

Cómo actualizar Wialon Local de la versión 1904 a la 2004

upgrading_wialon_local

Para actualizar Wialon Local de la versión 1904 a la versión 2004 se recomienda seguir los pasos descritos a continuación.

Actualice el sistema operativo Debian a la versión 10 (Buster).
Instale las utilidad pigz y curl. Para hacerlo, ingrese en el terminal como usuario principal (root) y ejecute el siguiente comando:
```
apt-get install pigz curl
```

Actualice Node.js a la versión 10.x, ejecutando como el usuario principal (root) los siguientes comandos:

cd /home/wialon/wlocal/
service wlocal stop
./adf_script stop
apt-get install -y curl
curl -sL https://deb.nodesource.com/setup_10.x | bash -
apt-get install -y nodejs
npm -g install forever
npm install
chown -R wialon:wialon /home/wialon/
service wlocal restart

Instale la versión 2004 de Wialon Local.

Compruebe la disponibilidad de sus sitios después de su reinicio.

Las instrucciones de actualización de Node.js también están disponibles en la página oficial del desarrollador de Node.js.

Además, para actualizar de la versión 1904 a la 2004, puede ponerse en contacto con el servicio de mantenimiento técnico.

Cómo actualizar Wialon Local de la versión 2104 a la 2204

upgrading_wialon_local

Para actualizar Wialon Local de la versión 2104 a la versión 2204 se recomienda seguir los pasos descritos a continuación.

Antes de actualizar Debian, debe conservar las versiones antiguas de los paquetes python y libpython. Para ello, ejecute el siguiente comando:

apt-mark hold python python2.7 libpython2.7

Actualice el sistema operativo Debian a la versión 11 (Bullseye).

Actualice Node.js a la versión 12.x, ejecutando como el usuario principal (root) los siguientes comandos:

cd /home/wialon/wlocal/
service wlocal stop
./adf_script stop
apt-get install -y curl
curl -sL https://deb.nodesource.com/setup_12.x | bash -
apt-get install -y nodejs npm
npm -g install forever
npm install
chown -R wialon:wialon /home/wialon/
service wlocal restart

Instale la versión 2204 de Wialon Local.

Compruebe la disponibilidad de sus sitios después de su reinicio.

Las instrucciones de actualización de Node.js también están disponibles en la página oficial del desarrollador de Node.js.

Además, para actualizar de la versión 2104 a la 2204, puede ponerse en contacto con el servicio de mantenimiento técnico.

Cómo actualizar Wialon Local de la versión 2204 a la 2304

Para actualizar Wialon Local de la versión 2204 a la versión 2304, siga los pasos que se describen a continuación.

Preparación

Coordine el cambio de la versión con su gerente personal.

Visto que para el cambio se requiere la conversión de las bases de datos del servidor principal y del servidor de copia de seguridad, asegúrese de que hay suficiente espacio libre en los servidores.

La conversión de la base de datos (directorio storage) puede aumentar su tamaño en hasta 20%.

Instale todas las actualizaciones disponibles en el sistema de administración del servidor principal. Si el sistema de administración está instalado en los servidores de copia de seguridad, instale también las actualizaciones que están disponibles allí.
Desactive la opción Automáticamente en la pestaña Sistema de los sistemas de administración de los servidores principal y de copia de seguridad.

Actualización del sistema operativo de servidores de copia de seguridad

Omita este paso si el sistema operativo Debian 11 (Bullseye) ya está instalado en los servidores de copia de seguridad.

Actualice el sistema operativo de los servidores en los que está instalado el módulo de copia de seguridad a la versión Debian 11 (Bullseye). Para esto, haga lo siguiente:

Detenga el módulo de copia de seguridad iniciado en el servidor de copia de seguridad.
Actualice la versión de Debian.
Realice la actualización del software de los servidores de copia de seguridad (vea a continuación).
Inicie el módulo de copia de seguridad.

Actualización del software de servidores de copia de seguridad

Actualice el software de servidores de copia de seguridad. Se requiere para convertir posteriormente sus bases de datos.

Si en el servidor de copia de seguridad el sistema de administración ya está iniciado en el modo del servidor de copia de seguridad, haga lo siguiente:

Compruebe si la herramienta rsync está instalada en el servidor de copia de seguridad. Si no lo está, instálela ejecutando el comando apt-get install rsync en el terminal del servidor.
En la pestaña Sistema en la sección Servidores de copia de seguridad, active la opción Actualizar automáticamente el servidor de copia de seguridad.
En la pestaña Sistema, haga clic en el icono (Volver a descargar todos los módulos).
Instale la actualización descargada.

Si el sistema de administración no está instalado en el servidor de copia de seguridad, haga lo siguiente:

En el sistema de administración del servidor principal, instale todas las actualizaciones disponibles.
Descargue el archivo comprimido con el módulo de copia de seguridad, haciendo clic en el botón Descargar en la sección Servidores de copia de seguridad.
Detenga el módulo de copia de seguridad.
Guarde la carpeta storage que está dentro del directorio del módulo de copia de seguridad y contiene la base de datos de Wialon Local.
Vuelva a instalar el módulo de copia de seguridad.
Copie la carpeta storage guardada anteriormente al directorio del módulo de copia de seguridad para que no tenga que sincronizar la base de datos de nuevo.
Inicie el módulo de copia de seguridad.

Cambio de distribución de software

Solicite el cambio de su distribución de software de Wialon Local de la versión 2204 a la versión 2304 a través de su gerente personal.
Espere hasta que se reciba la actualización con los módulos de Wialon Local de la versión 2204 en el sistema de administración del servidor principal de Wialon Local una vez realizado el cambio de distribución a la versión 2304.

En este momento, todos los servidores de copia de seguridad deben estar actualizados, iniciados y conectados con el servidor principal de Wialon Local.
Instale esta actualización. En el historial del sistema de administración del servidor principal se debe mostrar el registro Adding ADF_STORAGE_MSG_VERSION = v2 to wialonEnv:

Conversión de bases de datos

Una vez instalada la actualización, se inicia la conversión de las bases de datos del servidor principal y de los servidores de copia de seguridad. Esto puede llevar varias horas dependiendo del tamaño de las bases de datos.

Se puede seguir el proceso de conversión de la base de datos del servidor principal en el historial del sistema de administración. Cada 10 minutos, podrá ver allí el registro Set dbStats: 'X-Y'. Si X es igual a Y, esto significa que el proceso de conversión se ha finalizado:

Asimismo, se puede comprobar el estado de la conversión en el contenido del archivo /home/wialon/wlocal/storage/ms/msgs_stats.txt. Todos los archivos de la base de datos deben tener la versión V5:

Una vez finalizada la conversión, no detenga y no reinicie Wialon Local.

Asegúrese de que las bases de datos en todos los servidores de copia de seguridad se han convertido. Para hacerlo, compruebe el contenido del archivo storage/ms/msgs_stats.txt en los servidores de copia de seguridad. Todos los archivos de la base de datos deben tener la versión V5:

Unos 20 minutos después de la finalización de la conversión de la base de datos, en el sistema de administración del servidor principal aparece la actualización con la versión de Wialon Local 2304.

Instalación de Wialon Local 2304

Una vez finalizada la conversión de las bases de datos, se requiere instalar la actualización con la versión 2304 de Wialon Local. Para ello, haga lo siguiente:

Instale la actualización con la versión 2304 en el sistema de administración del servidor principal de Wialon Local.
Si los sistemas de administración de los servidores de copia de seguridad no están instalados, siga los pasos de la sección Actualización del software de servidores de copia de seguridad. Si ellos están instalados, espere hasta que se reciba la actualización en los sistemas de administración de servidores de copia de seguridad, active en ellos la opción Actualizar automáticamente el servidor de copia de seguridad e instale actualizaciones recibidas.

Además, para actualizar de la versión 2204 a la 2304, puede ponerse en contacto con el servicio de mantenimiento técnico.

Cómo actualizar Wialon Local de la versión 2304 a la 2404

Para actualizar Wialon Local de la versión 2204 a la versión 2304, siga los pasos que se describen a continuación.

En la versión 2404 pasamos a un nuevo sistema para iniciar el sitio de administración (servicio wlocal): se utilizará el componente pm2 en lugar del componente forever. Para actualizar, realice los siguientes pasos en el servidor:

npm -g install pm2
service wlocal stop
sed -i 's/forever/pm2/g' /etc/init.d/wlocal
systemctl daemon-reload
service wlocal start

Antes de actualizar Debian, debe conservar las versiones antiguas de los paquetes python y libpython. Para ello, ejecute el siguiente comando:

apt-mark hold python python2.7 libpython2.7

Detenga Wialon Local.
Actualice el sistema operativo a Debian 12 Bookworm.
Si se produce el error unknown directive "echo" in /etc/nginx/conf.d/lcm.conf:9 tras actualizar el paquete nginx, instale el paquete adicional nginx-extras:
apt-get install nginx-extras
Inicie Wialon Local.
Instale la versión 2404 de Wialon Local.

En la versión 2404, se han actualizado las opciones de diseño básico del sistema de rastreo. Si tiene problemas con el diseño básico personalizado previamente, haga lo siguiente:

En los ajustes del sitio en el campo Diseño personal, seleccione default_classic. Esta variante de diseño corresponde al diseño básico de la versión Wialon Local 2304.
En los mismos ajustes del sitio, desactive la opción Nueva página de inicio de sesión.