Настройка Web-монитора на Java-апплете
Важно : Версия кассового сервера должна быть не ниже 7.0.7.12.
1. Этапы установки
1.1. Подготовка к установке программы
А) Ниже представлен список необходимых файлов (находятся в папке bin/webmon инсталляционного пакета RK7:
- borlndmm.dll
- dllman.dll
- errors32.dll
- MonASPCOM.dll
- MonDLL.dll
- Netkern.dll
- NetMonDLL.dll
- TCPSOC.dll
- Thread32.dll
Если вы устанавливаете web-мониторинг на компьютер, где уже установлена RK7, то все другие файлы с такими же именами в системных папках (исключая эти файлы, лежащие в инсталляции RK7 по умолчанию) должны быть удалены!!
Б) Лицензирование Web-мониторинга *:
Создайте новый запрос на генерацию лицензии для объекта на сайте L.UCS.RU (в программе LM.jar) **.
В поле "Наименование программы" выберите "RKeeper 7 Web Monitoring", причина = "Master license".
Код запроса не нужен!
После получения мастер-лицензии создайте суб-лицензию.
После получения кода активации введите его в менеджерской станции:
Сервис -> Станции и устройства -> Свойства ресторана -> Информация о лицензии -> Web-мониторинг
* лицензия нужна для 7.1.5.0 версий и выше.
** процесс лицензирования web-мониторинга аналогичен лицензированию кассового сервера. Отличие - не нужен код запроса!
1.2. Установка Web-мониторинга
1) Установите Java (можно взять с официального сайта).
2) Установите Apache Tomcat (http://tomcat.apache.org/). Желательно одну из последних версий - 5.5 или выше). Условно папкой установки будем считать C:\Tomcat\.
С версией Tomcat 8.0.0-RC1 возможны проблемы, рекомендуем ставить Tomcat 7.0.42.
Рекомендуем устанавливать 32-х разрядную Java и 32-х разрядный Apache Tomcat не зависимо от разрядности ОС!
Внимание! Каталог установки Apache на Вашем компьютере может отличатся от каталога, прописанного в примере! Но он обязательно должен быть коротким и без пробелов!
(В нашем случае это "C:\Tomcat\" и он будет использоваться ниже в описании) .
3) Скопируйте все DLL-файлы из папки RK7\BIN\WEBMON в C:\Tomcat\webapps\MonDLL
Также скопируйте из папки RK7\BIN\WEBMON\INI файл MonDLL.ini в C:\Tomcat\webapps\MonDLL
4) Настройте MonDLL.ini:
[Config] Station=WEB_MON Server=MIDSERV [NETKERN] Protocols= C:\Tomcat\webapps\MonDLL\TCPSOC.dll // Убедитесь, что данный файл лежит в папке c MonDLL.ini! Прописывать полный путь! [TCPSOC] LISTEN=0 [TCPDNS] MIDSERV=127.0.0.1:49560 MIDSERV1=100.0.0.1:9878 // в случае нескольких кассовых серверов
Внимание! Иногда для правильной работы системы необходимо не прописывать номера портов!
Где:
Station = [сетевое имя web-монитора, произвольное]
Server = [сетевое имя (сетевой ID) кассового сервера, можно посмотреть на станции менеджера или в RKeeper.ini]
Protocols = [пропишите путь к TCPSOC.dll]. Или вы можете оставить по умолчанию 'Protocols=TCPSOC.dll'.
О секциях NETKERN, TCPSoc см. в разделе "Настройка сети" . При этом необходимо учитывать, что используются сетевые настройки только из одного (!) ini файла.
Предупреждение: если у вас больше одного кассового сервера, то создайте копию папки /MonDLL/ с файлами MonDLL.dll и MonDLL.ini для каждого кассового сервера, обязательно переименуйте файлы MonDLL.dll и MonDLL.ini внутри созданных папок (имена должны быть уникальными). Не забудьте эти пути прописать в системной переменной "PATH". В каждом MonDLL.ini нужно прописать соответствующие имя сервера и кассовой станции в секции [config], а в секции [TCPDNS] прописать все кассовые сервера (имя кассового сервера = ip-адрес:порт). Например, для 2-х серверов имеем папки:
MonDLL1
|----mondll1.ini
\----mondll1.dll
MonDLL2
|----mondll2.ini
\----mondll2.dll
5) Скопируйте файл MonASPCOM.dll в папку C:\Windows\system32\
6) Распакуйте файл ..\bin\webmon\webmonitoring.zip из дистрибутива РК7 в папку C:\TomCat\webapps\.
7) Настройте файлы *.xml в папке c:\Tomcat\webapps\WebMonReps\ как описано ниже:
1.2.2. Настройка monitors.xml
В файле monitors.xml хранится список серверов.
Для каждого кассового сервера нужно создать свою копию mondll.dll (например, mondll1.dll, mondll2.dll и т.д.), а также свою копию ini файла.
<?xml version="1.0" encoding="Windows-1251" standalone="yes"?>
<MIS>
<MI Name="MIDSERV" Path="c:\Tomcat\webapps\MonDLL\MonDLL.dll"/>
;; если кассовый сервер не один, то указываем его имя и путь к его MonDLL.dll!
<MI Name="MIDSERV1" Path="c:\Tomcat\webapps\MonDLL1\MonDLL1.dll"/>
<MI Name="Общий" Sum="1"/>
</MIS>где:
MIDSERV = [имя кассового сервера для отображения в окне web-мониторинга]
Path = [полный путь к папке с DLL + MonDLL.dll]
Сервера отображаются в мониторинге в виде закладок.
Примечание : При первом запуске WEB-мониторинга (до ввода пароля) список серверов читается из файла webapps\WebMonReps\servers.xml - чтение файла monitors.xml происходит после ввода действующего пароля.
1.2.3. Настройка settings.xml
<?xml version="1.0" standalone="yes"?>
<Settings>
<RepGenAddr ID ="127.0.0.1"/> ;; лучше вписать реальный IP-адрес машины
<Enter PWD="2"/>
;; Файлы для перевода (можно не менять)
<Strings File="rus_strings.xml"/> ;; Ищите в прикрепленном архиве!
<RepList File="rus_reptypes.xml"/>
<DLL File="c:\Tomcat\webapps\MonDLL\MonDLL.dll"/> // путь к папке с DLL + MonDLL.dll.Полное имя (с указанием пути) к mondll.dll. При указании пути соблюдать регистр! Если мониторинг настроен на несколько кассовых серверов, то здесь указывается dll любого из них. Если сервер, которому соответствует данная dll, не включен, то мониторинг не работает (даже если есть другие включенные сервера).
<RepPath Dir="c:\Tomcat\webapps\WebMonReps\"/> <DataDir Dir="c:\Tomcat\webapps\WebMonReps\"/> </Settings>
Предупреждение: В прописываемых путях НЕ ДОЛЖНО БЫТЬ ПРОБЕЛОВ! Программа регистро-зависима!
8) Запишите путь ко всем dll-файлам web-мониторинга (в нашем случае – «C:\Tomcat\webapps\MonDLL\») в системную переменную PATH (для Windows XP - "Мой компьютер -> Свойства системы -> Дополнительно -> Переменные среды").
Предупреждение: пути в системной переменной PATH должны быть разделены символом ";".
9) Запишите путь ко всем Java dll-файлам в системную переменную PATH
(в нашем случае – «C:\Program Files\Java\jre1.5.0_09\bin»)
Предупреждение: пути в системной переменной PATH должны быть разделены символом ";".
8) Перезагрузите компьютер
9) Запустите кассовый сервер (midserver)
10) Запустите Apache
( Если вы откроете окно кассового сервера (двойной клик по значку в системнои трее), то на вкладке "Станции" увидите имя веб-монитора, в нашем случае "WEB_MON").
11) Запустите web-мониторинг.
Запуск происходит после ввода в любом интернет-браузере следующей адресной строки:
- для локальной машины : http://localhost:8080/WebMonReps/WEBMonCli.html;
- для запуска web-мониторинга на других компьютерах , в адресной строке вместо параметра «localhost» следует прописать IP-адрес компьютера, на котором установлен Apache, например: http://192.168.100.200:8080/WebMonReps/WEBMonCli.html .
Для корректной работы системы может понадобиться плагин - об этом сообщит браузер. Установите его.
То же самое нужно сделать и для параметра "location" в файле WEBMonCli.html , который лежит в папке "c:\Tomcat\webapps\WebMonReps\". Например: (<param name="Location" value="http://192.168.100.200:8080/WebMonReps")!
12) После того как в браузере откроется окно авторизации, следует ввести имя пользователя и пароль из файла monclnts.xml.
13) О загрузке Веб-отчетов можно судить по появившемся на вкладке "Станции" кассового сервера строки Веб-мониторинга:
2. Решение различных проблем
В процессе установки и эксплуатации могут возникать неочевидные проблемы, в данном разделе представлена информация по некоторым из них:
- При совместной установке на один физический сервер приложений Apache Tomcat и СУБД Oracle, для Tomcat стоит указывать порт, отличный от 8080, т.к. данный порт ипользуется Oracle (также для собственного локального http-сервера, при этом никак не "выдавая" себя)
- Если при загрузке апплета WEB-мониторинга возникают какие-либо сложности (например, имена серверов отображаются не те, которые прописаны на данный момент в servers.xml), необходимо очистить кеш Java-машины. Для этого надо зайти в "Панель управления", кликнуть на иконке Java и на закладке General выбрать Setting и удалить кеш - более подробно здесь www.java.com/en/download/help/plugin_cache.xml
Если установка производится на машину с 64-х разрядной ОС, то возможно потребуется скопировать файлы библиотек (из папки \MonDLL\) в системную папку ..\Windows\SysWOW64\!
Если установка производится на машину с 64-х разрядной ОС,то ЖЕЛАТЕЛЬНО устанавливать 32-х разрядную Java и 32-х разрядный Apache Tomcat
Обнаружен конфликт когда одновременно используется web-мониторинг и ITV POS intellect! Исправлено в 7.4.21.273+
Бывает, что некоторые версии апач, например apache-tomcat-7.0.39 на Windows7 максимальная х32, при прописывании путей в системной переменной Path просто не запускаются. Для этого необходимо добавить строку set JAVA_HOME=c:\Program Files\Java\jre7\ в файлик catalina.bat перед следующими строками:
rem Guess CATALINA_HOME if not defined
set "CURRENT_DIR=%cd%"