Tomcat 8 на Java 8 За Apache на CentOS

Недавно один из моих коллег попросил меня развернуть приложение Spring на сервере CentOS с cPanel / WHM и Apache. Поскольку это требование к сборке не совсем очевидно, я подумал, что поделюсь опытом в качестве простого руководства. Обратите внимание, что это просто практическое руководство, а не руководство по передовым методам, поэтому, если вам требуется решение с усиленной безопасностью, я рекомендую проверить TomcatExpert для получения авторитетного практического руководства. Как говорится, давайте начнем.

Личные инструменты выбора

Поскольку я предпочитаю использовать инструменты GNU и использую Windows локально, я использую производный от Cygwin инструментарий на основе Arch Linux под названием MSYS2 и ConEmu — превосходный консольный эмулятор для Windows.

Список навыков и зависимостей

Чтобы заставить эту сборку работать, я предполагаю, что вы хотя бы случайно знакомы с основными командами Linux, доступом к оболочке и пониманием редактора Vim. Если нет, я покажу команды по мере продвижения, но эти навыки выходят за рамки этого руководства. Если вам неудобно использовать Vim, вы можете поручить эту задачу кому-то более уверенному в своих навыках или использовать другой редактор, такой как Nano или Emacs . Для получения дополнительной информации вы можете получить довольно хороший урок начальной загрузки по каждой технологии из вики StackOverflow… соответственно, SSH , Linux и Vim . Кроме того, нам, очевидно, понадобятся Java и Tomcat, поэтому давайте начнем с установки или обновления до последних версий. (В настоящее время Java 8 1.8.0_45, Tomcat v8.0.21).

Установка / обновление до последней версии Java 8

Чтобы установить двоичные файлы, мы собираемся подключиться к SSH на сервер от имени пользователя root и использовать GNU Wget для загрузки зависимостей. Я устанавливаю Java в / usr / local, но если вы хотите, вы можете заменить другое местоположение, такое как / opt или / usr / share. Обратите внимание, что когда вы видите командную строку со знаком # хеша в начале, это стандарт Unix, указывающий, что вы вошли в систему как «пользователь root». Однако, если вы не вошли в систему как пользователь root, для всех команд, отображающих знак хеша, # потребуются разрешения ‘sudo’. Соответственно, знак доллара означает, что вы обычный пользователь. Для получения дополнительной информации о команде sudo и запуске от имени пользователя root вы можете обратиться к справочным страницам или в CentOS Wiki .

Так что давайте перейдем в вашу целевую директорию с правами root и возьмем последнюю версию Java …

Обратите внимание, что эта запись была первоначально опубликована в апреле 2015 года, поэтому вы можете загрузить последние версии Java и Tomcat и соответствующим образом обновить требования.

После загрузки архива он может быть сохранен с добавленной строкой запроса AuthParam. Если это так, просто переименуйте архив, чтобы он заканчивался расширением tar.gz

Примечание: чтобы переименовать файл, вы можете просто набрать jdk и дважды нажать клавишу tab чтобы завершить имя файла вместо необходимости вводить полное имя файла.

Далее нам нужно извлечь архив в целевой каталог, используя tar. Опять же, если вы не устанавливаете в /usr/local обновите ваши пути соответственно.

Чтобы упростить будущие обновления JDK, я хотел бы создать Symlink, ссылающийся на текущий JDK, чтобы все двоичные файлы Java автоматически переназначались в текущий JDK через менеджер двоичных версий Linux Alternatives . Ниже я просто делаю ссылку на недавно извлеченный JDK.

Следующая серия команд не обязательна. Однако, если у вас в настоящее время не установлена ​​Java в вашей системе, это, безусловно, облегчает будущие обновления, поэтому я рекомендую просто следовать этому примеру, поэтому все, что вам нужно сделать, это заменить символическую ссылку JDK при следующем обновлении JDK. Однако, если вам нужно обновить current версию Java, руководство по альтернативам в вики CentOS поможет вам довольно быстро освоить задачу.

Предполагая, что у вас нет настроек для Java, следующие команды установят ссылки на альтернативы для двоичных файлов JDK.

Выполнив эти команды, вы можете проверить версии, передав аргумент --display в систему альтернатив.

После того, как вы установили и подтвердили альтернативы, просто java -version чтобы убедиться, что система находит JDK.

