Различия

Показаны различия между двумя версиями страницы.

--- onlineticket:102clientsettings [2016/02/16 12:35] – kalyapina
+++ onlineticket:102clientsettings [2023/07/21 09:11] (текущий) – внешнее изменение 127.0.0.1
@@ Строка 1: / Строка 1: @@
-======Настройка клиентской части системы Online-ticket=======
+====== Запуск и остановка клиента ======
-В настоящее время поддерживаются две разновидности программы клиента: одна для семейства операционных систем (ОС) Windows, другая – GNU/Linux. Клиент включает в себя 5 файлов:
+===== Запуск в ОС Windows =====
-  - Исполняемый файл: stat_client.exe – Windows, stat_client – Linux;
+Для того чтобы запустить клиент системы Online-ticket из командной строки в ОС Windows:
-  - Файл конфигурации (stat_client.conf – по умолчанию);
+  - Откройте папку установки системы Online-ticket.
-  - ca.crt – корневой сертификат (сертификат авторизационного центра);
+  - Запустите файл ''Stat_Client.exe''.
-  - «***».pem – сертификат пользователя;
-  - client.out – лог-файл.
+Если в файле конфигурации всё настроено верно, то в результате запуска клиента будет представлено пустое чёрное окно. Для администрирования работы системы используется файл системного журнала и папка хранилища.\\
-При запуске исполняемого файла с ключом --help программа выведет справку и прекратит работу.
+\\
-При подключении клиент посылает заявку в договорной отдел и скачивает с сайта необходимую ему версию ПО. Далее необходимо отредактировать файл конфигурации stat_client.conf, параметры, которые обязательно необходимо заполнить (поправить):
+===== Запуск в ОС семейства *nix =====
-  * connect – строка подключения к серверу, придет в письме;
+Для того чтобы запустить клиент системы Online-ticket из командной строки в ОС семейства *nix OS:
-  * ca_cert – сертификат придет в письме, называется ca.crt;
+  - Создайте папку ''/var/lock/'' или проверьте, что она уже создана.
-  * client_cert – сертификат клиента, придет в письме, содержит подстроку agn, ppr или awk, в зависимости от заказанной конфигурации;
+  - Обеспечьте доступ к папке ''/var/lock/''.
-  * storage – путь к директории, куда клиент будет сохранять файлы;
+  - Откройте папку установки системы Online-ticket.
-  * logger – путь к файлу, куда будет записываться лог.
+  - Запустите файл ''Stat_Client''.
-В конфигурационном файле, скачанном с сайта, есть примеры заполнения всех параметров.
-Во всех поддерживаемых ОС клиент можно запустить как из командной строки (вручную), так и в режиме демона (службы).
+Если в файле конфигурации всё настроено верно, то в результате запуска клиента будет отображаться только команда ''Stat_Client''. Для администрирования работы системы используется файл системного журнала и папка хранилища.\\
-<note important>При обновлении клиента на более новую версию перед ее установкой требуется удалить службу, созданную старой версией.
+\\
-</note>
+Для настройки запуска клиента применяются следующие ключи:
+  * //-d// – запуск в режиме демона;
+  * //-p stat_client.pid// – путь и имя файла, содержащего //pid// (путь по умолчанию: ''/var/run/stat_client/'');
+  * //-f stat_client.conf// – путь и имя файла конфигурации.
+Для того чтобы система Online-ticket запускалась вместе с загрузкой ОС:
+  * Добавьте команду ''<path>/Stat_Client'' в ''/etc/rc.local''.
+===== Запуск в режиме службы =====
+Для того чтобы запустить систему Online-ticket в режиме службы в ОС Windows:
+  - Запустите команду: ''stat_client.exe -i -f Tch.conf''.\\ В данной команде используются следующие ключи:
+    * //-i// – включение режима службы;
+    * //-f// – путь и имя файла конфигурации (по умолчанию – файл ''Stat_Client.conf'' из папки, где находится исполняемый файл).
+  - Нажмите кнопку **Пуск**, перейдите в **Панель управления** -> **Администрирование**, выберите раздел **Службы**. Будет представлено окно **Службы**.
+  - Найдите запись службы Online-ticket и в раскрывающемся списке действий над записью выберите пункт **Свойства**. Будет представлено окно **Свойства**: ''<Имя службы>''.
+  - Нажмите кнопку **Запустить** в разделе **Состояние**.
+  - Для того чтобы служба запускалась при загрузке ОС Windows, выберите опцию **Автоматически** в раскрывающемся списке раздела **Тип запуска**.
+  - Нажмите кнопку **OK** в нижней части окна для подтверждения установленных настроек. Служба Online-ticket будет запущена в выбранном режиме.
+===== Запуск двух служб/демонов на одном компьютере =====
+==== Две службы одновременно в ОС Windows ====
+Для получения XML файлов по двум разным сертификатам (например, двум агентствам) предусмотрена возможность запуска двух служб Online-ticket на одном компьютере.\\
+\\
+Первый способ такого запуска – установка системы дважды (в разные папки) и выполнение следующих шагов:
+  - Отредактировать каждый файл конфигурации.
+  - [[onlineticket:102clientsettings#запуск_в_режиме_службы|Запустить две службы]] с разными именами.
+Второй способ – создание двух конфигурационных файлов в одной папке установки системы и выполнение следующего шага:
+  * [[onlineticket:102clientsettings#запуск_в_режиме_службы|Запустить две службы]] с разными путями к соответствующему файлу конфигурации.
+<note important>При переименовании или перемещении папки установки системы Online-ticket требуется удалить и переустановить службы.</note>
+==== Два демона одновременно в ОС семейства *nix ====
+Для ОС семейства *nix также предусмотрено два способа запуска одновременно двух демонов системы Online-ticket.\\
+\\
+Первый способ – установка системы дважды (в разные папки) и выполнение следующих шагов:
+  - Отредактировать каждый файл конфигурации.
+  - Поочерёдно запустить разные клиенты системы в папках их установки, используя ключ -p [[onlineticket:102clientsettings#запуск_в_ос_семейства_nix|в командной строке]].
+Второй способ – создание двух конфигурационных файлов в одной папке установки системы и выполнение следующих шагов:
+  - Отредактировать каждый файл конфигурации.
+  - Дважды [[onlineticket:102clientsettings#запуск_в_ос_семейства_nix|запустить клиент системы]] с ключом //-p// и соответствующим ключом //-f//.
+Для дополнительной информации обратитесь в службу технической поддержки Help Desk:
+  * телефон: +7 (495) 725-09-00
+  * e-mail: [[helpdesk@sirena-travel.ru]].
+===== Остановка клиента =====
+==== Остановка клиента в ОС Windows ====
+Для остановки клиента системы Online-ticket:
+  * Закройте окно системы. Соединение с сервером будет прервано, и система прекратит работу.
+Для выключения режима службы:
+  * Запустите команду: ''stat_client.exe -u''.
+==== Остановка клиента в ОС семействе *nix ====
+Для остановки клиента системы Online-ticket:
+  * Запустите команду: ''stat_client -s -p stat_client.pid''.\\ В данной команде используются следующие ключи:
+    * //-s// – команда остановки
+    * //-p stat_client.pid// – путь и имя файла, содержащего //pid//.
+----
+См. далее:
+  * [[onlineticket:103description|Приложение 1. Описание XML-формата обменного файла]]
+  * [[onlineticket:104operations|Приложение 2. Описание полей XML документа]]
+  * [[onlineticket:105present|Приложение 3. Представление операций]]
+  * [[onlineticket:106comments|Приложение 4. Комментарии по заполнению]]
+{{tag>online-ticket}}