Подробный гайд по ошибке 4031 в R-Keeper

Подробный гайд по ошибке 4031 в R-Keeper: диагностика и устранение проблем подключения кассы к серверу, проверка служб, сети, базы данных и лицензий.

2026.05.26                  

Подробный гайд по ошибке 4031 в R-KeeperПодробный гайд по ошибке 4031 в R-Keeper

Важно:

Коды ошибок в R-Keeper могут незначительно отличаться в зависимости от версии (R-Keeper 6/7, Cloud, Enterprise) и конфигурации. Данный гайд основан на типовых сценариях и практике сопровождения R-Keeper. Всегда сверяйтесь с официальной документацией вашей версии системы.

Что означает ошибка 4031?

В большинстве случаев ошибка 4031 в R-Keeper указывает на нарушение связи клиентской станции (кассы/терминала) с сервером приложения или базой данных.

Часто сопровождается сообщениями:

  • Превышено время ожидания ответа от сервера
  • Ошибка подключения к БД
  • Сервер недоступен
  • Connection timeout / refused

Ошибка может возникать при:

  • Запуске клиентского приложения
  • Смене кассира / открытии смены
  • Печати чеков или отправке данных на кухню
  • Синхронизации справочников или прайс-листов

Основные причины

Причина Краткое описание
Службы R-Keeper не работают R-Keeper Server, R-Keeper Monitor или License Service остановлены/зависли
Сетевые проблемы Обрыв кабеля, нестабильный Wi-Fi, сбой коммутатора, неверный IP/DNS
Проблема с СУБД MS SQL / PostgreSQL не запущен, недоступен, неверные учётные данные в конфиге
Блокировка фаерволом/АВ Антивирус или Windows Defender блокирует порты или процессы R-Keeper
Лицензионный конфликт Превышен лимит сессий, истёк срок, дублирование лицензий
Повреждённый кэш/конфиг Файлы rk.ini, config.xml или временные данные клиента повреждены

Пошаговая диагностика и решение

Шаг 1. Проверка состояния серверных служб

  1. Откройте services.msc (Win + R → services.msc)
2. Найдите службы:
  • UCS R-Keeper Server
  • UCS R-Keeper Monitor
  • UCS R-Keeper License Service
    1. Убедитесь, что их статус Работает, тип запуска Автоматически
    2. Если служба остановлена → Запустить. Если зависла → Перезапустить
5. Проверьте логи:

C:\Program Files\UCS\R-Keeper\Logs\ или C:\ProgramData\UCS\R-Keeper\Logs\
Ищите записи с Error 4031, Timeout, Connection refused

Шаг 2. Проверка сетевого соединения

1. На кассе откройте командную строку:
   ping <IP_сервера_RKeeper>
   telnet <IP_сервера_RKeeper> 8080

(Порт может отличаться, проверьте в rk.ini или config.xml)
2. Если ping не проходит → проблема в сети/маршрутизации
3. Если telnet не соединяется → порт закрыт, служба не слушает, фаервол блокирует
4. Рекомендация: используйте проводное подключение для кассовых станций

Шаг 3. Проверка подключения к базе данных

  1. Убедитесь, что СУБД (MS SQL Server / PostgreSQL) работает
  2. Откройте SQL Server Management Studio (или аналог для PostgreSQL)
  3. Попробуйте подключиться с теми же логином/паролем, что указаны в конфиге R-Keeper
4. Проверьте строку подключения в:
  • C:\Program Files\UCS\R-Keeper\config\rk.ini
  • или C:\ProgramData\UCS\R-Keeper\config\config.xml
5. Убедитесь, что:
  • База существует и не в режиме Suspect/Offline
  • Пользователь имеет права db_owner или public + необходимые роли R-Keeper
  • Не превышен лимит подключений в SQL Server

Шаг 4. Лицензия и сессии

  1. Откройте R-Keeper License Manager (обычно в трее или через меню Пуск)
