如何在 Apache Tomcat 环境中安装 BIRT 查看器

BIRT 是一种基于 Java 技术的开源报告引擎。这是 Eclipse 顶级项目之一。

以下是 BIRT 的两个主要组件：

1. BIRT 报告设计器 – 您可以使用 Eclipse 中的此设计器 UI 设计丰富的报告。报表设计以 XML 格式存储。
2. BIRT 查看器 – 此运行时查看器可帮助您针对任何数据集执行报告。您可以直接从 Eclipse 中查看报告。或者，您可以将报告部署为 Apache Tomcat Web 应用程序，然后从 Web 浏览器查看它。

Birt Viewer 帮助开发人员在自定义应用程序中嵌入报告。BIRT 查看器支持多种报告输出格式，包括 HTML、PDF、XLS、DOC、power point、postscript 等。

本篇介绍了如何在 Apache Tomcat 环境中安装 BIRT 查看器。

1.创建Tomcat用户

在安装 tomcat 之前，创建一个将安装 tomcat 的 Linux 用户。

我们将在安装 Tomcat 后部署 BIRT 运行时环境。

adduser tomcat 
passwd tomcat

2.下载Tomcat 8

从官网下载当前版本的 Apache tomcat 。

或者，使用 wget 直接下载到服务器上，如下所示。

su - tomcat

wget http://apache.osuosl.org/tomcat/tomcat-8/v8.0.15/bin/apache-tomcat-8.0.15.zip

unzip apache-tomcat-8.0.15.zip

3. Tomcat 基本安全设置

在 /home/tomcat/apache-tomcat-8.0.15/conf 目录下，找到 tomcat-users.xml 文件。

在这个文件中，在“</tomcat-users>”前添加以下两行

vi tomcat-users.xml
  <role rolename="manager-gui"/>
  <user username="admin" password='mysecretpwd' roles="manager-gui"/>

4.启动Tomcat

启动Apache Tomcat，如下所示。

$ export CATALINA_HOME=/home/tomcat/apache-tomcat-8.0.15

$ cd $CATALINA_HOME/bin

$ sh catalina.sh start
Using CATALINA_BASE:   /home/tomcat/apache-tomcat-8.0.15
Using CATALINA_HOME:   /home/tomcat/apache-tomcat-8.0.15
Using CATALINA_TMPDIR: /home/tomcat/apache-tomcat-8.0.15/temp
Using JRE_HOME:        /usr
Using CLASSPATH:       /home/tomcat/apache-tomcat-8.0.15/bin/bootstrap.jar:/home/tomcat/apache-tomcat-8.0.15/bin/tomcat-juli.jar
Tomcat started.

注意：如果您在启动 Apache tomcat 时收到以下错误消息，请确保在您的系统上安装 Java。

# sh catalina.sh start
Neither the JAVA_HOME nor the JRE_HOME environment variable is defined
At least one of these environment variable is needed to run this program

在 CentOS（或 Red Hat）上，执行以下操作来安装 java：

yum install java-1.8.0

Tomcat 日志消息位于此日志文件中：$CATALINA_HOME/logs/catalina.out

5. 验证Tomcat Manager UI

从以下 URL 登录 tomcat manager：

http://{your-ip-address}:8080/manager/html

输入您在上一步中在 tomcat-users.xml 中设置的 uid/pwd。

在应用程序部分，您将看到以下内容。此时，您不会在此处注意到 BIRT：

• /
• /docs
• /examples
• /host-manager
• /manager
• 
  

6. 下载 BIRT 运行时查看器

去到BIRT 官网下载页面，找到“最新 BIRT 运行时发布版本”这一部分 -> 从该部分单击“立即下载”。

或者，使用 wget 直接下载它。

su - tomcat 

wget http://mirrors.xmission.com/eclipse/birt/downloads/drops/R-R1-4_4_1-201409161320/birt-runtime-4_4_1-20140916.zip

6. 部署 BIRT 查看器

要部署 BIRT 查看器，请解压缩 zip 文件并将 birt-runtime 移动到 Tomcat webapps 目录，如下所示。

unzip birt-runtime-4_4_1-20140916.zip

cd birt-runtime-4_4_1

export CATALINA_HOME=/home/tomcat/apache-tomcat-8.0.15

cp -r WebViewerExample $CATALINA_HOME/webapps/birt-viewer

之后查看catalina.out（tomcat日志文件），会显示birt-viewer部署成功，如下图。

$ tail catalina.out
14-Nov-2020 22:17:41.937 INFO [localhost-startStop-2] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory /home/tomcat/apache-tomcat-8.0.15/webapps/birt-viewer has finished in 24,050 ms

7.验证Birt Viewer

现在，如果您转到以下 URL，您将在应用程序列表中看到 /birt-viewer。您可以单击此处启动查看器测试应用程序。

http://{your-ip-address}:8080/manager/html

或者，您可以直接进入 BIRT Viewer 应用程序，如下所示。

http://{your-ip-address}:8080/birt-viewer/

如下图，我们已经安装了最新版本的BIRT Viewer 4.4.1。

当您单击“查看示例”时，它将启动与查看器捆绑在一起的示例 BIRT 报告，如下所示。

这表明查看器的 BIRT 运行时环境已设置并准备就绪。您可以开始部署您的自定义 BIRT 报告 xml 文件。