Если вы не получили правильный ответ, начните с самого начала и убедитесь, что вы правильно выполнили каждый шаг. Очень просто совершать простые ошибки как при установке Java, так и при работе в среде Linux.

Если вы сделали это далеко Поздравляем! Вы на полпути к наличию производственного Java-сервера, но пока не празднуете, установка JDK была простой, теперь нам нужно установить и настроить Tomcat.

Установка Tomcat 8

Мне лично нравится устанавливать Tomcat в каталог /opt . Как и в случае с JDK, если вы не устанавливаете в /opt обновите свой путь соответствующим образом.

Прежде всего нам нужно подумать о том, что мы в настоящее время планируем делать. Это общеизвестный общепринятый способ запуска Tomcat с непривилегированной учетной записью, поэтому мы собираемся создать пользователя Tomcat без оболочки входа в систему. Кроме того, для этой сборки я планирую запустить несколько экземпляров Tomcat Behind Apache 2.2 и оставить все статические HTTP-запросы для Apache. Tomcat вообще не будет запускать HTTP. Таким образом, мы собираемся перейти к Tomcat через AJP . Рабочий процесс по сути будет выглядеть так, как показано ниже.

AJP — не единственное решение, мы «могли» использовать Mod Proxy HTTP, чтобы проксировать все запросы к Tomcat через другой порт. Однако это не идеальное решение, так как тогда вы будете использовать два HTTP-сервера, и ваш сайт будет виден на обоих портах. Опять же, есть обходные пути, но для простоты я хотел бы полностью отключить HTTP-сервер Tomcat и использовать коннектор AJP от Apache для передачи запросов в Tomcat и из Tomcat через AJP и позволить Apache обрабатывать HTTP.

Итак, начнем с загрузки Tomcat. Я использую Apache для скачивания прямо с сайта, но если вам нужно более близкое зеркало, вы можете найти его на сайте Tomcat.

Прежде чем двигаться дальше, нам нужно проверить целостность md5 двоичного выпуска. Для этой версии сумма указана ниже, но вы также можете найти ссылку md5 рядом со ссылкой для скачивания tar.gz на сайте Tomcat . Если md5 не совпадает, загрузите другой архив, так как двоичные файлы могут легко испортиться во время передачи.

Если md5sum совпадает, извлеките архив и символическую ссылку в каталог /opt же, как мы делали это ранее с JDK.

Затем нам нужно настроить нашего пользователя tomcat, группировать и сменить владельца двоичных файлов на нового пользователя tomcat.

Теперь давайте проверим, что пользователь Tomcat был добавлен в систему…

Если у вас есть вывод, отображающий вашего пользователя Tomcat, то вы можете смело переходить к созданию собственной библиотеки Tomcat APR

Создайте собственную библиотеку Tomcat APR

Далее мы собираемся создать собственную библиотеку Tomcat для оптимальной производительности. Собственная библиотека APR обеспечивает повышение производительности за счет добавления поддержки неблокирующего ввода-вывода для запросов поддержки активности. Итак, вот суть, взятая прямо с сайта Tomcat Native Library, о том, как Tomcat Native повышает производительность.

«Собственная библиотека Apache Tomcat — это дополнительный компонент для использования с Apache Tomcat, который позволяет Tomcat использовать определенные собственные ресурсы для обеспечения производительности, совместимости и т. Д.
В частности, собственная библиотека Apache Tomcat предоставляет Tomcat доступ к реализации сетевого подключения (сокета) библиотеки Apache Portable Runtime (APR) и генератора случайных чисел. См. Документацию Apache Tomcat для получения дополнительной информации о том, как настроить Tomcat для использования соединителя APR ».

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

Находясь в CentOS, дистрибутиве на основе RPM, мы будем использовать Yum для установки двух необходимых зависимостей, необходимых для Tomcat Native — OpenSSL и библиотеки APR. Если вы используете дистрибутив на основе Debian (Ubuntu, Linux Mint и т. Д.), Вы можете так же легко использовать Aptitude или Apt и т. Д.

Как только Yum закончит установку библиотек, cd в базовый двоичный каталог Tomcat и извлеките собственный архив Tomcat.

