Настройка файлов конфигурации tomcat

Обновлено: 07.07.2024

Tomcat на Ubuntu не устанавливается из репозитория (в отличие от некоторых других дистрибутивов Linux, например, CentOS). Поэтому в данной инструкции мы выполним ручную установку — развертывание дополнительных компонентов (Java), загрузку и распаковку пакета веб-сервера Tomcat, а также настройку его автоматического запуска в случае сбоя или после перезагрузки системы. На момент обновления инструкции использовался Tomcat версии 10 и Ubuntu 20.04.

Подготовка системы

Обновляем список пакетов в репозиториях:

Задаем имя серверу:

Настраиваем часовой пояс, например:

timedatectl set-timezone Europe/Moscow

* где Europe/Moscow — московское время. Список всех возможных зон смотрим командой timedatectl list-timezones.

Устанавливаем сервис для автоматической синхронизации времени, а также разрешаем его автозапуск:

apt-get install chrony

systemctl enable chrony

Если мы используем брандмауэр, необходимо открыть порт 8080:

iptables -A INPUT -p tcp --dport 8080 -j ACCEPT

* 8080 — порт по умолчанию, на котором работает Tomcat. Если мы заходим поменять данный порт, то нужно будет открыть именно его.

Сохраняем правила — для этого устанавливаем утилиту iptables-persistent:

apt-get install iptables-persistent

Если в процессе установки мы отказались сохранять правила, выполняем команду:

Можно приступать к установке Java.

Подготовка к установке

Для работы веб-сервера нам необходимы Java и пользователь, под которым будет работать Tomcat.

Установка JAVA

Мы установим пакет openjdk. Для этого вводим команду:

apt-get install default-jdk

* будет установлена последняя версия, максимально совместимая с используемой версией операционной системы Ubuntu.

Если в системе окажется несколько версий java, выберем последнюю. Для этого вводим команду:

update-alternatives --config java

. и выбираем в списке соответствующий вариант.

Проверяем используемую версию java:

Мы должны увидеть что-то на подобие:

openjdk version "14.0.2" 2020-07-14
OpenJDK Runtime Environment (build 14.0.2+12-Ubuntu-120.04)
OpenJDK 64-Bit Server VM (build 14.0.2+12-Ubuntu-120.04, mixed mode, sharing)

Создание пользователя

Создаем пользователя командой:

useradd tomcat -U -s /bin/false -d /opt/tomcat -m

* в итоге будет создан пользователь tomcat со следующими опциями:

  • -U — также будет создана группа с таким же именем, что и пользователь.
  • -s /bin/false — запрещает пользователю интерактивный вход в систему.
  • -d /opt/tomcat — указывает путь до домашней директории пользователя.
  • -m — сразу создает домашнюю директорию пользователю.

Можно приступать к установке веб-сервера Apache Tomcat.

Установка Tomcat

Переходим на страницу официального сайта веб-сервера. В меню слева выбираем необходимую версию Tomcat:

Переходим на страницу загрузки последней версии Tomcat

* на момент обновления статьи, последняя версия была 10.

Копируем ссылку на архив tar.gz:

Копируем ссылку на архив tar.gz с веб-сервером

Используя скопированную ссылку, скачиваем архив на наш сервер:

Распаковываем содержимое архива в каталог /opt/tomcat:

tar zxvf apache-tomcat-*.tar.gz -C /opt/tomcat --strip-components 1

Готово. Можно запустить сервер командой:

Стартовая страница Tomcat Server

Наш сервер работает.

Посмотреть версию установленного программного обеспечения можно командой:

java -cp /opt/tomcat/lib/catalina.jar org.apache.catalina.util.ServerInfo

Мы должны увидеть что-то на подобие:

Настройка автозапуска

Для начала, остановим работу Tomcat:

Поменяем владельца для всех файлов в каталоге /opt/tomcat:

chown -R tomcat:tomcat /opt/tomcat

Создадим конфигурационный файл для нового юнита:

[Unit]
Description=Apache Tomcat Server
After=network.target

