Приток-Охрана-WEB 3.0.0 (4) ======================================== Описание ======================================== Приложение «Приток-Охрана-WEB» входит в состав программного обеспечения ИС ОПС Приток-А. «Приток-Охрана-WEB» предназначен для организации удаленного доступа к информации по охраняемым на ПЦН объектам для: - сотрудников обслуживающих организаций, - собственников квартир (частных домов, гаражей), - реагирующих организаций (ЧОП). Доступ обеспечивается в режиме реального времени (online) через web-интерфейс «Обслуживание», «Мониторинг» и «Реагирование» соответственно. ======================================== Технические требования ======================================== - JAVA 23 - Apache Tomcat 11 (рекомендовано: 11.0.2) ======================================== Установка ======================================== ?ВНИМАНИЕ! Приведенная ниже инструкция содержит только общие положения и некоторые рекомендации по настройке и запуску сервера Apache Tomcat. О детальной настройке можно прочитать по адресу: tomcat.apache.org, www.oracle.com или обратитесь к специалисту. [WINDOWS] - Установка с помощью инсталлятора: 1 Запустить Pritok_GRD_WEB_Setup.exe и следовать инструкциям по установке. Рекомендуется предварительно удалить предыдущю версию. -Ручная установка: 1 Установка и настройка Java Runtime Environment 1.1 Скачать архив JDK, удовлетворяющей тех. требованиям: https://www.oracle.com/java/technologies/downloads/ или воспользоваться одной из версий дистрибутива distr/java/win-* 1.2 Распаковать архив (например, ~путь_jdk~ = c:\jdk) 1.3 Установить переменную окружения: JAVA_HOME=~путь_jdk~ (см. примечание 1) или см. п.2.10 2 Установка и настройка Apache-Tomcat 2.1 Подготовка к установке 2.1.1 Скачать архив Tomcat: https://tomcat.apache.org/download-11.cgi 2.1.2 Распаковать архив (например, ~путь_tomcat~ = c:\apache-tomcat) 2.1.3 Редактировать ~путь_tomcat~\conf\server.xml 2.1.3.1 Внутри тега закомментировать все вхождения тега и добавить тег, куда ввести свой !порт! для подключения: 2.1.4 Редактировать ~путь_tomcat~\conf\tomcat-users.xml 2.1.4.1 Внутрь тега добавить тег, куда ввести свои !имяпользователя! и !пароль!: 2.1.5 (необязательно) Из папки ~путь_tomcat~\webapp удалить ВСЕ папки, КРОМЕ "manager" и "host-manager" 2.1.6 (для ограничения доступа к системе управления сервером "manager") В папке ~путь_tomcat~\conf\catalina\localhost создать файл manager.xml с текстом, где вместо !разрешенныеадреса! ввести свое регулярное выражение (например, "127.0.0.1" - только для локальный доступ): 2.1.7 Из дистрибутива Приток-Охрана скопировать файл "extras\setenv.bat" в ~путь_tomcat~\bin 2.1.8 (пропустить если был выполнен п.1.3) Редактировать файл ~путь_tomcat~\bin\setenv.bat 2.1.8.1 Добавить первой строчкой: set "JAVA_HOME=~путь_jdk~" (см. примечание 1); 2.2 Установка и запуск (необходимо выбрать один подпункт) 2.2.А Запуск приложения 2.2.А.1 Выполнить ~путь_tomcat~\bin\startup.bat 2.2.Б Установка службы 2.2.Б.1 Редактировать ~путь_tomcat~\bin\service.bat 2.2.Б.1.1 Найти блок кода под меткой "foundJvm" и отредактировать параметры выполнения (см. примечание 3): 2.2.Б.1.1.1 --JvmMs минимальный размер выделенной памяти в Мб рекоменд. 256 2.2.Б.1.1.2 --JvmMx ограничение на размер выделяемой памяти в Мб рекоменд. 1024 + 64 * [предполагаемое число объектов / 1000] 2.2.Б.1.1.3 --JvmOptions настройки Java-окружения рекоменд. наличие -XX:OnOutOfMemoryError=taskkill /F /PID %%p; 2.2.Б.1.2 Найти блок кода под меткой "installed" и добавить: 2.2.Б.1.2.1 sc failure %SERVICE_NAME% command= "msg * Service '%SERVICE_NAME%' was down" reset= 600 actions= restart/0/restart/300000/run/0 настройка автоматического перезапуска службы по схеме: сбой 1 -> немедленный перезапуск сбой 2 -> перезапуск с задержкой в 5 мин. сбой 3 -> вывод сообщения о падении сервера таймаут сброса счетчика сбоев - 10 мин. 2.2.Б.1.2.2 sc config %SERVICE_NAME% obj= LocalSystem password= "" start= auto изменить параметры службы для автоматического запуска с системной учетной записью 2.2.Б.1.2.3 sc start %SERVICE_NAME% запуск службы сразу после установки 2.2.Б.2 Открыть командную строку в контексте ~путь_tomcat~\bin и выполнить: call setenv service install ~имяслужбы~ sc start ~имяслужбы~ 3 Установка приложения (см. примечание 2) 3.1 (пропустить если !имядоменаверхнегоуровня! = "grdweb") Переименовать файл из дистрибутива Приток-Охрана: grdweb##3.0.0 (XX).war, где в имени файла заменить "grdweb" на !имядоменаверхнегоуровня! для установки Приток-Охрана (если требуется установить Приток-Охрана в корневой домен, заменить на "ROOT") 3.2 Открыть браузер и перейти по адресу, где указать, указанный ранее, !порт!: http://localhost:!порт!/manager 3.3 Ввести, указанные ранее, !имяпользователя! и !пароль! 3.4 На открывшейся странице в категории "WAR file to deploy" нажать "Обзор", выбрать файл из дистрибутива Приток-Охрана: !имядоменаверхнегоуровня!##3.0.0 (XX).war и нажать "Deploy" [LINUX] 1 Установка и настройка Java Runtime Environment 1.1 Скачать архив JDK, удовлетворяющей тех. требованиям: http://www.oracle.com/technetwork/java/javase/downloads/ или воспользоваться одной из версий дистрибутива distr/java/nix-* 1.2 Распаковать архив (например, ~путь_jdk~ = /opt/jdk) 2 Установка и настройка Apache-Tomcat 2.1 Подготовка к установке 2.1.1 Скачать архив Tomcat: https://tomcat.apache.org/download-11.cgi 2.1.2 Распаковать архив (например, ~путь_tomcat~ = /opt/apache-tomcat) 2.1.3 Редактировать ~путь_tomcat~/conf/server.xml 2.1.3.1 Внутри тега закомментировать все вхождения тега и добавить тег, куда ввести свой !порт! для подключения: 2.1.4 Редактировать ~путь_tomcat~/conf/tomcat-users.xml 2.1.4.1 Внутрь тега добавить тег, куда ввести свои !имяпользователя! и !пароль!: 2.1.5 (необязательно) Из папки ~путь_tomcat~/webapp удалить ВСЕ папки, КРОМЕ "manager" 2.1.6 (для ограничения доступа к системе управления сервером "manager") В папке ~путь_tomcat~/conf/catalina/localhost создать файл manager.xml с текстом, где вместо !разрешенныеадреса! ввести свое регулярное выражение (например, "127.0.0.1" - только для локальный доступ): 2.1.7 Из дистрибутива Приток-Охрана скопировать файл "extras/setenv.sh" в ~путь_tomcat~/bin 2.1.8 Редактировать файл ~путь_tomcat~/bin/setenv.sh 2.1.8.1 Добавить первой строчкой: export "JAVA_HOME=~путь_jdk~" (см. примечание 1); 2.2 Установка и запуск (необходимо выбрать один подпункт) 2.2.А Запуск приложения 2.2.А.1 В папке ~путь_tomcat~/bin разрешить выполнение файлов .sh: chmode +x *.sh 2.2.А.2 Выполнить скрипт ~путь_tomcat~/bin/startup.sh 3 Установка приложения (см. примечание 2) 3.1 (пропустить если !имядоменаверхнегоуровня! = "grdweb") Переименовать файл из дистрибутива Приток-Охрана: ROOT##3.0.0 (XX).war, где в имени файла заменить "grdweb" на !имядоменаверхнегоуровня! для установки Приток-Охрана (если требуется установить Приток-Охрана в корневой домен, заменить на "ROOT") 3.2 Открыть браузер и перейти по адресу, где указать, указанный ранее, !порт!: http://localhost:!порт!/manager 3.3 Ввести, указанные ранее, !имяпользователя! и !пароль! 3.4 На открывшейся странице в категории "WAR file to deploy" нажать "Обзор", выбрать файл из дистрибутива Приток-Охрана: !имядоменаверхнегоуровня!##3.0.0 (XX).war и нажать "Deploy" Примечание: 1 При установке новой версии приложения на сервер с уже развернутым приложением рекомендуется: удалить приложение, перезапустить сервер, установить новое приложение. 2 Все рекомендации по установке параметров носят эвристический характер и не учитывают возможные индивидуальные особенности. ======================================== Администрирование ======================================== Панель администратора находитс по адресу (пароль по умолчанию: admin): http://!адреспритокохрана!/admin Логи приложени находятся по адресу: [WINDOWS] ~путь_tomcat~\logs\sokrat\grdweb\!версияпритокохрана!\ [NIX] ~путь_tomcat~/logs/sokrat/grdweb/!версияпритокохрана!/ ======================================== Поддержка ======================================== ?ООО Охранное бюро "СОКРАТ", г. Иркутск www.sokrat.ru Тел. (3952) 20-66-69 Тех. поддержка: 8-800-333-66-70