TongWeb7-東方通 快速使用手冊

文章目錄

• 第1章 TongWeb7 產(chǎn)品介紹
• • 1.1 概述
  • 1.2 規(guī)范支持
• 第2章 TongWeb7 安裝
• • 2.1 TongWeb7 安裝要求
  • • 2.1.1 TongWeb7 支持的操作系統(tǒng)
    • 2.1.2 系統(tǒng)要求
    • 2.1.3 其他
  • 2.2 安裝TongWeb7
  • 2.3TongWeb7 目錄結(jié)構(gòu)說明
  • 2.4 TongWeb7 的啟動和停止
• 第3章 應(yīng)用部署
• • 3.1 創(chuàng)建數(shù)據(jù)源
  • 3.2 部署應(yīng)用
  • 3.3 測試并訪問應(yīng)用
• 第4章 常用 Web 主要參數(shù)調(diào)整
• • 4.1 JVM 堆內(nèi)存設(shè)置
  • 4.2 修改應(yīng)用訪問端口
  • 4.3 設(shè)置TongWeb7 日志
  • 4.4 關(guān)閉訪問日志
  • 4.5 設(shè)置并發(fā)線程數(shù)
  • 4.6 修改HTTP 通道
  • 4.7 JDBC 資源池相關(guān)性能參數(shù)
  • 4.8 JSP 預(yù)編譯

第1章 TongWeb7 產(chǎn)品介紹

1.1 概述

TongWeb7是遵循JavaEE7 Web Profile規(guī)范的企業(yè)級應(yīng)用服務(wù)器，它為企業(yè)應(yīng)用提供了可靠、可伸縮、可管理和高安全的基礎(chǔ)平臺。同時(shí)具有功能完善、支持開放標(biāo)準(zhǔn)和基于組件開發(fā)、多層架構(gòu)、輕量等特點(diǎn)，為開發(fā)和部署企業(yè)應(yīng)用提供了必需的底層核心功能。用戶通過TongWeb7的管理控制臺可方便的對應(yīng)用進(jìn)行管理，同時(shí)能夠監(jiān)控系統(tǒng)組件和應(yīng)用運(yùn)行時(shí)的狀態(tài)及調(diào)優(yōu)。因此TongWeb7適用于高度可用、可靠、可伸縮，穩(wěn)定的業(yè)務(wù)領(lǐng)域。

1.2 規(guī)范支持

類型

支持內(nèi)容

組件

JSP2.2
Servlet3.1
WebSocket1.0
JSF2.2
JSTL1.2
EJB3.2
EL3.0
JCA1.7
Debugging Support for Other Languages 1.0
Common Annotations for the Java Platform 1.2
JPA2.1
Bean Validation 1.1
CDI 1.1
JCA1.7
Dependency Injection for Java 1.0

資源和服務(wù)

JTA1.1
JDBC 4.0

協(xié)議

HTTP1.1
RMI

安全

JAAS1.0

第2章 TongWeb7 安裝

2.1 TongWeb7 安裝要求

2.1.1 TongWeb7 支持的操作系統(tǒng)

Windows 平臺

Linux 平臺

RedHat 系列

RedFlag 系列 Suse Linux 系列

Unix 平臺

Sun Microsystems Solaris 系列 IBM AIX 系列

2.1.2 系統(tǒng)要求

系統(tǒng)組件

系統(tǒng)要求

Java 環(huán)境

JDK1.7 以上

內(nèi)存

至少需要 512MB 的內(nèi)存

硬盤空間

至少需要 1024MB 磁盤空間

監(jiān)視器

圖形界面安裝需要 256 色，字符界面安裝沒有色彩要求

瀏覽器

Microsoft IE8 或 Firefox4.0 及以上版本瀏覽器

2.1.3 其他

TongWeb7 啟動前，需設(shè)置使用的 JDK 路徑，即設(shè)置本機(jī)環(huán)境變量 JAVA_HOME 值。

2.2 安裝TongWeb7

以在Linux下字符界面為例說明TongWeb7的安裝過程：

(1). 建立TongWeb7用戶賬戶或直接使用root用戶安裝。

