Apache Tomcat
Apache Tomcat — это контейнер, который позволяет вам использовать интернет приложения такие, как Java сервлеты и JSP (серверные страницы Java).
Пакеты Tomcat 6.0 в Ubuntu поддерживают два варианта запуска Tomcat. Вы можете установить его как классический одиночный экземпляр на всю систему, который будет запускаться при загрузке системы от имени непривилегированного пользователя tomcat6. Но вы можете развернуть частные экземпляры, которые будут запускаться с правами вашего собственного пользователя, и вам придется запускать и останавливать их самостоятельно. Второй вариант особенно полезен в контексте сервера разработки, где нескольким пользователям требуется тестировать их собственные частные экземпляры Tomcat.
Масштабная установка на всю систему
Для установки сервера Tomcat вам достаточно ввести следующую команду в терминале:
Это установит сервер Tomcat только с ROOT приложением, которое выдает минимальную страницу «It works» по умолчанию.
Настройка
Файл настроек Tomcat может быть найден в /etc/tomcat6. Здесь будут описаны только несколько общих элементов настройки; для более подробной информации обратитесь к документации по Tomcat 6.0.
Изменение портов по умолчанию
Изменение используемой JVM
По умолчанию Tomcat предпочитает использовать OpenJDK-6, затем пробует JVM от Sun (Oracle), а затем иные JVM. Если у вас установлено несколько JVM, вы можете определить какая из них будет использоваться, установив JAVA_HOME в /etc/default/tomcat6:
Определение пользователей и ролей
Пользователи, пароли и роли (группы) могут быть определены централизованно в секции Servlet. Для Tomcat 6.0 это настраивается в файле /etc/tomcat6/tomcat-users.xml:
Использование стандартных приложений Tomcat
Tomcat поставляется с приложениями, которые вы можете установить для документирования, администрирования или демонстрационных целей.
Документация Tomcat
Пакет tomcat6-docs содержит документацию Tomcat 6.0, упакованную в качестве интернет приложения, которое доступно по умолчанию по адресу http://yourserver:8080/docs. Вы можете его установить следующей командой в терминале:
Приложения администрирования Tomcat
Пакет tomcat6-admin содержит два приложения, которые могут быть использованы для администрирования сервера Tomcat через web интерфейс. Для их установки введите следующую команду в терминале:
Первое из них это приложение manager, которое по умолчанию доступно по адресу http://yourserver:8080/manager/html. Оно в первую очередь используется для получения статуса сервера и перезапуска web приложений.
Второе приложение — это host-manager, которое по умолчанию доступно вам по адресу http://yourserver:8080/host-manager/html. Оно может быть использовано для создания виртуальных хостов динамически.
По соображениям безопасности пользователь tomcat6 по умолчанию не может писать в каталог /etc/tomcat6. Некоторые возможности в этих приложениях администрирования (разработка приложений, создание виртуальных хостов) требуют права записи на этот каталог. Если вы хотите пользоваться этими возможностями, выполните следующее для предоставления группе tomcat6 необходимых прав:
Приложения примеров Tomcat
Пакет tomcat6-examples содержит два приложения, которые могут быть использованы для тестирования или демонстрации возможностей сервлетов и JSP, которые по умолчанию вы можете найти по адресу http://yourserver:8080/examples. Вы можете установить их следующей командой в терминале:
Использование пользовательских экземпляров
Tomcat в большей степени используется при разработке и тестировании, когда использование одиночной оболочки на сервере не удовлетворяет требованиям множества пользователей на одной системе. Пакеты Tomcat 6.0 в Ubuntu поставляются с инструментарием, помогающим создать ваши собственные настроенные на пользователя оболочки, позволяя каждому пользователю в системе запускать (без прав суперпользователя) отдельные частные экземпляры, при том, что они будут использовать библиотеки, установленные в системе.
Установка поддержки частных оболочек
Вы можете установить все необходимое для запуска частных оболочек вводом следующей команды в терминале:
Создание частного экземпляра
Вы можете создать каталог частной оболочки вводом следующей команды в терминале:
Это создаст новый каталог my-instance со всеми необходимыми подкаталогами и сценариями. Вы можете, например, установить свои общие библиотеки в подкаталог lib/ и развернуть свои приложения в подкаталоге webapps/. По умолчанию никакие приложения не разворачиваются.
Настройка вашего частного экземпляра
Вы обнаружите обычные файлы настроек Tomcat для вашего частного экземпляра в подкаталоге conf/. Вы конечно же можете отредактировать файл conf/server.xml для изменения портов по умолчанию, используемых вашим частным экземпляром Tomcat для предотвращения конфликтов с другими экземплярами, которые также могут быть запущены.
Запуск/остановка вашего частного экземпляра
Вы можете стартовать свой частный экземпляр, набрав следующую команду в терминале (подразумевается, что ваш экземпляр расположен в каталоге my-instance):
Вы можете остановить свой экземпляр, используя следующую команду в терминале (подразумевается, что ваш экземпляр все еще находится в каталоге my-instance):
Ссылки
Смотрите сайт Apache Tomcat для дополнительной информации.
Tomcat: The Definitive Guide — хороший ресурс для построения web приложений на Tomcat.
Tomcat
If deploying Tomcat onto a production environment, consider installing tomcat-native . The native library for Tomcat configures the server to use the Apache Portable Runtime (APR) library’s network connection (socket) and RNG implementations. It uses native 32- or 64-bit code to enhance performance and is sometimes used in production environments where speed is crucial. No configuration is necessary for default Tomcat installations. More information is available in the official Tomcat docs. To install Tomcat in version 9 which is needed for servlet specification 4.0 is at the moment missing and will come soon as possible. To install tomcat in version 9 follow the instructions in the official Tomcat 9 docs.
Using tomcat-native will remove the following warning in catalina.err :
Filesystem hierarchy
Replace the * with your installed version (7 or 8).
| Pathname | Use |
|---|---|
| /etc/tomcat* | Configuration files. Among some: tomcat-users.xml (defines users allowed to use administration tools and their roles), server.xml (Main Tomcat configuration file), catalina.policy (security policies configuration file) |
| /usr/share/tomcat* | Main Tomcat folder containing scripts and links to other directories |
| /usr/share/java/tomcat* | Tomcat Java libraries (jars) |
| /var/log/tomcat* | Log files not handled by systemd (see #Logging) |
| /var/lib/tomcat*/webapps | Where Tomcat deploys your web applications |
| /var/tmp/tomcat* | Where Tomcat store your webapps’ data |
Initial configuration
In order to be able to use the manager webapp and the admin webapp you need to edit the following file: /etc/tomcat7/tomcat-users.xml
Uncomment the «role and user» XML declaration and modify it to enable roles tomcat , admin-gui , admin-script and/or manager-gui , manager-script , manager-jmx , manager-status depending on your needs (see Configuring Manager Application Access). To keep it short, tomcat is the mandatory role used to run, manager-* are roles able to administer web applications and admin-* are full right administrator roles on the Tomcat server.
Here is a bare configuration file that declares some of these roles along with usernames and passwords (Be sure to change the following [CHANGE_ME] passwords to something secure):
Keep in mind that Tomcat must be restarted each time a modification is made to this file.
This blog post gives a good description of these roles.
To have read permissions on the configuration files and work well with some IDEs, you must add your user to the `tomcat7` (respectively `tomcat8`) group:
Start/stop Tomcat
Once Tomcat is started, you can visit this page to see the result: http://localhost:8080. If a nice Tomcat local home page is displayed this means your Servlet container is up and running and ready to host you web apps. If the startup script failed or you can only see a Java error displayed in you browser, have a look at startup logs using systemd’s journalctl. Google is full of answers on recurrent issues found in Tomcat logs.
Alternate «manual» way
Tomcat can also be controlled directly using upstream scripts:
This can be useful to debug applications or even debug Tomcat, but do not use it to start Tomcat for the first time as doing so can set some permissions wrongly and stop web apps from working. In order to be able to use these scripts, some further configuration may be needed. Be aware that using these scripts prevents the jsvc security advantage described above.
Deploy and handle web applications
Tomcat 7 is bundled with 5 already deployed web applications (change localhost with your server’s FQDN if needed):
- The default home page: http://localhost:8080/
- Tomcat 7’s local documentation: http://localhost:8080/docs/
- Examples of Servlets and JSP: http://localhost:8080/examples/
- The host-manager to handle virtual hosts: http://localhost:8080/host-manager/
- The manager to administer web applications: http://localhost:8080/manager/html/
The GUI way
Probably the easiest way is to use the manager webapp http://localhost:8080/manager/html. Use the username/password you defined as manager in tomcat-users.xml . Once logged in you can see five already deployed web applications. Add yours through the «Deploy» area and then stop/start/undeploy it with the «Applications» area.
The CLI way
One can also just copy the WAR file of the application to directory /usr/share/tomcat8/webapps . For that later, be sure that the autoDeploy option is still set for the right host as shown here:
Hosting files outside the webapps folder
If you want to keep your project outside the webapps folder this is possible by creating a Context . Go to /etc/tomcat<number>/Catalina/localhost/ and create your context. A context is a simple xml file which specifies where tomcat should look for the project. The basic format of the file is
A working example is as follows. This assumes that the project is hosted somewhere in the users /home-folder.
The files can now be hosted in /home/archie/code/jsp/myProject/ . To see the project in your webbrowser, go to http://localhost:8080/myProject. If tomcat is unable to load the files, it might be an issue with permissions. chmod o+x /home/archie/code/jsp/myProject should fix the issue.
Logging
Tomcat when used with official Arch Linux packages uses systemd’s journalctl for startup log. This means that files /var/log/tomcat7/catalina.err and /var/log/tomcat7/catalina.out are not used. Other logs such as access logs and business logs defined in /etc/tomcat7/server.xml as Valve will still by default end up in /var/log/tomcat7/ .
To restore upstream style logging, copy systemd file /lib/systemd/system/tomcat7.service to /etc/systemd/system/tomcat7.service and change both SYSLOG for the absolute paths of log files.
Further setup
Basic configuration can be made through the virtual host manager web application: http://localhost:8080/host-manager/html. Provide the username/password you set in tomcat-users.xml . Other options are tweaked in configuration files in /etc/tomcat7 , the most important being server.xml . Using these files is out of the scope of this 101 wiki page. Please have a look at the official Tomcat 7 documentation for more details.
Migrating from previous versions of Tomcat
As said in the introduction, Tomcat 8 does not deprecate Tomcat 7. They are all three, implementations of Servlet/JSP standards. Hence you must first determine which version of Tomcat you need depending on the versions of Servlet/JSP your application uses. If you need to migrate, the official website gives instructions on how to handle such a process.
Using Tomcat with a different JRE/JDK
Apart from installing the desired JRE/JDK, the only requirement is to set the TOMCAT_JAVA_HOME variable with a drop-in file:
Security configuration
This page gives the bare minimum to get your first web application to run on Tomcat. It is not intended to be the definitive guide to administering Tomcat (it is a job of its own). The official Tomcat website will provide all necessary official matter. One could also refer to this O’Reilly page and this last one. Still, here are some security tips to get you started:
- Keep your Tomcat installation up to date to get the latest fixes to security issues
- Remove unwanted default applications such as examples , docs , default home page ROOT («_» in the manager webapp). This prevents potential security holes to be exploited. Use the manager for that.
For more security you could even remove the host-manager and manager web applications. Keep in mind that the later is useful to deploy web applications.
- Disable the WAR auto-deploy option. This would prevent someone who gained restricted access to the server to copy a WAR into the /usr/share/java/webapps directory to get it running. Edit server.xml and set the autoDeploy to false :
- Anonymize Tomcat’s default error page to prevent potential attackers to retrieve Tomcat’s version. To see what Tomcat says by default, just visit an nonexistent page such as http://localhost:8080/I_dont_exist. You get a 404 error page with Tomcat’s version at the bottom.
To anonymize this, edit/open the following JAR (Editors like vim can edit zips directly)
And edit the following file
- Disable unused connectors in server.xml
- Keep restricted access to /etc/tomcat7/server.xml . Only tomcat user and/or root should be able to read and write this.
- Keep jsvc usage. Do not use upstream startup scripts unless particular reason as explained in the security note above.
- Use strong different passwords for each user in tomcat-users.xml , give roles to users who really need them and even disable usernames/roles you do not use/need.
One can even crypt tomcat-users.xml passwords using the following upstream script:
This will output something like:
Paste the hashed part in place of the clear password in tomcat-users.xml and add the following to server.xml :
Note that this may not be relevant because only root and/or tomcat is supposed to have read/write access to that file. If an intruder manages to gain root access then he would not need such passwords to mess with your applications/data anyway. Be sure to keep restricted RW access to that file!
- Always know what you are deploying
Troubleshooting
Tomcat service is started, but page is not loaded
First check /etc/tomcat7/tomcat-users.xml for any syntax error. If everything is fine and tomcat7 is correctly running, run journalctl -r as root to check the logs for any exception thrown (see Logging). If you read anything like java.lang.Exception: Socket bind failed: [98] Address already in use , this is due to some other service listening on the same port. For instance, it is possible that Apache HTTP Server and Tomcat are listening on the same port (if for example you have Apache running on port 8080 with Nginx serving it as a proxy on port 80). If this is the case, edit the /etc/tomcat7/server.xml file and change the Connector port to something else under <Service name=»Catalina»> :
Finally restart tomcat7 and httpd services.
If you have no solution and you are in a VM, it can help to delete /dev/random and create it again (cf. Solution: FUTEX_WAIT hangs Java on Linux / Ubuntu in vmware or virtual box):
Apache Tomcat
Tomcat (в старых версиях — Catalina) — контейнер сервлетов с открытым исходным кодом, разрабатываемый Apache Software Foundation. Реализует спецификацию сервлетов и спецификацию JavaServer Pages (JSP). Написан на языке Java.
Tomcat позволяет запускать веб-приложения, содержит ряд программ для самоконфигурирования.
Tomcat используется в качестве самостоятельного веб-сервера, в качестве сервера контента в сочетании с веб-сервером Apache HTTP Server, а также в качестве контейнера сервлетов в серверах приложений JBoss и GlassFish.
Содержание
Разработка
Разработка и поддержка Tomcat осуществляется фондом Apache Software Foundation и добровольцами. Пользователи имеют свободный доступ к исходным кодам и бинарным файлам Tomcat согласно лицензии Apache License 2.0. Номера версий Tomcat начинаются с 3.0.x (предыдущие версии были выпущены Sun для внутреннего пользования).
Компоненты
Tomcat версии 4.x был выпущен с Jasper (перепроектированный механизм JSP), Catalina (перепроектированный контейнер сервлетов) и Coyote (стек HTTP).
Catalina
Catalina — контейнер сервлетов Tomcat’а. Catalina реализует спецификацию сервлетов и JavaServer Pages (JSP). Архитектором Catalina являлся Craig McClanahan.
Coyote
Coyote — компонент стека HTTP Tomcat’а, который поддерживает протокол HTTP 1.1 для веб серверов или контейнера приложений. Coyote прослушивает входящие соединения на определённом TCP порту сервера и пересылает запросы в механизм Tomcat для обработки запросов и отправляет ответ назад запрашивающему клиенту.
Jasper
Jasper — механизм JSP Tomcat’а. Tomcat 5.x использует Jasper 2, который является реализацией спецификации JavaServer Pages 2.0 Sun Microsystems. Jasper анализирует JSP-файлы, чтобы компилировать их в Java код, как сервлеты (которые могут быть обработаны с помощью Catalina). Во время выполнения, Jasper может автоматически обнаруживать изменения JSP-файла и перекомпилировать его.