Инструкции | Wialon Local

Как настроить авторизацию через учетную запись Google

authorization

В этой инструкции описывается последовательность шагов, которую необходимо выполнить, если вы хотите использовать учетную запись Google для авторизации на сайте мониторинга.

Откройте страницу Google Cloud Platform и войдите в учетную запись Google. По умолчанию открыта вкладка Dashboard.
Нажмите на Create project.
Укажите имя проекта (Project name), название организации (Organization) и место расположения проекта (Location). Если вы используете личную учетную запись, то поле Organization не показывается.
Нажмите на Create.
Откройте вкладку OAuth consent screen.
В списке выберите тип пользователей External.
Нажмите на Create.
Укажите имя приложения (App Name) и адрес электронной почты для связи с пользователями (User support email).
Внизу страницы укажите имя домена сайта мониторинга и адрес электронной почты для связи с Google.
Нажмите на Save and continue.
При необходимости настройте области действия (Scopes) и нажмите на Save and continue.
При необходимости добавьте тестовых пользователей, у которых должен быть смогут иметь доступ к проекту до его публикации.
Нажмите на Save and continue.
Откройте вкладку Credentials.
Нажмите на Create credentials, чтобы указать авторизационные данные.
Выберите Oauth client ID.
Выберите тип приложения и укажите его имя.
В полях Authorized JavaScript origins и Authorized redirect URIs введите URI сайта мониторинга (должен быть https).
Нажмите на Create.
Скопируйте ID клиента из поля Your Client ID.
В системе администрирования на вкладке Wialon найдите сайт мониторинга (тип Wialon Web), для доступа в который вы хотите использовать авторизацию через Google, и нажмите на кнопку Изменить напротив его имени. На вкладке Расширенные настроек сайта включите опцию Авторизация через Google.

Для выбранного сайта мониторинга должен использоваться протокол https.
В поле ID клиента для веб-приложения вставьте скопированный ID клиента.
Нажмите на Сохранить.
Авторизуйтесь на сайте мониторинга от имени пользователя, для которого необходимо настроить авторизацию через Google. В настройках пользователя на вкладке Безопасность нажмите на кнопку Привязать к Google.
Выберите учетную запись Google, которую вы хотите использовать для авторизации, и нажмите ОК.

В результате на странице входа в систему мониторинга показывается надпись Войти через Google, которая позволяет авторизоваться в системе с помощью привязанной учетной записи Google.

Как обновить Wialon Local с версии 1704 до 1804

upgrading_wialon_local

В этой инструкции описывается последовательность действий для обновления Wialon Local с версии 1704 до версии 1804.

Для корректного функционирования Wialon Local версий 1704, 1804 и 1904 необходим пакет Node.js 6.x . Поддержка старых версий Node.js, начиная с релиза 1804, прекращена.

Официальные репозитории Debian 8 и Debian 9 включают в себя пакеты более ранних версий. При установке из нашего дистрибутива Node.js необходимой версии устанавливается автоматически.

Обновите Node.js до версии 6.x, если вы получили уведомление о том, что версия Node.js, используемая на вашем сервере, устарела. Для этого выполните следующие действия:
- Войдите в терминал от имени главного пользователя (root) и выполните команды, указанные ниже.
  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 также доступна на официальном сайте разработчика Node.js.
Установите версию Wialon Local 1804.

Как обновить Wialon Local с версии 1804 до 1904

upgrading_wialon_local

Чтобы обновить Wialon Local с версии 1804 до версии 1904, необходимо выполнить описанные ниже шаги.

Убедитесь, что операционная система Debian обновлена до версии 9 (Stretch).
- При обновлении с Debian 8 на Debian 9 необходимо в файл /etc/nginx/nginx.conf добавить строку вида «include /etc/nginx/modules-enabled/*.conf». Пример полученного файла:
```
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/*;
}
```
Добавьте дополнительные опции (указаны ниже) в конфигурационные файлы nginx для сайта администратора (/etc/nginx/conf.d/lcm.conf). Опции нужно внести в секцию location раздела server файла lcm.conf и в конфигурации других nginx, участвующих в проксировании запросов. Это необходимо для активации работы по веб-сокетам.
```
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "Upgrade";
```
Пример конфигурационного файла 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;
}
```
Установите утилиту ripgrep. Она необходима для быстрого считывания статистической информации о состоянии сервера.
```
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
```
Установите версию Wialon Local 1904.

Как обновить Wialon Local с версии 1904 до 2004

upgrading_wialon_local

Чтобы обновить Wialon Local с версии 1904 до версии 2004, выполните описанные ниже шаги.

Обновите операционную систему Debian до версии 10 (Buster).
Установите утилиту pigz и curl. Для этого войдите в терминал от имени главного пользователя (root) и выполните следующую команду:
```
apt-get install pigz curl
```

Обновите Node.js до версии 10.x, выполнив от имени главного пользователя (root) следующие команды:

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

Установите версию Wialon Local 2004.

Проверьте доступность ваших сайтов после их перезапуска.

Инструкция по обновлению Node.js также доступна на официальном сайте разработчика Node.js.

Для обновления с версии 1904 до версии 2004 вы можете также обратиться в службу технической поддержки.

Как обновить Wialon Local с версии 2104 до 2204

upgrading_wialon_local

Чтобы обновить Wialon Local с версии 2104 до версии 2204, выполните описанные ниже шаги.

Перед обновлением Debian необходимо оставить старые версии пакетов python и libpython. Для этого выполните следующую команду:

apt-mark hold python python2.7 libpython2.7

Обновите операционную систему Debian до версии 11 (Bullseye).

Обновите Node.js до версии 12.x, выполнив от имени главного пользователя (root) следующие команды:

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

Установите версию Wialon Local 2204.

Проверьте доступность ваших сайтов после их перезапуска.

Инструкция по обновлению Node.js также доступна на официальном сайте разработчика Node.js.

Для обновления с версии 2104 до версии 2204 вы можете также обратиться в службу технической поддержки.

Как обновить Wialon Local с версии 2204 до 2304

Чтобы обновить Wialon Local с версии 2204 до версии 2304, последовательно выполните описанные ниже шаги.

Подготовка

Согласуйте переход с версии 2204 до 2304 с вашим персональным менеджером.

Так как для перехода требуется конвертация баз данных основного и резервных серверов, убедитесь, что на серверах достаточно свободного места.

Конвертация базы данных (директория storage) приводит к увеличению ее размера до 20%.

Установите все доступные обновления в системе администрирования основного сервера. Если система администрирования установлена на резервных серверах, то также установите обновления для нее.
Отключите опцию Автоматически на вкладке Система в системах администрирования основного и резервных серверов.

Обновление операционной системы резервных серверов

Если на резервных серверах уже установлена версия операционной системы Debian 11 (Bullseye), пропустите этот шаг.

Обновите операционную систему серверов, на которых установлен модуль резервного копирования, до версии Debian 11 (Bullseye). Для этого сделайте следующее:

Остановите модуль резервного копирования, запущенный на резервном сервере.
Обновите версию Debian.
Выполните обновление программной части резервных серверов (см. далее).
Запустите модуль резервного копирования.

Обновление программной части резервных серверов

Обновите программную часть резервных серверов. Это необходимо для последующей конвертации их баз данных.

Если на резервном сервере запущена система администрирования в режиме резервного сервера, сделайте следующее:

Проверьте, установлена ли на резервном сервере утилита rsync. Если не установлена, установите ее, выполнив в терминале сервера команду apt-get install rsync
На вкладке Система в разделе Резервные серверы включите опцию Автоматически обновлять резервный сервер.
На вкладке Система нажмите на иконку (Повторно скачать все модули).
Установите загруженное обновление.

Если на резервном сервере не установлена система администрирования, сделайте следующее:

В системе администрирования основного сервера установите все доступные обновления.
Скачайте архив с модулем резервного копирования, нажав на кнопку Скачать в разделе Резервные серверы.
Остановите модуль резервного копирования.
Сохраните папку storage, которая находится в директории модуля резервного копирования и содержит базу данных Wialon Local.
Переустановите модуль резервного копирования.
Скопируйте ранее сохраненную папку storage в директорию модуля резервного копирования, чтобы базу данных не нужно было синхронизировать «с нуля».
Запустите модуль резервного копирования.

Переключение дистрибутива

Запросите переключение вашего дистрибутива Wialon Local с версии 2204 на версию 2304 через вашего персонального менеджера.
Дождитесь последующего обновления с модулями Wialon Local версии 2204, которое поступит в систему администрирования основного сервера Wialon Local после переключения дистрибутива на версию 2304.

К этому моменту все резервные серверы должны быть обновлены, запущены и соединены с основном сервером Wialon Local.
Установите это обновление. При этом в журнале в системе администрирования основного сервера будет отображаться запись Adding ADF_STORAGE_MSG_VERSION = v2 to wialonEnv:

Конвертация баз данных

После установки обновления начинается конвертация баз данных основного и резервных серверов. В зависимости от размера базы данных это может занять несколько часов.

Процесс конвертации базы данных основного сервера можно отслеживать по журналу системы администрирования. Там каждые 10 минут будет показываться запись вида Set dbStats: 'X-Y'. Если X будет равен Y, значит, процесс конвертации завершен:

Также готовность конвертации можно проверить по содержанию файла /home/wialon/wlocal/storage/ms/msgs_stats.txt. Все файлы базы данных должны иметь версию V5:

После завершения конвертации не следует останавливать или перезапускать Wialon Local.

Убедитесь, что базы данных на всех резервных серверах также сконвертированы. Для этого проверьте содержимое файла storage/ms/msgs_stats.txt на резервных серверах. Все файлы базы данных должны иметь версию V5:

Примерно через 20 минут после завершения конвертации базы данных, в систему администрирования основного сервера поступит обновление c версией Wialon Local 2304.

Установка Wialon Local 2304

После конвертации баз данных необходимо установить обновление с версией 2304 Wialon Local. Для этого сделайте следующее:

Установите обновление с версией 2304 в системе администрирования основного сервера Wialon Local.
Если системы администрирования резервных серверов не установлены, выполните шаги из раздела Обновление программной части резервных серверов. Если они установлены, дождитесь, пока поступит обновление в системы администрирования резервных серверов, включите в них опцию Автоматически обновлять резервный сервер и установите полученные обновления.

Для обновления с версии 2204 до версии 2304 вы можете также обратиться в службу технической поддержки.

Как обновить Wialon Local с версии 2304 до 2404

Чтобы обновить Wialon Local с версии 2304 до версии 2404, выполните описанные ниже шаги.

В версии 2404 мы переходим на новую систему запуска сайта администратора (сервиса wlocal): вместо компонента forever будет использоваться pm2. Для обновления выполните следующие шаги на сервере:

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

Перед обновлением Debian необходимо оставить старые версии пакетов python и libpython. Для этого выполните следующую команду:

apt-mark hold python python2.7 libpython2.7

Остановите Wialon Local.
Обновите операционную систему до версии Debian 12 Bookworm.
Если после обновления пакета nginx возникла ошибка unknown directive "echo" in /etc/nginx/conf.d/lcm.conf:9, установите дополнительный пакет nginx-extras:
apt-get install nginx-extras
Запустите Wialon Local.
Установите версию Wialon Local 2404.

В версии 2404 обновлены базовые варианты дизайна системы мониторинга. Если у вас возникли проблемы с ранее настроенной персонализацией на основе базового дизайна, то в настройках сайта в поле Персональный дизайн выберите вариант default_classic и отключите опцию Новая страница входа. Вариант дизайна default_classic соответствует базовому дизайну в версии Wialon Local 2304.