如何在 Ubuntu 22.04 LTS 上安裝 JasperReports

在本教程中,我們將向您展示如何在 Ubuntu 22.04 LTS 上安裝 JasperReports。 對於那些不知道的人,asperReports 庫是一個完全用 Java 編寫的開源報告引擎。 開發人員可以將 JasperReports 用作獨立的分析和報告庫服務器。 它完全用 Java 編寫,可以使用來自任何類型數據源的數據並生成像素完美的文檔,這些文檔可以查看、打印或導出為各種文檔格式,包括 HTML、PDF、ExcelOpen Office 和 Word。

本文假設您至少對 Linux 有基本的了解,您知道如何使用 shell,最重要的是,您在自己的 VPS 上託管您的站點。 安裝非常簡單,它假定您在 root 帳戶下運行,如果不是,您可能需要添加 'sudo' 獲取 root 權限的命令。 我將向您展示如何在 Ubuntu 22.04 (Jammy Jellyfish) 上逐步安裝 JasperReports。 對於 Ubuntu 22.04 和任何其他基於 Debian 的發行版(如 Linux Mint、Elementary OS、Pop!_OS 等),您可以按照相同的說明進行操作。

以前的要求

  • 運行以下操作系統之一的服務器:Ubuntu 22.04、20.04 和任何其他基於 Debian 的發行版,如 Linux Mint。
  • 建議您使用全新的操作系統安裝以避免潛在問題。
  • 通過 SSH 訪問服務器(如果您在桌面上,則只需打開終端)。
  • Anon-root sudo user或訪問root user. 我們建議充當non-root sudo user但是,如果您在以 root 身份運行時不小心,它可能會損壞您的系統。

在 Ubuntu 22.04 LTS Jammy Jellyfish 上安裝 JasperReports

第 1 步:首先,通過運行以下命令確保系統上的所有軟件包都是最新的apt終端中的命令。

sudo apt update
sudo apt upgrade
sudo apt install wget apt-transport-https gnupg2 software-properties-common

步驟 2. 安裝 Java OpenJDK。

JasperReports 基於 Java,因此您需要在服務器上安裝 Java JDK。 讓我們運行以下命令來安裝默認的 JDK 版本 11:

sudo apt install default-jdk

使用以下命令檢查 Java 版本:

java --version

有關安裝和管理 Java OpenJDK 的其他資源,請閱讀以下帖子:

  • 如何在 Ubuntu Linux 上安裝 OpenJDK √

步驟 3. 安裝 MariaDB 數據庫。

默認情況下,MariaDB 在 Ubuntu 22.04 基礎存儲庫中可用。 現在運行下面的命令在你的 Ubuntu 系統上安裝最新版本的 MariaDB:

sudo apt install mariadb-server mariadb-client

安裝成功後,啟用MariaDB(系統開機自動啟動),使用以下命令啟動並查看狀態:

sudo systemctl enable mariadb
sudo systemctl start mariadb
sudo systemctl status mariadb

確認安裝並檢查已安裝的 MariaDB 構建版本:

mariadb --version

有關安裝 MariaDB 的其他資源,請閱讀以下帖子:

  • 如何在 Ubuntu Linux 上安裝 MariaDB √

安全安裝 MariaDB。

默認情況下,MariaDB 未加固。 您可以使用以下方法保護 MariaDBmysql_secure_installation腳本。 您應該仔細閱讀下面的每個步驟,這將設置 root 密碼、刪除匿名用戶、禁止遠程 root 登錄、刪除測試數據庫並訪問安全的 MariaDB:

mysql_secure_installation

像這樣設置:

- Set root password? [Y/n] y
- Remove anonymous users? [Y/n] y
- Disallow root login remotely? [Y/n] y
- Remove test database and access to it? [Y/n] y
- Reload privilege tables now? [Y/n] y

安裝 MariaDB 後,使用以下命令登錄 MariaDB:

mysql

登錄後,使用以下命令創建用戶並設置密碼:

MariaDB [(none)]> grant all on *.* to [email protected] identified by 'your-strong-password';
MariaDB [(none)]> flush privileges;
MariaDB [(none)]> exit;

步驟 4. 安裝 Apache Tomcat 服務器。

首先,創建用於 Tomcat 的用戶和組帳戶:

groupadd tomcat
useradd -s /bin/bash -g tomcat -d /opt/tomcat tomcat