2. Проверьте:
  • Статус лицензии (Active / Expired)
  • Количество активных сессий
  • Привязку к железу/MAC-адресу (если используется аппаратная лицензия)
    1. При превышении лимита → закройте лишние клиенты или увеличьте лицензию
    2. Перезапустите службу лицензирования после изменений

Шаг 5. Очистка кэша и перезапуск клиента

  1. Полностью закройте R-Keeper (проверьте в Диспетчере задач)
2. Удалите временные файлы:
   %temp%\UCS\
   %localappdata%\UCS\R-Keeper\Cache\
   C:\ProgramData\UCS\R-Keeper\Cache\
3. Переименуйте или удалите (с бэкапом!) файлы:
  • rk.ini
  • config.xml
  • client.cfg
    1. Запустите R-Keeper от имени администратора → программа создаст свежие конфиги
    2. Протестируйте подключение

Шаг 6. Настройка исключений в фаерволе/АВ

Добавьте в белый список:

  • Процессы: rkclient.exe, rkserver.exe, rkmonitor.exe, sqlservr.exe
- Порты (по умолчанию, уточните в вашей конфигурации):
  • 8080, 8081 (веб-интерфейс/API)
  • 1433 (MS SQL) или 5432 (PostgreSQL)
  • 5000–5010 (внутренняя синхронизация)
    • Отключите на время проверки сетевой экран/АВ для диагностики

Шаг 7. Обновление и восстановление

  1. Проверьте версию R-Keeper → сравните с актуальной на портале UCS
  2. При наличии обновлений → установите в нерабочее время
  3. Если ошибка появилась после обновления → откатите версию или восстановите конфиги из бэкапа
  4. При подозрении на повреждение БД → восстановите из последней резервной копии

Диагностика через логи

Файл Где искать Что анализировать
rkserver.log ...\R-Keeper\Logs\ Ошибки инициализации, падения служб
rkclient.log %localappdata%\UCS\R-Keeper\Logs\ Таймауты, отвалы сети, ошибки авторизации
sql_error.log Папка логов СУБД Проблемы подключения, блокировки, права
license.log ...\R-Keeper\Logs\ Истечение срока, дубли сессий

Совет:

При обращении в поддержку r_keeper приложите свежие логи за период возникновения ошибки + скриншот окна ошибки + вывод ipconfig /all и ping/telnet.

Профилактика

  • Резервное копирование БД ежедневно (через SQL Agent или скрипты r_keeper)
  • Мониторинг свободного места на диске сервера (>15% свободно)
  • Стабильное проводное подключение касс к серверу
  • Автоперезапуск служб R-Keeper при падении (через sc failure или Task Scheduler)
  • Регулярное обновление ОС, драйверов сети, СУБД и R-Keeper
  • Ведение журнала изменений (кто, когда, что менял в конфигурации)

Когда обращаться в поддержку r_keeper?

Обращайтесь в официальную поддержку, если:

  • Ошибка появилась после обновления R-Keeper или СУБД
  • Подозрение на повреждение структуры БД или индексов
  • Лицензия активна, но сервер не видит ни одной кассы
  • Не помогают все шаги из данного гайда
  • Требуется миграция на новую версию или перенос на другое железо

Контакты UCS:

  • Портал поддержки: rkeeper.ru/technical-support/
  • Email: rkeeper@rkeeper.ru
  • Телефон горячей линии: указан в вашем договоре или на сайте

Важные предупреждения

  1. Не удаляйте и не редактируйте файлы БД вручную
  2. Всегда делайте бэкап перед изменением конфигов или обновлением
  3. Работайте под учётной записью с правами локального администратора
  4. Тестируйте изменения на тестовой кассе перед применением в продакшене
  5. Фиксируйте все действия в журнале администрирования

Мы делимся этой технической информацией, чтобы помочь вам в решении задач — используйте её с пониманием. Статья носит рекомендательный характер, поэтому, пожалуйста, применяйте описанные методы осмотрительно.

×

Полный размер Слайдшоу Предыдущий Следующий