[Service]
Type=forking
User=tomcat
Group=tomcat
Environment="JAVA_HOME=/usr/lib/jvm/default-java"
Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom -Djava.awt.headless=true"
Environment="CATALINA_BASE=/opt/tomcat"
Environment="CATALINA_HOME=/opt/tomcat"
Environment="CATALINA_PID=/opt/tomcat/temp/tomcat.pid"
Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC"
ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh
Restart=on-failure
RestartSec=10

* где обращаем внимание на:

  • User/Group — пользователь и группа пользователя, от чьего имени будет работать сервис.
  • Environment — переменные окружения. В нашем примере задается несколько для нормальной работы Java и Tomcat.
  • ExecStart/ExecStop — пути к скриптам, которые запускают или останавливают работу службы веб-сервера.
  • Restart/RestartSec — задают поведение сервиса при необходимости выполнить перезапуск. В нашем примере выполнять при сбое с интервалом в 10 секунд.

Из данных опций, возможно вам захочется поменять CATALINA_OPTS, например, задать другие значения для выделения памяти или указать определенный порт. Остальные опции можно оставить.

Перечитываем новый конфигурационный файл в systemd:

Стартуем наш сервис:

systemctl start tomcat

Проверяем, что он запустился и работает:

systemctl status tomcat

Мы должны увидеть что-то на подобие:

• tomcat.service - Apache Tomcat Server
Loaded: loaded (/etc/systemd/system/tomcat.service; disabled; vendor preset: enabled)
Active: active (running) since Tue 2021-02-09 10:30:25 UTC; 22h ago
Main PID: 14645 (java)

При необходимости перезапуска сервиса, можно будет использовать команду:

systemctl restart tomcat

Теперь открываем нашу страницу по IP-адресу сервера — мы снова должны увидеть стартовую страницу Tomcat.

Доступ к Managing Tomcat

Мы можем использовать веб-интерфейс для управления Tomcat. Для этого используются кнопки на стартовой странице:

  • Server Status
  • Manager App
  • Host Manager

По умолчанию, доступ закрыт в данные разделы. Пошагово, настроим доступ в каждый из них.

Создание служебного пользователя

Создаем пользователя, под которым мы будем авторизовываться в системе.

Внутрь раздела tomcat-users добавим:

* в данном примере мы создадим пользователя admin с паролем password и ролями admin-gui, manager-gui.

systemctl restart tomcat

Server Status и Manager App

Разделы позволяют получить доступ к статистике и управлению веб-приложениями. Они настраиваются вместе.

. и добавляем IP-адрес компьютера, с которого будем подключаться, например:

* в данном примере мы добавили адрес 192.168.1.15, которому разрешаем подключаться к статистике сервера и управлению веб-приложениями.

Пробуем зайти на стартовую страницу и перейти в раздел Server Status:

Server Status на стартовой странице Tomcat Server

Браузер запросит логин и пароль — вводим созданные ранее данные (admin и password). Мы должны увидеть статистику.

Теперь переходим в раздел Manager App:

Manager App на стартовой странице Tomcat Server

Мы должны увидеть раздел «Управление веб-приложениями Tomcat».

Host-Manager

В данном разделе можно управлять виртуальными серверами.

. и добавляем IP-адрес компьютера, с которого будем подключаться, например:

* в данном примере мы добавили адрес 192.168.1.15, которому разрешаем подключаться к управлению виртуальными серверами.

Пробуем зайти на стартовую страницу и перейти в раздел Host Manager:

Host Manager на стартовой странице Tomcat Server

Мы должны увидеть раздел «Управление виртуальными серверами Tomcat».

Поменять порт

По умолчанию, Tomcat запускается на порту 8080. Чтобы сменить номер, открываем файл:

В данном документе представлена информация о базовой установке Apache Tomcat 7 на CentOS 7, первоначальной настройке и запуске приложений.

Общие сведения

Архитектура

Установка

В этой главе описана информация о базовой установке Apache Tomcat сервер 7 при помощи менеджера пакетов yum и из файла дистрибутива (с сайта проекта) на сервер CentOS 7. Apache Tomcat сервер – это серверное ПО для исполнения web-приложений, написанных на Java. Поэтому, предполагается, что у вас уже установлена Java Runtime Environment (JRE).

