Tomcat9.0官方手冊中文版(一):入門介紹

1、引言

對於管理員和Web開發人員來說,在開始之前,您應該熟悉一些重要的信息。本文檔簡要介紹了Tomcat容器背後的一些概念和術語。同樣,當你需要幫助時,可以來這裡看看。

2、術語

在閱讀這些文件的過程中,您將遇到許多術語;一些特定於Tomcat,以及其他定義的Servlet and JSP specifications.

  • Context- 簡而言之,Context是一個Web應用程序。

3、目錄和文件

這是一些關鍵的tomcat目錄:

  • /bin- 啟動,關閉和其他腳本。其中的*.sh文件適合Unix系統,*.bat文件適用於Windows系統。由於Win32命令行缺少某些功能,因此這裡有一些額外的文件。
  • /conf- 配置文件和相關的DTD文件。這裡最重要的文件是server.xml。它是容器的主要配置文件。
  • /logs- 默認情況下,日誌文件在此處。
  • /webapps- 這是您的webapps的所在之地。

4、CATALINA_HOME和CATALINA_BASE

在整個文檔中,引用了以下兩個屬性:

  • CATALINA_HOME:例如,表示Tomcat安裝的根目錄/home/tomcat/apache-tomcat-9.0.10 或者 C:\\Program Files\\apache-tomcat-9.0.10.
  • CATALINA_BASE:表示特定Tomcat實例的運行時配置的根。如果要在一臺計算機上安裝多個Tomcat實例,請使用CATALINA_BASE 屬性.

如果將屬性設置為不同的位置,則CATALINA_HOME位置包含靜態源,例如.jar文件或二進制文件。 CATALINA_BASE位置包含配置文件,日誌文件,已部署的應用程序和其他運行時要求的文件。

5、為什麼使用CATALINA_BASE

默認情況下,CATALINA_HOME和CATALINA_BASE指向同一目錄。當您需要在一臺計算機上運行多個Tomcat實例時,請手動設置CATALINA_BASE。這樣做有以下好處:

  • 更輕鬆地管理升級到更新版本的Tomcat。因為具有單個CATALINA_HOME位置的所有實例共享一組.jar文件和二進制文件,您可以輕鬆地將文件升級到較新版本,並使用相同的CATALIA_HOME目錄將更改傳播到所有Tomcat實例。
  • 避免重複配置相同的靜態.jar 文件.
  • 共享某些設置,例如shell文件或bat腳本文件(取決於您的操作系統)。

6、CATALINA_BASE的內容

在開始使用CATALINA_BASE之前,首先考慮並創建CATALINA_BASE使用的目錄樹。請注意,如果您不創建所有推薦的目錄,Tomcat會自動創建目錄。如果無法創建必要的目錄,例如由於權限問題,Tomcat將無法啟動,或者可能無法正常運行。

請考慮以下目錄列表:

  • bin目錄並且包含setenv.sh, setenv.bat,以及 tomcat-juli.jar 文件。查找順序:首先查CATALINA_BASE下的bin路徑,然後查CATALINA_HOME路徑
  • lib目錄並且包含要在類路徑上添加的更多資源。 如果您的應用程序依賴於外部庫。 查找順序:首先檢查CATALINA_BASE; 然後是CATALINA_HOME。
  • logs目錄放特定於實例的日誌文件。
  • webapps目錄放置自動加載的Web應用程序。 如果要部署應用程序。 查找順序:僅限CATALINA_BASE。
  • work目錄包含已部署Web應用程序的臨時工作目錄。
  • temp目錄JVM用於臨時文件的目錄。

我們建議你不要改變tomcat-juli.jar文件。但是,如果您需要自己的日誌記錄實現,則可以替換tomcat-juli.jar在CATALINA_BASE位置中為特定Tomcat實例提供文件。

我們還建議您從中複製所有配置文件CATALINA_HOME/conf目錄進入CATALINA_BASE/conf/目錄。如果CATALINA_BASE中缺少配置文件,則不會回退到CATALINA_HOME。因此,這可能會導致失敗。

至少,CATALINA_BASE必須包含:

  • conf/server.xml
  • conf/web.xml

That includes the conf目錄。否則,Tomcat無法啟動或無法正常運行。

有關高級配置信息,請參閱 RUNNING.txt file.

7、如何使用CATALINA_BASE

CATALINA_BASE屬性是一個環境變量。您可以在執行Tomcat啟動腳本之前進行設置,例如:

  • On Unix: CATALINA_BASE=/tmp/tomcat_base1 bin/catalina.sh start
  • On Windows: CATALINA_BASE=C:\\tomcat_base1 bin/catalina.bat start

8、去哪裡尋求幫助

雖然我們已盡最大努力確保這些文件清晰易讀,但我們可能錯過了一些內容。下面提供了各種網站和郵件列表,以防您遇到困難。

請記住,Tomcat的主要版本之間的一些問題和解決方案各不相同。當您在網上搜索時,會有一些與Tomcat 9無關的文檔,但僅限於早期版本。

  • 當前文檔 - 大多數文檔將列出潛在的掛起。請務必完整閱讀相關文檔,因為這樣可以節省您的大量時間和精力。沒有什麼比搜索網絡只是為了找到答案就在你面前一直在你面前!
  • Tomcat FAQ
  • Tomcat WIKI
  • Tomcat FAQ at jGuru
  • Tomcat郵件列表存檔 - 眾多站點存檔Tomcat郵件列表。由於鏈接隨時間變化,點擊此處將搜索Google.
  • 您可以訂閱的TOMCAT-USER郵件列表here。如果您沒有得到答覆,那麼很可能您的問題可能會在列表存檔或其中一個常見問題解答中得到解答。雖然有時會詢問和回答有關Web應用程序開發的問題,但請將您的問題集中在Tomcat特定的問題上。
  • 您可以訂閱的TOMCAT-DEV郵件列表here. This list is reserved討論Tomcat自身的發展。有關Tomcat配置的問題以及在開發和運行應用程序時遇到的問題通常更適合TOMCAT-USER列表。


分享到:


相關文章: