Установка программы
Подготовка сервера и касс, установка компонентов, подключение к СУБД, лицензирование и диагностика.
1. Общие сведения
Entersight Front Office — программный комплекс автоматизации розничного магазина: кассовые рабочие места (включая кассы самообслуживания), сервер магазина, обмен данными с учётными системами, дисконтная система, лицензирование и автоматическое обновление.
Комплекс устанавливается в двух конфигурациях:
| Конфигурация | Где ставится | Что входит |
|---|---|---|
| Сервер / рабочая станция | Сервер магазина, АРМ администратора | База данных frontdk, службы лицензий, обмена, загрузки касс, уведомлений и обновления, агент обновлений, модуль администрирования, дисконтный модуль |
| Касса | Кассовый терминал, касса самообслуживания | Кассовый модуль, локальная база cashdk, драйвер фискального регистратора |
Хранение данных обеспечивает российская СУБД Digital Q.DataBase (АО «Диасофт»). СУБД работает на сервере под управлением отечественной ОС Linux и принимает подключения по протоколу TDS с поддержкой языка T-SQL, поэтому компоненты Entersight Front Office подключаются к ней штатно, без доработок. Совместная работа Entersight Front Office и Digital Q.DataBase проверена.
Схема развёртывания:
[Сервер СУБД, Linux] Digital Q.DataBase: базы frontdk и cashdk │ TDS, TCP 1433 [Сервер магазина, Windows] службы Entersight Front Office, агент обновлений │ локальная сеть [Кассы, Windows] кассовый модуль
2. Требования к оборудованию
| Параметр | Сервер магазина | Рабочая станция | Касса |
|---|---|---|---|
| Процессор | От 2 ядер, 3,0 ГГц; рекомендуется 4 ядра | От 1 ГГц | От 1 ГГц (Celeron, Atom) |
| ОЗУ | От 4 ГБ; рекомендуется 8 ГБ | От 2 ГБ | От 2 ГБ |
| Диск | От 40 ГБ; рекомендуется 160 ГБ, RAID | От 20 ГБ | От 20 ГБ |
| Экран | От 1024×768 | От 1024×768 | 800×600, 1024×768 |
| Сеть | Ethernet 100 Мбит/с | Ethernet 100 Мбит/с | Ethernet 100 Мбит/с |
Сервер СУБД Digital Q.DataBase: от 4 ядер, от 8 ГБ ОЗУ, от 100 ГБ на SSD. Допускается размещать СУБД на одном физическом сервере с сервером магазина в виде виртуальной машины.
3. Требования к программному окружению
Устанавливается до установки Entersight Front Office:
| Компонент | Сервер | Рабочая станция | Касса |
|---|---|---|---|
| Windows 10 / 11 и новее (x86 или x64) | Да | Да | Да |
| Microsoft .NET Framework 4.8 | Да | Да | Да |
| sqlcmd (Microsoft Command Line Utilities for SQL Server). Установщик и служба обновления выполняют SQL-скрипты на Digital Q.DataBase по TDS | Да | — | Да |
| Доступ к admin-api.entersight.ru по HTTPS (порт 443) | Да | — | — |
Сервер СУБД:
| Компонент | Требование |
|---|---|
| ОС | Astra Linux Special Edition 1.7/1.8, «Альт Сервер» 10/11 или РЕД ОС 8 |
| СУБД | Digital Q.DataBase, установленная по документации АО «Диасофт» |
Настройки СУБД:
- Включён приём подключений по протоколу TDS (совместимость с T-SQL), порт TCP 1433 открыт для сервера магазина и касс.
- Включена аутентификация по логину и паролю.
- Создана учётная запись с правом создавать базы данных. Она используется установщиком и службами Entersight Front Office.
- Имя сервера СУБД разрешается через DNS со всех компьютеров магазина.
4. Состав дистрибутива
| Файл / каталог | Назначение |
|---|---|
| setup_2.19.42.exe | Мастер установки: сервер, рабочая станция, касса |
| eula.txt | Лицензионное соглашение |
| fo-doctor.exe | Проверка и диагностика установленного объекта |
После установки на сервере (каталог по умолчанию C:\Program
Files\DataKrat\Front Office):
| Каталог | Компонент | Служба Windows |
|---|---|---|
| LS_service | Служба лицензий | Client.LS |
| EX_service | Обмен с учётными системами | ex_service |
| CL_service | Загрузка касс | cl_service |
| NT_service | Уведомления | nt_service |
| Upd_service | Обновления | upd_service |
| DkUpdateAgent | Агент обновлений, связь с облаком | DkUpdateAgent |
| AdminManager | Модуль администрирования | — |
| DiscountManager | Дисконтный модуль | — |
| db | Скрипты создания базы и резервного копирования | — |
На кассе: каталог Pos (кассовый модуль DkPos.exe или DKPosCSO.exe для кассы самообслуживания, загрузчик posLoader.exe, файл настроек dkpos.cfg).
5. Получение дистрибутива
Entersight Front Office поставляется одним файлом — мастером установки setup_X.Y.Z.exe, где X.Y.Z — номер версии ПО. Один и тот же файл используется для сервера магазина, рабочей станции и кассы: конфигурация выбирается в мастере на шаге «Выбор компонентов».
Порядок получения:
- Получите установщик актуальной версии у правообладателя. Вместе с установщиком передаются eula.txt и fo-doctor.exe.
- Сохраните установщик на каждый компьютер, где будет выполняться установка, или в сетевую папку, доступную с этих компьютеров. Доступ в интернет на время установки не нужен: установщик содержит все файлы ПО, базы данных и сторонние библиотеки.
- Проверьте версию: в свойствах файла (правый клик → «Свойства» → «Подробно») поле «Версия продукта» должно совпадать с номером в имени файла.
- Ставьте одну и ту же версию на сервер и на все кассы магазина. Следующие версии магазин получает автоматически через агент обновлений (раздел 10), повторно загружать установщик для обновления не нужно.
6. Работа мастера установки
Установщик запускается только с правами администратора Windows. Мастер последовательно показывает страницы настройки; набор страниц зависит от выбранного типа установки и компонентов. После нажатия «Установить» мастер
сам выполняет:
- копирование файлов выбранных компонентов в каталог установки;
- создание базы данных frontdk (сервер) или базы кассы (касса) на сервере СУБД — рабочей или демонстрационной. SQL-скрипты выполняются утилитой sqlcmd, её вывод сохраняется в файл sqlcmd.log в каталоге db;
- регистрацию компонентов DevExpress в глобальном кэше сборок (GAC);
- регистрацию служб Windows и настройку их автоматического перезапуска при сбое;
- запись параметров подключения к базе и службе лицензий в файлы настроек компонентов;
- создание ярлыков в меню «Пуск» и, если отмечено, на рабочем столе;
- по запросу — запуск конфигуратора службы обмена (ex_configurator.exe) и создание задания резервного копирования fo_backup в планировщике Windows (сценарий db\backup.bat).
Страницы мастера для типа «Сервер/Рабочая станция»:
| Страница мастера | Что указать |
|---|---|
| Выбор языка | Русский |
| Лицензионное соглашение | Принять условия |
| Папка установки | C:\Program Files\DataKrat\Front Office по умолчанию |
| Выбор компонентов | Сервер/Рабочая станция или Выборочная установка; отметки компонентов |
| Подключение к службе MS SQL SERVER | Имя экземпляра оставить пустым |
| Настройка базы данных | Рабочая или Демонстрационная |
| Подключение к серверной базе данных | Сервер СУБД, база frontdk, пользователь, пароль; «Проверить соединение» |
| Подключение к службе лицензий | Имя компьютера со службой лицензий, порт 1300 |
| Лицензионный ключ | Ключ от правообладателя; сервер admin-api.entersight.ru |
| Пароль администратора | Пароль пользователя «Администратор» |
| Папка в меню «Пуск», дополнительные задачи | Папка ярлыков, ярлыки на рабочем столе |
Страницы мастера для типа «Касса»:
| Страница мастера | Что указать |
|---|---|
| Выбор компонентов | Тип «Касса» |
| Подключение кассы к базе | Режим работы кассы с базой (раздел 9) |
| Подключение к серверной базе | Сервер СУБД, база frontdk, пользователь, пароль |
| Настройка базы | Рабочая |
| Подключение к кассовой базе | Сервер СУБД, имя базы кассы, пользователь, пароль, номер кассы, индекс магазина |
| Тип фискального регистратора | Модель ФР или «Не устанавливать драйвер ФР» |
| Автоматическая авторизация Windows | Логин и пароль Windows — только если касса ставится оболочкой Windows |
Мастер использует названия «MS SQL SERVER» и «экземпляр SQL Server» по историческим причинам: на этих страницах указываются параметры сервера Digital Q.DataBase, который принимает подключения по тому же протоколу TDS.
7. Установка сервера магазина
Выполняется под учётной записью с правами администратора Windows.
- Подготовьте сервер СУБД Digital Q.DataBase по разделу 3. На сервер магазина установите .NET Framework 4.8 и утилиту sqlcmd. Проверьте подключение командой sqlcmd -S <сервер СУБД>,1433 -U <пользователь> -P <пароль> -Q "select @@version".
- Запустите setup_2.19.42.exe, выберите язык установки «Русский».
- Примите лицензионное соглашение.
- Укажите каталог установки или оставьте предложенный C:\Program Files\DataKrat\Front Office.
- Выберите тип установки «Сервер/Рабочая станция». Отметьте компоненты: «База данных», «Утилита работы с ключом», «Служба лицензий», «Служба обмена данными», «Служба загрузки касс», «Служба уведомлений», «Служба обновления», «Агент обновлений Entersight», «Модуль администрирования», «Дисконтный модуль». Компонент «Служба загрузки весов» отмечайте, только если в магазине есть весы с загрузкой товаров из Entersight Front Office.
- Подключение к СУБД. Имя экземпляра оставьте пустым: Digital Q.DataBase принимает подключения на стандартном порту 1433.
- Тип базы данных. Выберите «Рабочая» (пустая база) или «Демонстрационная» (с демонстрационными данными для ознакомления).
- Параметры подключения к базе. Источник данных — сетевое имя сервера Digital Q.DataBase (не IP-адрес и не localhost), база данных frontdk, пользователь и пароль СУБД. Нажмите «Проверить соединение».
- Служба лицензий. Укажите имя компьютера, на котором работает служба лицензий (по умолчанию текущий), и порт 1300.
- Лицензионный ключ. Введите лицензионный ключ, выданный правообладателем. Адрес сервера лицензий оставьте admin-api.entersight.ru.
- Пароль администратора для входа в модуль администрирования и дисконтный модуль. Замените значение, подставленное в поле по умолчанию, своим паролем и сохраните его: под этим паролем выполняется первый вход в модуль администрирования.
- Укажите папку в меню «Пуск» и при необходимости отметьте создание ярлыков на рабочем столе. Нажмите «Установить».
- Установщик создаст базу frontdk на сервере Digital Q.DataBase, зарегистрирует и запустит службы.
- По запросу установщика запустите конфигуратор службы обмена (можно отложить) и создайте задание резервного копирования базы в планировщике Windows (fo_backup).
- Нажмите «Завершить».
Если на сервере уже есть база frontdk (например, при переустановке), выбирайте тип базы осторожно: создание базы заново удаляет её текущие данные. Перед переустановкой сделайте резервную копию базы.
8. Установка рабочей станции администратора
Если модули управления нужны на отдельном компьютере:
- Установите .NET Framework 4.8.
- Запустите setup_2.19.42.exe, выберите «Выборочная установка» и отметьте только «Модуль администрирования» и «Дисконтный модуль».
- Укажите параметры подключения к базе frontdk на сервере магазина и адрес службы лицензий (имя сервера, порт 1300).
9. Установка кассы
- Установите .NET Framework 4.8 и утилиту sqlcmd. Проверьте, что сервер Digital Q.DataBase доступен с кассы по порту 1433.
- Подключите и настройте фискальный регистратор по документации производителя.
- Запустите setup_2.19.42.exe, выберите тип установки «Касса».
- Режим работы кассы с базой данных: «Локальная база данных (SQL Online)» — рекомендуемый режим, касса работает с локальной базой cashdk и обменивается данными с сервером через службу загрузки касс. Режимы «FO Online», «FO Batch» и «FO Batch Mail» предназначены для особых схем обмена и выбираются только по согласованию с технической поддержкой; для «FO Batch Mail» мастер дополнительно запрашивает параметры почтовых серверов POP3 и SMTP.
- Подключение к серверной базе: сетевое имя сервера Digital Q.DataBase, база frontdk, пользователь и пароль.
- Подключение к базе кассы: сетевое имя сервера Digital Q.DataBase, имя базы кассы (для каждой кассы своё, например cashdk_01), пользователь и пароль. Тип базы — «Рабочая».
- Если база кассы с указанным именем уже существует, мастер спросит «Установить кассовую базу данных из дистрибутива?». Ответ «Да» заменяет базу чистой — текущие данные кассы будут утеряны. При переустановке работающей кассы сначала закройте смену и убедитесь, что все чеки переданы на сервер.
- Номер кассы и индекс магазина — целые числа, уникальные в пределах магазина.
- Фискальный регистратор: АТОЛ, ШТРИХ-М, ПИРИТ или «Не устанавливать драйвер ФР», если драйвер уже установлен.
- При необходимости отметьте «Установить кассовый модуль в качестве оболочки Windows» и укажите учётную запись для автоматического входа. По умолчанию мастер подставляет логин Administrator; укажите учётную запись, под которой касса должна входить в Windows.
- Нажмите «Установить», затем «Завершить». Настройки подключения сохраняются в Pos\dkpos.cfg.
10. Подключение к облачному сервису и лицензирование
- Объект регистрируется правообладателем в облачной консоли Entersight, ему выдаётся лицензия.
- Служба лицензий Client.LS получает разрешения по лицензионному ключу с сервера admin-api.entersight.ru.
- Агент обновлений DkUpdateAgent по тому же ключу получает из облака назначенную версию и устанавливает обновления в окне обслуживания (по умолчанию 02:00–05:00).
11. Проверка работоспособности
- На сервере СУБД убедитесь, что служба Digital Q.DataBase запущена и базы frontdk и cashdk_* созданы.
- На сервере магазина откройте «Службы» (services.msc) и убедитесь, что запущены: Client.LS, ex_service, cl_service, nt_service, upd_service, DkUpdateAgent.
- Запустите «Модуль администрирования» с ярлыка, войдите под пользователем «Администратор». Откройте справочник товаров.
- На кассе запустите кассовый модуль, войдите под кассиром, откройте смену и пробейте тестовый чек.
- Запустите fo-doctor.exe /check. Код завершения 0 означает, что проверки пройдены, 1 — есть предупреждения, 2 — найдены ошибки. Подробный отчёт выводится в консоль.
12. Повторный запуск установщика и обновление
Работающий объект обновляется агентом обновлений DkUpdateAgent (раздел 10):
он получает новую версию из облака, делает резервную копию, обновляет сервер, выполняет скрипты миграции базы и передаёт обновление кассам. Запускать установщик новой версии поверх работающего объекта для обновления не нужно.
Установщик повторно запускают только в следующих случаях:
добавление компонента на уже установленный компьютер (например, модуля администрирования на рабочую станцию) — через «Выборочную установку»; восстановление компьютера после замены оборудования или переустановки Windows; подключение новой кассы — установщиком той же версии, что работает на сервере магазина.
Перед повторной установкой на компьютер с данными сделайте резервную копию баз данных и каталога установки. На шаге выбора типа базы и на вопросе о восстановлении кассовой базы выбирайте варианты, которые не перезаписывают рабочие данные, если их нужно сохранить.
13. Ошибки при установке
| Сообщение мастера | Причина и действия |
|---|---|
| «Не удалось подключиться к серверу.» | Неверное имя сервера СУБД, закрыт порт 1433, неверные логин или пароль. Проверьте подключение командой sqlcmd из раздела 7 и повторите «Проверить соединение». |
| «Пожалуйста, введите номер кассы (целое число).», «Пожалуйста, введите индекс магазина (целое число).» | Введено не число. Укажите целое число, уникальное в пределах магазина. |
| «Служба … не запущена. Запустить службу?» | Служба зарегистрирована, но не стартовала. Ответьте «Да»; если запуск не удался, откройте services.msc, запустите службу вручную и посмотрите журнал. |
| «Не удалось запустить … автоматически. Произведите запуск службы вручную и нажмите OK.» | Чаще всего недоступна база данных или неверны параметры подключения. Устраните причину и запустите службу вручную в services.msc. |
| «Сервис … не установлен.» | Регистрация службы не прошла. Убедитесь, что установщик запущен от имени администратора, и повторите установку. |
| Ошибка выполнения SQL-скрипта | Скрипт создания базы завершился с ошибкой. Текст ошибки — в db\sqlcmd.log. Частые причины: нет права создавать базы, нет места на диске сервера СУБД. |
Подробный журнал установки можно получить, запустив установщик с ключом /LOG, например setup_X.Y.Z.exe /LOG="C:\fo_setup.log". При обращении в техническую поддержку приложите этот журнал, файл sqlcmd.log и снимок экрана с сообщением об ошибке.
14. Удаление
- Остановите кассовый модуль на кассах.
- Откройте «Параметры Windows → Приложения» (или «Программы и компоненты»), выберите «Entersight Front Office» и нажмите «Удалить». Деинсталлятор снимет регистрацию служб.
- Базы данных на сервере Digital Q.DataBase при удалении не удаляются. Если они больше не нужны, удалите их средствами СУБД.
15. Контакты технической поддержки
Entersight, сайт: https://entersight.ru
Вернуться к началу ↑