windows下JBOSS4.2的安装配置说明

 

 

一．下载与安装 JBoss

在本文中下载 JBoss版本为： 4.2.1.GA。

下载地址： www.jboss.org

在如上的下载页中下载 JBoss-4.2.1.GA.zip文件。

下载完成后，将其解压缩后即可完成安装，解压缩后将其放置到一个不带空格的目录 (若目录带有空格，例如： C:"Program Files，日后可能会产生一些莫名的错误 )， eg： E:"JBoss4 .2.1。同时在“环境变量设置”中设置名为 JBOSS_HOME的环境变量，值为 JBoss的安装路径，如下图所示：

在此， JBoss的安装工作已经结束，可通过如下方式测试安装是否成功：

运行 JBoss安装目录 "bin"run.bat，如果窗口中没有出现异常，且出现： 10:16:19,765 INFO [Server] JBoss (MX MicroKernel) [4.2.1.GA (build: SVNTag=JBoss_4_2_1_GA date=200707131605)] Started in 30s:828ms字样，则表示安装成功。

我们可以通过访问：   http://localhost:8080/   进入 JBoss的欢迎界面，点击 JBoss Management下的 JMX Console可进入 JBoss的控制台。

若启动失败，可能由以下原因引起：

1）               JBoss所用的端口（ 8080， 1099， 1098， 8083等）被占用。一般情况下为 8080端口被占用（例如， Oracle占用了 8080端口），此时需要修改 JBoss的端口，方法为进入 JBoss安装目录 "server"default"deploy"jboss-web.deployer目录，修改其下的 server.xml目录，在此文件中搜索 8080，将其改成你想要的端口即可（例如 8088）；

2）               JDK安装不正确；

3）               JBoss下载不完全。

二．              JBoss   的目录结构说明

目录	描述
bin	启动和关闭   JBoss  的脚本（   run.bat   为   windows   系统下的启动脚本，   shutdown.bat   为   windows   系统下的关闭脚本）。
client	客户端与   JBoss  通信所需的   Java  库（   JARs   ）。
docs	配置的样本文件（数据库配置等）。
docs/dtd	在   JBoss  中使用的各种   XML  文件的   DTD   。
lib	一些   JAR   ，   JBoss  启动时加载，且被所有   JBoss  配置共享。（不要把你的库放在这里）
server	各种   JBoss  配置。每个配置必须放在不同的子目录。子目录的名字表示配置的名字。   JBoss  包含   3  个默认的配置：   minimial   ，   default  和   all   ，在你安装时可以进行选择。
server/all	JBoss  的完全配置，启动所有服务，包括集群和   IIOP  。
server/default	JBoss  的默认配置。在没有在   JBoss  命令行中指定配置名称时使用。   (   我们下载的   4.2.1   版本默认采用此配置   )  。
server/default/conf	JBoss  的配置文件。
server/default/data	JBoss  的数据库文件。比如，嵌入的数据库，或者   JBossMQ
server/default /deploy	JBoss  的热部署目录。放到这里的任何文件或目录会被   JBoss  自动部署。   EJB   、   WAR  、   EAR   ，甚至服务。
server/default /lib	一些   JAR   ，   JBoss  在启动特定配置时加载他们。   (default  和   minimial  配置也包含这个和下面两个目录。   )
server/default/log	JBoss  的日志文件。
server/default/tmp	JBoss  的临时文件。

三．              JBoss   的配置

1.        日志文件设置

若需要修改 JBoss默认的 log4j设置，可修改 JBoss安装目录 "server"default"conf下的 jboss-log4j.xml文件，在该文件中可以看到， log4j的日志输出在 JBoss安装目录 "server"default"log下的 server.log文件中。对于 log4j的设置，读者可以在网上搜索更加详细的信息。

2.        web   服务的端口号的修改

这点在前文中有所提及，即修改 JBoss安装目录 "server"default"deploy"jboss-web.deployer下的 server.xml文件，内容如下：

<Connector port="8080" address="${jboss.bind.address}"   

         maxThreads="250" maxHttpHeaderSize="8192"

         emptySessionPath="true" protocol="HTTP/1.1"

         enableLookups="false" redirectPort="8443" acceptCount="100"

         connectionTimeout="20000" disableUploadTimeout="true" />

将上面的 8080端口修改为你想要的端口即可。重新启动 JBoss后访问： http://localhost/ :新设置的端口，可看到 JBoss的欢迎界面。

3.        JBoss   的安全设置

1）   jmx-console   登录的用户名和密码设置

默认情况访问   http://localhost:8080/jmx-console   就可以浏览 jboss的部署管理的一些信息，不需要输入用户名和密码，使用起来有点安全隐患。下面我们针对此问题对 jboss进行配置，使得访问 jmx-console也必须要知道用户名和密码才可进去访问。步骤如下：

i)  找到 JBoss安装目录 /server/default/deploy/jmx-console.war/WEB-INF/jboss-web.xml文件，去掉 <security-domain>java:/jaas/jmx-console</security-domain>的注释。修改后的该文件内容为：

