Tomcat Host manager#

Tomcat Host Manager (далее – Host Manager) позволяет создавать, удалять и управлять виртуальными хостами. Приложение является частью установки Tomcat и по умолчанию доступно по контекстному пути /host-manager.

Существует два режима использования Host Manager:

  • графический интерфейс, доступный по адресу {server}:{port}/host-manager/html;

  • набор минимальных HTTP-запросов, подходящих для написания скриптов. Доступен по адресу: {{server}:{port}/host-manager/text.

Где:

  • server - имя севера;

  • port - номер порта.

Часто используемые команды Host Manager представлены в таблице ниже.

Команды Host Manager#

Команда

Описание

list

Посмотреть доступные виртуальные хосты

add

Добавить новый виртуальный хост

remove

Удалить виртуальный хост

start

Запустить виртуальный хост

stop

Остановить виртуальный хост

persist

Сохранить виртуальный хост

Часто используемые параметры команды add представлены в таблице ниже.

Параметры команды add#

Параметр

Описание

string name

Имя виртуального хоста

string aliases

Псевдонимы виртуального хоста

string appBase

Базовый путь для приложения, которое будет обслуживаться виртуальным хостом

boolean manager

В значении true приложение Manager добавляется на виртуальный хост

boolean autoDeploy

В значении true Tomcat автоматически заново развертывает приложения, размещенные в каталоге appBase

boolean deployOnStartup

В значении true Tomcat при запуске автоматически развертывает приложения, размещенные в каталоге appBase

boolean deployXML

В значении true Tomcat читает и использует файл /META-INF/context.xml

boolean copyXML

В значении true Tomcat копирует файл /META-INF/context.xml и использует оригинальную копию, независимо от обновлений файла в приложении

Примеры использования#

  • Используйте команду list, чтобы увидеть доступные виртуальные хосты:

curl -u test:test http://localhost:0000/host-manager/text/list

Пример вывода команды:

OK - Listed hosts
localhost:
  • Используйте команду remove, чтобы удалить виртуальный хост:

curl -u test:test http://localhost:0000/host-manager/text/remove?name=wwww.exampleserver.ru

Пример вывода команды:

remove: Removing host [wwww.exampleserver.ru]
  • Используйте команду add, чтобы добавить виртуальный хост:

curl -u test:test http://localhost:8080/host-manager/text/add?name=www.exampleserver.ru&aliases=awesomeserver.ru&appBase/mnt/appDir&deployOnStartup=true

Пример вывода команды:

add: Adding host [www.exampleserver.ru]