readme_rus.txt

Инструкция по установке системы автоматизации работы с клиентами.


Шаг1. Приступая к установке.
Перед установкой системы, убедитесь, что у Вас установлена OracleJRE версии не ниже 1.8 и, если хотите использовать СУБД MySQL, то установите MySQL версии не ниже 5.5. В качестве альтернативы можно использовать встроенную базу данных Н2. Можно использовать СУБД Н2 встроенную в СУО QSystem и не устанавливать MySQL. Проверить установку JRE можно следующим способом: 
Пуск->Выполнить->cmd-> java –version.

Также рекомендуется установить графические утилиты для работы с СУБД MySQL при использовании MySQL в качестве БД для QSystem.

Шаг2. Запуск инсталляции системы.
Microsoft Windows:
Кликните два раза по файлу install.jar.
Linux(универсальный способ для любой ОС):
Запуск инсталляции с командной строки:
Перейдите в папку с файлом install.jar и выполните команду
 java –cp install.jar com.izforge.izpack.installer.Installer
 !!!  java -jar install.jar

Шаг3.  Инсталляция системы.
В окне приветствия жмем «Далее», в следующем окне представления системы так же жмем «Далее», в следующем окне будет показана версия сборки системы, дата сборки и другая информация о продукте, так же жмем «Далее».
 В следующем окне будет предложено выбрать каталог для установки системы, по умолчанию, каталогом является диск, с установленной ОС в папке Program Files и нажать «Далее». Инсталлятор автоматически создаст каталог, если его не существует.

Далее будет предложен выбор установки компонентов системы:
-файлы приложения и библиотеки (по умолчанию, невозможно изменить).
-рабочее место оператора (по умолчанию)
-сервер
-администрирование
-пункт регистрации
-документация*
* в компонент «Документация» входят: руководство пользователя и руководство администратора, контекстная помощь присутствует всегда.
После выбора необходимых компонентов жмем «Далее».

Шаг4. Настройка системы.
После выбора компонентов, Вам будет предложено ввести адреса и порты для взаимодействия компонентов системы:
- адрес сервера
- порт сервера
- адрес пункта регистрации
- порт пункта регистрации
- порт клиентов
- назначить пункт регистрации многоязычным.
Примечание! В случае заполнения неверных данных в адреса и порты серверов, их можно поправить в *.bat файлах, установленных компонентов системы.
После ввода данных, нажмите «Далее». Вам будет показан список выбранных компонентов, если Вас все устраивает, то жмите «Далее».

Шаг5. Завершение установки.
Началась установка программных компонентов системы. После ее завершения жмем «Далее». Появится окно, где будет предложено вывести ярлыки на рабочий стол. Создание ярлыков в установленную папку с системой стоит по умолчанию.

Далее после завершения работы инсталяционного пакета необходимо установить некоторые программные продукты и драйвера, если, конечно, они у вас не установлены ранее.

Шаг6. Добавление библиотеки JavaFX.
Начиная с версии 1.3.1 требуется подключение библиотеки JavaFX. Эта библиотека распространяется в составе OracleJRE, но по умолчанию не используется. Подключение представляет собой копирование одного файла из папки в папку. Файл <jre>\lib\jfxrt.jar скопируйте в папку <jre>\lib\ext. И все.
Начиная с версии Java8 эта библиотека JavaFX уже изначально входит в состав Java.

Для установки клиентского модуля этих действий достаточно.

Теперь все необходимые компоненты установлены на ваш компьютер. Необходимо только развернуть БД и настроить ситему для использования этой БД.

Шаг7.Развертывание БД.
* Для MySQL Требуется использование кодировки utf8. В администраторе MySQL или в my.ini(my.cnf) укажите сообветствующие настройки. К примеру:
[mysql]
default-character-set=utf8
[mysqld]
collation_server=utf8_unicode_ci
character_set_server=utf8

