本文介紹了Linux系統(tǒng)下Jboss-eap-7.1服務(wù)器 standalone 模式的配置部署入門(mén)田绑。90%的內(nèi)容來(lái)自jboss的官方配置文檔德澈,只不過(guò)從初學(xué)者的角度對(duì)配置過(guò)程進(jìn)行了梳理倍啥,介紹了部署應(yīng)用時(shí)普遍會(huì)用到的配置項(xiàng)技俐。參考本文,大多數(shù)應(yīng)用可以在Jboss-eap-7.1上成功運(yùn)行惑畴。
下文出現(xiàn)的命令黍少、代碼和文件地址中寡夹,${JBOSS_HOME}指代Jboss-eap-7.1所處的根目錄。
安裝與啟動(dòng)厂置、停止
安裝:所謂“安裝”,就是把下載好的包解壓到某個(gè)地址即可魂角。
啟動(dòng):進(jìn)入${JBOSS_HOME}/bin目錄昵济,執(zhí)行 standalone.sh 腳本,看到輸出started in XXXXms
野揪,就證明服務(wù)器已經(jīng)成功啟動(dòng)访忿。
停止:服務(wù)器的進(jìn)程通常都是后臺(tái)運(yùn)行。停止時(shí)斯稳,在${JBOSS_HOME}/bin目錄下執(zhí)行 ./jboss-cli.sh --connect
海铆,進(jìn)入命令行管理頁(yè)面,輸入shutdown
命令挣惰,即可停止服務(wù)器卧斟。(也可以合并為一條語(yǔ)句:./jboss-cli.sh --connect command=:shutdown
)
配置:修改${JBOSS_HOME}/bin下的 standalone.conf 文件,可以改變Jboss啟動(dòng)的配置憎茂。
在文件中加入 JAVA_HOME="/path/jdk"
珍语,可以指定使用的jdk,而不必依賴(lài)于系統(tǒng)默認(rèn)的java環(huán)境變量竖幔。
在文件中加入 LANG=Zh_CN.GB18030
板乙,可以設(shè)定語(yǔ)言環(huán)境為中文
修改JAVA_OPTS,可以設(shè)置JVM的啟動(dòng)參數(shù)
基本概念
- jboss-eap-7.1有兩種運(yùn)行模式拳氢,standalone——單機(jī)模式 和 domain——集群模式募逞。本文介紹了單機(jī)模式的部署。
- jboss啟動(dòng)服務(wù)器時(shí)馋评,默認(rèn)讀取的配置文件是${JBOSS_HOME}/standalone/configuration/standalone.xml放接。也可以指定讀取其他配置文件,命令是
./standalone.sh --server-config=standalone-custom.xml
- jboss-cli(command line interface)栗恩,是jboss的命令行管理工具透乾。執(zhí)行
${JBOSS_HOME}/bin/jboss-cli.sh
即可進(jìn)入洪燥。通過(guò)命令行實(shí)現(xiàn)部署卸載應(yīng)用、配置系統(tǒng)設(shè)置和執(zhí)行管理任務(wù)的功能乳乌。使用該工具修改系統(tǒng)配置時(shí)捧韵,最終也會(huì)作用到standalone.xml中。直接改xml的方式非常直觀汉操,所以更受本人青睞再来,本文所有配置示例均是直接修改xml。 - Management Console磷瘤,管理控制臺(tái)芒篷。是jboss提供的web管理系統(tǒng),地址在http://localhost:9990/console/App.html采缚, 所有的操作均可通過(guò)jboss-cli實(shí)現(xiàn)肿男,本文不再介紹該工具。
standalone.xml配置
地址配置
默認(rèn)的配置敢茁,服務(wù)器啟動(dòng)后只能通過(guò)localhost訪(fǎng)問(wèn)智哀。通過(guò)網(wǎng)卡IP地址訪(fǎng)問(wèn)時(shí),需修改配置文件贸呢。找到下面的配置片段
<interfaces>
<interface name="management">
<inet-address value="${jboss.bind.address.management:127.0.0.1}"/>
</interface>
<interface name="public">
<inet-address value="${jboss.bind.address:127.0.0.1}"/>
</interface>
</interfaces>
將 public 標(biāo)簽下的地址修改為網(wǎng)卡ip地址镰烧,這樣就能通過(guò)IP地址訪(fǎng)問(wèn)。也可以設(shè)置為0.0.0.0楞陷,機(jī)器上所有可用的ip地址均可以訪(fǎng)問(wèn)怔鳖。
不建議修改 management 標(biāo)簽下的地址,個(gè)人認(rèn)為遠(yuǎn)程的管理存在一定風(fēng)險(xiǎn)固蛾,還是直接在機(jī)器上做比較好结执。
端口配置
修改監(jiān)聽(tīng)的端口,找到下面的配置片段:
<socket-binding-group name="standard-sockets" default-interface="public" port-offset="${jboss.socket.binding.port-offset:0}">
<socket-binding name="management-http" interface="management" port="${jboss.management.http.port:9990}"/>
………… ………… …………
<socket-binding name="http" port="${jboss.http.port:8080}"/>
<socket-binding name="https" port="${jboss.https.port:8443}"/>
………… ………… …………
</socket-binding-group>
根據(jù)需要修改不同協(xié)議監(jiān)聽(tīng)的端口魏铅。管理控制臺(tái)的端口默認(rèn)是9990昌犹,也可以在此處修改。
數(shù)據(jù)源配置
數(shù)據(jù)源配置如下面代碼所示览芳,標(biāo)簽的含義非常明晰斜姥,不再針對(duì)標(biāo)簽做解釋說(shuō)明。
<subsystem xmlns="urn:jboss:domain:datasources:5.0">
<datasources>
………… ………… …………
<datasource jndi-name="java:jboss/datasources/MyDB" pool-name="MyDB" enabled="true" use-java-context="true" use-ccm="true">
<connection-url>jdbc:jtds:sybase://10.2.4.16:11100/testDB;charset=cp936</connection-url>
<driver>jtds124</driver>
<pool>
<min-pool-size>1</min-pool-size>
<max-pool-size>20</max-pool-size>
<prefill>true</prefill>
</pool>
<security>
<user-name>user</user-name>
<password>password</password>
</security>
<validation>
<valid-connection-checker class-name="org.jboss.jca.adapters.jdbc.extensions.sybase.SybaseValidConnectionChecker"/>
<check-valid-connection-sql>SELECT 1</check-valid-connection-sql>
<validate-on-match>true</validate-on-match>
<exception-sorter class-name="org.jboss.resource.adapter.jdbc.vendor.SybaseExceptionSorter"/>
</validation>
<timeout>
<blocking-timeout-millis>30000</blocking-timeout-millis>
<idle-timeout-minutes>1</idle-timeout-minutes>
</timeout>
<statement>
<track-statements>true</track-statements>
</statement>
</datasource>
<drivers>
………… ………… …………
<driver name="jtds124" module="net.sourceforge.jtds.jdbc.124">
<xa-datasource-class>net.sourceforge.jtds.jdbcx.JtdsDataSource</xa-datasource-class>
</driver>
</drivers>
</datasources>
</subsystem>
配置好數(shù)據(jù)源后沧竟,需要將數(shù)據(jù)庫(kù)驅(qū)動(dòng)jar包放在 ${JBOSS_HOME}/modules 下正確的位置铸敏,才能成功綁定數(shù)據(jù)源。驅(qū)動(dòng)的放置目錄要和driver標(biāo)簽中module的值保持一致悟泵,以上面的配置為例杈笔,驅(qū)動(dòng)jar包的路徑應(yīng)該是
${JBOSS_HOME}/modules/modules/net/sourceforge/jtds/jdbc/124/main/
main不要體現(xiàn)在屬性中,124文件夾下必須要有main文件夾糕非,jar包在main文件夾中蒙具。
main文件夾下還要有module.xml球榆,配置示例如下:
<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="net.sourceforge.jtds.jdbc.124">
<resources>
<resource-root path="jtds-1.2.4.jar"/>
</resources>
<dependencies>
<module name="javax.api"/>
<module name="javax.transaction.api"/>
<module name="org.jboss.as.connector"/>
</dependencies>
</module>
module.xml中module標(biāo)簽的 name 屬性要和standalone.xml中driver標(biāo)簽的 module 屬性保持一致。
符合JDBC標(biāo)準(zhǔn)的數(shù)據(jù)源如此就配置完成禁筏。但本例中使用的是jtds持钉,所以還要做額外的操作,否則無(wú)法正確綁定數(shù)據(jù)源篱昔。在驅(qū)動(dòng)jar包的META-INF文件夾中新建 services 文件夾每强,然后新建名為 java.sql.Driver 的文件,在文件第一行寫(xiě)下Driver的路徑州刽。本例中空执,java.sql.Driver文件的內(nèi)容如下:
net.sourceforge.jtds.jdbc.Driver
經(jīng)過(guò)上述配置,在啟動(dòng)服務(wù)器時(shí)穗椅,看到輸出Started Driver service with driver-name = jtds124辨绊,證明數(shù)據(jù)源配置成功。
Undertow容器配置
經(jīng)過(guò)下面的配置操作房待,修改了接收http請(qǐng)求的設(shè)置邢羔、容器默認(rèn)的字符集,移除了jboss默認(rèn)的歡迎頁(yè)面桑孩,開(kāi)啟了http訪(fǎng)問(wèn)的日志以及輸出http請(qǐng)求和響應(yīng)的信息。
找到如下配置片段框冀,默認(rèn)配置為:
<subsystem xmlns="urn:jboss:domain:undertow:4.0">
<buffer-cache name="default"/>
<server name="default-server">
<http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true"/>
<https-listener name="https" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true"/>
<host name="default-host" alias="localhost">
<location name="/" handler="welcome-content"/>
<filter-ref name="server-header"/>
<filter-ref name="x-powered-by-header"/>
<http-invoker security-realm="ApplicationRealm"/>
</host>
</server>
<servlet-container name="default">
………… ………… …………
</servlet-container>
<handlers>
<file name="welcome-content" path="${jboss.home.dir}/welcome-content"/>
</handlers>
<filters>
………… ………… …………
</filters>
</subsystem>
修改后的配置如下:
<subsystem xmlns="urn:jboss:domain:undertow:4.0">
<buffer-cache name="default"/>
<server name="default-server">
<http-listener name="default" socket-binding="http" redirect-socket="https" enable-http2="true" url-charset="GBK" decode-url="false"/>
<https-listener name="https" socket-binding="https" security-realm="ApplicationRealm" enable-http2="true"/>
<host name="default-host" alias="localhost">
<!-- <location name="/" handler="welcome-content"/> -->
<filter-ref name="server-header"/>
<filter-ref name="x-powered-by-header"/>
<http-invoker security-realm="ApplicationRealm"/>
<filter-ref name="request-dumper"/>
<access-log pattern="combined" directory="${jboss.home.dir}/standalone/log"/>
</host>
</server>
<servlet-container name="default" default-encoding="GBK" use-listener-encoding="true">
………… ………… …………
</servlet-container>
<!-- <handlers>
<file name="welcome-content" path="${jboss.home.dir}/welcome-content"/>
</handlers> -->
<filters>
………… ………… …………
<filter name="request-dumper" class-name="io.undertow.server.handlers.RequestDumpingHandler" module="io.undertow.core"/>
</filters>
</subsystem>
- 修改http請(qǐng)求設(shè)置:在http-listener標(biāo)簽中流椒,增加了url-charset和decode-url。其中url-charset默認(rèn)使用的UTF-8明也,可以根據(jù)需要修改宣虾。decode-url指是否使用字符集解碼url和參數(shù),默認(rèn)為true温数。設(shè)為false則交由后續(xù)代碼進(jìn)行解碼處理绣硝。http-listener的詳細(xì)配置屬性點(diǎn)擊這里。
- 修改容器默認(rèn)字符集:在servlet-container標(biāo)簽中撑刺,default-encoding設(shè)置所有應(yīng)用的字符集(默認(rèn)為utf-8)鹉胖,use-listener-encoding指是否使用listener定義的編碼。servlet-container的詳細(xì)配置屬性點(diǎn)擊這里够傍。
- 移除Jboss默認(rèn)歡迎頁(yè)面:配置文件中注釋的部分甫菠,就是jboss默認(rèn)歡迎頁(yè)面的配置。直接注釋就是將其移除冕屯,也可以將默認(rèn)地址映射到某個(gè)應(yīng)用上寂诱。
- 開(kāi)啟http訪(fǎng)問(wèn)日志:在host標(biāo)簽下增加access-log這一標(biāo)簽,即可將http請(qǐng)求的信息記在日志中安聘,便于調(diào)試痰洒。directory是日志存放的目錄瓢棒,默認(rèn)文件名為access_log.log。pattern是要日志中記錄的信息丘喻,預(yù)定義了common和combined兩種模式脯宿,combined的信息豐富一些。自定義的輸出模式詳見(jiàn)此處仓犬。
- 輸出http請(qǐng)求和響應(yīng)的信息:在filters標(biāo)簽下增加名為request-dumper的filter嗅绰,在host標(biāo)簽下增加命名一致的filter-ref,就能在jboss日志中輸出每一個(gè)http請(qǐng)求的request和response信息搀继,便于調(diào)試窘面。
注:對(duì)于上面的操作1,早期版本中叽躯,在extensions和management標(biāo)簽之間增加下面的配置代碼财边,可以實(shí)現(xiàn)同樣的效果。但自從wildfly 8 之后点骑,jboss放棄tomcat容器轉(zhuǎn)而使用undertow酣难,所以下面的配置不再起作用了。
<system-properties>
<property name="org.apache.catalina.connector.URI_ENCODING" value="GBK"/>
<property name="org.apache.catalina.connector.USE_BODY_ENCODING_FOR_QUERY_STRING" value="true"/>
</system-properties>
部署應(yīng)用
下面將介紹三種部署模式黑滴,但官方推薦在生產(chǎn)環(huán)境中憨募,使用第三種手動(dòng)模式,前兩種可以應(yīng)用于開(kāi)發(fā)環(huán)境袁辈。
應(yīng)用部署相關(guān)的默認(rèn)配置如下:
<subsystem xmlns="urn:jboss:domain:deployment-scanner:2.0">
<deployment-scanner path="deployments" relative-to="jboss.server.base.dir" scan-interval="5000" runtime-failure-causes-rollback="${jboss.deployment.scanner.rollback.on.failure:false}"/>
</subsystem>
scan-interval是每隔多少毫秒掃描deployments文件夾下的變化菜谣。如果設(shè)定的值小于1,則只在啟動(dòng)時(shí)掃描晚缩。
全自動(dòng)模式
在默認(rèn)配置下尾膊,將war包上傳至${JBOSS_HOME}/standalone/deployments,服務(wù)器會(huì)在啟動(dòng)時(shí)和每5000毫秒間隔荞彼,檢查deployments下的文件變化冈敛,部署應(yīng)用。
半自動(dòng)模式
增加屬性 auto-deploy-zipped="false"
上傳應(yīng)用myApp.war至deployments文件夾后鸣皂,在deployments文件夾下新建一個(gè)文件抓谴,命名為myApp.war.dodeploy,服務(wù)器檢測(cè)到這個(gè)文件后签夭,則會(huì)開(kāi)始執(zhí)行部署齐邦。更多配置詳情點(diǎn)擊這里。
手動(dòng)模式
增加屬性scan-enabled="false"
此模式是官方推薦的生產(chǎn)環(huán)境部署應(yīng)用方式第租,無(wú)需將應(yīng)用上傳至deployments文件夾下措拇。首先保證myApp.war在服務(wù)器上,假設(shè)其路徑為/usr/me/myApp.war慎宾。
啟動(dòng)服務(wù)器丐吓,并使用./jboss-cli.sh --connect
命令進(jìn)入命令行管理界面浅悉。執(zhí)行命令deploy /usr/me/myApp.war
部署應(yīng)用。取消部署時(shí)券犁,在命令行管理界面執(zhí)行 undeploy myApp.war
术健。
應(yīng)用的數(shù)據(jù)會(huì)在${JBOSS_HOME}/standalone/data/content下,并且standalone.xml最下方會(huì)出現(xiàn)deployments標(biāo)簽粘衬,顯示已經(jīng)部署的應(yīng)用荞估。
題外話(huà)
既然是一個(gè)入門(mén)級(jí)的教程,就介紹下jboss一系列的產(chǎn)品稚新。因?yàn)楦拿彼牛瑢?dǎo)致jboss系列越來(lái)越亂,下面做一個(gè)簡(jiǎn)單梳理褂删。
Undertow: Jboss自主研發(fā)的Servlet容器飞醉。
Jboss AS(Application Server): Jboss社區(qū)版的早期版本,由于和Jboss eap名稱(chēng)相近屯阀,在Jboss AS7之后就改名為Wildfly缅帘。內(nèi)部封裝的容器是基于Tomcat的升級(jí)版。
WildFly: 版本號(hào)從WildFly 8.0開(kāi)始难衰,由Jboss AS改名而來(lái)钦无。內(nèi)部封裝的容器是Undertow。
Jboss EAP(Enterprise Application Platform):Jboss的企業(yè)版盖袭。會(huì)將社區(qū)版中驗(yàn)證過(guò)的铃诬,成熟的技術(shù)引入該版本,支持周期長(zhǎng)苍凛。6的版本以Jboss AS7為基礎(chǔ);7的版本以Wildfly為基礎(chǔ)兵志。
參考資料
原博文發(fā)布在個(gè)人博客醇蝴,歡迎訪(fǎng)問(wèn)!想罕!