Skip to content

Автономная конфигурация портов WebSocket

1. Обзор

1.1 Версия

Версия сервера BI
5.1

1.2 Сценарии применения

В этой статье описывается, как настроить порт WebSocket в автономной среде.

Примечание: Для BI-проектов 5.1.20 и более поздних версий добавлена новая схема контейнерных сокетов. Рекомендуется сначала проверить доступность этого решения: Container Websocket Solution

Без каких-либо действий со стороны пользователя, без ручной настройки, без открытия дополнительных портов система может автоматически использовать для подключения WebSocket, поставляемый вместе с веб-контейнером, и мультиплексирование портов http.

2. Примеры

2.1 Модификация значений полей

Супер администратор может изменить порт WebSocket через "fine_conf_entity Visual Configuration Plugin". Настройки вступают в силу после перезапуска сервера.

Примечание: Методы изменения значений полей таблиц базы данных FineDB см. в разделе " Модификации полей общих таблиц FineDB ".

портыJAR-пакетIDзначение по умолчаниюДиапазон настройкиПоддерживается ли онаУстановка нескольких значений
Порт Websocket-WebSocketConfig.port["48888", "49888"]Значением параметра является массив портов ["port1", "port2"].порт находятся в интервале (1024,65535]поддержка
Порт переадресации WebsocketДо 2019-11-08WebSocketConfig.requestPort48889адъювант
2019-11-08 и далееWebSocketConfig.requestPorts48889адъювант

При установке номеров портов следует учитывать некоторые моменты:

(1) Номер порта может быть установлен в диапазоне 1024~65535, если он имеет более одного значения, формат установки следующий: [номер порта 1, номер порта 2, номер порта 3].

2) Рекомендуется установить несколько значений для "Порта WebSocket" в качестве резервной копии, чтобы предотвратить развертывание на сервере нескольких проектов и занятие порта.

3) Не устанавливайте номер порта на порт удаленного подключения к серверу 3389.

4) Не дублируйте номер порта, который одновременно является портом WebSocket и портом переадресации WebSocket.

(5) Если после полей WebSocketConfig.port, WebSocketConfig.requestPort, WebSocketConfig.requestPorts стоит пробел, конфигурация не вступит в силу.

6) Если WebSocketConfig.port, WebSocketConfig.requestPort, WebSocketConfig.requestPorts имеют неправильные размеры, конфигурация не вступит в силу.

7) WebSocketConfig.requestPort и WebSocketConfig.requestPorts не могут существовать в таблице fine_conf_entity одновременно, иначе это будет ошибкой.

2.2 Открытые порты

  • Закройте брандмауэр, если он включен, или откройте порт отдельно.
  • Если на облачном сервере есть группа безопасности или что-то подобное, вам нужно установить порт, чтобы он был открыт для внешнего мира.

2.3 Возобновление работ

Перезапустите проект FineBI.

При перезапуске проекта необходимо убить процессы, запущенные в проекте, и подождать 2 минуты, пока порт не будет освобожден, иначе перезапуск может закончиться неудачей.

2.4 Предварительный просмотр эффектов

Следуйте порядку порт WebSocket >> порт переадресации WebSocket, т.е. если вы используете порт со значением по умолчанию, попробуйте слушать в порядке "48888, 49888, 48889".

  • Если один порт успешно прослушивается, другие порты не пытаются это сделать.

  • Если все порты не могут установить прослушивание с сервером системы, откроется страница Deployment Wizard, на которой вам будет предложено изменить список прослушиваемых портов, что повлияет на соответствующие функции.
  • В этот момент перенастройте порт WebSocket и порт переадресации WebSocket, пока не появятся свободные порты.