Apache Tomcat 11

指示已停止的应用程序重新启动，并使其再次可用。停止和启动很有用，例如，当您的应用程序所需的数据库暂时不可用时。通常最好停止依赖该数据库的 Web 应用程序，而不是让用户不断遇到数据库异常。

如果此命令成功，您将看到类似以下的消息：

OK - Started application at context path /examples

否则，消息将以 FAIL 开头，并包含错误消息。可能的问题原因包括：

• 遇到异常

  尝试启动 Web 应用程序时遇到异常。请检查 Tomcat 日志以获取详细信息。

• 指定了无效的上下文路径

  上下文路径必须以斜杠字符开头，除非您引用的是 ROOT Web 应用程序 -- 在这种情况下，上下文路径必须是零长度字符串。

• 路径 /foo 不存在上下文

  您指定的上下文路径上没有部署应用程序。

• 未指定上下文路径

  path 参数是必需的。

指示现有应用程序使其自身不可用，但保持部署状态。当应用程序停止时，任何传入的请求都将看到 HTTP 404 错误，并且此应用程序将在应用程序列表命令中显示为“已停止”。

如果此命令成功，您将看到类似以下的消息：

OK - Stopped application at context path /examples

否则，消息将以 FAIL 开头，并包含错误消息。可能的问题原因包括：

• 遇到异常

  尝试停止 Web 应用程序时遇到异常。请检查 Tomcat 日志以获取详细信息。

• 指定了无效的上下文路径

  上下文路径必须以斜杠字符开头，除非您引用的是 ROOT Web 应用程序 -- 在这种情况下，上下文路径必须是零长度字符串。

• 路径 /foo 不存在上下文

  您指定的上下文路径上没有部署应用程序。

• 未指定上下文路径

  path 参数是必需的。

指示现有应用程序自行关闭并重新加载。当 Web 应用程序上下文不可重新加载，并且您已更新 /WEB-INF/classes 目录中的类或属性文件，或者在 /WEB-INF/lib 目录中添加或更新了 jar 文件时，这会很有用。

注意： 重新加载时不会检查 /WEB-INF/web.xml Web 应用程序配置文件；将使用之前的 web.xml 配置。如果您更改了 web.xml 文件，则必须先停止再启动 Web 应用程序。

如果此命令成功，您将看到类似以下的消息：

OK - Reloaded application at context path /examples

否则，消息将以 FAIL 开头，并包含错误消息。可能的问题原因包括：

• 遇到异常

  尝试重新启动 Web 应用程序时遇到异常。请检查 Tomcat 日志以获取详细信息。

• 指定了无效的上下文路径

  上下文路径必须以斜杠字符开头，除非您引用的是 ROOT Web 应用程序 -- 在这种情况下，上下文路径必须是零长度字符串。

• 路径 /foo 不存在上下文

  您指定的上下文路径上没有部署应用程序。

• 未指定上下文路径

  path 参数是必需的。

• WAR 部署在路径 /foo 上不支持重载

  目前，当 Web 应用程序直接从 WAR 文件安装（发生在主机配置为不解压 WAR 文件时），不支持应用程序重载（以获取对类或 web.xml 文件的更改）。因为它只在 Web 应用程序从解压的目录安装时才有效，如果您正在使用 WAR 文件，则应该 取消部署 然后再次 部署 应用程序以获取您的更改。

警告 - 如果 Web 应用程序目录和/或 ".war" 文件存在于此虚拟主机的 appBase 目录（通常为 "webapps"）中，此命令将删除其内容。Web 应用程序的临时工作目录也将被删除。如果您只是想让应用程序停止服务，您应该使用 /stop 命令代替。

指示现有应用程序正常关闭，然后将其从 Tomcat 中移除（这也会使此上下文路径在以后可供重用）。此命令与 /deploy Ant 命令以及 HTML 管理器中可用的相关部署功能在逻辑上是相反的。

如果此命令成功，您将看到类似以下的消息：

OK - Undeployed application at context path /examples

否则，消息将以 FAIL 开头，并包含错误消息。可能的问题原因包括：

• 遇到异常

  尝试取消部署 Web 应用程序时遇到异常。请检查 Tomcat 日志以获取详细信息。

• 指定了无效的上下文路径

  上下文路径必须以斜杠字符开头，除非您引用的是 ROOT Web 应用程序 -- 在这种情况下，上下文路径必须是零长度字符串。

• 路径 /foo 不存在上下文

  您指定的上下文路径上没有部署应用程序。

• 未指定上下文路径 path 参数是必需的。

部署并启动一个新的 Web 应用程序，将其附加到指定的上下文路径：（该路径不能被其他 Web 应用程序使用）。此命令与取消部署命令在逻辑上相反。

部署命令有多种不同的用法。

Context Path: /footoo
WAR or Directory URL: file:C:/path/to/foo

WAR or Directory URL: jar:file:/path/to/bar.war!/

WAR or Directory URL: foo

