Установка программы

Подготовка сервера и касс, установка компонентов, подключение к СУБД, лицензирование и диагностика.

1. Общие сведения

Entersight Front Office — программный комплекс автоматизации розничного магазина: кассовые рабочие места (включая кассы самообслуживания), сервер магазина, обмен данными с учётными системами, дисконтная система, лицензирование и автоматическое обновление.

Комплекс устанавливается в двух конфигурациях:

Хранение данных обеспечивает российская СУБД 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. Требования к оборудованию

Сервер СУБД Digital Q.DataBase: от 4 ядер, от 8 ГБ ОЗУ, от 100 ГБ на SSD. Допускается размещать СУБД на одном физическом сервере с сервером магазина в виде виртуальной машины.

3. Требования к программному окружению

Устанавливается до установки Entersight Front Office:

Сервер СУБД:

Настройки СУБД:

1. Включён приём подключений по протоколу TDS (совместимость с T-SQL), порт TCP 1433 открыт для сервера магазина и касс.
2. Включена аутентификация по логину и паролю.
3. Создана учётная запись с правом создавать базы данных. Она используется установщиком и службами Entersight Front Office.
4. Имя сервера СУБД разрешается через DNS со всех компьютеров магазина.

4. Состав дистрибутива

После установки на сервере (каталог по умолчанию C:\Program

Files\DataKrat\Front Office):

На кассе: каталог Pos (кассовый модуль DkPos.exe или DKPosCSO.exe для кассы самообслуживания, загрузчик posLoader.exe, файл настроек dkpos.cfg).

5. Получение дистрибутива

Entersight Front Office поставляется одним файлом — мастером установки setup_X.Y.Z.exe, где X.Y.Z — номер версии ПО. Один и тот же файл используется для сервера магазина, рабочей станции и кассы: конфигурация выбирается в мастере на шаге «Выбор компонентов».

Порядок получения:

1. Получите установщик актуальной версии у правообладателя. Вместе с установщиком передаются eula.txt и fo-doctor.exe.
2. Сохраните установщик на каждый компьютер, где будет выполняться установка, или в сетевую папку, доступную с этих компьютеров. Доступ в интернет на время установки не нужен: установщик содержит все файлы ПО, базы данных и сторонние библиотеки.
3. Проверьте версию: в свойствах файла (правый клик → «Свойства» → «Подробно») поле «Версия продукта» должно совпадать с номером в имени файла.
4. Ставьте одну и ту же версию на сервер и на все кассы магазина. Следующие версии магазин получает автоматически через агент обновлений (раздел 10), повторно загружать установщик для обновления не нужно.

6. Работа мастера установки

Установщик запускается только с правами администратора Windows. Мастер последовательно показывает страницы настройки; набор страниц зависит от выбранного типа установки и компонентов. После нажатия «Установить» мастер

сам выполняет:

• копирование файлов выбранных компонентов в каталог установки;
• создание базы данных frontdk (сервер) или базы кассы (касса) на сервере СУБД — рабочей или демонстрационной. SQL-скрипты выполняются утилитой sqlcmd, её вывод сохраняется в файл sqlcmd.log в каталоге db;
• регистрацию компонентов DevExpress в глобальном кэше сборок (GAC);
• регистрацию служб Windows и настройку их автоматического перезапуска при сбое;
• запись параметров подключения к базе и службе лицензий в файлы настроек компонентов;
• создание ярлыков в меню «Пуск» и, если отмечено, на рабочем столе;
• по запросу — запуск конфигуратора службы обмена (ex_configurator.exe) и создание задания резервного копирования fo_backup в планировщике Windows (сценарий db\backup.bat).

Страницы мастера для типа «Сервер/Рабочая станция»:

Страницы мастера для типа «Касса»:

Мастер использует названия «MS SQL SERVER» и «экземпляр SQL Server» по историческим причинам: на этих страницах указываются параметры сервера Digital Q.DataBase, который принимает подключения по тому же протоколу TDS.

