部署知行跨平台版连接器

在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应用程序管理员给用户授予“rssbus_appuser”和“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应用程序需要特定的用户角色才能访问。创建一个授予用户“rssbus_appuser”和“rssbus_admin”角色的计划,该用户可被当作RSSBus应用程序管理员。WebSphere有wizard可以帮助创建上述计划,在Application->Plan Creator。关于rssbus.war应用程序,以下有创建计划的示例:

  • 一旦计划创建完毕,便可用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应用程序的管理员信息。该管理员需要拥有“rssbus_appuser”和“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”和“rssbus_appuser”两个角色。如果没有更改任何默认设置,对于Jetty服务器来说,你可通过打开文件%JETTY_HOME%/etc/realm.properties直接给admin用户增加那些角色。在这儿你可编辑用户角色。可同时更改用户的密码,并增加“rssbus_admin”和“rssbus_apppuser”两个角色。当你编辑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,内容如下:

  • 一但打开war文件,并已配置admin用户、RSSBusRealm的登陆服务。便可开始启动Jetty服务器,可通过复制war文件到Jetty的webapps目录下,再进行部署。

  • 准备登陆RSSBus应用程序。默认情况下,所有应用程序数据将在data目录下,该路径在web应用程序的WEB-INF文件下创建。如果你想使用其他路径,登陆之后点击Welcome首先是设置RSSBus应用程序的data目录。点击右上角的link,选择“Admin Settings”。然后会跳转到另一个界面,在该界面可以设置RSSBus应用程序的不同管理员的信息,包括data目录。在web应用程序以外选择一个地方,存储关于profile配置的信息。

文章分类 知识库