在Java Web服务器上部署RSSBus服务应用程序指导说明。RSSBus应用可以托管在任意Java servlet容器。安装包是.war文件,其可部署到Java Web服务器上。本文主要介绍常用的Java服务器(Tomcat,JBoss,WebSphere,WebLogic,和Jetty),但如果你所要部署的服务器不在下列的讨论中,请联系我们,我们很乐意帮您解决问题。
注:RSSBus应用程序需使用Java Servlet API 3.0的安全特性。请确认您所选择的Java服务器是否支持Java Servlet API 3.0或更高版本,因为Java Servlet API早期的版本在RSSBus管理控制台可能会出现安全漏洞。
-安装到Tomcat
- 注:Java Servlet API 3.0仅支持Tomcat 7.0及以后的版本。
- 部署war文件到Tomcat,有很多种方法。你可以打开rssbus.war文件,然后复制webapps文件下的rssbus路径;或者你可在Tomcat管理控制台部署war文件。在Tomcat文档中,你会找到更多关于部署War文件到Tomcat管理控制台的信息。
- 注:在安装到Tomcat之前,请确认你的Tomcat服务器选项设置为unpack war(一般该选项是默认打开的)。
- 接着,你需要授权Tomcat用户接入你部署的RSSBus应用程序。RSSBus应用程序管理员可通过分配“rssbus_appuser”和“rssbus_admin”的角色给指定的Tomcat用户。如果你使用的是Tomcat的默认用户名,您可以通过编辑Tomcat-users增加这些角色。XML文件位于$CATALINA_BASE/conf/tomcat-users.xml。该例中,“admin”用户已被授予访问RSSBus应用程序的管理权限。
<user name="admin" password="admin" roles="rssbus_appuser,rssbus_admin,admin-gui,manager-gui,manager-status,manager-script,manager-jmx"/>
关于角色的更多信息,请参阅RSSBus管理控制台中有关安全的RSSBus内链文档。
-
当你配置完用户角色时,为了确保更改的内容生效,你需要重启Tomcat服务器。
-
现在,可准备登陆RSSBus应用程序。默认情况下,所有的应用程序数据将在data目录下管理,该目录是由RSSBus应用程序在web应用程序下WEB-INF文件夹中创建的。如果你想使用其他路径,登陆之后点击Welcome首先是设置RSSBus应用程序的data目录。点击右上角的link,选择“Admin Settings”。然后会跳转到另一个界面,在该界面可以设置RSSBus应用程序的不同管理员的信息,包括data目录。在web应用程序以外选择一个地方,存储关于profile配置的信息。
-安装到JBoss
- 有多种方法部署war文件到JBoss。先打开安装包将RSSBus.war文件复制到固定目录/server/default/deploy/directory of JBoss下,或者可通过使用JBoss管理控制台来安装war文件(确认选择部署已解压选项)。
注意:在部署之前打开rssbus.war,否则RSSBus AppServer将无法保存相关设置。在版本6中,JBoss不能自动地部署war文件。为在JBoss部署web应用程序,必须设置选项或在deploy目录下手动创建空文件夹命名为rssbus.war.dodeploy。
-
接着,你需要授权JBoss用户,允许访问RSSBus应用程序。可以通过RSSBus应用程序管理员给用户授予“
cdata_admin
”和“rssbus_admin
”这两个角色。如果使用JBoss的默认用户域,可通过JBoss服务器上的add-user.bat文件添加角色。 -
准备登陆RSSBus应用程序。默认情况下,所有应用程序数据将在data目录下,该路径在web应用程序的WEB-INF文件下创建。如果你想使用其他路径,登陆之后点击Welcome首先是设置RSSBus应用程序的data目录。点击右上角的link,选择“Admin Settings”。然后会跳转到另一个界面,在该界面可以设置RSSBus应用程序的不同管理员的信息,包括data目录。在web应用程序以外选择一个地方,存储关于profile配置的信息。
-安装到WebSphere
- 若要将rssbus.war部署到WebSphere,首先,必须得创建一个计划,因为RSSBus应用程序需要特定的用户角色才能访问。创建一个授予用户“
cdata_admin
”和“rssbus_admin
”角色的计划,该用户可被当作RSSBus应用程序管理员。WebSphere有wizard可以帮助创建上述计划,在Application->Plan Creator。关于rssbus.war应用程序,以下有创建计划的示例:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-2.0.1"> <dep:environment xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.2"> <dep:moduleId> <dep:groupId>default</dep:groupId> <dep:artifactId>rssbus</dep:artifactId> <dep:version>1371673558693</dep:version> <dep:type>war</dep:type> </dep:moduleId> <dep:dependencies/> </dep:environment> <context-root>rssbus</context-root> <security-realm-name>geronimo-admin</security-realm-name> <app:security xsi:type="sec:securityType" xmlns:sec="http://geronimo.apache.org/xml/ns/security-2.0" xmlns:app="http://geronimo.apache.org/xml/ns/j2ee/application-2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <sec:role-mappings> <sec:role role-name="rssbus_admin"> <sec:principal name="system" class="org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal"/> </sec:role> <sec:role role-name="admin"/> </sec:role-mappings> </app:security> </web-app> <sec:role-mappings> <sec:role role-name="rssbus_admin"> <sec:principal name="system" class="org.apache.geronimo.security.realm.providers.GeronimoUserPrincipal"/> </sec:role> <sec:role role-name="admin"/> </sec:role-mappings> </app:security> </web-app> |
-
一旦计划创建完毕,便可用WebSphere的功能Applications->Deployer按照计划部署war文件。
-
准备登陆RSSBus应用程序。默认情况下,所有应用程序数据将在data目录下,该路径在web应用程序的WEB-INF文件下创建。如果你想使用其他路径,登陆之后点击Welcome首先是设置RSSBus应用程序的data目录。点击右上角的link,选择“Admin Settings”。然后会跳转到另一个界面,在该界面可以设置RSSBus应用程序的不同管理员的信息,包括data目录。在web应用程序以外选择一个地方,存储关于profile配置的信息。
- 安装到Weblogic
- 若要部署RSSBus应用服务器到WebLogic,需解压rssbus.war文件到名为rssbus的文件夹下。如果在部署之前没有暴露war文件,RSSBus应用服务器则不能正常运作。
- 一旦打开rssbus.war,便可使用Weblogic的部署说明将应用程序部署到您的WebLogic服务器。这个说明将帮你配置应用程序的安全模型和确定你想如何管理RSSBus应用程序的角色和策略。在RSSBus应用程序中定义角色和策略,然而你必须将角色映射到WebLogic服务器的一个用户上。在这推荐的额方法是:自定义角色:使用管理控制平台中定义的角色;使用在部署描述符中定义的策略。选择这个选项将允许您管理WebLogic管理控制台的角色和用户,同时可发现RSSBus应用服务器应用程序的策略定义。
- 当部署成功之后,需要配置RSSBus应用程序的管理员信息。该管理员需要拥有“
cdata_admin
”和“rssbus_admin
”角色。在WebLogic管理控制台,可通过点击Security->Application Scope->Roles来配置rssbus应用程序这些角色。在这里,你需要添加两个应用程序作用域的角色,并将它们分配给RSSBus应用程序的用户。关于角色的更多信息,请参阅RSSBus管理控制台的关于安全的帮助文档。 - 准备登陆RSSBus应用程序。默认情况下,所有应用程序数据将在data目录下,该路径在web应用程序的WEB-INF文件下创建。如果你想使用其他路径,登陆之后点击Welcome首先是设置RSSBus应用程序的data目录。点击右上角的link,选择“Admin Settings”。然后会跳转到另一个界面,在该界面可以设置RSSBus应用程序的不同管理员的信息,包括data目录。在web应用程序以外选择一个地方,存储关于profile配置的信息。
-安装到Jetty
- 若要部署RSSBus应用程序到Jetty,需打开安装包将rssbus.war文件复制到webapps文件夹下。
- 开始部署Jetty之前先配置RSSBus应用程序管理员信息。首先,给admin用户配置“
rssbus_admin
”和“cdata_admin
”两个角色。如果没有更改任何默认设置,对于Jetty服务器来说,你可通过打开文件%JETTY_HOME%/etc/realm.properties直接给admin用户增加那些角色。在这儿你可编辑用户角色。可同时更改用户的密码,并增加“rssbus_admin”和“rssbus_apppuser”两个角色。当你编辑admin用户时,类似以下内容:
1 2 3 |
admin: password,server-administrator,content-administrator,admin,rssbus_admin,cdata_admin |
上述例子,“test”是admin用户的密码,之后由逗号分隔的值都是admin用户的角色。
- 登陆服务,必须配置用于RSSBus应用服务器(RSSBusRealm)的Java realm。看看Jetty配置realms的帮助文档,或许你可编辑存在 %JETTY_HOME%/etc/test-realm.xml 配置文件,如果你未更改Jetty服务器的默认值该文件与Jetty共存。关于RSSBusRealm配置登陆服务,Jetty 7和Jetty 8 添加 / contexts/rssbus.xml, Jetty 9 添加 /webapps/rssbus.xml,内容如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
<Configure class="org.eclipse.jetty.webapp.WebAppContext"> <Set name="contextPath">/rssbus</Set> <Set name="war"><SystemProperty name="jetty.home" default="."/>/webapps/rssbus.war</Set> <Get name="securityHandler"> <Set name="loginService"> <New class="org.eclipse.jetty.security.HashLoginService"> <Set name="name">RSSBus Realm</Set> <Set name="config"><SystemProperty name="jetty.home" default="."/>/etc/realm.properties</Set> </New> </Set> </Get> </Configure> |
-
一但打开war文件,并已配置admin用户、RSSBusRealm的登陆服务。便可开始启动Jetty服务器,可通过复制war文件到Jetty的webapps目录下,再进行部署。
-
准备登陆RSSBus应用程序。默认情况下,所有应用程序数据将在data目录下,该路径在web应用程序的WEB-INF文件下创建。如果你想使用其他路径,登陆之后点击Welcome首先是设置RSSBus应用程序的data目录。点击右上角的link,选择“Admin Settings”。然后会跳转到另一个界面,在该界面可以设置RSSBus应用程序的不同管理员的信息,包括data目录。在web应用程序以外选择一个地方,存储关于profile配置的信息。
注:文案部分图片及内容来源于网络,版权归原创作者所有,如有侵犯到您的权益,请您联系我们进行删除,给您带来困扰,我们深感抱歉。