<jboss-web>

   <!-- Uncomment the security-domain to enable security. You will

      need to edit the htmladaptor login configuration to setup the

      login modules used to authentication users.-->

      <security-domain>java:/jaas/jmx-console</security-domain>

</jboss-web>

ii）修改与 i）中的 jboss-web.xml同级目录下的 web.xml文件，查找到 < security-constraint/>节点，去掉它的注释，修改后该部分内容为：

<!-- A security constraint that restricts access to the HTML JMX console

   to users with the role JBossAdmin. Edit the roles to what you want and

   uncomment the WEB-INF/jboss-web.xml/security-domain element to enable

   secured access to the HTML JMX console.-->

   <security-constraint>

     <web-resource-collection>

       <web-resource-name>HtmlAdaptor</web-resource-name>

       <description>An example security config that only allows users with the

         role JBossAdmin to access the HTML JMX console web application

       </description>

       <url-pattern>/*</url-pattern>

       <http-method>GET</http-method>

       <http-method>POST</http-method>

     </web-resource-collection>

     <auth-constraint>

       <role-name>JBossAdmin</role-name>

     </auth-constraint>

   </security-constraint>

    在此处可以看出，为登录配置了角色 JBossAdmin。

iii）   在第一步中的 jmx-console 安全域和第二步中的运行角色 JBossAdmin 都是在 login-config.xml 中配置，我们在 JBoss 安装目录 /server/default/config 下找到它。查找名字为： jmx-console 的 application-policy ：

<application-policy name = "jmx-console">
       <authentication>
          <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"
             flag = "required">
           <module-option name="usersProperties">props/jmx-console-users.properties</module-option>
           <module-option name="rolesProperties">props/jmx-console-roles.properties</module-option>
          </login-module>
       </authentication>
    </application-policy>

在此处可以看出，登录的角色、用户等的信息分别在 props目录下的 jmx-console-roles.properties和 jmx-console-users.properties文件中设置，分别打开这两个文件。

其中 jmx-console-users.properties文件的内容如下：

# A sample users.properties file for use with the UsersRolesLoginModule

admin=admin

该文件定义的格式为：用户名 =密码，在该文件中，默认定义了一个用户名为 admin，密码也为 admin的用户，读者可将其改成所需的用户名和密码。

jmx-console-roles.properties的内容如下：

# A sample roles.properties file for use with the UsersRolesLoginModule

admin=JBossAdmin, HttpInvoker

该文件定义的格式为：用户名 =角色，多个角色以“ ,”隔开，该文件默认为 admin用户定义了 JBossAdmin和 HttpInvoker这两个角色。

配置完成后读者可以通过访问：   http://localhost:8088/jmx-console/   ，输入 jmx-console-roles.properties文件中定义的用户名和密码，访问 jmx-console的页面。

2）   web-console   登录的用户名和密码设置

默认情况下，用户访问 JBoss的 web-console时，不需要输入用户名和密码，为了安全起见，我们通过修改配置来为其加上用户名和密码。步骤如下：

i）找到 JBoss安装目录 "server"default"deploy"management"console-mgr.sar"web-console.war"WEB-INF"jboss-web.xml文件，去掉 <security-domain>java:/jaas/web-console</security-domain>的注释，修改后的文件内容为：

<?xml version='1.0' encoding='UTF-8' ?>

<!DOCTYPE jboss-web

    PUBLIC "-//JBoss//DTD Web Application 2.3V2//EN"

    "http://www.jboss.org/j2ee/dtd/jboss-web_3_2.dtd">

<jboss-web>

   <!-- Uncomment the security-domain to enable security. You will

   need to edit the htmladaptor login configuration to setup the

   login modules used to authentication users.-->

   <security-domain>java:/jaas/web-console</security-domain>

   <!-- The war depends on the -->

   <depends>jboss.admin:service=PluginManager</depends>

</jboss-web>

ii）打开 i）中 jboss-web.xml同目录下的 web.xml文件，去掉 <security-constraint>部分的注释，修改后的该部分内容为：

<!-- A security constraint that restricts access to the HTML JMX console

   to users with the role JBossAdmin. Edit the roles to what you want and

   uncomment the WEB-INF/jboss-web.xml/security-domain element to enable

   secured access to the HTML JMX console.-->

   <security-constraint>

   <web-resource-collection>

   <web-resource-name>HtmlAdaptor</web-resource-name>

   <description>An example security config that only allows users with the

   role JBossAdmin to access the HTML JMX console web application

   </description>

   <url-pattern>/*</url-pattern>

   <http-method>GET</http-method>

   <http-method>POST</http-method>

   </web-resource-collection>

   <auth-constraint>

   <role-name>JBossAdmin</role-name>

   </auth-constraint>

   </security-constraint>

iii）打开 JBoss安装目录 "server"default"conf下的 login-config.xml文件，搜索 web-console，可找到如下内容：

<application-policy name = "web-console">

       <authentication>

          <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"

              flag = "required">

             <module-option name="usersProperties">web-console-users.properties</module-option>

             <module-option name="rolesProperties">web-console-roles.properties</module-option>

          </login-module>

       </authentication>

    </application-policy>

在文件中可以看到，设置登录 web-console的用户名和角色等信息分别在 login-config.xml文件所在目录下的 web-console-users.properties和 web-console-roles.properties文件中，但因为该目录下无这两个文件，我们在 JBoss安装目录 "server"default"conf"props目录下建立这两个文件，文件内容可参考在“ jmx-console 登录的用户名和密码设置” 中的两个相应的配置文件的内容， web-console-users.properties文件的内容如下：

# A sample users.properties file for use with the UsersRolesLoginModule

admin=admin

web-console-roles.properties文件的内容如下：

# A sample roles.properties file for use with the UsersRolesLoginModule

admin=JBossAdmin,HttpInvoker

因为此时这两个文件不与 login-config.xml同目录，所以 login-config.xml文件需进行少许修改，修改后的 <application-policy name = "web-console">元素的内容为：

<application-policy name = "web-console">

       <authentication>

          <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule"

             flag = "required">

             <module-option name="usersProperties">props/web-console-users.properties</module-option>

             <module-option name="rolesProperties">props/web-console-roles.properties</module-option>

          </login-module>

       </authentication>

    </application-policy>

四．              在 MyEclipse   中配置 JBoss

笔者的 MyEclipse版本： 5.1.1 GA

JBoss版本： 4.2.1 GA

JDK版本： 1.5

进入 Window-> Preferences-> MyEclipse -> Application Servers ->  JBoss4 ，进行如下设置：

选择 JBoss 4下的 JDK设置所用的 JDK.

设置完成后，部署程序时，会发现多出 JBoss 4部署的选择，如下图所示：

同时在  中展开，可看到 JBoss 4的启动图标。

 

linux上安装jboss 
解压jboss到一个目录中如:/usr/local/jboss,然后添加"/usr/local/jboss"到路径中,并设置jboss_home="/usr/local/jboss" 
然后执行run.sh,打开浏览器http://localhost:8080,如果有测试页显示,说明安装成功! 

注意：设置环境变量时，很容易出问题，因为linux主要是面向多用户，它的环境变量一种是全局的，一种是面向用户的，要注意不同的情况采取相应的方法设置，有两种设置方法： 
第一种方法：（针对用户的，假定用户为root） 
在用户主目录下有一个 /root/.bashrc 文件，可以在此文件中加入 PATH 的设置如下： 
export PATH=”$PATH:/your path1/:/your path2/…..” 
注意：每一个 path 之间要用 “:“ 分隔。 
注销重启 X 就可以了。 


第二种方法：（全局的) 
在 /etc/profile中增加。 
PATH="$PATH:/usr/local/arm/2.95.3/bin" 
export PATH