Затем cd в каталог tomcat-native- {version} -src / jni и выполните следующие команды точно так, как вы видите. Обратите внимание, что скрипт ./configure довольно хорошо подходит для выбора большинства стандартных реализаций OpenSSL, поэтому вам не нужно явно указывать путь для ssl.

После настройки сборки выполните make и make install.

Теперь вы должны иметь встроенные двоичные файлы libtcnative в каталоге /usr/local/apr/lib . Для подтверждения просто ls справочник. Если вы столкнулись с проблемами при сборке собственных двоичных файлов tomcat, проверьте установку, чтобы убедиться, что все необходимые зависимости были правильно найдены. Чаще всего возникают трудности с поиском библиотеки APR.

Чтобы убедиться, что библиотека APR загружается правильно, давайте проведем быстрый тест, установив переменную среды, добавив путь к библиотеке APR и протестировав конфигурацию.

После выдачи ./configtest.sh вы хотите прокрутить вывод, чтобы убедиться, что библиотека APR загружается правильно.

Если ты все еще со мной так далеко, у тебя все отлично! Итак, теперь давайте перейдем к настройке отдельных экземпляров.

Примечание. Если в этот момент у вас возникли проблемы, например «Не найдена нативная библиотека Apache Tomcat на основе APR», проверьте в / opt / tomcat / lib или / usr / local / apr / lib, чтобы определить, есть ли у вас двоичные файлы.

Настройка нескольких экземпляров Tomcat

В настоящее время у нас есть файлы времени выполнения Tomcat в / opt / tomcat. Однако для этой сборки нам нужна возможность управлять несколькими экземплярами, предоставляя каждому экземпляру отдельную JVM. Таким образом, в случае сбоя приложения в одном экземпляре приложения не будут закрыты в другом. Хотя это и идеальная ситуация, для ее настройки требуется немало настроек. Итак, давайте перейдем к этому.

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

В двух словах, основные указания предлагают сохранить базовую установку $CATALINA_HOME и создать отдельные каталоги экземпляров $CATALINA_BASE содержащие ресурсы, необходимые для каждого экземпляра. Вот что мы будем делать.

Итак, давайте теперь создадим отдельные экземпляры, скопируем необходимые файлы в каждый экземпляр и удалим посторонние файлы из $CATALINA_HOME .

Теперь у вас должна быть следующая структура каталогов для каталога /opt/tomcat .

Ради абстракции, я собираюсь использовать example1.com и example2.com в качестве справочного материала, но, конечно, вам придется обновить их с вашими фактическими доменами хоста. Чтобы настроить наши экземпляры, мы собирались внести некоторые изменения в несколько элементов в файле server.xml каждого экземпляра. Вам необходимо указать две переменные: сетевой IP-адрес вашего домена и ваше доменное имя. В противном случае для каждого экземпляра сервера требуется семь элементов.

1. Выделенный порт отключения сервера.
2. Отключите HTTP-соединитель.
3. Порт выделенного сервера AJP.
4. Определен адрес разъема AJP.
5. Определен хост по умолчанию.
6. Элемент Host определен.
7. Определен префикс регистрации элемента Valve.

При желании вы также можете обновить UserDatabaseRealm для использования дайджест-аутентификации, если хотите, добавив атрибут дайджеста со значением алгоритма. Я лично предпочитаю работать с SHA-256.

Итак, давайте перейдем к этому … Откройте vim и внесите изменения в /opt/tomcat/tomcat_1/conf/server.xml, обновив элементы с помощью IP-адреса вашей доменной сети для элемента 4 и вашего домена для элементов 5,6,7. Файл server.xml должен напоминать следующее без ваших собственных переменных.

После сохранения первых экземпляров server.xml перейдем к обновлению второго. На этот раз мы внесем те же изменения, что и для первого server.xml, с некоторыми дополнительными изменениями для элементов 1 и 3. Поскольку оба экземпляра не могут использовать один и тот же порт завершения работы, обновите атрибут порта элемента сервера, чтобы использовать другой порт чем первый экземпляр. В этом примере я использую 8006, увеличивая один из портов отключения первых экземпляров. Следуя примеру 3, я также обновляю атрибут порта элемента соединителя AJP, чтобы использовать порт 8010, снова просто увеличивая единицу с порта AJP первых экземпляров.

Второй экземпляр server.xml должен выглядеть следующим образом.

