在本教程中,我們將向您展示如何在 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 訪問服務器(如果您在桌面上,則只需打開終端)。
- A
non-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官方網站.