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

    技术2022-05-19  26

     

     

    一.下载与安装 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


    最新回复(0)