Пока мы работаем с каталогами conf, давайте продолжим и обновим файл tomcat-users.xml для каждого экземпляра. Начиная с /opt/tomcat/tomcat_1/conf/tomcat-users.xml добавьте следующие роли и пользовательские теги в конец файла перед закрывающим тегом tomcat-users. Обновите имя пользователя и пароль так, как вы хотите.

Теперь нам нужно настроить инициализацию каждого экземпляра, создав файл среды, расположенный в каталоге bin экземпляра. Соответственно, /opt/tomcat/ndominstance‹/bin/setenv.sh

Я сделал специальный, специально подходящий для этой цели, так что вы можете просто скопировать мой, если хотите. Хотя это очевидно, вам нужно обновить $CATALINA_BASE и $CATALINA_PID для instance_2. Более того, если вы устанавливаете более двух экземпляров, следуйте их примеру. Обратите внимание, что параметры ниже для моей собственной конфигурации сервера. YMMV.

Затем, измените владельца и установите исполняемый бит для каждого экземпляра setenv.sh, и тогда мы будем делать некоторые настройки Apache.

Настройка виртуальных хостов Apache включает

Далее нам нужно убедиться, что Apache загружает и mod_proxy и mod_proxy_ajp как мы выполняем прокси на Tomcat. Просто введите следующую команду, чтобы убедиться, что оба модуля действительно загружены.

Вы должны увидеть оба модуля в выводе.

Хотя почти во всех профилях cPanel / WHM оба модуля активны по умолчанию, если вы не видите оба модуля в выходных данных, вам необходимо обратиться к документации по cPanel / WHM для включения модулей.

Далее нам нужно включить файл конфигурации tomcat для каждого домена определенным образом, чтобы при внесении изменений через cPanel / WHM наши конфигурации не перезаписывались. Для поддержки этого мы добавим определенную структуру каталогов и файл tomcat.conf для обоих доменов.

Нам не нужно обновлять /usr/local/apache/conf/httpd.conf по умолчанию, чтобы включить наши конфигурации. Если вы обновите файл /usr/local/apache/conf/httpd.conf по умолчанию, ваши изменения будут потеряны после обновления обновления cPanel / WHM. Считай себя предупрежденным.

Чтобы включить наши конфигурации, структура каталогов должна отражать правильную структуру пользователей и доменов, чтобы apache мог загружать файлы конфигурации. Я снова использую domain1.com, domain2.com в качестве примеров. Чтобы проиллюстрировать далее, чтобы включить наш новый tomcat.conf для user1, domain1.com и user2, domain2.com, нам нужно создать tomcat.conf, используя следующую структуру.

Итак, давайте вернемся к этому. Сначала cd в правильное местоположение для любого имени пользователя, которое использует ваш user1 и создайте каталоги. Если вы используете только одного пользователя и два домена, просто перейдите туда сейчас. В противном случае обновите ваш путь соответственно.

После создания каталогов создайте файл tomcat.conf для первого пользователя, добавьте следующие операторы Proxy и сохраните файл.

Повторите то же самое для второго пользователя, заменив второй домен необходимыми значениями.

Далее нам нужно вызвать скрипты для обновления конфигураций httpd.conf. Выполните следующие команды ниже, чтобы сделать это.

На данный момент у нас теперь должны быть запросы Apache к Tomcat, но мы не настроили сервер для автоматического запуска наших экземпляров Tomcat. Опять же, я создал служебный скрипт, который вы можете использовать для каждого экземпляра, если хотите. Создайте файл с именем tomcat_1 в каталоге /etc/init.d со следующим содержимым. После создания tomcat_1 просто скопируйте его как tomcat_2 и обновите значения $CATALINA_BASE и $CATALINA_PID как мы делали это ранее с конфигурациями setenv.sh .

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

Теперь мы должны иметь возможность запрашивать состояние нашего экземпляра сервера Tomcat с помощью команд системной службы.

Теперь мы можем просто вызвать каждый скрипт для инициализации экземпляров Tomcat, перезапустить Apache, и каждый домен будет перенаправлять на свой собственный экземпляр Tomcat.

Congrats! Теперь у вас есть несколько экземпляров Tomcat 8, установленных на Java 8, работающих за веб-сервером Apache в Centos с cPanel / WHM.

До следующего раза…