Apache Tomcat
Tomcat представляет веб-контейнер сервлетов и предназначен для работы с рядом технологий Java EE, в частности, с JSP, сервлетами и рядом других. Нередко Tomcat называют веб-сервером.
В данном случае мы будем использовать последнюю на сегодняшний день (29.08.2018) 9-ю версию. Для установки Tomcat перейдем на официальный сайт данного контейнера на странцу загрузок — https://tomcat.apache.org/download-90.cgi. На данной странице мы можем увидеть различные опции для загрузки: в виде архива, который достаточно распаковать, либо в виде инсталлятора.
В данном случае большой разницы не будет, какой именно пакет использовать. Но в моем случае для упрощения настройки я выберу пункт 32-bit/64-bit Windows Service Installer .
После выбора этой опции на компьютер будет загружен инсталлятор, который надо запустить.
Вначале надо принять лицензионное соглашение:
Затем надо настроить устанавливаемые компоненты:
Здесь можно выбрать те компоненты, которые мы хотим установить, в частности, можно выбрать пункт Service Startup , и тогда Tomcat будет запускаться автоматически при запуске системы. Можно выбрать все, а можно ограничиться теми компонентами, которые уже выбраны по умолчанию.
Далее будет предложено настроить порты и ряд дополнительных моментов конфигурации Tomcat:
Здесь стоит обратить внимание на пункт HTTP/1.1 Connector Port . Он указывает, по какому порту будет запускаться приложение. Укажем в этом поле номер 8081.
Затем надо будет указать версию java, которая будет использоваться:
По умолчанию инсталлятор должен определять путь к Java. Но естественно при необходимости его можно изменить. И в конце надо будет указать путь к устанавливаемому веб-контейнеру на жестком диске:
Также можно оставить путь по умолчанию. И после этого собственно произойдет установка контейнера.
После установки на финальном экране оставим отмеченнным пункт Run Apache Tomcat и нажмем на кнопку Finish. После этого Tomcat будет запущен, и мы сможем к нему обращаться.
Установка Apache Tomcat 9 в Ubuntu 18.04
Apache Tomcat — это веб-сервер и контейнер сервлетов, используемый для обслуживания приложений Java. Tomcat представляет собой реализацию технологий Java Servlet и JavaServer Pages с открытым исходным кодом, разработанную Apache Software Foundation. В настоящем руководстве описывается базовая установка и определенные моменты конфигурации последней версии Tomcat 9 на сервере Ubuntu 18.04.
Предварительные требования
Прежде чем начать изучение настоящего обучающего руководства, необходимо настроить на сервере стандартного пользователя без прав root и с привилегиями sudo . Вы можете узнать, как это сделать, из нашего руководства по начальной настройке сервера Ubuntu 16.04.
Шаг 1 — Установка Java
Tomcat требуется наличие на сервере Java, чтобы выполнять любой код веб-приложения Java. Мы можем удовлетворить это требование, установив OpenJDK с помощью apt.
Во-первых, обновите индекс пакетов apt:
Затем установите пакет для разработки Java с помощью apt:
Теперь, когда Java установлена, мы можем создать пользователя tomcat , который будет использоваться для запуска службы Tomcat.
Шаг 2 — Создание пользователя Tomcat
По соображениям безопасности Tomcat необходимо запускать с помощью пользователя без привилегий (т. е. без прав root). Мы создадим нового пользователя с группой, который будет запускать службу Tomcat.
Во-первых, создайте новую группу tomcat :
Далее создайте нового пользователя tomcat . Мы сделаем этого пользователя участником группы tomcat с домашней директорией /opt/tomcat (куда мы будем устанавливать Tomcat) и с оболочкой в /bin/false (чтобы никто не мог войти в учетную запись):
Теперь, когда наш пользователь tomcat настроен, мы загрузим и установим Tomcat.
Шаг 3 — Установка Tomcat
Лучшим способом установки Tomcat 9 является загрузка последней бинарной версии, а затем ее ручная настройка.
Найдите последнюю версию Tomcat 9 на странице загрузки Tomcat 9. На момент написания номер последней версии — 9.0.10, но вы должны использовать более позднюю стабильную версию, если такая будет доступна. Перейдите в раздел Binary Distributions (Бинарные дистрибутивы), а затем в списке Core скопируйте ссылку на файл tar.gz. В большинстве браузеров вы можете сделать это, нажав правой кнопкой мыши по ссылке и выбрав Скопировать адрес ссылки или похожий вариант.
Далее перейдите к директории /tmp на сервере. Эта директория отлично подходит для загрузки кратковременных элементов, таких как tar-архив (тарбол) Tomcat, который нам не потребуется после извлечения содержимого Tomcat:
Используйте curl для загрузки ссылки, скопированной на веб-сайте Tomcat:
Мы установим Tomcat в директорию /opt/tomcat . Создайте директорию, а затем извлеките туда архив с помощью этих команд:
Далее мы сможем настроить соответствующие разрешения пользователя для нашей установки.
Шаг 4 — Обновление разрешений
Пользователю tomcat , которого мы настроили, требуется доступ к установке Tomcat. Сейчас мы добавим нужные настройки.
Перейдите в директорию, куда мы распаковали установку Tomcat:
Предоставьте группе tomcat права владения для всей директории установки:
Далее предоставьте группе tomcat доступ для чтения для директории conf и всего ее содержимого, а также доступ execute для самой директории:
Сделайте пользователя tomcat владельцем директорий webapps , work , temp и logs :
Теперь, когда соответствующие разрешения настроены, мы сможем создать служебный файл systemd для управления процессом Tomcat.
Шаг 5 — Создание служебного файла systemd
Мы должны иметь возможность запустить Tomcat в качестве службы, поэтому мы настроим служебный файл systemd.
Tomcat должен знать, где установлена Java. Обычно этот путь называют JAVA_HOME. Самым простым способом поиска расположения является использование этой команды:
Outputjava-1.11.0-openjdk-amd64 1081 /usr/lib/jvm/java-1.11.0-openjdk-amd64 Ваш путь JAVA_HOME — это вывод из последнего столбца (выделено красным). Учитывая приведенный выше пример, для этого сервера правильное значение JAVA_HOME будет выглядеть таким образом:
JAVA_HOME/usr/lib/jvm/java-1.11.0-openjdk-amd64 Ваш путь JAVA_HOME может отличаться.
Получив эту информацию, мы сможем создать служебный файл systemd. Откройте файл tomcat.service в директории /etc/systemd/system с помощью следующей команды:
Добавьте следующее содержимое в служебный файл. Измените значение JAVA_HOME , если потребуется, согласно значению, которое вы используете в вашей системе. Также вы можете изменить параметры распределения памяти, указанные в CATALINA_OPTS :
/etc/systemd/system/tomcat.service
[Unit] Description=Apache Tomcat Web Application Container After=network.target [Service] Type=forking Environment=JAVA_HOME=/usr/lib/jvm/java-1.11.0-openjdk-amd64 Environment=CATALINA_PID=/opt/tomcat/temp/tomcat.pid Environment=CATALINA_HOME=/opt/tomcat Environment=CATALINA_BASE=/opt/tomcat Environment='CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC' Environment='JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom' ExecStart=/opt/tomcat/bin/startup.sh ExecStop=/opt/tomcat/bin/shutdown.sh User=tomcat Group=tomcat UMask=0007 RestartSec=10 Restart=always [Install] WantedBy=multi-user.target После завершения редактирования сохраните и закройте файл.
Далее перезагрузите демон systemd, чтобы он знал о существовании вашего служебного файла:
Запустите службу Tomcat с помощью следующей команды:
Дополнительно проверьте, что служба запущена без ошибок, выполнив следующую команду:
Шаг 6 — Настройка брандмауэра и тестирование сервера Tomcat
Теперь, когда служба Tomcat запущена, мы сможем протестировать ее, чтобы убедиться, что страница по умолчанию доступна.
Перед этим нам нужно настроить брандмауэр, чтобы разрешить доступ к службе для наших запросов. Если вы выполнили предварительные требования, у вас должен быть включен брандмауэр ufw .
Tomcat использует порт 8080 для принятия обычных запросов. Разрешите прием трафика для этого порта с помощью следующей команды:
После изменения брандмауэра вы можете получить доступ к начальной странице по умолчанию, перейдя к вашему домену или IP-адресу с :8080 в браузере.
Open in web browserhttp://server_domain_or_IP:8080 Вы увидите начальную страницу Tomcat по умолчанию в дополнение к другой информации. Однако, если вы воспользуетесь ссылками на диспетчер приложения, например, вам будет отказано в доступе. Мы можем настроить этот доступ далее.
Если вы смогли успешно получить доступ к Tomcat, сейчас лучшее время для активации служебного файла, чтобы Tomcat автоматически запускался при загрузке:
Шаг 7 — Настройка веб-интерфейса управления Tomcat
Чтобы использовать веб-приложение диспетчера, которое поставляется вместе с Tomcat, мы должны добавить вход на ваш сервер Tomcat. Для этого мы отредактируем файл tomcat-users.xml :
Вы должны будете добавить пользователя, который может получить доступ к manager-gui и admin-gui (веб-приложения, которые поставляются вместе с Tomcat). Вы можете сделать это, определив пользователя, аналогичного приведенному ниже примеру, между тегами tomcat-users . Обязательно измените имя пользователя и пароль на более безопасные:
tomcat-users.xml — Admin User
admin" password="password" roles="manager-gui,admin-gui"/> Сохраните файл и закройте его после завершения.
По умолчанию новые версии Tomcat ограничивают доступ к приложениям диспетчера и диспетчера хостов для подключений с самого сервера. Поскольку мы выполняем установку на удаленном компьютере, вы, вероятно, захотите удалить или изменить это ограничение. Чтобы изменить подобные ограничения IP-адреса, откройте соответствующие файлы context.xml .
Для приложения диспетчера введите:
Для приложения диспетчера хостов введите:
Внутри закомментируйте ограничение IP-адреса, чтобы разрешить подключение из любого места. Также, если вы хотите разрешить доступ только для подключений с вашего IP-адреса, вы можете добавить ваш публичный IP-адрес в список:
context.xml files for Tomcat webapps
Сохраните файл и закройте после завершения.
Чтобы изменения вступили в силу, перезапустите службу Tomcat:
Шаг 8 — Доступ к веб-интерфейсу
Теперь, после создания пользователя, мы снова сможем получить доступ к веб-интерфейсу управления в веб-браузере. Вы снова можете перейти к правильному интерфейсу, введя в браузере доменное имя или IP-адрес вашего сервера с портом 8080:
Open in web browserhttp://server_domain_or_IP:8080 Страница, которую вы увидите, должна выглядеть аналогично странице, которую вы видели при тестировании ранее:
Давайте изучим приложение диспетчера, доступ к которому можно получить по ссылке или по адресу http:// server_domain_or_IP :8080/manager/html . Вам нужно будет ввести данные учетной записи, которые вы добавили в файл tomcat-users.xml . После этого вы должны увидеть страницу, которая выглядит следующим образом:
Веб-приложение диспетчера используется для управления приложениями Java. Здесь вы можете запустить, остановить, перезагрузить, развернуть и отменить развертывание. Также вы можете запустить инструменты диагностики для ваших приложений (например, найти утечки памяти). Информация о вашем сервере доступна в самом низу страницы.
Теперь давайте рассмотрим диспетчер хостов, доступный по ссылке или по адресу http:// server_domain_or_IP :8080/host-manager/html/ :
На странице диспетчера виртуальных хостов вы можете добавить виртуальные хосты для обслуживания ваших приложений.
Заключение
Ваша установка Tomcat завершена! Теперь вы можете развернуть ваши собственные веб-приложения Java!
В настоящее время ваша установка Tomcat работает, но абсолютно не имеет шифрования. Это означает, что все данные, включая чувствительную информацию, например пароли, отправляются в текстовой форме и могут быть кем-либо перехвачены и прочитаны в Интернете. Чтобы предотвратить это, мы настоятельно рекомендуем шифровать ваши соединения с помощью SSL. Вы можете узнать, как реализовать шифрование ваших подключений в Tomcat в этом руководстве (примечание: в настоящем руководстве описано шифрование Tomcat 8 в Ubuntu 16.04).
Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.
Как установить tomcat
2. Если используется база данных MSSQL, см. раздел Использование MSSQL в качестве поставщика хранилища данных . Выполните шаги, описанные в этом разделе, чтобы настроить базу данных, и вы будете снова отсылаться к этому разделу.
5. Убедитесь, что переменная среды Java сконфигурирована правильно:
1. Найдите папку установки Java и скопируйте путь. По умолчанию путь к папке равен C:\Program Files\Java\jdk_ <номер версии>.
2. Из меню «Пуск» в Windows перейдите к Дополнительным параметрам системы . Путь к этим свойствам будет изменяться в зависимости от версии Windows. Например, для Windows 10 выполните поиск Переменные среды и выберите Изменить системные переменные среды .
3. Щелкните Переменные среды .
4. В разделе Системные переменные щелкните Создать .
5. В поле Имя переменной введите JAVA_HOME .
6. В поле Значение переменной введите путь к установке Java, как определено на шаге a.
7. Нажмите кнопку ОК .
7. Посетите веб-сайт Tomcat , чтобы загрузить файл 32-bit/64-bit Windows Service Installer (pgp, sha1, sha512) .
8. Запустите Apache Tomcat Setup Wizard. Нажмите кнопку Next .
9. Щелкните I Agree .
10. В разделе Choose Components используйте настройки по умолчанию. Нажмите кнопку Next .
11. В поле HTTP/1.1 Connector Port введите 80 (или другой доступный порт).
12. В полях Учетные данные администратора Tomcat (Tomcat Administrator Login) необходимо ввести имя пользователя Tomcat и уникальный безопасный пароль для администрирования Tomcat. В ThingWorx это необходимое действие, а не факультативное.
13. Нажмите кнопку Next .
14. Нажмите кнопку Next .
15. Щелкните Install .
16. Нажмите кнопку Finish .
17. Запустите Tomcat. Щелкните Configure Tomcat . В окне Configure Tomcat щелкните вкладку Java .
18. В поле Java Options добавьте следующий код в конце поля опций:
-Dserver -Dd64
-XX:+UseG1GC
-Dfile.encoding=UTF-8
-Djava.library.path= \webapps\Thingworx\WEB-INF\extensions
Пример для Djava.library.path :
-Djava.library.path=C:\Program Files\Apache Software Foundation\Tomcat8.5\webapps\
Thingworx\WEB-INF\extensions
При первой установке ThingWorx Platform необходимо задать опцию Java -Duser.timezone=UTC , которая не распознает переход на летнее время UTC . Задание этой опции предотвращает перезапись данных при смене летнего времени. В данный момент существующие клиенты не должны изменять эту настройку.
20. Нажмите кнопку ОК .
21. В расположении установки Tomcat откройте файл conf/web.xml . Замените страницу с ошибками по умолчанию (значение по умолчанию: stacktrace), добавив в файл web.xml следующие данные. Поместите следующий код в тег web-app (после тега welcome-file-list ). В правильно сконфигурированном веб-приложении это значение по умолчанию будет переопределено в файле webapps/APP_NAME/WEB-INF/web.xml , поэтому проблемы не возникнут.
22. В расположении установки Tomcat откройте файл conf/server.xml . Добавьте внутрь тегов следующее:
По соображениям безопасности критически важно отключить соединитель AJP, если это еще не сделано, выполнив следующий шаг.
23. В расположении установки Tomcat откройте файл conf/server.xml и выполните поиск следующей строки. Если она найдена, закомментируйте ее и сохраните файл:
В Apache Tomcat 9.0 и более поздних версиях для атрибута rejectIllegalHeader по умолчанию задано значение true. Изменение вручную файла conf/web.xml , чтобы задать значение false для этого атрибута, не рекомендуется или поддерживается PTC.
24. Удалите все веб-приложения Tomcat, расположенные в папке /<путь_к_tomcat>/webapps/ . Удаление этих приложений предотвращает нежелательный доступ к Tomcat, особенно в контексте, который позволит пользователям просматривать файлы cookie других пользователей.
25. Если для приложения требуется специальный набор шифров, обратитесь к следующей документации для получения информации о конфигурации:
27. (НЕОБЯЗАТЕЛЬНЫЙ ШАГ) Чтобы увеличить значения по умолчанию настроек кэша, влияющих на кэширование статических файлов, добавьте следующую строку, заключенную в теги , в файл $CATALINA_HOME/conf/context.xml :
Увеличение этой настройки улучшает производительность и предотвращает появление следующего сообщения в Tomcat:
WARNING: Unable to add the resource at [/Common/jquery/jquery-ui.js] to the cache
because there was insufficient
free space available after evicting expired cache entries —
consider increasing the maximum size of the cache
# Как установить Tomcat на Ubuntu
Apache Tomcat — это веб-сервер, который может использоваться как контейнер для сервлетов и поддерживать работу Java-приложений. Как правило, его используют в связке с другим веб-сервером — Apache или Nginx — для расширения их функционала. В такой связке Tomcat поставляет веб-страницы, а стоящий «выше» веб-сервер обрабатывает их и передаёт пользователю.
В этой инструкции мы установим Java Development Kit — необходимый инструмент для работы Tomcat — и сам веб-сервер на подготовленный к работе VPS под управлением Ubuntu. Настроим работу веб-сервера, создадим пользователей, от чьего имени будет осуществляться вход в панель администрирования, и проверим работу веб-сервера.
# Подготовка к установке
Начнём установку с создания отдельного пользователя для Tomcat. Мы не будем наделять его особыми привилегиями и запретим вход на сервер от имени этого пользователя. Будем использовать его только для работы с директорией, где расположен Tomcat:
sudo useradd -m -d /opt/tomcat -U -s /bin/false tomcat Мы добавили пользователя tomcat, выделили для него директорию и запретили подключение к серверу от его имени. Теперь можно переходить к подготовке окружения.
Для работы Tomcat необходим минимальный набор Java-инструментов — Java Development Kit. В отдельной инструкции мы рассказывали, как установить Java на Ubuntu — вы можете воспользоваться этой инструкцией, чтобы развернуть полноценное Java-окружение или же установить минимально необходимый набор инструментов.
В данном случае мы ограничимся только Java Development Kit:
sudo apt install default-jdk После завершения установки проверим версию установленной Java:
java -version # Output openjdk version "11.0.14.1" 2022-02-08 OpenJDK Runtime Environment (build 11.0.14.1+1-Ubuntu-0ubuntu1.20.04) OpenJDK 64-Bit Server VM (build 11.0.14.1+1-Ubuntu-0ubuntu1.20.04, mixed mode, sharing) Готово! Java Development Kit установлен и готов к работе. Теперь переходим к установке веб-сервера.
# Установка Tomcat
Устанавливать мы будем ядро Tomcat. Для этого на официальной странице
(opens new window) выберем файл .tar.gz и скопируем ссылку для его загрузки.
Далее перейдём в папку с временными файлами и скачаем сюда наш архив с Tomcat:
cd /tmp wget https://dlcdn.apache.org/tomcat/tomcat-10/v10.0.20/bin/apache-tomcat-10.0.20.tar.gz После завершения скачивания распакуем архив и скопируем распакованные файлы в специально отведённую для Tomcat директорию:
sudo tar xzvf apache-tomcat-10*tar.gz -C /opt/tomcat --strip-components=1 Теперь осталось только передать все права на эту папку нашему пользователю:
sudo chown -R tomcat:tomcat /opt/tomcat/ sudo chmod -R u+x /opt/tomcat/bin Готово! Можно переходить к настройке Tomcat.
# Настройка Tomcat
Чтобы получить доступ к страницам управления Tomcat, необходимо вручную прописать нужных пользователей, их привилегии и пароли в файле, содержащем все сведения о пользователях:
sudo vim /opt/tomcat/conf/tomcat-users.xml В открывшемся текстовом файле перед закрывающим тэгом нужно добавить следующие строки:
role rolename="manager-gui" /> user username="manager" password="manager_password" roles="manager-gui" /> role rolename="admin-gui" /> user username="admin" password="admin_password" roles="manager-gui,admin-gui" /> Здесь мы указываем права для двух новых пользователей (manager и admin), их имена и пароли для доступа.
По умолчанию Tomcat настроен так, чтобы доступ к нему нельзя было получить с удалённого хоста — только с того же, на котором расположен сам сервер. Это не очень удобно, поэтому следующим шагом мы уберём это ограничение.
Откроем конфигурационный файл, отвечающий за доступ пользователя manager к серверу:
sudo vim /opt/tomcat/webapps/manager/META-INF/context.xml В этом файле найдём раздел:
... Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" /> Далее закомментируем его — укажем в начале строки символ . Вот что должно получиться:
... !-- Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1" /> --> … То же самое нужно сделать в конфигурационном файле host-manager:
sudo vim /opt/tomcat/webapps/host-manager/META-INF/context.xml # Создание сервиса на основе Tomcat
Чтобы Tomcat работал в фоновом режиме и сам перезапускался при рестарте сервера, добавим его в список сервисов.
Нам нужно узнать путь к исполняемому файлу java. Это можно сделать командой:
sudo update-java-alternatives -l # Output java-1.11.0-openjdk-amd64 1111 /usr/lib/jvm/java-1.11.0-openjdk-amd64 После этого в директории, где хранятся сведения о сервисах, создадим новый текстовый файл, описывающий Tomcat:
sudo nano /etc/systemd/system/tomcat.service Заполним этот файл:
[Unit] Description=Tomcat After=network.target [Service] Type=forking User=tomcat Group=tomcat Environment="JAVA_HOME=/usr/lib/jvm/java-1.11.0-openjdk-amd64" Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom" 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 RestartSec=10 Restart=always [Install] WantedBy=multi-user.target Здесь мы описываем сам сервис, его расположение, правила работы и переменные его среды. Адрес исполняемого файла Java добавляем в строку Environment=»JAVA_HOME= . В строке Environment=»CATALINA_OPTS= описываем доступные для Tomcat лимиты использования памяти.
Строки Restart отвечают за тип и время перезагрузки веб-сервера — в данном случае он автоматически перезагружается после ошибок.
Теперь осталось только запустить дэймона и активировать сам веб-сервер:
sudo systemctl daemon-reload sudo systemctl start tomcat sudo systemctl enable tomcat Tomcat запущен. Проверить его работу можно командой systemctl status .
# Веб-интерфейс Tomcat
По умолчанию Tomcat работает на порту 8080. Проверить это можно командой:
sudo netstat -tulpn # Output … tcp6 0 0 . 8080 . * LISTEN 34467/java … Если у вас запущен фаервол, не забудьте добавить порт в список разрешённых:
sudo ufw allow 8080 После этого можно открыть браузер и зайти по адресу your_server_ip:8080 .
Здесь вы должны увидеть стартовую страницу Tomcat:
В правой части стартовой страницы находятся кнопки для доступа в интерфейс управления Tomcat:
В этих разделах можно будет управлять работой как Java-приложений (Manager App), так и виртуальных хостов веб-сервера (Host Manager).
Функционал Tomcat достаточно широк, чтобы использовать его и как самостоятельный веб-сервер, и как вспомогательный сервис для обработки и поддержки Java-приложений в связке с классическим Apache или Nginx.
© Джино, 2003–2022. «Джино» является зарегистрированным товарным знаком.
Лицензия на телематические услуги связи №150549 от 09.03.2017.