接下來,我們創建一個 Tomcat 帳戶主目錄,然後將 Tomcat 內容下載並解壓到該目錄中:

mkdir /opt/tomcat
wget https://dlcdn.apache.org/tomcat/tomcat-8/v8.5.83/bin/apache-tomcat-8.5.83.tar.gz
sudo tar -xzvf apache-tomcat-8.5.83.tar.gz -C /opt/tomcat --strip-components=1

現在為 Tomcat 目錄設置適當的權限和所有權:

sudo chown -R tomcat: /opt/tomcat
sudo sh -c 'chmod +x /opt/tomcat/bin/*.sh'

然後創建一個systemd使用以下命令為 Tomcat 創建服務文件:

sudo nano /etc/systemd/system/tomcat.service

添加以下文件:

[Unit]
Description=Tomcat webs servlet container
After=network.target

[Service]
Type=forking

User=tomcat
Group=tomcat
RestartSec=10
Restart=always 
Environment="JAVA_HOME=/usr/lib/jvm/java-1.11.0-openjdk-amd64"
Environment="JAVA_OPTS=-Djava.awt.headless=true -Djava.security.egd=file:/dev/./urandom"

Environment="CATALINA_BASE=/opt/tomcat"
Environment="CATALINA_HOME=/opt/tomcat"
Environment="CATALINA_PID=/opt/tomcat/temp/tomcat.pid"
Environment="CATALINA_OPTS=-Xms1024M -Xmx2048M -server -XX:+UseParallelGC"

ExecStart=/opt/tomcat/bin/startup.sh
ExecStop=/opt/tomcat/bin/shutdown.sh

[Install]
WantedBy=multi-user.target

保存並關閉文件,然後重新載入systemd應用更改的守護進程:

sudo systemctl daemon-reload
sudo systemctl start tomcat

步驟 5. 在 Ubuntu 22.04 上安裝 JasperReports。

現在我們將用戶更改為 Tomcat 並使用以下命令下載 JasperReports 文件:

sudo su - tomcat
wget https://sourceforge.net/projects/jasperserver/files/JasperServer/JasperReports%20Server%20Community%20edition%208.0.0/TIB_js-jrs-cp_8.0.0_bin.zip

接下來,解壓下載的文件:

unzip TIB_js-jrs-cp_8.0.0_bin.zip

然後使用以下命令複製 MySQL 屬性文件:

cp jasperreports-server-cp-8.0.0-bin/buildomatic/sample_conf/mysql_master.properties jasperreports-server-cp-8.0.0-bin/buildomatic/default_master.properties

現在運行以下命令打開新創建的文件:

nano jasperreports-server-cp-8.0.0-bin/buildomatic/default_master.properties

添加數據庫配置詳細信息,如下所示:

# if linux package managed tomcat instance, set two properties below

CATALINA_HOME = /opt/tomcat
CATALINA_BASE = /opt/tomcat
#database type

dbType=mysql
#database location and connection settings
dbHost=localhost
dbUsername=jasperadmin
dbPassword=strong-your-password

保存並關閉文件,然後使用以下命令安裝 JasperReports:

cd jasperreports-server-cp-8.0.0-bin/buildomatic/
./js-install-ce.sh

安裝完成後,您將獲得以下輸出:

install-normal-ce:
[echo] Installation successfully completed!BUILD SUCCESSFUL
Total time: 2 minute 16 seconds
Checking Ant return code: OK

最後,現在重新啟動 Tomcat 服務以應用更改:

sudo systemctl restart tomcat

步驟 6. 配置防火牆。

現在我們使用 Apache 配置一個簡單的防火牆 (UFW),以允許公共訪問 HTTP 和 HTTPS 的默認 Web 端口:

sudo ufw allow OpenSSH
sudo ufw allow 8080/tcp
sudo ufw enable

步驟 7. 訪問 JasperReports Web 界面。

成功安裝後,打開 Web 瀏覽器並使用 URL 訪問 JasperReports 安裝嚮導https://your-IP-address:8080/jasperserver/. 您將被重定向到以下頁面:

恭喜! 您已經成功安裝了 JasperReports。 感謝您使用本教程在 Ubuntu 22.04 LTS Jammy Jellyfish 系統上安裝 JasperReports。 如需更多幫助或有用信息,我們建議您諮詢JasperReports官方網站.

相關文章