Установка с помощью менеджера пакетов

Проверить, установлен ли уже Apache Tomcat через менеджер пакетов, можно командой:

Установить Tomcat, используя менеджер пакетов, можно следующей командой:

После выполнения этой команды будет установлен сервер Tomcat 7 и все его зависимости. Кроме того, команда создаст пользователя tomcat.

Данное руководство подразумевает установку нескольких дополнительных пакетов, которые помогут управлять web-приложениями. Чтобы установить стандартную root-страницу (tomcat-webapps), менеджер веб-приложений и виртуальных хостов Tomcat (tomcat-admin-webapps), выполните команду:

После этого в каталоге tomcat/webapps появятся веб-приложения ROOT, examples, sample, manager и host-manager.

Установка из файла дистрибутива

В некоторых случаях установка ПО с помощью пакетного менеджера невозможна. Тогда используется способ установки из файла дистрибутива. Общий подход в работе Apache Tomcat остается таким же, но есть ряд отличий в установке и запуске.

Чтобы установить Apache Tomcat сервер, необходимо c сайта проекта (или дистрибутива ПО) взять файл apache-tomcat-7.0.67.zip и распаковать его в папку /home/user/tomcat, а потом перенести в /usr/share/tomcat7

Компиляция из исходного кода

Установка JDBC-драйвера

Неофициальным стандартом, которому следуют программы на языке Java, осуществляя доступ к реляционным базам данных, является JDBC. JDBC – это стандартный API-¬интерфейс, посредством которого Java-программы могут получать доступ к внешним менеджерам ресурсов, главным образом к реляционным базам данных, независящим от менеджера ресурсов способом. То есть Java-приложение, написанное с применением стандартных классов и интерфейсов JDBC, может переноситься на базы данных других производителей реляционных СУБД, если они поддерживают SQL, удовлетворяющий стандарту ANSI.

Далее, нужно добавить следующие строки внутри тега «Context» в файл /usr/shatre/tomcat/conf/context.xml:

Теперь JNDI-ресурс настроен.

После того, как вы разместили jar-файл драйвера в нужном каталоге, и внесли необходимые изменения в файл «context.xml» необходимо перезапустить Apache Tomcat

Настройка

Каталоги и файлы

После установки, в системе будут созданы следующие файлы и каталоги:

  • /usr/share/tomcat/bin: содержит управляющие скрипты;
  • /etc/tomcat: конфигурационные файлы (server.xml, web.xml, context.xml, tomcat-users.xml);
  • /usr/share/java/tomcat: jar-файлы, используемые всеми расширениями Tomcat и веб-приложениями;
  • /var/log/tomcat: log-файлы;
  • /srv/tomcat/webapps: каталог, содержащий веб-приложения (сервлеты и JSP);
  • /var/cache/tomcat/work: рабочий каталог Tomcat, который используется, в первую очередь, при преобразовании JSP-страниц в сервлеты;
  • /var/cache/tomcat/temp: временные файлы.

В каталоге /usr/share/tomcat будут, также, размещены симлинки на указанные каталоги. Путь к основному каталогу Tomcat можно записать в переменную окружения $CATALINA_HOME (export CATALINA_HOME='/usr/share/tomcat/').

Для настройки сервера Tomcat используются следующие конфигурационные XML-файлы, размещенные в каталоге /usr/share/tomcat/conf/:

  • server.xml: Общие настройки сервера (порты, виртуальные хосты и проч.).
  • web.xml: Параметры, общие для ВСЕХ веб-приложений на текущем сервере. Настройки отдельных веб-приложений задаются в их собственных файлах /WEB-INF/web.xml (здесь можно провести аналогию с использованием файла .htaccess в Apache).
  • context.xml: Общие настройки управления контентом.
  • tomcat-users.xml: Список пользователей и групп (ролей).

