本主题描述了如何在 WebSphere® Application
Server 上配置 BIRT Web 归档。
关于此任务
在 WebSphere Application
Server 上安装 Business Intelligence and Reporting
Tools (BIRT) 服务器运行时之后,将 BIRT Web 归档中的配置设置更改为您的环境所需的值。
- 查找端口信息
- 这些指示信息中指定的路径位置使用针对 WebSphere Application Server 概要文件配置的缺省端口。如果您的环境不使用缺省值,那么必须更新端口号以使用正确的值。您可在以下目录中找到针对概要文件的已配置端口:/profiles/logs/AboutThisProfile.txt。
- 使用 wsadmin 工具
- 如果您正在使用 BIRT V2.3.2 或更高版本,那么更改配置设置后,必须使用
WebSphere Application Server wsadmin 工具来更新 BIRT web.xml 文件。有关该工具的信息,请参阅 WebSphere Application Server 信息中心。
过程
- 打开 BIRT Web 归档。
- 在 Web 浏览器中输入以下 URL,启动 WebSphere 集成解决方案控制台:
http://server_host:port/ibm/console/login.do
其中 port
是针对 WebSphere Application
Server 概要文件的端口。如果 WebSphere 已安装到新的概要文件目录中,那么缺省端口为 12060。如果安装在缺省 WebSphere 概要文件中,那么管理端口为 9060。
- 更新配置设置:
- 选择应用程序 -> 应用程序类型
→ WebSphere 企业应用程序。
- 单击 birt_war。 这样会打开用于定制 BIRT 设置的“配置”选项卡。
- 从详细属性页面中,选择类装入和更新检测。
- 在已更新文件的轮询时间间隔中,提供一个整数值,例如 60。
- 在类装入器顺序中,选择以用应用程序类装入器装入的类为先(父级最后)。
- 在 WAR 类装入器策略页面中,选择单个应用程序类装入器。
- 单击“确定”保存配置设置。然后,单击保存,将更改应用于主配置。
- 如果您正在使用 BIRT V2.3.2 或更高版本,那么更新 BIRT web.xml。
- 将 BIRT web.xml 文件复制到临时目录。 您可在以下目录中找到 web.xml:<cq_profile_dir>/installedApps/dfltCell/birt_war.ear/birt.war/WEB-INF/web.xml
注: 在 Windows、Unix 和 Linux 平台上,缺省的 WebSphere Application Server 单元目录为 dfltCell。在 Solaris 平台上,缺省目录为 <srv>Node01Cell。
- 转至临时目录。然后,编辑 web.xml 文件。
- 将 WORKING_FOLDER_ACCESS_ONLY 的参数值从 true 更改为 false。
<context-param>
<param-name>WORKING_FOLDER_ACCESS_ONLY</param-name>
<param-value>false</param-value>
- 将 WORKING_FOLDER_ACCESS_ONLY 的参数值从 true 更改为 false。
- 保存该文件。
- 将更新的文件应用于 WebSphere 主配置。
- 通过命令提示符,转至在步骤 4 中创建的临时目录。然后,运行以下命令以针对目标概要文件启动 wsadmin 工具。
- Windows
- <cq_profile_dir>\bin\wsadmin
- UNIX 或 Linux
- <cq_profile_dir>/bin/wsadmin.sh
其中 <cq-profile-dir> 是指向安装 BIRT 服务器运行时环境的概要文件的路径。
注: 如果已针对此概要文件启用了 WebSphere 管理安全性,那么在提示时输入管理用户的用户名和密码。在某些情况下,您可能必须提供额外的参数,才能启动 wsadmin 工具。例如,如果 WebSphere 概要文件未使用 8880 作为缺省 SOAP 接口,那么您必须提供其端口号。
在
<cqweb-profile-root> 目录中,查找
cqwebprofile_ports.txt 文件或在现有 WAS 概要文件中查找端口定义文件。打开文件,然后查找
SOAP_CONNECTOR_ADDRESS=<port#>。
在常见安装方案中,该端口号将是 12880。
使用以下语法提供端口号:
wsadmin -connType SOAP -port #### -user admin -password YourPassword
- 在 wsadmin 提示符中,输入以下命令:
wsadmin> $AdminApp update birt_war file {-operation update -contents web.xml -contenturi birt.war/WEB-INF/web.xml}
wsadmin> $AdminConfig save
wsadmin>exit