• 海淀北部生态科技新区新技术新产品项目推介会举行 2019-10-13
  • 守住青山不放松 护好绿水不辞难——在渝全国人大代表聚焦“共抓大保护、不搞大开发”专题调研记略 2019-10-13
  • 沃尔沃S60也玩性能版,或售45万起剑指奥迪S4,就问你怕了吗? 2019-10-11
  • 鹰潭摊贩卖野生蘑菇幸被执法人员当场销毁 2019-10-10
  • 拉萨市墨竹工卡县全力打造“绿色矿山” 2019-10-08
  • LADY咔咔(39)这个小三儿你媳妇也喜欢 2019-10-02
  • 【端午话民俗】指尖上的端午节 师生一起包粽子做香包体验传统文化 2019-10-02
  • 四个"记者团"与一个"培训班"的故事 2019-10-02
  • 北京市北京盈之宝4S店【在线咨询】 2019-10-02
  • 新华时评:美挑贸易战 失信于人输了世界 2019-10-01
  • 中央环保督察组向江西移交1258件信访问题线索 2019-09-29
  • 高清:C罗帽子戏法科斯塔梅开二度 葡萄牙3 2019-09-28
  • 学会了脆皮炸香蕉 再也不会把香蕉放到烂啦-美食资讯 2019-09-21
  • 网友给太原市市长留言获回复 共计11条 2019-08-22
  • 香港举行春节彩灯展(1) 2019-08-21
  • 
      The Apache Tomcat Servlet/JSP Container

    微信h5十三水:Apache Tomcat 7

    Version 7.0.52, Feb 13 2014
    Apache Logo

    闲来疯狂十三水 www.aipom.tw Links

    User Guide

    Reference

    Apache Tomcat Development

    Tomcat Web Application Deployment

    Table of Contents
    Introduction

    Deployment is the term used for the process of installing a web application (either a 3rd party WAR or your own custom web application) into the Tomcat server.

    Web application deployment may be accomplished in a number of ways within the Tomcat server.

    • Statically; the web application is setup before Tomcat is started
    • Dynamically; by directly manipulating already deployed web applications (relying on auto-deployment feature) or remotely by using the Tomcat Manager web application

    The Tomcat Manager is a web application that can be used interactively (via HTML GUI) or programmatically (via URL-based API) to deploy and manage web applications.

    There are a number of ways to perform deployment that rely on the Manager web application. Apache Tomcat provides tasks for Apache Ant build tool. Apache Tomcat Maven Plugin project provides integration with Apache Maven. There is also a tool called the Client Deployer, which can be used from a command line and provides additional functionality such as compiling and validating web applications as well as packaging web application into web application resource (WAR) files.

    Installation

    There is no installation required for static deployment of web applications as this is provided out of the box by Tomcat. Nor is any installation required for deployment functions with the Tomcat Manager, although some configuration is required as detailed in the Tomcat Manager manual. An installation is however required if you wish to use the Tomcat Client Deployer (TCD).

    The TCD is not packaged with the Tomcat core distribution, and must therefore be downloaded separately from the Downloads area. The download is usually labelled apache-tomcat-7.0.x-deployer.

    TCD has prerequisites of Apache Ant 1.6.2+ and a Java installation. Your environment should define an ANT_HOME environment value pointing to the root of your Ant installation, and a JAVA_HOME value pointing to your Java installation. Additionally, you should ensure Ant's ant command, and the Java javac compiler command run from the command shell that your operating system provides.

    1. Download the TCD distribution
    2. The TCD package need not be extracted into any existing Tomcat installation, it can be extracted to any location.
    3. Read Using the Tomcat Client Deployer
    A word on Contexts

    In talking about deployment of web applications, the concept of a Context is required to be understood. A Context is what Tomcat calls a web application.

    In order to configure a Context within Tomcat a Context Descriptor is required. A Context Descriptor is simply an XML file that contains Tomcat related configuration for a Context, e.g naming resources or session manager configuration. In earlier versions of Tomcat the content of a Context Descriptor configuration was often stored within Tomcat's primary configuration file server.xml but this is now discouraged (although it currently still works).

    Context Descriptors not only help Tomcat to know how to configure Contexts but other tools such as the Tomcat Manager and TCD often use these Context Descriptors to perform their roles properly.

    The locations for Context Descriptors are:

    1. $CATALINA_BASE/conf/[enginename]/[hostname]/[webappname].xml
    2. $CATALINA_BASE/webapps/[webappname]/META-INF/context.xml

    Files in (1) are named [webappname].xml but files in (2) are named context.xml. If a Context Descriptor is not provided for a Context, Tomcat configures the Context using default values.

    Deployment on Tomcat startup

    If you are not interested in using the Tomcat Manager, or TCD, then you'll need to deploy your web applications statically to Tomcat, followed by a Tomcat startup. The location you deploy web applications to for this type of deployment is called the appBase which is specified per Host. You either copy a so-called exploded web application, i.e non-compressed, to this location, or a compressed web application resource .WAR file.

    The web applications present in the location specified by the Host's (default Host is "localhost") appBase attribute (default appBase is "$CATALINA_BASE/webapps") will be deployed on Tomcat startup only if the Host's deployOnStartup attribute is "true".

    The following deployment sequence will occur on Tomcat startup in that case:

    1. Any Context Descriptors will be deployed first.
    2. Exploded web applications not referenced by any Context Descriptor will then be deployed. If they have an associated .WAR file in the appBase and it is newer than the exploded web application, the exploded directory will be removed and the webapp will be redeployed from the .WAR
    3. .WAR files will be deployed
    Deploying on a running Tomcat server

    It is possible to deploy web applications to a running Tomcat server.

    If the Host autoDeploy attribute is "true", the Host will attempt to deploy and update web applications dynamically, as needed, for example if a new .WAR is dropped into the appBase. For this to work, the Host needs to have background processing enabled which is the default configuration.

    autoDeploy set to "true" and a running Tomcat allows for:

    • Deployment of .WAR files copied into the Host appBase.
    • Deployment of exploded web applications which are copied into the Host appBase.
    • Re-deployment of a web application which has already been deployed from a .WAR when the new .WAR is provided. In this case the exploded web application is removed, and the .WAR is expanded again. Note that the explosion will not occur if the Host is configured so that .WARs are not exploded with a unpackWARs attribute set to "false", in which case the web application will be simply redeployed as a compressed archive.
    • Re-loading of a web application if the /WEB-INF/web.xml file (or any other resource defined as a WatchedResource) is updated.
    • Re-deployment of a web application if the Context Descriptor file from which the web application has been deployed is updated.
    • Re-deployment of dependent web applications if the global or per-host Context Descriptor file used by the web application is updated.
    • Re-deployment of a web application if a Context Descriptor file (with a filename corresponding to the Context path of the previously deployed web application) is added to the $CATALINA_BASE/conf/[enginename]/[hostname]/ directory.
    • Undeployment of a web application if its document base (docBase) is deleted. Note that on Windows, this assumes that anti-locking features (see Context configuration) are enabled, otherwise it is not possible to delete the resources of a running web application.

    Note that web application reloading can also be configured in the loader, in which case loaded classes will be tracked for changes.

    Deploying using the Tomcat Manager

    The Tomcat Manager is covered in its own manual page.

    Deploying using the Client Deployer Package

    Finally, deployment of web application may be achieved using the Tomcat Client Deployer. This is a package which can be used to validate, compile, compress to .WAR, and deploy web applications to production or development Tomcat servers. It should be noted that this feature uses the Tomcat Manager and as such the target Tomcat server should be running.

    It is assumed the user will be familiar with Apache Ant for using the TCD. Apache Ant is a scripted build tool. The TCD comes pre-packaged with a build script to use. Only a modest understanding of Apache Ant is required (installation as listed earlier in this page, and familiarity with using the operating system command shell and configuring environment variables).

    The TCD includes Ant tasks, the Jasper page compiler for JSP compilation before deployment, as well as a task which validates the web application Context Descriptor. The validator task (class org.apache.catalina.ant.ValidatorTask) allows only one parameter: the base path of an exploded web application.

    The TCD uses an exploded web application as input (see the list of the properties used below). A web application that is programmatically deployed with the deployer may include a Context Descriptor in /META-INF/context.xml.

    The TCD includes a ready-to-use Ant script, with the following targets:

    • compile (default): Compile and validate the web application. This can be used standalone, and does not need a running Tomcat server. The compiled application will only run on the associated Tomcat X.Y.Z server release, and is not guaranteed to work on another Tomcat release, as the code generated by Jasper depends on its runtime component. It should also be noted that this target will also compile automatically any Java source file located in the /WEB-INF/classes folder of the web application.
    • deploy: Deploy a web application (compiled or not) to a Tomcat server.
    • undeploy: Undeploy a web application
    • start: Start web application
    • reload: Reload web application
    • stop: Stop web application

    In order for the deployment to be configured, create a file called deployer.properties in the TCD installation directory root. In this file, add the following name=value pairs per line:

    Additionally, you will need to ensure that a user has been setup for the target Tomcat Manager (which TCD uses) otherwise the TCD will not authenticate with the Tomcat Manager and the deployment will fail. To do this, see the Tomcat Manager page.

    • build: The build folder used will be, by default, ${build}/webapp/${path}. After the end of the execution of the compile target, the web application .WAR will be located at ${build}/webapp/${path}.war.
    • webapp: The directory containing the exploded web application which will be compiled and validated. By default, the folder is myapp.
    • path: Deployed context path of the web application, by default /myapp.
    • url: Absolute URL to the Tomcat Manager web application of a running Tomcat server, which will be used to deploy and undeploy the web application. By default, the deployer will attempt to access a Tomcat instance running on localhost, at //localhost:8080/manager/text.
    • username: Tomcat Manager username (user should have a role of manager-script)
    • password: Tomcat Manager password.
    Comments

    Notice: This comments section collects your suggestions on improving documentation for Apache Tomcat.

    If you have trouble and need help, read Find Help page and ask your question on the tomcat-users 闲来疯狂十三水. Do not ask such questions here. This is not a Q&A section.

    The Apache Comments System is explained here. Comments may be removed by our moderators if they are either implemented or considered invalid/off-topic.


    Copyright © 1999-2014, Apache Software Foundation
  • 海淀北部生态科技新区新技术新产品项目推介会举行 2019-10-13
  • 守住青山不放松 护好绿水不辞难——在渝全国人大代表聚焦“共抓大保护、不搞大开发”专题调研记略 2019-10-13
  • 沃尔沃S60也玩性能版,或售45万起剑指奥迪S4,就问你怕了吗? 2019-10-11
  • 鹰潭摊贩卖野生蘑菇幸被执法人员当场销毁 2019-10-10
  • 拉萨市墨竹工卡县全力打造“绿色矿山” 2019-10-08
  • LADY咔咔(39)这个小三儿你媳妇也喜欢 2019-10-02
  • 【端午话民俗】指尖上的端午节 师生一起包粽子做香包体验传统文化 2019-10-02
  • 四个"记者团"与一个"培训班"的故事 2019-10-02
  • 北京市北京盈之宝4S店【在线咨询】 2019-10-02
  • 新华时评:美挑贸易战 失信于人输了世界 2019-10-01
  • 中央环保督察组向江西移交1258件信访问题线索 2019-09-29
  • 高清:C罗帽子戏法科斯塔梅开二度 葡萄牙3 2019-09-28
  • 学会了脆皮炸香蕉 再也不会把香蕉放到烂啦-美食资讯 2019-09-21
  • 网友给太原市市长留言获回复 共计11条 2019-08-22
  • 香港举行春节彩灯展(1) 2019-08-21
  • 理财婆一肖一码期期准 重庆时时综合走势图 足彩胜负14场 中信彩票注册 时时彩后二36码 紫金国际app 大唐炸金花技巧规律 电子投注单有实体票吗 快乐时时开奖号码 时时彩遗漏