(2).上傳TongWeb7安裝程序,如Install_TW7..._Standard_linux.bin至服務(wù)器機(jī)器，并賦予可執(zhí)行權(quán)限(chmod +x Install_TW7..._Standard_linux.bin)。

(3). 執(zhí)行命令./ Install_TW7...*_Standard_linux.bin –i console開始安裝。

(4). 出現(xiàn)如下信息的后，請輸入下圖中所述的 1 或者 2 或者直接回車表示默認(rèn)為 2

(5). 出現(xiàn)以下信息后，請按回車鍵接受安裝和使用許可協(xié)議。

(6). 出現(xiàn)以下信息后，請按回車鍵接受協(xié)議。

(7). 輸入“Y”，確認(rèn)接受本協(xié)議。

(8).出現(xiàn)如上信息后，請選擇是否接受許可條款，若接受請輸入“Y”。進(jìn)入選擇Java VM，默認(rèn)為當(dāng)前系統(tǒng)正在使用Java VM。

(9). 輸入TongWeb7安裝目錄并回車，若使用缺省目錄，直接回車。

(10).輸入“Y”，確認(rèn)安裝目錄。

(11).選擇“4”，不用建立連接。

(12).出現(xiàn)以下信息后，請確認(rèn)預(yù)安裝信息是否正確，若正確請按回車鍵繼續(xù)安裝。

(13).安裝中，等待進(jìn)度條走完。

(14). 安裝成功后提示修改端口。

(15).出現(xiàn)以上信息后，提示修改端口，若不修改、以上端口將作為默認(rèn)端口。

(16). 出現(xiàn)以下信息，安裝完成，請按回車鍵退出程序。

2.3TongWeb7 目錄結(jié)構(gòu)說明

目錄名稱

說明

autodeploy

服務(wù)器默認(rèn)提供的自動部署監(jiān)聽目錄。

bin

服務(wù)器啟動，停止等腳本文件所在目錄。

conf

服務(wù)器的配置文件所在目錄。

deployment

已部署應(yīng)用的應(yīng)用程序目錄。

applications

系統(tǒng)應(yīng)用所在目錄。

TongDataGrid

TongDataGrid 緩存所在目錄(標(biāo)準(zhǔn)版不存在該目錄)

lib

服務(wù)器運(yùn)行所需的類文件所在目錄，主要以 Jar 文件形式存在。

logs

服務(wù)器存放日志文件的目錄，日志文件包括訪問日志文件和服務(wù)器日志文件。

samples

TongWeb7 的示例目錄，示例包括 EJB、WEB 等模塊。

persistence

存放各類監(jiān)視量的持久化文件。

snapshot

存放服務(wù)器生成的快照文件。

native

Apr native 在不同平臺所需要的庫文件。

temp

服務(wù)器產(chǎn)生的臨時(shí)文件以及應(yīng)用預(yù)編譯文件所在的目錄。

2.4 TongWeb7 的啟動和停止

(1). 啟動TongWeb7需要進(jìn)入TongWeb7的bin 目錄，執(zhí)行如下命令：

./startservernohup.sh

注：這是后臺啟動方式，如果直接運(yùn)行startserver.sh，當(dāng)Telnet斷開后導(dǎo)致TongWeb7進(jìn)程退出。

(2). 當(dāng)日志中出現(xiàn)如下一行，沒有異常信息，說明TongWeb7啟動成功。

(3).在客戶端打開瀏覽器, 輸入TongWeb7控制臺地址: http://TongWebIP:9060/console，端口9060，前綴console，顯示出TongWeb7控制臺首頁面，輸入用戶名/密碼(默認(rèn)值:thanos/thanos123.com)登錄控制臺。

(4).停止 TongWeb7，需進(jìn)入 TongWeb7 的 bin 目錄執(zhí)行 stopserver.sh 。

第3章 應(yīng)用部署

本章采用自帶用例%TW7_HOME%/samples/jdbc/nonxa/nonXaDsWeb.war，介紹如何部署一個(gè)通過數(shù)據(jù)源訪問數(shù)據(jù)庫信息的應(yīng)用；