Внимание: Прежде чем вносить какие-либо изменения в эти файлы, стоит сделать их резервные копии. Также следует обращать внимание на комментарии, которыми снабжены эти файлы

Настройка портов подключений и межсетевого экрана

Настройка портов подключений

Для того, чтобы сменить порт Apache Tomcat, отредактируйте файл конфигурации server.xml в каталоге /etc/tomcat/server.xml. Найдите строку "<Connector port="8080" protocol="HTTP/1.1"" и замените номер порта. Аналогично с портом 8009:

После этого перезапустите Tomcat для того, чтобы изменение настроек вступило в силу.

Настройка межсетевого экрана (firewall)

После установки Tomcat необходимо убедиться, что в файле конфигурации (/etc/firewalld/zones/public.xml) межсетевого экрана открыты порты, по которым будут обращения к серверу web-приложений из браузера. Чтобы открыть порт 8080 (который используется Tomcat по-умолчанию), выполните команду:

И перезагрузите сетевой экран

В результате вышеописанных действий, файл конфигурации межсетевого экрана будет выглядеть следующим образом (добавилась предпоследняя строка):

Настройка ролей и прав доступа пользователей

Для управления пользователями и ролями Tomcat используется файл tomcat-users.xml, расположенный в каталоге /usr/share/tomcat/conf. Например, чтобы пользоваться ранее установленным менеджером веб-приложений, необходимо добавить соответствующего пользователя на сервер Tomcat. Для этого нужно отредактировать вышеупомянутый файл, добавив в него данные о пользователе, который получит доступ к manager-gui и admin-gui (ранее установленному интерфейсу). Для этого используйте следующий формат, указав имя и пароль пользователя:

Файл содержит подсказки по его настройке. Чтобы создать, например, пользователя manager, который сможет управлять веб-приложениями через графическую оболочку (предопределенная роль manager-gui), нужно добавить в этот файл запись вида:

Сохраните и закройте файл tomcat-users.xml Обратите внимание, что в Tomcat 7 нет единой роли «manager», а существуют отдельные роли для администрирования:

  • manager-gui - позволяет администрировать через веб-интерфейс;
  • manager-script - позволяет администрировать через скрипты;
  • manager-jmx - позволяет администрировать через JMX прокси;
  • manager-status - дает доступ только к странице статуса сервера.

Например, для развертывания web-приложений через Maven необходимо присвоить пользователю роль «manager-script». В файле tomcat-users.xml описание этой роли будет выглядеть следующим образом:

Настройка переменных среды исполнения

Переменные среды окружения не используются Java-приложением Tomcat – вся настройка переменных происходит в стартовых скриптах. Но в некоторых случаях все же может понадобиться настройка некоторых переменных. Обратите внимание на то, что если у вас установлено несколько JVM, по умолчанию Tomcat попробует использовать OpenJDK, затем пробует JVM от Oracle, а затем иные JVM. Если у вас будут проблемы, связанные с переменными среды исполнения, выполните следующие шаги:

  1. Установите переменную среды CATALINA_HOME и CATALINA_BASE
  2. Установить переменную среды JRE_HOME или JAVA_HOME. Переменная среды используется для указания расположения JRE или JDK. Если определены обе переменные, то используется JRE_HOME.
  3. Остальные переменные среды опциональны: CATALINA_OPTS, JAVA_OPTS, CATALINA_PID, JSVC
  4. Использование скрипта setenv для установки переменных среды (рекомендуется)

Настройка сервера-разработки

Если вы используете Tomcat на сервере разработки и/или тестирования, вам могут быть полезны следующие опции:

Автоматическая перезагрузка страниц

Имеется возможность заставить Tomcat выполнять автоматическую перезагрузку после изменения кода. Нужно добавить атрибут reloadable со значением "true" в элемент <Context> файла conf/context.xml. Это весьма полезно в процессе разработки и отладки сервлетов, но не рекомендуется в процессе постоянной работы web-приложения.

Включение листинга каталогов