В папке DB вы найдете развертывающий скрипт qsystem.sql для MySQL. Для СУБД Н2 скрипт называется qsystem_H2.sql Этот скрипт создаст саму базу, необходимые таблици и заполнит таблици начальными данными. Если у вас уже имеется БД и вы переходите на новую версию БД, то вам необходимо использовать sql-скрипт для обновления вашей базы до требуемой версии. Для выполнения скрипта для Н2 воспользуйтесь h2.bat/h2.sh или h2w.bat. Для выполнения sql-скриптов для MySQL можно использовать консоль СУБД MYSQL, но лучше поспользоваться приложением MySQL Query Browser, её вы можите бесплатно скачать из Internet и установить на свой компьютер. Добавте пользователя СУБД и дайте ему доступ до созданной БД.
В настройках СУБД MySQL есть параметр wait_timeout, это время в секундах, на протяжении которого сервер наблюдает неактивность в неинтерактивном соединения прежде, чем закрыть его. Значение по умолчанию 28800 секунд. Если сервер сстемы остается работать, к примеру, на ночь или продолжнительные праздники, то при начале работы произойдет ошибка, т.к. СУБД на обработает запрос. Этот параметр можно указать в конфигурационном файле MySQL. Часто в Windows это файл my.ini, точнее посмотреть в настройках сервера в приложении MySQL Administrator. Добавить в этот файл строчку "wait_timeout=хххх". Сервер имеет функционал для поддержания соединения путем опроса СУБД раз в час. Учтите это если у вас более жесткие настройки.

Шаг8. Настройка системы для использования БД.
В папке приложения запустите admdbcom.bat для OS Windows или admdbcom.sh для OS Linux. admspt.bat для консольной настройки. Введите правильные данные касательно соединения с БД. Сохраните параметры. Серверов БД можно завести несколько. Пометьте один из них как текущий и применяться будут настройки текущего сервера.

Шаг 9. Заполнение конфигурации и настройка сервера.

Запустите StartAdmin.bat. Первоначально войдите в программу администрирования под пользователем "Администратор" с пустым паролем. Заполните список операторов, составьте дерево услуг, назначте услуги операторам. Позаботьтесь об расписании оказания услуг. Не забудьте сохранить изменения.

Шаг 10. Позиционирования главного и опрераторских табло.

Начиная с версии 1.3.7 для главного или операторского табло укажите номер монитора в редакторе табло в параметрах центральной части "Номер дополнительного монитора для табло". Этого достаточно. Если монитор не подключен, то будут использоваться координаты из clientboard.xml и mainboard.xml. Если номер указан 0, то табло считается отключенным.

Для более старых версий. В папке <Qsystem>\config\ есть 2 файлика: clientboard.xml и mainboard.xml (для клиенской машины и для сервера соответственно). В них и указываются координаты позиционирования табло, там-же его можно отключить\включить. Если второй монитор не подключен программа раскрывает всё на одном мониторе. Что-бы табло попадало на второй монитор, нужно указать в clientboard.xml и mainboard.xml координаты, которые находятся на втором мониторе. В настроечных файлах выставить параметры х и у:
<Board visible="1" x="-500" y="10" Наименование="Сохранить конфигурацию табло">

По ним будет определено расположение табло и развернуто на весь второй монитор. Когда подключается второй монитор, то нужно на него расширить рабочий стол. Это расширение рабочего стола будет иметь координаты относительно основного рабочего стола. В настройках нужно указать координаты точки попадающей на это расширение. По этой точке будет позиционирование. Т.е. табло будет помещено левым верхним углом в эту точку. Помним что координаты левого верхнего угла основного монитора (0,0). К примеру, подключен доп.монитор и рабочий стол расширен на него как бы слева от основного. Доп. монитор имеет расширение 640х480. Относительно главного рабочего стола левый верхний угол дополнительного рабочего стола имеет координаты (-640, 0). В настройках стоит x="-500" y="10", это значит табло позиционируется на доп.рабочий стол, но не в самый угол доп.монитора, а на 10 пикселов вниз и на 140 пикселов от края доп. монитора. И после этого развернется на весь экран.

После выполнения всех шагов система готова к использованию.