一 配置变量
首先,要安装JDK,配置JAVA_HOME环境变量
其次,将下载的JBoss解压,即完成安装。(解压目录最好不要有空格,否则运行容易出现异常)
然后,配置JBOSS_HOME环境变量,值为JBoss的解压路径
最后,可以运行%JBOSS_HOME%in目录中的run.bat运行JBoss;地址栏输入http://localhost:8080/会进入JBoss的欢迎界面
二 目录结构说明
目录 描述
bin 包含启动和关闭JBoss等脚本文件。
docs 配置的样本文件(包括数据库配置等)。
docs/dtd 在JBoss中使用的各种XML文件的DTD文档。
lib 一些JAR,JBoss启动时加载,且被所有JBoss配置共享。
client客户端与JBoss通信所需的Java库(JARs)。
server各种JBoss配置。每个配置必须放在不同的子目录。子目录名字表示配置名字。JBoss包含3个默认的配置:minimial,default,all。在安装时可以进行选择。
server/default/confJBoss的配置文件。
server/default/dataJBoss的数据库文件。比如,嵌入的数据库或者JBossMQ。
server/default/deploy JBoss的热部署目录。放到这里的任何文件或目录会被JBoss自动部署。包括EJB,WAR,EAR甚至服务。
server/default/lib一些JAR,JBoss在启动特定配置时加载它们。
server/default/logJBoss的日志文件。
server/default/tmpJBoss的临时文件。
三 JBoss的配置
1 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的欢迎界面。
2 JBoss的安全设置
(1)jmx-console登陆的用户名和密码设置
在%JBOSS_HOME%/server/default/deploy/jmx-console.war/WEB-INF/jboss-web.xml文件中
将注释文档去掉修改为:
- < jboss-web>
- < security-domain>java:/jaas/jmx-console< /security-domain>
- < /jboss-web>
在同目录下web.xml,查找< security-constraint/>节点,修改为:
- < security-constraint>
- < web-resource-collection>
- < web-resource-name>HtmlAdaptor< /web-resource-name>
- < description>An example security config that only allows user 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>
在jmx-console安全域和运行角色JBossAdmin都是在login-config.xml中配置,在%JBOSS_HOME%/server/default/conf下找到它,查找application-policy name = "jmx-console",修改为
- < 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_HOME%/server/default/deploy/management/console-mgr.sar/web-console.war/WEB-INF下的jboss-web.xml文件,去掉< security-domain>java:/jaas/web-console< /security-domain>的注释。
在同目录下的web.xml文件中去掉< security-constraint>部分的注释。
在%JBOSS_HOME%/server/default/conf下的login-config.xml文件中查找application-policy name = "web-console"
在文件中可以看到,设置登录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文件的内容如下:
admin=JBossAdmin,HttpInvoker
因为此时这两个文件不与login-config.xml同目录,所以login-config.xml文件需进行少许修改
- < module-option name="usersProperties">props/web-console-users.properties
- < /module-option>
- < module-option name="rolesProperties">props/web-console-roles.properties
- < /module-option>
JBoss的配置这样就完成了。