Для установки отображения списка файлов в каталогах (листинга), нужно поменять значение атрибута listings с ложного (false) на истинное (true) в блоке настроек сервлета по умолчанию ("default"-servlet) в файле conf/web.xml. Это бывает полезным при разработке и отладке веб-приложений, но не рекомендуется использовать на production-сервере по соображениям безопасности.

Запуск

Запуск и остановка Tomcat

Tomcat-01.jpg

Если вы установили Tomcat с помощью менеджера пакетов, то для запуска сервиса Tomcat введите следующую команду:

Для того, чтобы перезапустить сервис (например, после внесения изменений в настройки), используется следующая команда:

Чтобы сервис Tomcat автоматически запускался на этапе загрузки сервера:


Рисунок N. Приветственная страница Tomcat.

Запуск при установке без использования менеджера пакетов

Запуск Tomcat может быть осуществлен с использованием следующих команд:


Скрипт catalina.sh используется для ручного запуска и остановки сервера Tomcat. Для автоматического запуска можно использовать скрипт:

Завершение работы Apache Tomcat:

Файлы вашего приложения нужно расположить в каталоге /usr/share/tomcat7/webapps, более подробная информация по развертыванию приложений в главе «Запуск приложений».

Менеджер Web-приложений

Tomcat-03.jpg

Рисунок N. Окно авторизации.

Для входа в менеджер web-приложений необходимо воспользоваться теми именем пользователя и паролем, которые были заданы при настройке пользователей и ролей. Web Application Manager используется для управления приложениями Java; он позволяет запускать, останавливать, перезапускать и удалять приложения. Также Web Application Manager позволяет выполнять диагностику приложений (например, обнаруживать утечки памяти). Кроме того, в самом низу этой страницы находится информация о сервере.

Tomcat-04.jpg

Рисунок N Основное окно менеджера web-приложений.

В разделе «Manager» есть ссылка «Server Status», для получения детального описания состояния сервера.

В разделе Applications перечислены веб-приложения, установленные на данном сервере, и есть кнопки для управления ими:

  • Start — запустить приложение;
  • Stop — остановить приложение, при этом сам сервер и остальные приложения продолжат работу;
  • Reload — перезапустить приложение;
  • Undeploy — удалить приложение;
  • Expire sessions with idle >= … minutes — считать веб-сессии пользователей истекшими по прошествии стольки-то минут без активности.

Раздел Deploy предназначен для инсталляции приложения из war-файла.

Diagnostics позволяет найти утечки памяти и принудительно запустить сборку мусора в JVM.

Web Application Manager сам является web-приложением, которое предварительно установлено в Tomcat. Следовательно, для того, чтобы Tomcat мог его использовать, это приложение должно быть запущено и присутствовать в списке приложений. Кроме менеджера web-приложенй (manager), в числе предустановленных часто бывает приложение для управления хостами (host-manager).

Установка и удаление web-приложений

Tomcat-06.jpg

Установка web-приложений

Существует два способа развертывания приложений.

Способ 1. Без использования менеджера приложений (Tomcat Web Application Manager):

  1. Скопировать war-файл в каталог <TOMCAT_HOME>\webapps
  2. Если Tomcat был запущен, то он сам развернет приложение из war-файла через несколько секунд (появится одноименный каталог). Либо самостоятельно перезапустите Tomcat, и он развернёт war.
  3. Проверьте работоспособность приложения, пройдя по соостветствующей ссылке.

Способ 2. С использованием менеджера приложений (Tomcat Web Application Manager):

После этого Tomcat самостоятельно скопирует war-файл к себе в каталог \webapps и развернет его. Web-приложение появится в списке Applications и вы сможете перейти к нему, кликнув по ссылке с соответствующим названием.

Удаление web-приложений Существует два способа развертывания приложений.

Способ 1. Без использования менеджера приложений (Tomcat Web Application Manager):

  1. Выключите Apache Tomcat сервер командой «systemctl stop tomcat»
  2. В каталоге \webapps удалите war-файл и одноименный каталог.
  3. В каталоге \conf\Catalina\localhost удалите одноименный xml.
  4. В каталоге \work\Catalina\localhost удалите одноименный каталог.

Последний шаг необязателен: удаляются временные файлы которые создал Tomcat.