3.1 創(chuàng)建數(shù)據(jù)源

(1).啟動TongWeb7，進(jìn)入管理控制臺進(jìn)行JDBC連接池配置。

登錄TongWeb7管理控制臺,進(jìn)入“JDBC配置”界面，點(diǎn)擊“創(chuàng)建連接池”按鈕，如下圖：

配置參數(shù)：

名稱：testdb

資源類型：DataSource

數(shù)據(jù)庫驅(qū)動名稱：oracle.jdbc.driver.OracleDriver

連接 URL：jdbc:oracle:thin:@168.1.50.20:1521:orcl

數(shù)據(jù)庫驅(qū)動類名：oracle.jdbc.driver.OracleDriver

用戶名／密碼：twtest/twtest

驅(qū)動路徑：/home/test/ojdbc6.jar（注：驅(qū)動所在路徑）

點(diǎn)擊“下一步”,連接池其它參數(shù)采用默認(rèn)值，見下圖:

點(diǎn)擊“完成”,testdb創(chuàng)建成功。點(diǎn)擊“testdb”連接池后的測試連接，出現(xiàn)連接成功，如下圖：

3.2 部署應(yīng)用

TongWeb7可以從本機(jī)和服務(wù)器，以目錄或文件方式部署。但本機(jī)只能以文件方式部署，現(xiàn)介紹文件形式部署。

(1).登錄TongWeb7管理控制臺，進(jìn)入“應(yīng)用部署”界面，點(diǎn)擊“部署應(yīng)用”,如下圖：

配置參數(shù)：

文件位置：本機(jī)。

部署文件：d:TongWeb7samplesjdbc onxa onXaDsWeb.war（注：應(yīng)用所在路徑）。

點(diǎn)擊“開始部署”，進(jìn)入基本屬性配置界面。

配置參數(shù)：

應(yīng)用名稱：nonXaDsWeb

應(yīng)用前綴：/nonXaDsWeb

其余暫為默認(rèn)值

點(diǎn)擊“下一步”，如下圖

虛擬主機(jī)選擇“server”,點(diǎn)擊“完成”，開始部署應(yīng)用。

(1). 如果顯示部署成功，則整個(gè)部署過程完畢。同時(shí)注意觀察TongWeb7日志，看部署過程中有沒有異常信息。

3.3 測試并訪問應(yīng)用

(1).確認(rèn)應(yīng)用部署成功，日志中沒有異常信息出現(xiàn)。

(2).TongWeb7默認(rèn)為應(yīng)用分配的訪問端口為8088，通過http://IP:8088/nonXaDsWeb/可以訪問到應(yīng)用。

(3). 也可以點(diǎn)擊應(yīng)用后的“http訪問”，訪問到應(yīng)用。（注：TW7不自帶https通道，如果想通過https訪問，需要在“管理控制臺”－>“WEB容器配置”－>“HTTP通道管理”創(chuàng)建https通道）。

第4章 常用 Web 主要參數(shù)調(diào)整

本章簡單介紹影響性能的主要參數(shù)，以200用戶并發(fā)為基準(zhǔn)，此參數(shù)調(diào)整基本可保證系統(tǒng)正常運(yùn)行，但并不能保證調(diào)整的參數(shù)為最優(yōu)。

4.1 JVM 堆內(nèi)存設(shè)置

(1).修改%TW7_HOME%/bin目錄下external.vmoptions配置文件，在配置文件開始，根據(jù)需要設(shè)置JVM堆內(nèi)存大小，主要是增大堆內(nèi)存，用戶還可根據(jù)自己需要增加JVM參數(shù),建議設(shè)置如下：

(2).也可以在控制臺選擇“啟動參數(shù)配置”設(shè)置JVM堆內(nèi)存大小、垃圾回收方法等，如圖：

4.2 修改應(yīng)用訪問端口

有兩種方式可以修改應(yīng)用訪問端口。
方式一：
修改%TW7_HOME%/conf目錄下的tongweb.xml文件，找到8088端口后改為需要的端口。
方式二：
(1).進(jìn)入“管理控制臺”->“WEB容器配置”－>“HTTP通道管理”,點(diǎn)擊“tong-http-listener”修改8088端口,如圖:

