En este tutorial, le mostraremos cómo instalar JasperReports en Ubuntu 22.04 LTS. Para aquellos de ustedes que no lo sabían, la biblioteca asperReports es un motor de informes de código abierto que está completamente escrito en Java. Los desarrolladores pueden usar JasperReports como un servidor de biblioteca de informes y análisis independiente. Está completamente escrito en Java y puede usar datos provenientes de cualquier tipo de fuente de datos y producir documentos con píxeles perfectos que se pueden ver, imprimir o exportar en una variedad de formatos de documentos, incluidos HTML, PDF, ExcelOpen Office y Word.

Este artículo asume que tiene al menos un conocimiento básico de Linux, sabe cómo usar el shell y, lo que es más importante, aloja su sitio en su propio VPS. La instalación es bastante simple y se supone que está ejecutando en la cuenta raíz, si no, es posible que deba agregar ‘sudo‘ a los comandos para obtener privilegios de root. Le mostraré la instalación paso a paso de JasperReports en Ubuntu 22.04 (Jammy Jellyfish). Puede seguir las mismas instrucciones para Ubuntu 22.04 y cualquier otra distribución basada en Debian como Linux Mint, Elementary OS, Pop!_OS y más.

requisitos previos

• Un servidor que ejecuta uno de los siguientes sistemas operativos: Ubuntu 22.04, 20.04 y cualquier otra distribución basada en Debian como Linux Mint.
• Se recomienda que utilice una instalación de sistema operativo nueva para evitar posibles problemas.
• Acceso SSH al servidor (o simplemente abra la Terminal si está en una computadora de escritorio).
• Anon-root sudo usero acceder a laroot user. Recomendamos actuar como unnon-root sudo usersin embargo, puede dañar su sistema si no tiene cuidado al actuar como raíz.

Instalar JasperReports en Ubuntu 22.04 LTS Jammy Jellyfish

Paso 1. Primero, asegúrese de que todos los paquetes de su sistema estén actualizados ejecutando lo siguienteaptComandos en la terminal.

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

Paso 2. Instalación de Java OpenJDK.

JasperReports se basa en Java, por lo que deberá instalar Java JDK en su servidor. Ejecutemos el siguiente comando para instalar la versión 11 de JDK predeterminada:

sudo apt install default-jdk

Verifique la versión de Java usando el siguiente comando:

java --version

Para obtener recursos adicionales sobre la instalación y administración de Java OpenJDK, lea la publicación a continuación:

• Cómo instalar OpenJDK en Ubuntu Linux √

Paso 3. Instalación de la base de datos MariaDB.

De forma predeterminada, MariaDB está disponible en el repositorio base de Ubuntu 22.04. Ahora ejecute el siguiente comando a continuación para instalar la última versión de MariaDB en su sistema Ubuntu:

sudo apt install mariadb-server mariadb-client

Después de instalar con éxito, habilite MariaDB (para que se inicie automáticamente al iniciar el sistema), inicie y verifique el estado con los siguientes comandos:

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

Confirme la instalación y verifique la versión de compilación instalada de MariaDB:

mariadb --version

Para obtener recursos adicionales sobre la instalación de MariaDB, lea la publicación a continuación:

• Cómo instalar MariaDB en Ubuntu Linux √

Instalación segura de MariaDB.

De forma predeterminada, MariaDB no está reforzado. Puede asegurar MariaDB usando elmysql_secure_installationguion. debe leer y debajo de cada paso cuidadosamente, que establecerá una contraseña de root, eliminará usuarios anónimos, no permitirá el inicio de sesión de root remoto y eliminará la base de datos de prueba y accederá a MariaDB segura:

mysql_secure_installation

Configúralo así:

- 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

Una vez que MariaDB esté instalado, inicie sesión en MariaDB con el siguiente comando:

mysql

Una vez que haya iniciado sesión, cree un usuario y establezca una contraseña con el siguiente comando:

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

Paso 4. Instalación del servidor Apache Tomcat.

Primero, cree cuentas de usuario y grupo para usar con Tomcat:

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

A continuación, creamos un directorio de inicio de la cuenta de Tomcat, luego descargamos y extraemos el contenido de Tomcat en el directorio:

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

Ahora establezca el permiso y la propiedad adecuados para el directorio de Tomcat:

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

Luego, crea unsystemdarchivo de servicio para Tomcat usando el siguiente comando a continuación:

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

Agregue el siguiente archivo:

[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

Guardar y close el archivo, luego vuelva a cargar elsystemddaemon para aplicar los cambios:

sudo systemctl daemon-reload
sudo systemctl start tomcat

Paso 5. Instalación de JasperReports en Ubuntu 22.04.

Ahora cambiamos el usuario a Tomcat y descargamos el archivo JasperReports con el siguiente comando a continuación:

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

A continuación, descomprima el archivo descargado:

unzip TIB_js-jrs-cp_8.0.0_bin.zip

Luego, copie el archivo de propiedades de MySQL con el siguiente comando:

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

Ahora ejecute los siguientes comandos para abrir el archivo recién creado:

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

Agregue los detalles de configuración de la base de datos como se muestra a continuación:

# 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

Guardar y close el archivo y luego instale JasperReports con el siguiente comando:

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

Una vez que se complete la instalación, obtendrá el siguiente resultado:

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

Finalmente, ahora reinicie el servicio Tomcat para aplicar los cambios:

sudo systemctl restart tomcat

Paso 6. Configure el cortafuegos.

Ahora configuramos un cortafuegos sin complicaciones (UFW) con Apache para permitir el acceso público a los puertos web predeterminados para HTTP y HTTPS:

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

Paso 7. Acceso a la interfaz web de JasperReports.

Una vez instalado correctamente, abra su navegador web y acceda al asistente de instalación de JasperReports usando la URLhttps://your-IP-address:8080/jasperserver/. Será redirigido a la siguiente página:

¡Felicidades! Ha instalado correctamente JasperReports. Gracias por usar este tutorial para instalar JasperReports en el sistema Ubuntu 22.04 LTS Jammy Jellyfish. Para obtener ayuda adicional o información útil, le recomendamos que consulteel sitio web oficial de JasperReports.