7. Установка сервера магазина

Выполняется под учётной записью с правами администратора Windows.

1. Подготовьте сервер СУБД Digital Q.DataBase по разделу 3. На сервер магазина установите .NET Framework 4.8 и утилиту sqlcmd. Проверьте подключение командой sqlcmd -S <сервер СУБД>,1433 -U <пользователь> -P <пароль> -Q "select @@version".
2. Запустите setup_2.19.42.exe, выберите язык установки «Русский».
3. Примите лицензионное соглашение.
4. Укажите каталог установки или оставьте предложенный C:\Program Files\DataKrat\Front Office.
5. Выберите тип установки «Сервер/Рабочая станция». Отметьте компоненты: «База данных», «Утилита работы с ключом», «Служба лицензий», «Служба обмена данными», «Служба загрузки касс», «Служба уведомлений», «Служба обновления», «Агент обновлений Entersight», «Модуль администрирования», «Дисконтный модуль». Компонент «Служба загрузки весов» отмечайте, только если в магазине есть весы с загрузкой товаров из Entersight Front Office.
6. Подключение к СУБД. Имя экземпляра оставьте пустым: Digital Q.DataBase принимает подключения на стандартном порту 1433.
7. Тип базы данных. Выберите «Рабочая» (пустая база) или «Демонстрационная» (с демонстрационными данными для ознакомления).
8. Параметры подключения к базе. Источник данных — сетевое имя сервера Digital Q.DataBase (не IP-адрес и не localhost), база данных frontdk, пользователь и пароль СУБД. Нажмите «Проверить соединение».
9. Служба лицензий. Укажите имя компьютера, на котором работает служба лицензий (по умолчанию текущий), и порт 1300.
10. Лицензионный ключ. Введите лицензионный ключ, выданный правообладателем. Адрес сервера лицензий оставьте admin-api.entersight.ru.
11. Пароль администратора для входа в модуль администрирования и дисконтный модуль. Замените значение, подставленное в поле по умолчанию, своим паролем и сохраните его: под этим паролем выполняется первый вход в модуль администрирования.
12. Укажите папку в меню «Пуск» и при необходимости отметьте создание ярлыков на рабочем столе. Нажмите «Установить».
13. Установщик создаст базу frontdk на сервере Digital Q.DataBase, зарегистрирует и запустит службы.
14. По запросу установщика запустите конфигуратор службы обмена (можно отложить) и создайте задание резервного копирования базы в планировщике Windows (fo_backup).
15. Нажмите «Завершить».

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

8. Установка рабочей станции администратора

Если модули управления нужны на отдельном компьютере:

1. Установите .NET Framework 4.8.
2. Запустите setup_2.19.42.exe, выберите «Выборочная установка» и отметьте только «Модуль администрирования» и «Дисконтный модуль».
3. Укажите параметры подключения к базе frontdk на сервере магазина и адрес службы лицензий (имя сервера, порт 1300).

9. Установка кассы