(2).同時(shí)還可以為應(yīng)用配置多個(gè)訪問端口，具體見《TongWeb7用戶使用手冊》。

(3).在 Unix/Linux 下如果要使用 80 端口，則需要以 root 用戶啟、停 TongWeb7 服務(wù)器。

4.3 設(shè)置TongWeb7 日志

TongWeb7日志默認(rèn)通過輪轉(zhuǎn)方式生成，輪轉(zhuǎn)日志時(shí)將新建一個(gè)名為server.log的空文件，并將舊文件重命名為server.date_i，其中date是輪轉(zhuǎn)文件的日期,i為序列號。建議采用如下兩種方式，進(jìn)入“管理控制臺”－>“日志服務(wù)”－>“系統(tǒng)日志配置”里進(jìn)行配置,如圖：

設(shè)置方式一：按大小輪轉(zhuǎn)生成日志，如50M生成一個(gè)server.log。參數(shù)：

輪轉(zhuǎn)大小：50MB

日志數(shù)量：20 個(gè)（系統(tǒng)日志超過該數(shù)量后，會自動刪除較早的日志文件）

設(shè)置方式二：按周期生成日志，按設(shè)置的時(shí)間生成一個(gè)server.log。參數(shù)：

日志數(shù)量：30

輪轉(zhuǎn)周期：1 小時(shí)

設(shè)置方式三：按天生成日志，按每天生成一個(gè)server.log。參數(shù)：

日志數(shù)量：30

4.4 關(guān)閉訪問日志

訪問日志主要記錄應(yīng)用訪問的IP和URL，日志生成在%TW7_HOME%/logs目錄下。如果沒有需要可以停掉此日志，節(jié)省資源。進(jìn)入“管理控制臺”－>“WEB容器配置”－>“虛擬主機(jī)管理”，選擇應(yīng)用使用的虛擬主機(jī)，如“server”和“admin”, 將“訪問日志”開關(guān)的勾去掉并保存。如圖：

4.5 設(shè)置并發(fā)線程數(shù)

TongWeb7默認(rèn)的并發(fā)初始線程數(shù)只有5，實(shí)際使用時(shí)需根據(jù)并發(fā)數(shù)設(shè)置。進(jìn)入“管理控制臺”－> “WEB容器配置”－>“HTTP通道處理”中，編輯應(yīng)用所使用的通道，如” tong-http-listener”.如下：

最大線程數(shù): 200(注：暫時(shí)建議值)

初始線程數(shù): 50(注：暫時(shí)建議值)

等待隊(duì)列: 100(注：暫時(shí)建議值)

4.6 修改HTTP 通道

進(jìn)入“管理控制臺”－>“WEB容器配置”－>“HTTP通道管理”,點(diǎn)擊“tong-http-listener”修改參數(shù)，如圖:

以下幾個(gè)參數(shù)對大并發(fā)下設(shè)置才有效果，具體含義參考《TongWeb7用戶使用手冊》，暫時(shí)使用默認(rèn)值。

TCP_NODELAY

請求超時(shí)時(shí)間

最大長連接請求數(shù)

處理器緩存數(shù)量

4.7 JDBC 資源池相關(guān)性能參數(shù)

“管理控制臺”－>“JDBC配置”，修改創(chuàng)建的testdb連接池，對連接池影響較大的就是連接數(shù)，如圖：

最大連接數(shù)：100(注：暫時(shí)建議值)

初始連接數(shù)：10 (注：暫時(shí)建議值)

等待超時(shí)時(shí)間：30000 (注：暫時(shí)建議值)

4.8 JSP 預(yù)編譯

部署Web應(yīng)用時(shí)，有“JSP預(yù)編譯”功能，如果勾上此選項(xiàng)可在部署應(yīng)用時(shí)就將所有JSP編譯為class，但部署時(shí)間會增長。同時(shí)要保證所有的JSP文件語法正確，如果存在錯(cuò)誤的JSP 會導(dǎo)致編譯錯(cuò)誤，整個(gè)應(yīng)用部署失敗，如圖：

)