Установка и настройка сервера Tomcat (backend) - LamronNu/i GitHub Wiki

Способ 1. Запуск wf-central и/или wf-region на встроенном Томкате с помощью Maven

  1. Убедиться, что в блоках plugin у wf-central/pom.xml i wf-region/pom.xml проставлены неконфликтные порты для локального запуска:

org.apache.tomcat.maven tomcat7-maven-plugin 8081 /wf-region 4000 local ```
  1. Проект собираем командой mvn tomcat7:run-war

  2. Переходим по урлу http://localhost:8081/wf-region/


###Способ 2. Запуск wf-central и/или wf-region на автономном (standalone) Томкате

  1. Скачать Томкат https://tomcat.apache.org/download-80.cgi

  2. Собрать варники

    2.1. Выполнить команду mvn clean install

    2.2. Появятся файлы wf-region/target/wf-region.war и wf-central/target/wf-central.war

  3. Настроить Томкат в Еклипсе

    3.1. Создадим проект в eclipse для более удобной работы с сервером Tomcat:

    • File->new-> Other->Server->Server
    • выбираем Apache -> свою версию tomcat-> указываем директорию установленного локально tomcat и jre-> Finish

    3.2. Настройки:

    • Window-ShowView-Server-Server
    • Правой кнопкой - Properties - Generel-SwitchLocation-Apply-ok
    • Двойной щелчок по серверу и в открывшемся окне выберем:
      • Use Tomcat Installation
      • Deploy path - путь к папке webapp
    • в разделе Server Options отмечаем три первых галочки
    • open launch configuration -> Arguments-> Vm arguments-> доставляем системную переменную -Dspring.profiles.active="local"

    3.3. Запуск Tomcata:

    • Правой кнопкой - Start
    • Переходим по ссылке http://localhost:8080/manager/html и деплоим варник проекта (см. ниже "Tomcat Web Application Manager").

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


Tomcat Web Application Manager

Для быстрого старта можно использовать Tomcat Web Application Manager:

  1. После установки tomcat :
    • проверить в каталоге webapps/ должны быть проекты: host-manager, manager.
    • в каталоге ../conf в файле tomcat-users.xml раскомментарить role и user и добавить роль manager-gui:
- **P.S.** Если нет проектов host-manager, manager, то скачать и подложить в нужную директорию.
  1. После локального запуска Tomcat (bin/startup.bat) перейти по ссылке: http://localhost:8080/manager/html/

  2. Откроется окно, в нем нужно задеплоить wf-central.war (или wf-region.war):

    • в разделе WAR file to deploy выбираем war-ик (директория: wf-central/target/wf-central.war) и нажимаем Deploy
    • окне Applications добавится диретория /wf-dniprorada переходим по ней и мы в активити

Ссылка для дополнительной информации: http://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html

P.S. в версии apache-tomcat-7.0.59-windows-x64 уже встроенный manager

Настройка работы локального wf-central с локальным wf-region

По умолчанию, wf-central работает с тестовым хостом https://test.region.igov.org.ua/, поэтому даже с локальным Томкатом, будут испольняться сервисы https://test.region.igov.org.ua/wf-region/, а не http://localhost:8081/wf-region/ . Для того, чтобы настроить связку локального wf-central и локального wf-region, необходимо:

  • Заменить у файле wf-central/src/main/resources/data/ServiceData.csv все вхождения https://test.region.igov.org.ua/wf-region/ на http://localhost:8081/wf-region/
  • Добавить этот файл в локальный игнор-лист (right click -> Team -> Advanced -> Assume Unchanged) - файл не должен быть залит в репозиторий.
  • пересобрать варники и передеплоить их.

Проверка работоспособности webapp-ов

Для проверки можно выполнить любой из сервисов, описанных у iGov.ua APIs . Например:

⚠️ **GitHub.com Fallback** ⚠️