Jboss eap7.1 配置部署入門(mén)

本文介紹了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>
  1. 修改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)擊這里
  2. 修改容器默認(rèn)字符集:在servlet-container標(biāo)簽中撑刺,default-encoding設(shè)置所有應(yīng)用的字符集(默認(rèn)為utf-8)鹉胖,use-listener-encoding指是否使用listener定義的編碼。servlet-container的詳細(xì)配置屬性點(diǎn)擊這里够傍。
  3. 移除Jboss默認(rèn)歡迎頁(yè)面:配置文件中注釋的部分甫菠,就是jboss默認(rèn)歡迎頁(yè)面的配置。直接注釋就是將其移除冕屯,也可以將默認(rèn)地址映射到某個(gè)應(yīng)用上寂诱。
  4. 開(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)此處仓犬。
  5. 輸出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ǔ)兵志。

參考資料

  1. 非jdbc驅(qū)動(dòng)配置services

博文發(fā)布在個(gè)人博客醇蝴,歡迎訪(fǎng)問(wèn)!想罕!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末悠栓,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子按价,更是在濱河造成了極大的恐慌惭适,老刑警劉巖,帶你破解...
    沈念sama閱讀 221,820評(píng)論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件楼镐,死亡現(xiàn)場(chǎng)離奇詭異癞志,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)框产,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,648評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門(mén)凄杯,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)错洁,“玉大人,你說(shuō)我怎么就攤上這事戒突⊥筒辏” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 168,324評(píng)論 0 360
  • 文/不壞的土叔 我叫張陵膊存,是天一觀的道長(zhǎng)导而。 經(jīng)常有香客問(wèn)我,道長(zhǎng)隔崎,這世上最難降的妖魔是什么今艺? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 59,714評(píng)論 1 297
  • 正文 為了忘掉前任,我火速辦了婚禮仍稀,結(jié)果婚禮上洼滚,老公的妹妹穿的比我還像新娘。我一直安慰自己技潘,他們只是感情好遥巴,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,724評(píng)論 6 397
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著享幽,像睡著了一般铲掐。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上值桩,一...
    開(kāi)封第一講書(shū)人閱讀 52,328評(píng)論 1 310
  • 那天摆霉,我揣著相機(jī)與錄音,去河邊找鬼奔坟。 笑死携栋,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的咳秉。 我是一名探鬼主播婉支,決...
    沈念sama閱讀 40,897評(píng)論 3 421
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼澜建!你這毒婦竟也來(lái)了向挖?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 39,804評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤炕舵,失蹤者是張志新(化名)和其女友劉穎何之,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體咽筋,經(jīng)...
    沈念sama閱讀 46,345評(píng)論 1 318
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡溶推,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,431評(píng)論 3 340
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片悼潭。...
    茶點(diǎn)故事閱讀 40,561評(píng)論 1 352
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡庇忌,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出舰褪,到底是詐尸還是另有隱情皆疹,我是刑警寧澤,帶...
    沈念sama閱讀 36,238評(píng)論 5 350
  • 正文 年R本政府宣布占拍,位于F島的核電站略就,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏晃酒。R本人自食惡果不足惜表牢,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,928評(píng)論 3 334
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望贝次。 院中可真熱鬧崔兴,春花似錦、人聲如沸蛔翅。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 32,417評(píng)論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)山析。三九已至堰燎,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間笋轨,已是汗流浹背秆剪。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,528評(píng)論 1 272
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留爵政,地道東北人仅讽。 一個(gè)月前我還...
    沈念sama閱讀 48,983評(píng)論 3 376
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像钾挟,于是被迫代替她去往敵國(guó)和親何什。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,573評(píng)論 2 359

推薦閱讀更多精彩內(nèi)容