3.3目的
此文档的编写目的是为介绍StyleReportEE服务器的工作平台和EnterpriseManager的使用者怎样来管理这个平台的说明手册。
Replet工作平台的管理
一个服务器端报表被称为ireplet.逻辑上的replets的收集后将被保存在一个报表储存库中。
这个储存库有几种实现方式,包括一个基于web的报表浏览器程序、基于java的报表浏览器RMI、CORBA。
服务器端的报表工作平台的设计及框架构建都将在此章中说明。
StyleReportEnterpriseManager的使用
EnterpriseManager是一个基于web的服务程序,它是作为StyleReport报表储存库的一个管理工具来提供的。
在此章文字中,描述了怎样利用EnterpriseManager来进行报表储存库的管理。
如何配置Replets
当replets发展增多时,可以用EnterpriseManage来创建一个replets储存库。
也可以利用它来配置一个已经存在的储存库,并为这个储存库配置一个WAR文件。
此节文章描述了如何一步步来进行这些配置的步骤。
疑难解答
通常会出现的问题及它们的解决办法。
4管理Replet平台
4.1简介
一个replet可以在广义上被定义为发布到服务器(web应用服务器,RMIserver或者CORBAserver)上的报表。
StyleReport的报表可以使用设计器或纯JAVA编码两种方式来设计,它们都可以被发布到报表服务器上,也就是说,他们都可以被称为replet。
StyleReport提供一个基于servlet的被称为EnterpriseManager的管理界面,这个工具提供一个WEB界面来管理replet环境。
它使得报表发布、安全管理、展现管理以及报表引擎的性能调优都变的极其方便。
插图1.RepletEnvironment
4.2入门
我们从发布一个报表模板文件(.srt)为一个replet开始。
在此,我们首先通过在EnterpriseManager界面发布一个简单的模板文件来介绍这个过程。
你可以在你的安装路径下找到模板例子installation_folder\Tomcat\webapps\sree\WEB-INF\classes\inetsoft\demo\templates。
拷贝toolbars.srt(或任何一个模板文件)到classes目录。
首先从StyleReport菜单中启动enterprisemanager,EnterpriseManager(AdmServlet)中提供支持的Tomcatserver已经被展开。
现在,打开一个web浏览器并且将其连接到下列URL:
http:
//localhost:
8080/sree/EnterpriseManager。
在左边的导航树上依次点开节点“Repository->RepleteRegistry”,点击“Folders&Replets”旁边的编辑按钮,将出现如下界面:
插图2.文件夹与Replet的管理
注册一个replet,点击‘AddReplet’.,将打开下面所示窗口。
插图3.增加一个Replet
按下面表格的说明填写这个对话框:
字段
值
说明
文件夹
Guide
允许选择一个被创建的文件夹。
登录到此页的replet将被添加到文件夹中。
Name
Toolbars-2
这个字段包括着被用来指向报表的名称。
Alias
Toolbars-2-Alias
是在你如果需要时,可设置的别名。
Type
Template
如果发布的replet是一个用java编写的类,则选择class,如果是模板(.srt),则选择Template。
也可以选择Upload来上载模板。
HTML布局
Default
默认的表格转换方式是转变为html格式。
类/模版
/toolbars.srt
如果replet是一个模版,则填写包含在相对路径下的模板文件名;如果是class,则填写包含类的包在内的全来名,如com.deom.Demo。
点击‘Save’。
系统将把这些信息储存到repository.xml中。
打开一个浏览器,键入下面URL
http:
//localhost:
8080/sree/Examples
我们可以通过报表浏览截面来查看刚才发布好的报表。
插图4.Toolbar-2报表
4.3Thesree.home目录
‘sree.home’是一个目录,包含着重要的报表库配置配置文件。
两个最重要的配置文件是:
•sree.properties–包含着最关键的报表服务器的配置信息。
在sree.properties中的路径可以利用一个完全的路径来指定,或在相关的sree.home路径上,可以利用可变的环境e.g.$(sree.home)\repository.xml来指定。
•repository.xml–存储报表库的逻辑结构。
其他的配置文件包括:
•schedule.xml–包含着计划任务的配置的xml规范。
•datasource.xml–包含报表应用程序的数据源的配置的xml规范。
•query.xml.–包含特别数据源相关的query的xml规范。
•sree.log–无格式文本文件包含SREE服务器的日志事件。
•schedule.log–无格式文本文件包含着服务器的计划任务组成的日志。
sree.home通常作为Report储存服务程序(inetsoft.sree.web.ServletRepository)和EnterpriseManagerservlet的初始化参数被指定。
然而,如果配置文件放置在类路径的根部,那么sree.home初始化参数并不是必需的(i.e.inWEB-INF/classes)。
4.4并发
定义相关的报表引擎中的并发数.我们需要定义报表引擎,并发数作为可以在同一时间用报表引擎sessions的用户来定义。
用户在他登陆后session开始。
在用户退出或者当所有的报表同用户的session超时时,session停止。
4.5报表库对象的执行
在StyleReport中,有一系列的ready-to-use报表库服务器组成构件。
•基于servlet的嵌入报表引擎服务程序。
基于报表的webreplet存储执行程序。
•服务器集群的服务程序。
载入平衡储存库端的replet储存库的执行服务程序。
用户必须为一个执行向导指定片断3.6。
•RMIReplet存储库
RMI服务器对象执行replet存储。
•CORBAReplet存储库
CORBA服务器对象执行replet存储。
我们点击相应的‘Edit’图标和选择适当的服务器类型来更改服务器类型,然后点击‘Save’。
插图5.选择Server类
如果我们选择基于servlet嵌入式报表引擎为服务程序,我们只需要从主服务器页面重起储存库。
RMI和CORBA服务器类型可以从主服务器页面被启动,停止和重起。
replet存储库是主服务器构件。
它可以从客户端可靠的处理所有的replet-related请求。
也可以管理已注册的replets和当前使用的replet程序。
API是为储存库在RepletRepository界面定义的,然而,应用程序并不需要直接使用API储存库。
4.5.1基于servlet的嵌入式报表引擎服务程序
这是最常用的报表引擎,在这个配置下,我们通过一个内嵌了报表引擎的的servlet来访问报表库。
通过这个引擎,我们可以通过浏览器看到所有的报表。
插图6.EnterpriseManager主要服务器页面
注意:
在这个界面中“restart”按钮不能重起应用服务器服务器程序。
它仅仅是通过重新加载sree.properties来刷新与报表服务器相关的配置。
我们的报表库服务程序URL(RepositoryServletURL)指定了访问报表浏览引擎(StyleReportEEreportserver)的URL。
它必须通过服务器端应用程序与已有的URL相匹配。
如果属性中包含一个不同的URL,它就不能正确地访问服务程序。
在大部分的服务器应用程序中,属性可以设置为空白,所以服务程序建立它自己的url。
然而,一些服务器应用程序不能向服务程序正确地返回url。
既然如此,服务程序url属性就必须可以用来覆盖并提供正确的url。
其他类型的引擎,我们将专门制作文档介绍!
5StyleReportEnterpriseManager的使用
5.1简介
EnterpriseManager推动下列的典型管理任务:
•管理XML配置文件和标准的属性文件。
•无论他们是否为servlet,RMI或CORBA,启动和停止服务器组成。
•管理计划任务和启动、停止计划任务服务器。
•管理报表存档容量。
•在StyleReport上打包、配置和注册报表。
•管理和配置安全机制,包括创建用户和角色
•默认的安全提供者管理用户和角色定义。
在下面,我们将说明EnterpriseManager的使用。
注意:
贯穿EnterpriseManager始终,路径和文件名称不允许包括中文或其他unicode字符。
5.1.1浏览器设置的需求
EnterpriseManager支持4.0或更高版本的浏览器。
(Netscape4.x
或IE4.x或更高版本)。
唯一的要求就是浏览器必须同一个Java虚拟机器相链接并在网页上执行JavaScript。
NetscapeNavigator
在Netscape中,选择‘Edit->Preferences’.
插图9.NetscapeAdvancedPreferences
MicrosoftInternetExplorer
在IE上,选择‘Tools->InternetOptions...’
插图10.InternetExplorerAdvancedInternetOptions
5.2用SSL启动EnterpriseManager
假设SSL已经用Tomcat配置,因此,EnterpriseManager可以在TOMCAT_HOME/conf/server.xml文件之后的无标注内容来启动:
className=”org.apache.tomcat.service.PoolTcpConnector”>
value=”org.apache.tomcat.service.http.HttpConnectionHandler
value=”8443”/>
value=”org.apache.tomcat.SSLSocketFactory”/>
现在EnterpriseManager通过下列URL来访问:
http:
//localhost:
8443/sree/EnterpriseManager,
利用SSL来执行鉴定任务。
.
5.3主服务器页面
当EnterpriseManager启动后,它默认为‘MainServer’页面,可以在主服务器的导航树上发现‘MainServer’页面。
从服务器主菜单中我们看出可以执行下列操作:
•更改服务器类型
•更改servletURL(如果报表储存库是基于web的servlet,那么为这些文件拥有有效的写入值是非常重要的)
•更改serverURL(如果报表存储库是一个非web的java客户端)
•检查状态,‘Running’或者‘Stopped’
•配置LicenseKeys.
•‘Start’,‘Stop’或是‘Restart’报表储存库,注意:
如果报表储存库是基于servlet的web,我们仅仅可以重启,这里并不支持开始、停止。
5.3.1更改服务器类型
如果我们点击‘edit’链接旁的ServerType,我们将调上来以下的让我们更改服务器类型的对话框。
插图11.更改服务器类型
选择我们所使用的报表储存执行并点击‘Save’。
5.3.2编辑URL
这里有两种类型的URL:
RepositoryServletURL和ServerURL。
RepositoryServletURL是指报表库的webURL。
如果我们在web浏览器上使用这个链接,我们将会看到我们的报表储存库(假定储存库程序运行在appserver里)。
URL需要正确的格式化,否则我们连接不上储存库服务程序,例如:
‘http:
//localhost:
8100/servlet/SreeServlet’如果你使用一个和EnterpriseManager相同的服务程序url,主机的ip地址和端口号就可以被忽略。
所以相关的url格式就要与‘/sree/Examples’相类似。
ServerURL涉及到用来将其绑定报表储存库对象到RMIregistry的绑定的名称,或者CORBA名称服务程序(取决于我们是否使用RMI,集群或者CORBA)。
URL有若干的格式,关于我们报表存储库的命名和绑定是灵活多变的。
下列的为格式:
//[server-name]:
[port-number]/[bindingname]
servername的名称是必需的。
portnumber是可选的,如果没有指定端口号,那么将使用默认的RMI端口号1099,COBBA端口号1050。
bindingname是可选的。
如果没有指定,那么基于储存库的RMI默认为RepletRepository。
基于COBBA的存储库也默认为RepletRepository。
5.3.3License文件
在EnterpriseManager中,如果需要使用附加模块,那么确认‘srlicense.dat’文件保存到sreehome。
如果文件被储存到其它的目录中,在EnterpriseManager的license文件中输入全部的路径。
5.4配置页面
通过点击导航树上的配置链接,我们可以更改服务器的类型。
展开配置节点,我们就可以设置下列服务器端报表工作环境的问题:
表2.配置节点下的链接
链接
说明
集群
允许为集群中的节点来配置选项。
Java
将显示服务器CLASSPATH的应用程序
数据库/库
可以为数据库、query和库文件指定位置。
邮件
如果报表需要发送给用户,那么可以用来设置邮件设定值
服务器打印机
服务器旁的打印机列表,通常用来输出报表
本地化
配置报表内容的本地化
最大Session页面
注册惯用的显示页面来通知用户所有可以利用的sessions都被利用上了。
5.4.1集群
如果我们选定了一个支持集群的服务器类型,此集群页面才为我们展示。
插图12.集群页面
“RestartAll”按钮被用来重新启动所有的群集节点。
表3.集群管理选项
选项
说明
检验框
如果我们希望从菜单中删除一个节点,就从这里选择。
编辑节点
当我们编辑一个已有的URL节点时,会像创建一个RMI或者是服务器URL的时候一样,应用相同的格式规则。
请注意上面的“EditingtheURL”。
点击‘Add’来添加一个新的节点,‘Delete’来选择移出一个节点。
5.4.2Java
此页简单的介绍了关于应用服务器的JVM和CLASSPATH.的一些信息。
5.4.3数据资源
此页面允许定义指定的datasource.xml和query.xmlregistry注册文件。
一个附加的boolean选项可以指出query的名称是否是唯一的。
此页面也承认StyleReportbeans的Bean库的规格。
你可以指定JDBC数据资源使用的连接池类型。
如果选择应用服务程序连接池,在数据资源注册文件中的数据资源名称必须与应用服务程序中的JNDI数据资源名称相匹配。
所支持的应用程序服务器有Tomcat,WebSphere,WebLogic。
如果选择用户定义,就必须输入全部有效的所提供的文本文件连接池执行的类名称。
5.4.4邮件
Mail配置控制着计划任务怎样邮寄一个报表给用户。
这封E-mail总是从一个固定的e-mail地址来发送,这是指定的mail配置的一部分。
为使e-mail的传送工作正常进行,mail的主机必须配置好并且选择一个有效的SMTP服务器。
系统管理E