This guide describes the sequence of steps you should follow if you want to use your Google account to log in to the monitoring site.
On the Wialon tab of the administration system, find the monitoring site (Wialon Web type) which you want to access using Google authorization and click Change next to its name. On the Advanced tab of the site settings, enable the Google authorization option.
The https protocol should be used for the selected monitoring site.
As a result, the Log in with Google caption is displayed on the login page of the monitoring system. It allows logging in to the system using the connected Google account.
This guide describes the sequence of steps you should follow if you want to upgrade Wialon Local from version 1704 to version 1804.
In order for Wialon local version 1704 and above to function correctly, the Node.js 6.x package is required. Support for older versions of Node.js, starting with the release of 1804, is discontinued.
The official Debian 8 and Debian 9 repositories include earlier versions of packages. When installing from our distribution package, the required Node.js version is installed automatically.
Log in to the terminal on behalf of the main user (root) and run the following commands:
cd /home/wialon/wlocal/ service wlocal stop ./adf_script stop apt-get install -y curl curl -sL https://deb.nodesource.com/setup_6.x | bash - apt-get install -y nodejs npm -g install forever npm install chown -R wialon:wialon /home/wialon/ service wlocal restart
Node.js upgrade instructions are also available on the official site of the Node.js developer.
To upgrade Wialon Local from version 1904 to version 2004, follow the steps below.
Install the pigz and curl utilities. To do this, log in to the terminal on behalf of the main user (root) and run the following command:
apt-get install pigz curl
Upgrade Node.js to the version 10.x, by running on behalf of the main user (root) the following commands:
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
Node.js upgrade instructions are also available on the official site of the Node.js developer.
You can also contact technical support to upgrade from version 1904 to version 2004.
To upgrade Wialon Local from version 2104 to version 2204, follow the steps below.
Upgrade Node.js to the version 12.x, by running on behalf of the main user (root) the following commands:
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
Check the availability of your sites after they restart.
Node.js upgrade instructions are also available on the official site of the Node.js developer.
You can also contact technical support to upgrade from version 2104 to version 2204.
To upgrade Wialon Local from version 2204 to version 2304, follow the instruction below step by step.
As the upgrade requires a database conversion for the primary and backup servers, ensure that the servers have sufficient free space.
The conversion of the database (the storage directory) leads to an increase in its size up to 20%.
Install all available updates in the primary server administration system. If the administration system is installed on backup servers, install updates for it as well.
If the backup servers are already running Debian 11 (Bullseye), skip this step.
Upgrade the operating system to Debian 11 (Bullseye) for the servers with the backup module installed. To do this, follow the steps below.
Update the software part of the backup servers. This is necessary for the subsequent conversion of their databases.
If the backup server is running the administration system in the backup server mode, do the following:
If the backup server doesn't have the administration system installed, do the following:
Wait for the next update with Wialon Local modules version 2204, which will be delivered to the administration system of the primary Wialon Local server after switching the distribution to version 2304.
By this time, all backup servers should be updated, launched and connected to the primary Wialon Local server.
After installing the update, the database conversion of the primary and backup servers begins. Depending on the size of the database, this may take several hours.
You can monitor the process of converting the primary server database in the log of the administration system. There will be a record like Set dbStats: 'X-Y' every 10 minutes. If X is equal to Y, then the conversion process is complete:
You can also check if the conversion has ended in the /home/wialon/wlocal/storage/ms/msgs_stats.txt file. All database files must be V5:
Don't stop or restart Wialon Local after the conversion is completed.
Make sure the databases on all backup servers are also converted. To do this, check the contents of the storage/ms/msgs_stats.txt file on the backup servers. All database files must be V5:
Approximately 20 minutes after the database conversion is completed, the administration system of the primary server will receive an update with Wialon Local version 2304.
After the database conversion, you should install the update with Wialon Local version 2304. To do this, follow the steps below.
You can also contact technical support to upgrade from version 2204 to version 2304.
To upgrade Wialon Local from version 2304 to 2404, follow the steps below.
In version 2404, we are switching to a new system of launching the admin site (wlocal service): the pm2 component will be used instead of forever. To upgrade, perform the following actions on the server:
npm -g install pm2 service wlocal stop sed -i 's/forever/pm2/g' /etc/init.d/wlocal systemctl daemon-reload service wlocal start
Before upgrading Debian, you should retain the old versions of the python and libpython packages. For this purpose, run the following command:
apt-mark hold python libpython2.7
Upgrade the operating system to Debian 12 Bookworm.
If the error unknown directive "echo" in /etc/nginx/conf.d/lcm.conf:9 occurs after upgrading the nginx package, install an additional nginx-extras package:
apt-get install nginx-extras
In version 2404, we have updated the basic skins in the monitoring system. If you have problems with the personalization configured previously for a basic skin, go to the site settings, select default_classic in the Skin field and disable the New login page option. The default_classic skin corresponds to the basic skin in Wialon Local 2304.