Настройки устаревших клиентов
HandyCafe работает параллельно со старыми клиентскими установками V3 и V4 без сбоев. Страница настроек для устаревших клиентов управляет Runtime Protocol: сетевыми слушателями, которые позволяют клиентам V3 и V4 подключаться к этому серверу на их оригинальных портах.
Импорт данных из старой установки выполняется отдельно, на своей собственной странице настроек. См. Миграция данных. Эти две функции независимы друг от друга. Поддержка во время выполнения работает без миграции каких-либо данных. Миграция работает без поддержки во время выполнения. Вы также можете использовать обе функции вместе.
Раздел протокола времени выполнения
Включить поддержку устаревших клиентов
Главный переключатель в верхней части раздела. Когда он включен, сервер запускает три сетевых слушателя:
- UDP-слушатель на настроенной multicast-группе.
- TCP-слушатель команд на
UDP port + 2. - TCP-слушатель передачи файлов на
UDP port + 7.
Если переключатель выключить, все три слушателя останавливаются атомарно. Пока они отключены, можно изменить номера портов или кодировку, а затем снова включить их, чтобы применить изменения.
Поля конфигурации
| Поле | По умолчанию | Описание |
|---|---|---|
| Auth Key | HANDYCAFE | Общий ключ длиной 10 символов. Каждая входящая и исходящая рамка содержит эту строку. Рамки, которые не совпадают, отбрасываются. Все устаревшие клиенты должны использовать один и тот же ключ. |
| UDP Multicast IP | 230.4.4.46 | Multicast-группа, используемая для beacon-сообщений обнаружения клиентов и для отправки команд по UDP. Жестко задана в большинстве старых сборок клиента. |
| Server UDP Port | 710 | UDP-порт, на котором сервер слушает beacon-сообщения и команды клиентов. Устаревшие клиенты отправляют данные на этот порт. |
| Client UDP Port | 711 | UDP-порт, на котором слушают устаревшие клиенты. Сервер отправляет однокастовые команды управления на этот порт на обнаруженный IP клиента. |
| Encoding | cp1254 | Кодировка символов для строковых полей в сетевом формате. Используйте cp1254 для турецких установок, cp1252 для западноевропейских. Неизвестные значения откатываются к cp1254 с предупреждением в журнале сервера. |
| Server Version | 3.4.01 | Строка версии, которая рассылается в каждом UDP-beacon. Некоторые устаревшие клиенты отвергают рамки от версий, которых они не распознают. Укажите здесь строку версии вашего исходного сервера. |
| Protocol Variant | STE | Выбор формата передачи. См. сравнение вариантов ниже. |
| Inactivity Timeout | 10 | Секунды. Сторожевой таймер для каждого MAC. Если от клиента не приходит трафик в течение этого окна, клиент помечается как offline. Интервал в 10 секунд подходит для устаревших клиентов, которые шлют beacon каждые 2--3 секунды. |
Производные порты
Под формой показана строка только для чтения с производными TCP-портами:
TCP Command Port: 712 File Transfer Port: 717
Эти порты вычисляются из UDP-порта сервера. Отдельно настраивать их не нужно. Если вы измените Server UDP Port на другое значение, производные порты сместятся вместе с ним.
Вариант протокола
Поле Protocol Variant выбирает формат передачи, который использует сервер. Выбирайте вариант, соответствующий тому, как была собрана ваша старая серверная установка.
| Вариант | Когда использовать |
|---|---|
| STE (Smart/Turbo Edition) | Современная устаревшая кодовая база. Добавляет 70-байтный префикс license-info к структуре рамки. Размер рамки - 1337 байт. Выбирайте этот вариант, если ваша старая установка была Smart или Turbo edition. |
| Standard | Обычная базовая старая сборка. Размер рамки - 1267 байт без префикса license-info. Выбирайте только если ваша старая установка была Standard edition без регистрации лицензии. |
Если выбрать неверный вариант, рамки будут отброшены или прочитаны неправильно. Симптомы: клиенты выглядят онлайн, но игнорируют все команды, либо данные команд смещены на 70 байт.
Совместимость с современными клиентами
Устаревшие порты (710, 711, 712, 717) полностью отделены от современных портов протокола HandyCafe (TCP 5001, 5002, 5003, UDP 5004). Оба стека протоколов работают одновременно без конфликтов. Вы можете смешивать старые и новые клиенты в одной LAN и управлять ими из одной Панели администратора.
Применение изменений
Каждое поле в разделе Протокола времени выполнения сохраняется общей кнопкой Сохранить внизу страницы. При сохранении сервер:
- Останавливает три устаревших слушателя, если они были запущены.
- Проверяет ключ авторизации (он не должен быть пустым).
- Собирает новые конфигурации слушателей на основе обновленных полей.
- Перезапускает слушатели параллельно.
- Показывает уведомление, когда все три снова онлайн.
Если какой-то порт уже занят другим процессом, сервер сообщает об ошибке, а переключатель возвращается в выключенное состояние. Проверьте брандмауэр и другие службы с помощью netstat и выберите свободный диапазон портов.
Database Migration
Импорт данных из установки HandyCafe 3.x или 4.x больше не осуществляется на этой странице. Он доступен на странице настроек Миграция данных под источником HandyCafe Legacy, наряду с импортерами EveryCafe и Pancafe.
Эта страница охватывает обнаружение старой установки, что именно импортируется, гарантию только для чтения на исходные файлы, повторное выполнение импорта и его отмену. Для пошагового руководства см. Как перенести данные из старой установки.
Советы
- Останавливайте старый сервер перед миграцией. Если старая система все еще пишет в свою базу данных, импорт может увидеть устаревшие или частичные данные.
- Перед первой миграцией сопоставьте поле Encoding с локалью старой системы. Если изменить его после импорта, уже испорченные имена это не исправит.
- Всегда сначала запускайте тестовую миграцию. Проверьте количество записей в "Last Counts" и выборочно сравните несколько строк участников и транзакций, прежде чем переводить персонал на новую систему.
- Включите поддержку времени выполнения и оставьте старые клиенты подключенными на переходный период. Так вы сможете убедиться, что новый сервер обслуживает их так же, прежде чем отключать старый сервер.
- Если вы меняете Server UDP Port, помните, что вместе с ним меняются производные порты команд и передачи файлов. Правила брандмауэра тоже нужно обновить.