Skip to main content

Руководство по установке BriefCam

Установка и настройка NGINX

Последнее обновление: 5 минут чтения
Версия2024r2
ЯзыкРусский

В этом разделе описаны шаги, которые необходимо предпринять для использования NGINX.

Примечание

Для работы с SSL и BriefCamBriefCamтребуется использовать балансировщик нагрузки.

Рекомендации

Балансировщик нагрузки рекомендуется устанавливать на отдельную машину.

Если вы работаете в виртуализированной среде, балансировщик нагрузки должен быть на отдельной машине.

Если вы работаете в невиртуализированной среде (физические серверы), балансировщик нагрузки можно установить на тот же компьютер, что и веб-службы (хотя это и не рекомендуется). Однако если вы устанавливаете балансировщик нагрузки на тот же компьютер, что и веб-службы, IIS должен работать на другом порте (не 80, поскольку 80 предназначен для NGINX).

Важно

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

Предварительные условия

  • Убедитесь, что порты 80 и 443 не используются другим приложением.

  • Если IIS установлен, обязательно остановите его или измените порт по умолчанию.

Действия

  1. Чтобы запустить мастер установки BriefCam NGINX, нажмите правой кнопкой мыши BriefCamNGINX_<Version number>.exeфайл и выберите " Запустить от имени администратора" .

    Если вы используете последнее обновление Windows и появляется предупреждение Защитника Windows, нажмите ссылку Дополнительная информация и нажмите " Запустить в любом случае" .

    Windows protected your PC4.png

  2. На экране приветствия нажмите " Начало работы" .

    NGINX_welcome.png

  3. Примите условия лицензионного соглашения BriefCam и нажмите " Далее" .

    NGINX_license_2.png

  4. Ознакомьтесь с лицензионным соглашением и нажмите " Далее" .

    NGINX_license_1.png

  5. Введите IP-адрес или имя хоста (при наличии разрешения DNS) для каждой из соответствующих служб ниже и нажмите " Далее" . Обратите внимание, что после входа на хост Research вы можете нажать кнопку "Нажать, чтобы использовать хост RESEARCH для всех служб", чтобы заполнить все поля этим значением.

    NGINX_services_configuration.png

  6. Решите, следует ли использовать защищенное подключение.

    NGINX_using_HTTPS.png

  7. Если поставлена отметка, введите пути к сертификату и закрытому ключу.

    Примечание

    Вам необходимо создать или использовать существующий самозаверяющий сертификат, разделенный на два файла: CRT и KEY.

  8. Если ваш SSL-сертификат защищен паролем, вам нужно настроить NGINX на чтение списка паролей, которые хранятся в отдельном файле. Если закрытый ключ отсутствует в этом файле, NGINX не будет запущен. Вы делаете это следующим образом:

    1. Создайте новый текстовый файл с именем ssl_passwords.txtи сохраните его в папке, отличной от той, где находится SSL-сертификат.

    2. Установите файл, который будет доступен только пользователю, под управлением NGINX.

    3. Введите пароль сертификата в первую строку ssl_passwords.txtфайла.

    4. В nginx configфайл добавьте следующую строку над существующими строками сертификатов:

      ssl_password_file /var/lib/nginx/ssl_passwords.txt;

    5. Распространите этот файл отдельно от файла конфигурации.

  9. Нажмите Далее.

    Появится следующий экран.

    NGINX_Database_fields.png

  10. В полях Database Host и Database Port введите имя и порт компьютера, на котором установлен PostgreSQL.

  11. В полях Пользователь приложения и Пароль приложения введите имя пользователя и пароль, которые вы ввели при установке PostgreSQL.

  12. Нажмите кнопку Проверка подключения к базе данных .

  13. Нажмите Далее.

  14. Подтвердите или выберите диск, на который вы хотите установить NGINX, и нажмите " Установить" .

    NGINX_install_path.png

  15. Если у вас несколько имен хостов веб-служб, после установки NGINX откройте nginx.confфайл (по умолчанию находится по адресу: C:/nginx/conf) и в httpразделе скопируйте и вставьте существующие строки и обновите новые строки дополнительными именами хостов.

  16. Убедитесь, что домены (или имя хоста) на любом хосте, на котором запущено приложение (браузер), могут быть разрешены DNS. Если DNS недоступен, можно отредактировать файл hosts и добавить IP-адрес балансировщика нагрузки, используя следующий синтаксис:

    10.x.x.x www.example.com example.com

    Пример: 10.0.0.143 www.example.com

  17. Откройте следующие три файла веб-конфигурации .js на BriefCamсервере (по умолчанию эти три файла находятся в C:\Program Files\BriefCam\WebServices):

    • \app\webConfig.js

    • \ProWebAdminClient\web.config.js

    • \ProWebClient\webConfig.js

      NGINX Webconfig files.png

  18. В каждом из трех файлов web config .js задайте конечные точки (endPointApi), которые будут указывать на балансировщик нагрузки. В приведенном ниже примере вы просто измените PRODUCT1адрес балансировщика нагрузки. Убедитесь, что в пути не отображается "http:".

    Web config endpoint.png

  19. Откройте QMC QLIK с пользователем, который использовался для установки модуля RESEARCH (https://<hostname>/qmc).

  20. Выберите виртуальные прокси и добавьте два новых параметра, используя имя хоста каждой из машин (например, имя хоста машины QLIK и имя хоста машины NGINX, как показано на рисунке ниже), для обоих прокси:

    • Виртуальные прокси -> bc -> advanced->Белый список Host

    • Виртуальные прокси -> Центральный прокси (по умолчанию) -> расширенный->белый список Host

      Host white list.png

      Примечание

      В некоторых системах может потребоваться добавить имя хоста, полное доменное имя и IP-адрес балансировщика нагрузки, а также все экземпляры веб-служб в белый список виртуальных прокси в QMC.

  21. На экране Коннекторы каталогов пользователей перейдите к Видимой строке подключения и добавьте доменное имя к serverзначению. Например, на изображении ниже, Stress-DBбыло исходным значением, а теперь оно равно.Stress-DB.briefcamdev.com

    Qlik User directory connectors.png

  22. Убедитесь, что для следующих параметров среды задан IP-адрес или имя хоста NGINX, а если вы решили использовать защищенное соединение (https), убедитесь, что URL-адреса начинаются с https:

    • BaseVideoUrl

    • clientNotificationEndPoint

    • DB.LocalStorageAddress

    • LoadBalancerAddress – Этот параметр должен быть установлен в имя хоста NGINX (FQDN)

    • ProWebApiАдрес

    • Адрес ProWebClient

    • QlikСервер

    • Site.Url

    • Url-адрес StorageGateway

    • SSOEndpoint – Если вы хотите использовать встроенный клиент, это значение должно быть установлено как: http[s]://<NGINX-host>:8030/MilestoneSSO/

  23. Если вы устанавливаете движок OX на базе Linux, убедитесь, что значение параметра среды OX6.EngineOutputGatewayGrpcPort соответствует значению, введенному в поле "Обработка" установщика ( 49149 по умолчанию).

  24. Если вы устанавливаете движок OX на базе Linux, убедитесь, что значение параметра среды OX6.VmsAdapterGrpcPort соответствует значению, введенному в поле "Агент VMS" установщика (49151 по умолчанию ).

    NGINX_ports_check.png

  25. Перезапустите BriefCamслужбы.

  26. Если вы решили использовать защищенное соединение (https), перейдите к приложению и убедитесь, что оно работает с запросами https. Пример:

    • https://www.example.com/app

    • https://www.example.com/admin

Служба Windows NGINX

Установщик BriefCamNGINX создает службу BriefCamNGINX Web Server на экране "Службы Windows". Эта служба отвечает за то, чтобы процесс NGINX постоянно выполнялся, а балансировщик нагрузки был готов принимать запросы. Пользователь, который запускает эту службу, является пользователем BriefCamWindows.

NGINX Web Server.png

Общие конфигурации

Для любого другого типа балансировщика нагрузки, такого как Amazon ELB, Google Cloud Platform Load Balancer и так далее, необходимо настроить правила перенаправления на основе URL-адреса. Ниже приведены правила перенаправления:

1. Служба уведомлений

Поиск: /signalr

Перенаправить на: notification-server:7080

2. Video Streaming Gateway

Поиск: /vsg

Использовать правило перезаписи для удаления содержимого /vsgиз URL-адреса

Перенаправить на: videostreaming-server:5010

3. Исследования (Qlik)

Поиск: /bc/

Перенаправить на: www.example.com:8090

4. Веб-службы

Поиск: /

Перенаправить на: briefcam-webserver