Способ 2. С использованием менеджера приложений (Tomcat Web Application Manager):

Структура каталогов web-приложений

Web-app.jpg

Все web-приложения размещаются в каталоге webapps (/usr/share/tomcat/webapps). Каждое приложение размещается в собственном, одноименном, каталоге с определенной вложенной структурой. Например, для приложения websample структура каталогов должны быть следующей: webapps/websample/WEB-INF/classes. Соответственно, создать эту структуру можно так:

Изменение конфигурации Tomcat

Если вы знакомы с сервером Tomcat, установленным в качестве Web-контейнера, то вы знаете что он настраивается в документе XML с именем server.xml в каталоге conf , в котором Tomcat установлен. После интеграции в WASCE сервер Tomcat настраивается с помощью значений атрибутов, указанных в плане развертывания.

Интеграция Tomcat состоит из набора объектов GBean, каждый из которых представляет различные компоненты, контейнеры, коннекторы, службы, хосты, valve и области. План развертывания Tomcat задает, настраивает и организует компоненты в интеграции. В отличие от server.xml , в котором связанные компоненты вложены в элементы, описывающие их родительские компоненты, план развертывания использует среду WASCE для вставки указателей на связанные компоненты. Например, контейнер (также известный как служба Tomcat) содержит указатель на коннекторы службы, а служба содержит указатель на базе шаблона, собирающего все виртуальные хосты.