Context Path: /bartoo
WAR or Directory URL: bar.war

<Context path="/foobar" docBase="C:\path\to\application\foobar">
</Context>

XML Configuration file URL: file:C:/path/to/context.xml

XML Configuration file URL: file:/path/to/context.xml
WAR or Directory URL: jar:file:/path/to/bar.war!/

从本地系统上传一个 WAR 文件，并将其安装到主机的 appBase 中。不带 ".war" 扩展名的 WAR 文件名将用作上下文路径名。

使用浏览按钮从本地桌面系统选择要上传到服务器的 WAR 文件。

WAR 文件可以通过在 /META-INF/context.xml 中包含一个上下文配置 XML 文件来包含 Tomcat 特定的部署配置。

WAR 文件上传失败的原因可能有以下几种：

• 上传文件必须是 .war 文件

  上传安装只接受文件扩展名为 ".war" 的文件。

• 服务器上已存在同名 WAR 文件

  如果您的主机 appBase 中已存在同名 WAR 文件，上传将失败。请取消部署主机 appBase 中现有的 WAR 文件，或使用不同的名称上传新 WAR 文件。

• 文件上传失败，没有文件

  文件上传失败，服务器没有收到任何文件。

• 安装上传失败，异常

  WAR 文件上传或安装因 Java 异常而失败。异常消息将列出。

如果主机配置了 unpackWARs=true 并且您安装了一个 war 文件，该 war 文件将被解压到您的 Host appBase 目录中的一个目录。

如果应用程序 WAR 文件或目录部署在您的 Host appBase 目录中，并且 Host 配置了 autoDeploy=true，则上下文路径必须与目录名或不带 ".war" 扩展名的 WAR 文件名匹配。

为了安全起见，当不受信任的用户可以管理 Web 应用程序时，可以将 Host deployXML 标志设置为 false。这可以防止不受信任的用户使用配置文件 XML 文件安装 Web 应用程序，并阻止他们安装位于其 Host appBase 之外的应用程序目录或 ".war" 文件。

如果部署和启动成功，您将收到类似以下的消息：

OK - Deployed application at context path /foo

否则，消息将以 FAIL 开头，并包含错误消息。可能的问题原因包括：

• 应用程序已存在于路径 /foo

  所有当前运行的 Web 应用程序的上下文路径必须是唯一的。因此，您必须取消部署使用此上下文路径的现有 Web 应用程序，或者为新应用程序选择不同的上下文路径。

• 文档基准不存在或不是可读目录

  WAR 或目录 URL: 字段指定的 URL 必须标识此服务器上包含 Web 应用程序“解压”版本的一个目录，或者包含此应用程序的 Web 应用程序存档 (WAR) 文件的绝对 URL。请更正WAR 或目录 URL: 字段中输入的值。

• 遇到异常

  尝试启动新的 Web 应用程序时遇到异常。请检查 Tomcat 日志以获取详细信息，但可能的原因包括解析 /WEB-INF/web.xml 文件时出现问题，或者初始化应用程序事件监听器和过滤器时缺少类。

• 指定了无效的应用程序 URL

  您为WAR 或目录 URL: 字段指定的 URL 无效。此类 URL 必须以 file: 开头，并且 WAR 文件的 URL 必须以 ".war" 结尾。

• 指定了无效的上下文路径

  上下文路径必须以斜杠字符开头，除非您引用的是 ROOT Web 应用程序——在这种情况下，上下文路径必须是“/”字符串。

• 上下文路径必须与目录或 WAR 文件名匹配

  如果应用程序 WAR 文件或目录部署在您的 Host appBase 目录中，并且 Host 配置了 autoDeploy=true，则上下文路径必须与目录名或不带 ".war" 扩展名的 WAR 文件名匹配。

• 只有 Host Web 应用程序目录中的 Web 应用程序才能被部署

  如果 Host deployXML 标志设置为 false，并且尝试在 Host appBase 目录之外安装 Web 应用程序目录或“.war”文件，则会发生此错误。

“查找内存泄漏”诊断会触发一次完全垃圾回收。在生产系统上应极其谨慎使用。

“查找内存泄漏”诊断试图识别在停止、重载或取消部署时导致内存泄漏的 Web 应用程序。结果应始终通过分析器进行确认。该诊断使用了 StandardHost 实现提供的额外功能。如果使用的是不扩展 StandardHost 的自定义主机，则它将无法工作。

此诊断将列出已停止、重新加载或未部署但其先前运行的类仍存在于内存中的 Web 应用程序的上下文路径，从而构成内存泄漏。如果一个应用程序已被重新加载多次，它可能会被列出多次。

从 Java 代码显式触发完全垃圾回收被记录为不可靠。此外，根据所使用的 JVM，存在禁用显式 GC 触发的选项，例如 -XX:+DisableExplicitGC。如果您想确保诊断成功运行了完全 GC，则需要使用 GC 日志、JConsole 或类似工具进行检查。