Сегодня мы рассмотрим: Настоящие ценители музыки знают, что для качественного...
Замысел написать эту статью про установку и настройку, наверное, одного и самых популярных веб-серверов на Java возник уже давно. Одной из причин было желание сделать небольшую заметку "для себя" с подробной инструкцией. Возможно эта статья также пригодится другим java программистам. Пользы для кого-нибудь ещё, например для системных администраторов в ней будет не так много. Скорее всего они просто сделают так: apt-get install tomcat8 и затем потребуют у программиста war-ик для развертывания. Программист же часто хочет чуть большего — например, возможности работать с различными версиями серверов (которых может даже ещё нет в официальном репозитории) или наоборот откатиться к какой-то специфичной версии. Системному администратору такие исследования, как правило, не нужны. По-хорошему, у него должна стоять просто стабильная работающая версия, на которую периодически он будет накатывать обновления и лишний раз на неё не дышать.
В общем, это статья про то, как программисту установить Apache Tomcat под Linux чтобы "поиграться" с ним, но при этом ничего сильно не сломать.
Также эта статья может быть полезна в тех случаях, когда начинающий java программист отладив свое веб-приложение Tomcat запущенным на Windows, сталкивается со жгучим желанием развернуть свой сайт на какой-нибудь недорогой VPS-ке с Ubunt-ой.
Статья может показаться излишне многословной, но мне хотелось рассказать про основные "грабли" и способы их обхода. Могу предположить, что системные администраторы могут быть недовольны тем, что это решение недостаточно системные. Поэтому тем, кто хочет подробно изучить данный вопрос или посвятить свою жизнь профессиональной (т.е. получать за это деньги) настройки линуксовых серверов, тому лучше следует обратиться к соответствующей литературе, обучится этому ремеслу у профессионала и черпать знания у сисадминского сообщества. Здесь же у меня просто блог для java программистов.
Итак, поехали!
Подготовка
Исходные данные.
Linux. Debian 9. 64bit.
1. Устанавливаем JDK.
Почему JDK, а не JRE? По-факту достаточно JRE, но лично мне приятно иметь возможность в случае необходимости по-быстрому скомпилировать программку на java прямо на сервере.
Вы не поверите, но жизнь такая интересная штука, никогда не угадаешь когда тебе может понадобится скомпилировать и запустить что-то на Java. Лично мне запуск javac
из консоли на сервере помогал несколько раз.
Далее, я предпочитаю ставить Oracle JDK. Собственно OpenJDK тоже неплох и устанавливается гораздо проще (sudo apt-get install default-jdk). Просто я отдаю предпочтение оригинальной Sun/Oracle. Тем не менее, ставить Oracle JDK, OpenJDK или какую-либо другую версию - личное дело каждого. Лично я отношусь к пользователям Open JDK без предубеждения. Более того, сам часто использую версии Open JDK (например Java 9) для того, чтобы ознакомиться с их новыми возможностями.
Установка Oracle JDK под Windows и Linux сильно отличаются. Под Windows проще установить Oracle JDK проще простого (скачать и запустить), а сборку Open JDK под Windows нужно ещё поискать.
С Linux-ом всё наоборот. Open JDK как я писал ставится очень просто через apt, с Oracle JDK чуть сложнее.
В интернете существует совет, что для установки нужно добавить ещё один apt-репозиторий. Я так не делаю. Возможно это лично моя паранойя, но я стараюсь так не делать и делаю установку руками. Особенно если учесть, что установка заключается в том, чтобы скачать и распаковать архив .
Выбираем jdk-XYZ-linux-x64.tar.gz файл. Правой кнопкой - сохранить ссылку.
$wget --header "Cookie: oraclelicense=accept-securebackup-cookie" [ссылка]
Например так:
$sha256sum jdk-8u73-linux-x64.tar.gz
Смотрим что показалось на экране и сверяем значение, с тем что опубликовано на официальном сайте.
Для этого заходим на сайт на сайт загрузки и ищем строчку Checksum
.
Например для jdk-8u73-linux-x64.tar.gz
$tar -xzf jdk-8u73-linux-x64.tar.gz -C /opt
По старой привычке я складываю всё в "/opt". После этого делаю симлинк.
$wget http://apache-mirror.rbc.ru/pub/apache/tomcat/tomcat-8/v8.0.33/bin/apache-tomcat-8.0.33.tar.gz
Проверяем хэши.
$wget https://www.apache.org/dist/tomcat/tomcat-8/v8.0.33/bin/apache-tomcat-8.0.33.tar.gz.sha1 $sha1sum -c apache-tomcat-8.0.33.tar.gz.sha1
Тоже самое в картинках:
2. Сервер можно распаковать туда же в /opt.
JAVA_HOME=/opt/jdk
Про этот файл можно почитать в документации: RUNNING.txt .
На самом деле, часто некоторые разработчики просто тупо вбивают "JAVA_HOME=...." прямо в catalana.sh.
Дело в том, что проще открыть nano catalana.sh
и поправить его, чем создавать setenv.sh (а точнее как-то узнать про его существование), хотя изначально этот файл специально был сделан для того, чтобы менять ключи JVM и различные переменные окружения, и при этом не портить основной запускаемый файл.
Вот выдержка из документации:
Using the "setenv" script (optional, recommended)
Apart from CATALINA_HOME and CATALINA_BASE, all environment variables can
be specified in the "setenv" script. The script is placed either into
CATALINA_BASE/bin or into CATALINA_HOME/bin directory and is named
setenv.bat (on Windows) or setenv.sh (on *nix). The file has to be
readable.By default the setenv script file is absent. ...
Строго говоря, часто переменная окружения JAVA_HOME часто указывает туда, где установлена системная JVM. По-большому счету это правило работает, но часто в работе/отладке приходится запускать какую-то конкретную версию Tomcat-а под какой-то специальной версией JVM. Поэтому удобно иметь возможность гибко менять настройки через setenv.sh.
После того как все пути настроены, запускаем и проверяем, что все хорошо работает.
Кстати заметил интересный момент. При запуске на виртуальном хостинге может быть довольно ощутимая задержка в старте (около минуты).
Не хочется углубляться в детали, но мне помогла установка haveged.
$groupadd tomcat $useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat $chown -R tomcat:tomcat /opt/tomcat
После этого проверяем, что всё запускается. Например так:
$iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-ports 8080
Естественно нужно убедиться, что у вас не установлен уже какой-нить веб-сервер (например apache или nginx), который работает на 80-ом порту.
Проверяем, что все нормально и если всё хорошо - сохраняем правило переброса портов.
$apt-get install iptables-persistent
Собственно говоря всё.
Теперь о том, на что скорее всего обратят внимание профессиональные системные администраторы.
1. Tomcat заводят через mod_jk за Apache HTTPD или за Nginx (через reverse proxy).
Это дает возможность разделить статику, балансировать нагрузку и делать многие другие полезные штуки. Это круто в продакшене, но в девелоперской конфигурации это ещё один слой который не всегда упрощает отладку и разработку.
В принципе в настройке ничего сложного нет, но всё равно нужно будет покурить документацию. Раньше я предпочитал связку через mod_jk, теперь чаще сталкиваюсь с Nginx.
2. Нужно сделать запуск Tomcat-а как службу. Это не паранойя, а здравый смысл. По-крайней мере если не дай Бог сервер перезапустится, не нужно будет в ручную его запускать.
3. Правильные сисадмины разводят файлы томката по правильным папкам (/etc, /var/log и т.д.) и более деликатно относятся к правам доступа к конфигурационным файлам (и не только).
Можно посмотреть, как это делается через apt-get install tomcat8.
4. Не буду отрицать, что у многих /opt - помойка в которой лежит всякое барахло.
Тем не менее, если это мой персональный сервер, то это не помойка, а мой личный склад программ.
5. Хорошие сисадмины настраивают iptables и прикрывают 8080 порт извне. Точнее они прикрывают все порты, к которым не нужен доступ из вне.
Если уж говорить на чистоту, то лично я не люблю заниматься администрированием и настройкой серверов. Каждый должен заниматься своим делом, пусть это делает линуксоид со стажем. Ещё раз повторюсь, здесь речь идет скорее о некой девелоперской конфигурации, т.к. сисадмин делает установку нормальной стабильной версии "на века", настраивает её и потом периодически накатывает обновления. Программисту же, в силу своей профессиональной деятельности, приходится периодически меняет настройки, тестировать, менять версии библиотек, конфиги, что-то накатывать/откатывать и делать другие непотребства с сервером, пока не добьется от сервера нужной работы.
С другой стороны, всегда нужно соблюдать технику безопасности.
Не запускать от рута (даже если нужен 80-ый порт).
- Закрывать доступ к служебным портам.
- Не оставлять дефолтных паролей.
- Не запускать непонятных и непроверенных программ.
В идеале этим нужно заниматься у себя в песочнице, но часто такие вещи нужно уметь делать и в реальном мире.
Да и вот мой реферал на DigitalOcean , для всяких пробных веб-проектов на Java я пользуюсь их хостингом. Раньше пользовался brim.ru, они наверное самый известный java-хостинг в России.
PS: Если совсем не терпится и хочется сделать совсем всё по-быстрому, то можно запустить в два-три шага:
1. Через apt-get поставить tomcat8
2. Загрузить свой ROOT.war
3. Если нужно пробросить порт.
В сегодняшнем посте рассмотрим весь процесс компиляции tomcat из исходников, а затем его настроим и запустим. Эксперимент будем проводить на linux ubuntu
на примере tomcat 7
.
Первый вопрос который может появится, что тут сложного? А второй, зачем вообще его компилировать из исходников, если можно взять уже готовый бинарный дистрибутив? Ну во-первых это вообще интересно как этот tomcat
собирать из исходников, а во-вторых все кто когда-либо имел дело с установкой tomcat
, вся его установка сводилась к скачиванию бинарного дистрибутива и его запуском, то есть выполнением скрипта ./startup.sh
, а в виндовс мире так там вообще все еще проще, там инсталятор создает ярлыки запуск в меню start
. Тут же мы пройдем через все шаги от скачивания исходников, до более или менее тонкой настройки tomcat
.
Для этого поста на понадобится:
- JRE — виртуальная java-машина на которой выполняется tomcat .
- Apche ant — инструмент для сборки приложений
- Исходники tomcat — это просто непонятный для машины текст, который ничем не отличается от текста этого поста (в смысле тоже состоит из символов), и который надо преобразовать в бинарный код, понятный машине.
Добавление юзера tomcat
Начнем с того, что добавим пользователя tomcat который будет ответственен за веб-сервер tomcat , то есть администратора веб-сервера tomcat . Для чего он нужен? Он нужен для того, чтобы только он мог запускать и останавливать сервер, плюс только он может (вместе с рутом) изменять конфигурацию сервера.
sudo useradd -d /home/tomcat -U tomcatключ -d
означает домашняя директория, ключ -U
имя пользователя.
После того как юзер tomcat
создан зададим ему пассворд:
Теперь сделаем юзера tomcat сюдоером:
sudo adduser tomcat sudo Добавляется пользователь «tomcat» в группу «sudo» ... Добавление пользователя tomcat в группу sudo Готово.Чтобы проверить, что юзер tomcat
стал сюдоером можно открыть файл /etc/group
и найти в нем строку: sudo:x:27:#####,#####,tomcat
Или переключиться в юзера tomcat
и ввести команду (как переключаться в другого юзера, чуть дальше):
Если команда sudo whoami
вернет root
значит юзер tomcat
стал сюдоером. Поясню почему команда whoami
возвращает рута
, а не tomcat
, потому что когда запускается какая-нибудь команда с sudo
, это значит, что она запускается от имени рута
, соответственно команда sudo whoami
запускается как рут
и результат будет пользователь рут
.
Теперь создадим домашний каталог для юзера tomcat
:
И назначим владельца каталога юзера tomcat :
sudo chown tomcat /home/tomcatТеперь переключимся в пользователя tomcat и перейдем в его домашний каталог:
su tomcat Пароль: cdСкачавание исходников tomcat
В предыдущем шаге мы создали юзера tomcat и перешли в его домашний каталог. Теперь создадим в его домашнем каталоге каталог downloads и перейдем в него:
mkdir downloads cd downloadsТеперь переходим на сайт http://tomcat.apache.org/download-70.cgi для скачивания исходников, которые можно найти в самом низу страницы в разделе Source Code Distributions
и скачайте их в каталог downloads
который мы только что создали.
Измените владельца этого архива на tomcat
(если надо):
Разпакуйте архив в текущий каталог:
tar xvzf apache-tomcat-7.0.54-src.tar.gzа архив можно удалить:
rm apache-tomcat-7.0.54-src.tar.gzУстановка apache-ant
Компилировать tomcat
будем с помощью сборщика apache-ant
. Заходим на сайтapache-ant и скачиваем дистрибутив в каталог downloads
. На момент написания поста, последний был 1.9.4
.
Распакуем его в текущий каталог:
Переместим его в общий каталог /usr/bin
sudo cp apache-ant-1.9.4-bin.tar.gz /usr/binТеперь добавим этот путь в переменную окружения PATH для того:
PATH=/usr/bin/apache-ant-1.9.4:$PATH
Удаляем архив и распакованный каталог из каталога downloads :
rm -rf apache-ant*Ключ -r
нужен для того, чтобы каталог apache-ant-1.9.4-bin
был удален рекурсивно, а ключ -f
чтобы linux не выводила предупреждение, что архив apache-ant-1.9.4-bin.tar.gz
защищенный.
Теперь проверим, что apache-ant
видим:
Если ответ такой, то значит переходим к компиляции tomcat , если нет, то еще раз пройдите через шаг Установка apache-ant .
Компиляция tomcat
И так каталог с исходниками tomcat скачен и распакован, apache ant настроен, теперь заходим в каталог с исходниками tomcat :
cd apache-tomcat-7.0.54-src.tar.gzоткрываем на редактирование файл build.properties.default :
build.properties.default
# ----- Default Base Path for Dependent Packages ----- # Please note this path must be absolute, not relative, # as it is referenced with different working directory # contexts by the various build scripts. base.path=/usr/share/java #base.path=C:/path/to/the/repository #base.path=/usr/localИщем в нем строчку #base.path=/usr/local , раскомментируем ее и изменим путь на /home/tomcat/downloads/tomcat (строчка 7):
build.properties.default
# ----- Default Base Path for Dependent Packages ----- # Please note this path must be absolute, not relative, # as it is referenced with different working directory # contexts by the various build scripts. base.path=/usr/share/java #base.path=C:/path/to/the/repository base.path=base.path=/home/tomcat/downloads/tomcatЧто мы сейчас сделали? Мы указали каталог, куда билдскрипт будет скачивать необходимые для сборки исходники. Затем переименуем файл в build.properties :
mv build.properties.default build.propertiesИ теперь мы дошли до компиляции tomcat . Сначала очистим каталог:
ant clean clean-dependи с компилируем tomcat командой ant -Dno.build.dbcp=true :
ant -Dno.build.dbcp=trueЕсли в все было сделано правильно, то билд должен вернуть BUILD SUCCESSFUL :
Build: Compiling 31 source files to /home/tomcat/downloads/apache-tomcat-7.0.54-src/output/jdbc-pool/classes warning: bootstrap class path not set in conjunction with -source 1.5 warning: source value 1.5 is obsolete and will be removed in a future release warning: target value 1.5 is obsolete and will be removed in a future release warning: To suppress warnings about obsolete options, use -Xlint:-options. 4 warnings Building jar: /home/tomcat/downloads/apache-tomcat-7.0.54-src/output/jdbc-pool/tomcat-jdbc.jar Copying 1 file to /home/tomcat/downloads/apache-tomcat-7.0.54-src/output/build/lib BUILD SUCCESSFUL Total time: 23 seconds
если это так, то поздравляю, компиляция tomcat прошла успешно, и его билд должен появится в каталоге output/build .
Настройка tomcat
После того как tomcat
успешно с компилирован, теперь под настроем его чуть-чуть. Сначала перенесем его в более приемлемый каталог, пусть это будет каталог bin
где юзер tomcat
будет складывать все свои бинарные приложения.
Создадим каталог bin
в домашнем каталоге юзера tomcat
:
Теперь перенесем с компилированный tomcat в каталог bin :
cp -r /home/tomcat/downloads/apache-tomcat-7.0.54-src/output/build /home/tomcat/binНапоминаю сам tomcat
с компилирован в каталог build
.
Далее перейдем в каталог /home/tomcat/bin
и переименуем каталог build
на что-то по понятней, например на apache-tomcat-7
:
По умолчанию все веб-приложения помещаются в каталог webapps
каталога {$CATALINA_HOME}
. Мы создадим отдельный каталог куда будут помещаться веб-приложения, чтобы в сам каталог {$CATALINA_HOME}
не заходить без надобности, так как файлы веб-приложения могут меняться относительно часто в отличие от файлов самого контейнера сервлетов.
Перейдем в домашний каталог юзера tomcat
и создадим каталоге с таким же именем webapps
:
Теперь самое важное, у нас есть каталог веб-сервера /home/tomcat/bin/apache-tomcat-7 и есть каталог /home/tomcat/webapps куда будут помещаться веб приложения. Ограничим к ним доступ до юзера tomcat :
sudo chmod -R 700 /home/tomcat/bin/apache-tomcat-7 password for tomcat: sudo chmod -R 700 /home/tomcat/webappsТеперь пропишем путь к каталогу, в который будем помещать все вэб-приложения, в конфигурационном файле сервера server.xml . Перейдем в каталоге bin/apache-tomcat-7/conf , где хранятся все файлы конфигурации сервера, и откроем на редактирование файл server.xml . В теге Host поменяем значение атрибута appBase с webapps на /home/tomcat/webapps (строчка 124):
server.xml
Теперь добавим админку, с помощью которой юзеры смогут деплоить веб приложения, но для них юзер tomcat должен выдать соответствующие права. Но юзер tomcat выдаст себе права. Для этого переходим в каталог conf :
cd /home/tomcat/bin/apache-tomcat-7/confи открываем на редактирование файл tomcat-users.xml
.
Раскомментируем последние пять тегов, и добавим роли для usrename tomcat
:
Строчка 31:
tomcat-users.xml
Теперь удалим юзера tomcat из группы sudo . Зачем это делать? Затем, что sudo детям не игрушка, нам нужно было назначить юзера tomcat сюдоером, чтобы не переключаться постоянно в сюдоера, если нам надо было установить права на каталог где будут лежать веб-приложения и проч. Но а теперь, когда уже все сделано и мы точно знаем, что юзер tomcat не будет заниматься никакими другими админискими задачами кроме как запускать/останавливать сервер и настройку этого сервера, то и не зачем ему быть сюдоером. Для этого перейдем в другого сюдоера, и выполним от имени того другого сюдоера команду:
sudo gpasswd -d tomcat sudo Удаление пользователя tomcat из группы sudoЗдесь у команды gpasswd
ключ -d
означает удалить
юзера tomcat
из группы sudo
.
И последнее что осталось нам сделать это скопировать все веб-приложения из каталога /home/tomcat/bin/apache-tomcat-7/webapps
в наш созданный каталог /home/tomcat/webapps
:
Запуск веб-сервера tomcat
Все готово для запуска веб-сервера tomcat . Перейдем в каталог /home/tomcat/bin/apache-tomcat-7/bin и запустим скрипт ./startup.sh :
Cd /home/tomcat/bin/apache-tomcat-7/bin ./startup.sh Using CATALINA_BASE: /home/tomcat/bin/apache-tomcat-7 Using CATALINA_HOME: /home/tomcat/bin/apache-tomcat-7 Using CATALINA_TMPDIR: /home/tomcat/bin/apache-tomcat-7/temp Using JRE_HOME: /usr/java Using CLASSPATH: /home/tomcat/bin/apache-tomcat-7/bin/bootstrap.jar:/home/tomcat/bin/apache-tomcat-7/bin/tomcat-juli.jar Tomcat started.
Проверим, что tomcat запущен, для этого перейдем по линке http://localhpst:8080 и должна появится стартовая страница tomcat :
Теперь зайдем в админку, жмем на батон
Apache Tomcat - это контейнер, который позволяет вам использовать интернет приложения такие, как Java сервлеты и JSP (серверные страницы Java).
Пакеты Tomcat 6.0 в Ubuntu поддерживают два варианта запуска Tomcat. Вы можете установить его как классический одиночный экземпляр на всю систему, который будет запускаться при загрузке системы от имени непривилегированного пользователя tomcat6 . Но вы можете развернуть частные экземпляры, которые будут запускаться с правами вашего собственного пользователя, и вам придется запускать и останавливать их самостоятельно. Второй вариант особенно полезен в контексте сервера разработки, где нескольким пользователям требуется тестировать их собственные частные экземпляры Tomcat.
Масштабная установка на всю систему
Настройка
Изменение портов по умолчанию
Изначально Tomcat 6.0 запускает HTTP соединитель (connector) на порту 8080 и AJP соединитель на порту 8009. Вы можете захотеть изменить эти порты для избежания конфликтов с другими серверами на системе. Это делается изменением следующих строк в /etc/tomcat6/server.xml:
Изменение используемой JVM
По умолчанию Tomcat предпочитает использовать OpenJDK-6, затем пробует JVM от Sun (Oracle), а затем иные JVM. Если у вас установлено несколько JVM, вы можете определить какая из них будет использоваться, установив JAVA_HOME в /etc/default/tomcat6:
JAVA_HOME=/usr/lib/jvm/java-6-sun
Определение пользователей и ролей
Пользователи, пароли и роли (группы) могут быть определены централизованно в секции Servlet. Для Tomcat 6.0 это настраивается в файле /etc/tomcat6/tomcat-users.xml:
Использование стандартных приложений Tomcat
Tomcat поставляется с приложениями, которые вы можете установить для документирования, администрирования или демонстрационных целей.
Документация Tomcat
Пакет tomcat6-docs содержит документацию Tomcat 6.0, упакованную в качестве интернет приложения, которое доступно по умолчанию по адресу http://yourserver:8080/docs . Вы можете его установить следующей командой в терминале:
Sudo apt-get install tomcat6-docs
Приложения администрирования Tomcat
Пакет tomcat6-admin содержит два приложения, которые могут быть использованы для администрирования сервера Tomcat через web интерфейс. Для их установки введите следующую команду в терминале:
Sudo apt-get install tomcat6-admin
Первое из них это приложение manager , которое по умолчанию доступно по адресу http://yourserver:8080/manager/html . Оно в первую очередь используется для получения статуса сервера и перезапуска web приложений.
Доступ к приложению manager по умолчанию защищено: вам надо определить пользователя с ролью "manager" в /etc/tomcat6/tomcat-users.xml для получения к нему доступа.
Второе приложение - это host-manager , которое по умолчанию доступно вам по адресу http://yourserver:8080/host-manager/html . Оно может быть использовано для создания виртуальных хостов динамически.
Доступ к приложению host-manager также закрыто по умолчанию: вам надо определить пользователя с ролью "admin" в /etc/tomcat6/tomcat-users.xml для получения к нему доступа.
По соображениям безопасности пользователь tomcat6 по умолчанию не может писать в каталог /etc/tomcat6. Некоторые возможности в этих приложениях администрирования (разработка приложений, создание виртуальных хостов) требуют права записи на этот каталог. Если вы хотите пользоваться этими возможностями, выполните следующее для предоставления группе tomcat6 необходимых прав:
Sudo chgrp -R tomcat6 /etc/tomcat6 sudo chmod -R g+w /etc/tomcat6
Приложения примеров Tomcat
Пакет tomcat6-examples содержит два приложения, которые могут быть использованы для тестирования или демонстрации возможностей сервлетов и JSP, которые по умолчанию вы можете найти по адресу http://yourserver:8080/examples . Вы можете установить их следующей командой в терминале:
Sudo apt-get install tomcat6-examples
Использование пользовательских экземпляров
Tomcat в большей степени используется при разработке и тестировании, когда использование одиночной оболочки на сервере не удовлетворяет требованиям множества пользователей на одной системе. Пакеты Tomcat 6.0 в Ubuntu поставляются с инструментарием, помогающим создать ваши собственные настроенные на пользователя оболочки, позволяя каждому пользователю в системе запускать (без прав суперпользователя) отдельные частные экземпляры, при том, что они будут использовать библиотеки, установленные в системе.
Существует возможность запускать общий и частные экземпляры в параллель, до тех пор пока они не используют одни и те же TCP порты.
Установка поддержки частных оболочек
Вы можете установить все необходимое для запуска частных оболочек вводом следующей команды в терминале:
Sudo apt-get install tomcat6-user
Создание частного экземпляра
Вы можете создать каталог частной оболочки вводом следующей команды в терминале:
Tomcat6-instance-create my-instance
Это создаст новый каталог my-instance со всеми необходимыми подкаталогами и сценариями. Вы можете, например, установить свои общие библиотеки в подкаталог lib/ и развернуть свои приложения в подкаталоге webapps/. По умолчанию никакие приложения не разворачиваются.
Настройка вашего частного экземпляра
Вы обнаружите обычные файлы настроек Tomcat для вашего частного экземпляра в подкаталоге conf/. Вы конечно же можете отредактировать файл conf/server.xml для изменения портов по умолчанию, используемых вашим частным экземпляром Tomcat для предотвращения конфликтов с другими экземплярами, которые также могут быть запущены.
Запуск/остановка вашего частного экземпляра
Вы можете стартовать свой частный экземпляр, набрав следующую команду в терминале (подразумевается, что ваш экземпляр расположен в каталоге my-instance):
My-instance/bin/startup.sh
Вы можете проверить подкаталог logs/ на предмет обнаружения каких-либо ошибок. Если вы получили ошибку java.net.BindException: Address already in use
Вы можете остановить свой экземпляр, используя следующую команду в терминале (подразумевается, что ваш экземпляр все еще находится в каталоге my-instance).
Мне необходимо было настроить и запустить Tomcat на Mac OS X (Mountain Lion) и зарегистрировать данный сервер приложений (контейнер сервлетов) в NetBeans.
Для того чтобы это сделать, я выполнил следующие пункты.
Установка Tomcat
- Скачать архив Tomcat отсюда .
- Распаковать архив, например, в папку пользователя. ~/apache-tomcat-7.0.42
- Открыть программу «Терминал».
- Перейти в папку «bin» cd ~/apache-tomcat-7.0.42/bin и установить разрешение на запуск файлов с расширением.sh. sudo chmod +x ./*.sh
- Установить переменную окружения CATALINA_HOME. Для того чтобы она сохранилась не на время сессии в терминале, а постоянно, нужно ее прописать в файле «launchd.conf».
Создать/открыть файл (пример приведен с помощью редактора vi, но можно использовать любой другой, например emacs): sudo vi /etc/launchd.conf
Перейти в режим вставки: «клавиша s».
Записать туда текст: setenv CATALINA_HOME /Users/ХХХ/apache-tomcat-7.0.42
XXX - это имя вашего пользователя, если вы сохранили tomcat в папку пользователя как было указано в п.2, если нет, то укажите путь к папке, куда вы сохранили tomcat.
Закрыть режим вставки «клавиша Esc».
Перейти в режим команды «клавиша:».
Сохранить файл, команда «wq». - По умолчанию сервер настроен на порт 8080. Чтобы его изменить нужно перейти в папку «conf»: cd ~/apache-tomcat-7.0.42/conf
Открыть там файл «server.xml».
Найти тэг «Connector» где атрибут port равен «8080» и установить атрибут port в нужное Вам значение:
- По умолчанию пользователь, имеющий права публикации (deploy) на сервер через веб GUI или через скрипт, отключен. Его нужно прописать в файле «tomcat-users.xml». Для этого нужно перейти в папку «conf»: cd ~/apache-tomcat-7.0.42/conf
Открыть там файл «tomcat-users.xml» и добавить следующее (имя пользователя и пароль можно использовать отличающиеся от приведенных):
- Перезагрузить компьютер, чтобы установленная переменная окружения CATALINA_HOME установилась.
- Открыть программу «Терминал».
- Перейти в папку «bin» cd ~/apache-tomcat-7.0.42/bin
и запустить скрипт «startup.sh»
sh startup.sh
Должно отобразиться в терминале примерно следующее (в зависимости от ваших настроек системы): Using CATALINA_BASE: /Users/ХХХ/apache-tomcat-7.0.42 Using CATALINA_HOME: /Users/ХХХ/apache-tomcat-7.0.42 Using CATALINA_TMPDIR: /Users/ХХХ/apache-tomcat-7.0.42/temp Using JRE_HOME: /Library/Java/JavaVirtualMachines/jdk1.7.0_25.jdk/Contents/Home Using CLASSPATH: /Users/ХХХ/apache-tomcat-7.0.42/bin/bootstrap.jar:/Users/XXX/apache-tomcat-7.0.42/bin/tomcat-juli.jar - Запустить браузер и набрать в адресной сроке http://localhost:8080 . Если вы поменяли порт, как было указано в п. 6, то укажите свой порт.
- Должна открыться домашняя страница tomcat.
- По кнопке «Server status» можно посмотреть статус поднятого сервера. Нужно будет ввести имя пользователя и пароль созданные ранее.
- По кнопке «Manager App» можно публиковать (удалять) приложения. Нужно будет ввести имя пользователя и пароль созданные ранее.
- Остановка сервера выполняется следующим образом. Перейти в папку «bin» cd ~/apache-tomcat-7.0.42/bin
и запустить скрипт «shutdown.sh»
sh shutdown.sh
Регистрация сервера Tomcat в NetBeans
- Если была установлена 8 версия Tomcat, то необходимо сделать символьную ссылку на каталог библиотек.
ln -s /Users/XXX/apache-tomcat-8.0.0-RC3/lib /Users/XXX/apache-tomcat-8.0.0-RC3/common/lib - Открыть NetBeans
- Меню Сервис->Серверы
- В открывшемся окне нажать кнопку «Добавить сервер»
- В открывшемся окне выбрать «Apache Tomcat» и нажать кнопку «Далее»
- В следующей отображенной панели указать домашнюю папку Tomcat, например "/Users/ХХХ/apache-tomcat-7.0.42"
- Указать имя пользователя и пароль, созданные ранее. Нажать кнопку «Далее».
- Указать порт, если он был изменен ранее. Нажать кнопку «Готово».
- Для проверки можно создать Веб приложение и выбрать в качестве сервера приложений Apache Tomcat. После чего запустить его из NetBeans. Данное приложение развернется автоматически в Tomcat-е и запуститься в браузере, например под таким адресом: http://localhost:8090/WebApplication1 (обычно по умолчанию шаблон веб приложения содержит страничку jsp с текстом «Hello World!»).
Примечание
Это не относится к настройке Tomcat или регистрации сервера Tomcat в NetBeans, но некоторые приложения ищут java в папке /bin, а в Mac OS X java устанавливается в другие папки, но при этом есть символьная ссылка на java в папке /usr/bin.Таким образом нужно сделать еще одну символьную ссылку на java.
sudo ln -s /usr/bin/java /bin/java |
Apache Tomcat – это сервер приложений, который используется для обслуживания приложений Java. Tomcat – это открытая реализация технологий Java Servlet и JavaServer Pages, выпущенная Apache Software Foundation. Данное руководство описывает базовую установку и настойку Tomcat 8 на сервере Ubuntu 16.04.
Требования
- Предварительно настроенный сервер Ubuntu 16.04 (инструкции по начальной настройке – ).
- Не-root пользователь с доступом к sudo.
1: Установка Java
Для работы Tomcat необходимо установить Java, иначе код Java не будет выполняться. Установите OpenJDK при помощи стандартного пакетного менеджера apt-get.
Сначала нужно обновить индекс пакетов.
sudo apt-get update
Чтобы установить JDK, введите:
sudo apt-get install default-jdk
После установки Java создайте пользователя tomcat для запуска сервиса Tomcat.
2: Создание пользователя Tomcat
В целях безопасности сервер Tomcat следует запускать с правами обычного пользователя (т.е. не-рутового). Для этого создайте нового пользователя и группу.
Чтобы создать группу tomcat, введите:
sudo groupadd tomcat
После этого нужно создать пользователя tomcat, который должен состоять в одноименной группе. Домашний каталог пользователя – /opt/tomcat (в него будет установлен Tomcat); оболочка – /bin/false (чтобы никто не мог открыть учётную запись):
sudo useradd -s /bin/false -g tomcat -d /opt/tomcat tomcat
После этого приступайте к установке Tomcat.
3: Установка Tomcat
На данный момент Tomcat 8 проще всего установить вручную из бинарного релиза.
На странице загрузки найдите последнюю версию Tomcat. На данный момент такой версией является 8.0.33. В разделе Binary Distributions найдите список Core и скопируйте ссылку на tar.gz.
Перейдите в каталог /tmp на сервере. Этот каталог предназначен для временных пакетов.
Чтобы загрузить архив Tomcat, используйте следующую команду (приведенная ниже ссылка может отличаться):
curl -O http://apache.mirrors.ionfish.org/tomcat/tomcat-8/v8.0.33/bin/apache-tomcat-8.0.33.tar.gz
Установите Tomcat в каталог /opt/tomcat. Создайте этот каталог и извлеките в него архив:
sudo mkdir /opt/tomcat
sudo tar xzvf apache-tomcat-8*tar.gz -C /opt/tomcat --strip-components=1
После этого нужно установить соответствующие права на каталог.
4: Права
Пользователь tomcat должен иметь доступ к установке Tomcat.
Откройте каталог Tomcat:
Дайте пользователю tomcat право на изменение каталога conf и право на чтение файлов в нём:
sudo chgrp -R tomcat conf
sudo chmod g+rwx conf
sudo chmod g+r conf/*
Затем сделайте пользователя tomcat владельцем каталогов work, temp и logs.
sudo chown -R tomcat webapps/ work/ temp/ logs/
5: Создание файла systemd
Чтобы запустить Tomcat как сервис, нужно создать service-файл systemd.
Серверу Tomcat нужно знать, где находится установка Java. Этот путь называется JAVA_HOME. Чтобы узнать местонахождение установки, используйте команду:
sudo update-java-alternatives -l
java-1.8.0-openjdk-amd64 1081 /usr/lib/jvm/java-1.8.0-openjdk-amd64
Примечание : В данном примере JAVA_HOME выделен красным.
Теперь добавьте к полученному значению секцию /jre и установите в качестве значения JAVA_HOME:
JAVA_HOME
/usr/lib/jvm/java-1.8.0-openjdk-amd64/jre
Примечание : Переменная JAVA_HOME может отличаться.
Теперь можно создать service-файл. Откройте tomcat.service в каталоге /etc/systemd/system:
sudo nano /etc/systemd/system/tomcat.service
Внесите в файл следующий скрипт, при необходимости изменив JAVA_HOME; также можно изменить настройки распределения памяти, которые указаны в CATALINA_OPTS:
Description=Apache Tomcat Web Application Container
After=network.target
Type=forking
Environment=JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64/jre
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
WantedBy=multi-user.target
Сохраните и закройте файл.
После этого нужно перезапустить демон systemd:
sudo systemctl daemon-reload
Теперь сервис Tomcat готов к запуску. Для этого используйте:
sudo systemctl start tomcat
Убедитесь, что при запуске не произошло ошибок:
sudo systemctl status tomcat
6: Настройка брандмауэра и тестирование сервера Tomcat
После запуска сервиса Tomcat нужно убедиться, что стандартная страница доступна.
Но сначала нужно откорректировать настройки брандмауэра и разблокировать порт Tomcat. Если вы следовали , на данный момент сервер защищён брандмауэром ufw.
Для обработки запросов Tomcat использует порт 8080. Чтобы разблокировать трафик этого порта, введите:
sudo ufw allow 8080
Теперь брандмауэр пропускает трафик Tomcat. Чтобы получить доступ к стандартной странице сервиса, откройте ссылку:
http://server_domain_or_IP:8080
На экране появится приветственная страница Tomcat, которая содержит некоторую информацию о программе. Однако доступа к ссылкам (например, Manager App) у вас на данный момент нет.
Если всё работает должным образом, включите service-файл, чтобы сервис Tomcat автоматически запускался вместе с сервером.
sudo systemctl enable tomcat
7: Настройка веб-интерфейса управления Tomcat
Чтобы использовать поставляемый с Tomcat интерфейс, добавьте логин на сервер Tomcat. Для этого отредактируйте файл tomcat-users.xml:
sudo nano /opt/tomcat/conf/tomcat-users.xml
Теперь нужно добавить пользователя, который будет иметь доступ к поставляемым с Tomcat интерфейсам: manager-gui и admin-gui. Для этого можно использовать приведённый ниже код (но укажите более надёжное имя и пароль пользователя):
Сохраните и закройте файл tomcat-users.xml. Чтобы обновить настойки, перезапустите сервис Tomcat.
sudo systemctl restart tomcat
8: Доступ к веб-интерфейсу
Теперь сервер Tomcat запущен. Откройте в браузере веб-интерфейс управления. http://server_IP_address:8080
На экране появится страница с сообщением:
If you’re seeing this, you’ve successfully installed Tomcat. Congratulations!
Теперь откройте Manager App, доступный по ссылке:
http://server_IP_address:8080/manager/html
Этот менеджер нужен для управления приложениями Java. Он позволяет запускать, перезапускать, останавливать и сворачивать их. Кроме того, он может выполнять диагностику приложений (к примеру, обнаруживать утечки памяти). В конце этой страницы содержится информация о сервере.
Теперь откройте Host Manager:
http://server_IP_address:8080/host-manager/html/:
Страница Virtual Host Manager нужна для управления виртуальными хостами; она позволяет добавлять виртуальные хосты для развёртывания приложений.
Заключение
Готово! Теперь сервер Tomcat полностью готов к обслуживанию приложений Java.
Tags: ,