Изменения конфигурации, такие как изменение номеров портов коннектора, могут быть выполнены с помощью переопределения значений атрибутов в файле config-substitutions.properties (см. раздел Изменение номеров портов. Дополнительные изменения в конфигурацию сервера можно внести в файле config.xml .

Ниже приведен фрагмент файла config.xml.

Подробные инструкции по настройке коннекторов приведены в следующих разделах:

Кроме того значения конфигурации, влияющие на значения по умолчанию для всех Web-приложений, такие как спецификация сервлета по умолчанию, компилятор JSP, тайм-аут сеанса и преобразование типов MIME, можно найти в глобальном файле web.xml . Дополнительная информация приведена в разделе Каталог catalina.

Изменение номеров портов по умолчанию

Изменение номеров портов коннекторов - это самая распространенная операция настройки Tomcat. Для изменения номеров портов необходимо остановить сервер, отредактировать файл config-substitutions.properties и перезапустить сервер. Этот файл находится в каталоге

  • установочный-каталог \var\config\config-substitutions.properties
  • установочный-каталог /var/config/config-substitutions.properties

где установочный-каталог - это каталог установки сервера.

Дополнительные сведения приведены в разделе Быстрое внесение изменений в конфигурацию.

Элементы конфигурации кластера

Ниже перечислены параметры и атрибуты, которые необходимо настроить для стандартного кластера Tomcat.

  • Cluster
    • ClusterListenerChain
    • TomcatValveChain
    • Channel
      • Membership
      • Receiver
      • Sender
      • ChannelInterceptor
        • StaticMember

        Несмотря на то, что возможности кластеров Tomcat достаточны для работы со многими приложениями, они имеют некоторые ограничения:

        • Эта функция не поддерживает репликацию сеансовых объектов EJB с сохранением состояния. В распределенных приложениях рекомендуется избегать применения сеансовых объектов EJB с сохранением состояния.
        • Эта функция не поддерживает репликацию динамических обновлений интерфейса JNDI. Все имена JNDI, применяемые распределенными приложениями, потребуется вручную настроить на каждом узле кластера.
        • Эта функция не поддерживает репликацию распределяемых веб-приложений в другие узлы кластера. Распределяемые веб-приложения потребуется вручную развернуть на каждом узле.

        Кластерная конфигурация позволяет повысить масштабируемость и доступность веб-приложения. В следующих разделах приведены подробные инструкции по настройке узлов кластера.

        Настройка кластерной среды

        Планирование кластера

        Каждый узел передает данные своего сеанса всем остальным узлам, входящим в состав кластера. Такой алгоритм эффективен только для небольшого кластера. Если размер кластера становится слишком большим, дополнительная нагрузка по использованию памяти и обработке сетевого потока данных становится чрезмерной. Для того чтобы избежать чрезмерной дополнительной нагрузки рекомендуется разделить узлы на несколько небольших кластеров.

        Подготовка веб-приложения

        Для участия в конфигурации кластера веб-приложение должно быть реализовано правильным образом.

        Включение привязки сеансов

        Процесс настройки привязки сеансов на сервере CE аналогичен настройке веб-контейнера Tomcat. Для включения привязки сеансов необходимо внести изменения в файл servel.xml из каталога <CE_HOME>/var/catalina и настроить <Engine>, указав для атрибута jvmRoute уникальное для каждого узла кластера значение. После этого распределитель нагрузки вернет это значение в cookie сеанса или зашифрованном URL, возвращаемым в браузер. При поступлении связанного запроса это значение может использоваться для направления запроса в нужный узел. Пример:

          После остановки сервера внесите в файл server.xml каждого узла кластера следующие изменения:

        • nodeId - это уникальный в пределах кластера идентификатор узла. В случае применения mod_jk убедитесь, что значение атрибута jvmRoute совпадает с именем исполнителя, указанным в файл workers.properties .

        Включение распределения нагрузки и передачи управления

        Настройка кластера на уровне приложения

        Пример кластера Tomcat с конфигурацией многоадресной передачи

        Ниже приведен шаблон плана развертывания веб-приложения. Дополнительная информация о параметрах приведена в разделе Создание планов развертывания для веб-приложений.

        • web-cluster-server1 - имя файла WAR. Может быть разным для каждого узла кластера.

        На каждом узле разверните веб-приложение с помощью административной консоли или команды deploy:

        deploy --user имя-пользователя --password пароль deploy архив план

        • имя-пользователя - это имя пользователя, обладающего правами на управление сервером. Если эта опция не указана, вам будет предложено ввести имя пользователя.
        • пароль - пароль, применяемый для идентификации пользователя Если эта опция не указана, вам будет предложено ввести пароль.
        • архив - спецификация файла WAR веб-приложения.
        • план - спецификация файла плана развертывания.

        Примечание: после установки сервера по умолчанию применяется имя пользователя system с паролем manager.

        Пример кластера Tomcat с конфигурацией одноадресной передачи

        Ниже приведен фрагмент из примера кода кластера с конфигурацией одноадресной передачи. Статические элементы заданы с помощью org.apache.geronimo.tomcat.cluster.StaticMemberGBean . В плане развертывания необходимо указать каждый статический элемент, чтобы обеспечить правильную работу приложения в кластере и согласованное присвоение портов TCP для репликации сеансов на всех узлах.

        • IPAddress1 - IP-адрес или имя хоста текущего статического элемента.
        • TCP_port1 - номер порта TCP текущего узла, применяемого для приема данных о репликации сеансов от других статических элементов.
        • IPAddress2 - IP-адрес или имя хоста второго статического элемента.
        • TCP_port2 - номер порта TCP второго статического узла, применяемого для приема данных о репликации сеансов от других статических элементов.

        Для преобразования этого примера в конфигурацию многоадресной передачи удалите определения DisableMCastInterceptor, StaticMemberInterceptor и StaticMember. Кроме того, укажите значение "auto" для атрибута "address" в определении TomcatReceiver.

        Настройка кластера на уровне службы или хоста

        Процедура настройки кластера аналогична настройке автономного веб-контейнера Tomcat. Укажите все параметры конфигурации кластера в файле var/catalina/server.xml на сервере CE с учетом конкретных требований. Поддерживаются многоадресные и направленные рассылки. Следующие примеры кода помогают настроить кластер уровня службы или хоста. Эти сегменты должны входить в состав элемента <Engine> или <Host> в файле server.xml . $ извлекается из файла var/config/config-substitutions.properties , который должен совпадать на всех узлах кластера.

        Сведения о каждом компоненте кластера и параметры конфигурации приведены в документации по Tomcat: Кластеры Tomcat6.

        Читайте также: