Инструкции | 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 вы можете также обратиться в службу технической поддержки. В этом случае укажите в письме данные для доступа в консоль сервера — SSH (IP, логин и пароль).
Инструкция также расположена на официальном сайте разработчика 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 вы можете также обратиться в службу технической поддержки. В этом случае укажите в письме данные для доступа в консоль сервера — SSH (IP, логин и пароль).

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

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

upgrading_wialon_local

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

Обновите операционную систему 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 -g install forever
npm install
chown -R wialon:wialon /home/wialon/
service wlocal restart

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

Проверьте доступность ваших сайтов после их перезапуска. Для обновления Node.js вы можете также обратиться в службу технической поддержки. В этом случае укажите в письме данные для доступа в консоль сервера — SSH (IP, логин и пароль).

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