1. Установите .NET Framework 4.8 и утилиту sqlcmd. Проверьте, что сервер Digital Q.DataBase доступен с кассы по порту 1433.
2. Подключите и настройте фискальный регистратор по документации производителя.
3. Запустите setup_2.19.42.exe, выберите тип установки «Касса».
4. Режим работы кассы с базой данных: «Локальная база данных (SQL Online)» — рекомендуемый режим, касса работает с локальной базой cashdk и обменивается данными с сервером через службу загрузки касс. Режимы «FO Online», «FO Batch» и «FO Batch Mail» предназначены для особых схем обмена и выбираются только по согласованию с технической поддержкой; для «FO Batch Mail» мастер дополнительно запрашивает параметры почтовых серверов POP3 и SMTP.
5. Подключение к серверной базе: сетевое имя сервера Digital Q.DataBase, база frontdk, пользователь и пароль.
6. Подключение к базе кассы: сетевое имя сервера Digital Q.DataBase, имя базы кассы (для каждой кассы своё, например cashdk_01), пользователь и пароль. Тип базы — «Рабочая».
7. Если база кассы с указанным именем уже существует, мастер спросит «Установить кассовую базу данных из дистрибутива?». Ответ «Да» заменяет базу чистой — текущие данные кассы будут утеряны. При переустановке работающей кассы сначала закройте смену и убедитесь, что все чеки переданы на сервер.
8. Номер кассы и индекс магазина — целые числа, уникальные в пределах магазина.
9. Фискальный регистратор: АТОЛ, ШТРИХ-М, ПИРИТ или «Не устанавливать драйвер ФР», если драйвер уже установлен.
10. При необходимости отметьте «Установить кассовый модуль в качестве оболочки Windows» и укажите учётную запись для автоматического входа. По умолчанию мастер подставляет логин Administrator; укажите учётную запись, под которой касса должна входить в Windows.
11. Нажмите «Установить», затем «Завершить». Настройки подключения сохраняются в Pos\dkpos.cfg.

10. Подключение к облачному сервису и лицензирование

1. Объект регистрируется правообладателем в облачной консоли Entersight, ему выдаётся лицензия.
2. Служба лицензий Client.LS получает разрешения по лицензионному ключу с сервера admin-api.entersight.ru.
3. Агент обновлений DkUpdateAgent по тому же ключу получает из облака назначенную версию и устанавливает обновления в окне обслуживания (по умолчанию 02:00–05:00).

11. Проверка работоспособности

1. На сервере СУБД убедитесь, что служба Digital Q.DataBase запущена и базы frontdk и cashdk_* созданы.
2. На сервере магазина откройте «Службы» (services.msc) и убедитесь, что запущены: Client.LS, ex_service, cl_service, nt_service, upd_service, DkUpdateAgent.
3. Запустите «Модуль администрирования» с ярлыка, войдите под пользователем «Администратор». Откройте справочник товаров.
4. На кассе запустите кассовый модуль, войдите под кассиром, откройте смену и пробейте тестовый чек.
5. Запустите fo-doctor.exe /check. Код завершения 0 означает, что проверки пройдены, 1 — есть предупреждения, 2 — найдены ошибки. Подробный отчёт выводится в консоль.

12. Повторный запуск установщика и обновление

Работающий объект обновляется агентом обновлений DkUpdateAgent (раздел 10):

он получает новую версию из облака, делает резервную копию, обновляет сервер, выполняет скрипты миграции базы и передаёт обновление кассам. Запускать установщик новой версии поверх работающего объекта для обновления не нужно.

Установщик повторно запускают только в следующих случаях:

добавление компонента на уже установленный компьютер (например, модуля администрирования на рабочую станцию) — через «Выборочную установку»; восстановление компьютера после замены оборудования или переустановки Windows; подключение новой кассы — установщиком той же версии, что работает на сервере магазина.

Перед повторной установкой на компьютер с данными сделайте резервную копию баз данных и каталога установки. На шаге выбора типа базы и на вопросе о восстановлении кассовой базы выбирайте варианты, которые не перезаписывают рабочие данные, если их нужно сохранить.

13. Ошибки при установке

Подробный журнал установки можно получить, запустив установщик с ключом /LOG, например setup_X.Y.Z.exe /LOG="C:\fo_setup.log". При обращении в техническую поддержку приложите этот журнал, файл sqlcmd.log и снимок экрана с сообщением об ошибке.

14. Удаление

1. Остановите кассовый модуль на кассах.
2. Откройте «Параметры Windows → Приложения» (или «Программы и компоненты»), выберите «Entersight Front Office» и нажмите «Удалить». Деинсталлятор снимет регистрацию служб.
3. Базы данных на сервере Digital Q.DataBase при удалении не удаляются. Если они больше не нужны, удалите их средствами СУБД.

15. Контакты технической поддержки

Entersight, сайт: https://entersight.ru