Instalar Pentaho Server

Instalación de los componentes del servidor Pentaho ..

Servidor Pentaho

Esta sección le guía a través de la instalación e inicio del Servidor Pentaho en Ubuntu.

Usted va a:

Crear directorios de instalación
Preparar las bases de datos del Repositorio Pentaho
Configurar conexiones JDBC/JNDI
Iniciar el Servidor Pentaho (y opcionalmente configurar systemd)
Configurar el Gestor de Licencias

Línea base probada: Ubuntu 24.04 LTS con Java 21 (OpenJDK) y PostgreSQL 17.

Asegúrese de haber completado Preparar Entorno primero.

Para detalles de compatibilidad, consulte Referencia de Componentes.

Requisitos previos

Servidor Ubuntu 24.04 LTS
Java 21 instalado y PENTAHO_JAVA_HOME establecido
PostgreSQL 17 instalado y en ejecución
Un usuario pentaho que no sea root con sudo
paquete unzip
Archivos ZIP del archivo y controladores JDBC descargados

Directorios del Servidor Pentaho

El Servidor Pentaho es una aplicación web que se ejecuta en un contenedor de servlets Apache Tomcat.

Crear directorios base bajo /opt/pentaho.

cd
sudo mkdir -p /opt/pentaho/{server,software}

/opt/pentaho
├── server      # Runtime del servidor desempaquetado (tomcat, pentaho-solutions, scripts)
└── software    # Instaladores, ZIPs, controladores (área de preparación)

Crear subdirectorios en /opt/pentaho/software.

cd /opt/pentaho/software
sudo mkdir -p {db-drivers,docker,ee-client,ee-plugins,ops-mart,sdk,server,shims}

db-drivers   - controladores JDBC
docker       - configuración on-prem de Pentaho y dockerfiles
ee-client    - complementos cliente EE de Pentaho
ee-plugins   - complementos de servidor EE de Pentaho
ops-mart     - scripts de Operations Mart
sdk          - kit del SDK de Pentaho
server       - servidor Pentaho
shims        - colecciones de shims de Hadoop

Desempaquetar el Paquete del Servidor Pentaho (ZIP)

Use paquete para extraer el ZIP del servidor en el directorio runtime. Esto evita requerir el JDK completo (el JRE no incluye la herramienta jar ).

pentaho-server-ee-11.0.0.0-2xx.zip - Servidor Pentaho (Archivo - incluye Tomcat 10)

Asegúrese de que paquete esté disponible y copie los ZIPs del servidor en el área de preparación.

cd
sudo apt update -y && sudo apt install -y unzip
sudo cp ~/Downloads/'Archive Build (Suggested Installation Method)'/* /opt/pentaho/software/server

Extraer el ZIP del Servidor Pentaho en $PENTAHO_BASE/server.

cd
cd "$PENTAHO_BASE/server"

# Reemplace <version> con el nombre de archivo exacto que descargó
sudo unzip /opt/pentaho/software/server/pentaho-server-ee-11.0.0.0-2xx.zip

Hacer todos los .sh archivos ejecutables.

cd
cd "$PENTAHO_BASE/server"
sudo find . -iname "*.sh" -exec chmod +x {} \;

Establecer la propiedad y permisos sensatos para ejecutar 'pentaho' como un usuario que no sea root.

cd
sudo chown -R pentaho:pentaho /opt/pentaho
sudo find /opt/pentaho -type d -exec chmod 755 {} \;
sudo find /opt/pentaho -type f -exec chmod 644 {} \;
sudo find /opt/pentaho -name "*.sh" -exec chmod 755 {} \;

755 significa que usted puede hacer cualquier cosa con el archivo o directorio, y otros usuarios pueden leer y ejecutar pero no modificarlo. Adecuado para programas y directorios que desea hacer públicos.

644 significa que usted puede leer y escribir el archivo o directorio y otros usuarios solo pueden leerlo.

Verifique la estructura de directorios del servidor.

/opt/pentaho/

  server/
    pentaho-server/
      pentaho-solutions/
        system/

Los complementos del servidor se instalan en la pentaho-solutions/system carpeta.

Componentes del Repositorio Pentaho

El Repositorio Pentaho (en PostgreSQL por defecto) consiste en:

Jackrabbit: repositorio de soluciones, seguridad y metadatos de contenido
Quartz: datos del programador
Hibernate: registro de auditoría
Pentaho Operations Mart: informes de uso y rendimiento

Revisar contraseñas por defecto en scripts SQL

Inspeccione los scripts de PostgreSQL incluidos con el servidor.

cd
cd "$PENTAHO_SERVER/data/postgresql"
ls -1

Debería ver archivos similares a:

alter_script_postgresql_BISERVER-13674.sql
create_jcr_postgresql.sql
create_quartz_postgresql.sql
create_repository_postgresql.sql
migrate_old_quartz_data_postgresql.sql
pentaho_logging_postgresql.sql
pentaho_mart_drop_postgresql.sql
pentaho_mart_postgresql.sql
pentaho_mart_upgrade_audit_postgresql.sql
pentaho_mart_upgrade_postgresql.sql

Abra un script para revisar usuarios/contraseñas por defecto (cambie para producción).

sed -n '1,120p' create_jcr_postgresql.sql

Ejecutar scripts SQL para crear las bases de datos del Repositorio

Confirme que PostgreSQL está en ejecución y localice los scripts.

sudo systemctl status postgresql --no-pager
cd
cd "$PENTAHO_SERVER/data/postgresql"
ls -l

Conectarse como un pentaho superusuario.

Contraseña: SecurePassword123

sudo -u pentaho psql -d postgres

Ejecute los comandos paso a paso - no como un único bloque de script. Proporcione contraseñas si se le solicitan - ver más abajo.

\i create_jcr_postgresql.sql
\i create_quartz_postgresql.sql
\q salir después de Quartz y vuelva a iniciar sesión ..
asegúrese de estar en el directorio "$PENTAHO_SERVER/data/postgresql"
sudo -u pentaho psql -d postgres
\i create_repository_postgresql.sql
\i pentaho_mart_postgresql.sql
\q salir después de hibernate y vuelva a iniciar sesión ..
asegúrese de estar en el directorio "$PENTAHO_SERVER/data/postgresql"
sudo -u pentaho psql -d postgres
\i pentaho_logging_postgresql.sql
\q

Usuario

Contraseña

postgres

SecurePassword123

pentaho

SecurePassword123

jcr_user

password

pentaho_user

password

hibuser

password

Validación rápida (CLI) - listar bases de datos creadas y conectar - presione q para desplazarse por la lista.

\l+ jackrabbit
\l+ quartz
\l+ hibuser
\l+ opsmart
\c jackrabbit
\dt
\c quartz
\dt

Las tablas para Hibernate y Jackrabbit pueden crearse más tarde por el Servidor Pentaho en el primer inicio. Ver esquemas vacíos en esta etapa puede ser esperable.

Opcional: verificar en pgAdmin (GUI).

Configurar Pentaho para usar PostgreSQL

PostgreSQL es el predeterminado. Si mantuvo las contraseñas y el puerto por defecto (5432), solo verifique las siguientes configuraciones; de lo contrario, ajuste host/puerto/usuario/contraseña para que coincidan con su entorno.

Quartz - establecer el delegado de PostgreSQL y la fuente de datos JNDI.

Abra la configuración de Quartz.

cd "$PENTAHO_SERVER/pentaho-solutions/system/scheduler-plugin/quartz"
sudo nano -c quartz.properties

Verifique estos valores (los números de línea pueden diferir):

quartz.properties — entradas requeridas

org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.PostgreSQLDelegate
org.quartz.dataSource.myDS.jndiURL=Quartz

Hibernate — apuntar al archivo de configuración de PostgreSQL.

Abra la configuración de Hibernate.

cd "$PENTAHO_SERVER/pentaho-solutions/system/hibernate"
sudo nano -c hibernate-settings.xml

Confirme la referencia al archivo de configuración:

hibernate-settings.xml

<config-file>system/hibernate/postgresql.hibernate.cfg.xml</config-file>

Opcionalmente revise postgresql.hibernate.cfg.xml para el nombre de la fuente de datos y el dialecto.

sudo nano -c postgresql.hibernate.cfg.xml

Asegúrese:

postgresql.hibernate.cfg.xml — propiedades clave

<property name="connection.driver_class">org.postgresql.Driver</property>
<property name="dialect">org.hibernate.dialect.PostgreSQLDialect</property>
<property name="hibernate.connection.datasource">java:comp/env/jdbc/Hibernate</property>

Jackrabbit — verifique el almacenamiento en PostgreSQL en repository.xml.

Abra la configuración de Jackrabbit.

cd "$PENTAHO_SERVER/pentaho-solutions/system/jackrabbit"
sudo nano -c repository.xml

Compruebe que las secciones de PostgreSQL estén activas (otras comentadas), por ejemplo:

Esquema de sistema de archivos: postgresql
Datastore databaseType="postgresql"
Esquema de PersistenceManager: postgresql
Journal de la Base de Datos: postgresql

Verifique cruzando los nombres JNDI y puertos entre Quartz, Hibernate, Jackrabbit y Tomcat context.xml para asegurar consistencia (mismo host, puerto 5432 a menos que se haya cambiado, y nombres de recursos JNDI coincidentes).

Nombres JNDI esperados:

Quartz: Quartz
Hibernate: java:comp/env/jdbc/Hibernate
Jackrabbit: como se referencia en repository.xml

Tomcat

Después de configurar el Repositorio, configure el servidor de aplicaciones web (Tomcat 10) para conectarse al Repositorio usando JDBC/JNDI.

Controladores JDBC

Para conectar a bases de datos (incluido el Repositorio), instale los controladores JDBC apropiados. Debido a restricciones de licencia, algunos controladores deben descargarse manualmente.

JDBC drivers reference | Pentahodocs.pentaho.com

https://jdbc.postgresql.org/download/postgresql-42.7.8.jarjdbc.postgresql.org

Verifique que el controlador JDBC de PostgreSQL esté presente en lib de Tomcat (requerido para el Repositorio):

ls -1 "$TOMCAT_HOME/lib" | grep -i postgresql || echo "Controlador PostgreSQL no encontrado"

Si no se encuentra, descargue el controlador JDBC de PostgreSQL (por ejemplo, postgresql-42.7.8.jar) y distribúyalo usando el script auxiliar:

sudo cp ~/Downloads/'Database Drivers'/postgresql-*.jar /opt/pentaho/server/jdbc-distribution
cd /opt/pentaho/server/jdbc-distribution
sudo ./distribute-files.sh "$TOMCAT_HOME/lib"

Copie cualquier controlador JDBC adicional a la carpeta de preparación y distribúyalos.

sudo cp ~/Downloads/'Database Drivers'/* /opt/pentaho/software/db-drivers
cd /opt/pentaho/software/db-drivers
sudo cp mysql-connector-j-9.0.0.jar /opt/pentaho/server/jdbc-distribution

Distribuya los controladores a Tomcat.

cd /opt/pentaho/server/jdbc-distribution
sudo ./distribute-files.sh "$TOMCAT_HOME/lib"

Verifique que los JARs estén presentes en lib de Tomcat.

ls -1 "$TOMCAT_HOME/lib" | grep -Ei 'mysql|postgresql' || echo "No encontrado"

Debe reiniciar el Servidor Pentaho (y las herramientas cliente, si se están ejecutando) para cargar nuevos controladores JDBC. No se requiere un reinicio completo del sistema.

context.xml

La información de conexión a la base de datos para recursos JNDI usados por Pentaho se almacena en context.xml.

Abra el archivo y revise los recursos JNDI y las credenciales.

cd "$TOMCAT_HOME/webapps/pentaho/META-INF"
sudo nano -c context.xml

En producción, verifique que el nombre de usuario, la contraseña, la clase del controlador, el host/IP y el puerto coincidan con su entorno. Asegúrese de que los nombres JNDI se alineen con las configuraciones de Quartz, Hibernate y Jackrabbit.

Iniciar Servidor Pentaho

Ejecute el servidor como el usuario pentaho para evitar problemas de permisos.

Inicie el servidor.

cd
cd "$PENTAHO_SERVER"
./start-pentaho.sh

Observe (tail) el registro de Tomcat (patrón robusto).

tail -f "$TOMCAT_HOME/logs/catalina."*.log

Los mensajes esperados incluyen:

... Starting ProtocolHandler ["http-nio-8080"]
... Server startup in [xxxxx] milliseconds

Consola de Usuario de Pentaho (PUC)

La Consola de Usuario de Pentaho (PUC) es la interfaz web para crear y ver contenido.

Credenciales por defecto (cambie inmediatamente después del primer inicio de sesión):

Nombre de usuario: admin
Contraseña: password

También tiene la opción de cambiar a la nueva pantalla de inicio de sesión.

http://localhost:8080/pentaho/content/login/web/index.htmllocalhost

Si ya ha introducido sus detalles de licencia, será redirigido a la nueva Consola de Usuario.

Validaciones rápidas

Compruebe que HTTP responde:

curl -I http://localhost:8080/pentaho/ | head -n 1

Opcional (acceso remoto): abra el firewall y pruebe desde una máquina cliente (ajuste según la política de su red):

sudo ufw allow 8080/tcp || true

Validar el Repositorio después del primer inicio (haga clic para expandir)

-- Ejemplo Quartz
\c quartz
SELECT COUNT(*) FROM qrtz_scheduler_state;

-- Ejemplo Hibernate (espere muchas tablas después del primer inicio)
\c hibuser
\dt

Systemd (opcional)

Cree un servicio systemd para gestionar Pentaho en el arranque y en caso de fallo.

Guarde el archivo de unidad como /etc/systemd/system/pentaho-server.service.

/etc/systemd/system/pentaho-server.service

[Unit]
Description=Servidor Pentaho
After=network-online.target
Wants=network-online.target

[Service]
Type=forking
User=pentaho
Group=pentaho
EnvironmentFile=-/etc/environment
# Alternativa opcional si no usa PENTAHO_JAVA_HOME en /etc/environment
# Environment="JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64"
WorkingDirectory=/opt/pentaho/server/pentaho-server
ExecStart=/opt/pentaho/server/pentaho-server/start-pentaho.sh
ExecStop=/opt/pentaho/server/pentaho-server/stop-pentaho.sh
TimeoutSec=500
Restart=on-failure
RestartSec=5
SuccessExitStatus=5 6
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target

Recargue e inicie.

sudo systemctl daemon-reload
sudo systemctl start pentaho-server
sudo systemctl enable pentaho-server

Gestione el servicio:

sudo systemctl status pentaho-server
sudo systemctl restart pentaho-server
sudo systemctl stop pentaho-server

Resolución de problemas (haga clic para expandir)

HTTP 404 en /pentaho después del inicio: confirme "$TOMCAT_HOME/webapps/pentaho" existe, revise catalina.*.log para errores de despliegue, y verifique los permisos de archivos bajo $PENTAHO_SERVER.
Puerto 8080 ya en uso: cambie el puerto de Tomcat en server.xml o detenga el servicio en conflicto.
Controlador JDBC no encontrado: verifique que los JARs del controlador (p. ej., postgresql-*.jar, mysql-*.jar) existan en "$TOMCAT_HOME/lib".
La autenticación a PostgreSQL falla: prefiera scram-sha-256; revise pg_hba.conf, reinicie PostgreSQL y pruebe psql -h 127.0.0.1 con el usuario objetivo.
Problemas de esquema de Jackrabbit: vuelva a comprobar que repository.xml las secciones están configuradas como postgresql.
Errores de activación de licencia: consulte los registros de Tomcat en tomcat/logs/ para license/elm mensajes.

Gestor de Licencias

Pentaho Pro Suite 11.x utiliza un Gestor de Licencias (en la nube o local) para gestionar derechos de PDI y BA y verificar complementos EE.

Licencia de prueba

Se incluye una licencia de prueba de 30 días si ha descargado desde: Prueba de Pentaho de 30 días

Si ha descargado los binarios GA desde: Portal de Clientes de Pentaho, entonces necesitará un ID de Activación o su URL de Licenciamiento.

Si ha instalado en un entorno desconectado (air-gapped), necesitará solicitar una licencia offline.

Abra Servidor Pentaho > Administración > Licencias para abrir el diálogo Agregar Licencia.
Haga clic en el signo +.

Ingrese el código de Activación o su URL de licenciamiento:

Licencias empresariales

Si actualiza desde 9.x o anterior, instale la nueva versión del producto antes de activar las licencias. No inicie el servidor antes de actualizar las licencias.

Establecer la variable de entorno de la ruta de licencia

Crear una PENTAHO_LICENSE_INFORMATION_PATH variable de entorno para que el Servidor Pentaho encuentre consistentemente su archivo de licencia.

Asegúrese de que el directorio destino exista y esté protegido.

sudo -u pentaho mkdir -p /home/pentaho/.pentaho
sudo chown -R pentaho:pentaho /home/pentaho/.pentaho
chmod 700 /home/pentaho/.pentaho

Edite /etc/environment y agregue la línea abajo (sin export).

sudo nano /etc/environment

Añada (o actualice) lo siguiente:

PENTAHO_LICENSE_INFORMATION_PATH=/home/pentaho/.pentaho/.elmLicInfo.plt

Cierre sesión/inicie sesión o recargue el entorno y verifique.

source /etc/environment
env | grep PENTAHO_LICENSE_INFORMATION_PATH

La PENTAHO_LICENSE_INFORMATION_PATH variable ahora está establecida.

AnteriorPreparar el entorno SiguientePlugins del servidor

Última actualización hace 1 mes

¿Te fue útil?

Buenas noches

hashtagServidor Pentaho

hashtagDirectorios del Servidor Pentaho

hashtagComponentes del Repositorio Pentaho

hashtagTomcat

hashtagControladores JDBC

hashtagcontext.xml

hashtagIniciar Servidor Pentaho

hashtagGestor de Licencias

hashtagLicencia de prueba

Servidor Pentaho

Directorios del Servidor Pentaho

Componentes del Repositorio Pentaho

Tomcat

Controladores JDBC

context.xml

Iniciar Servidor Pentaho

Gestor de Licencias

Licencia de prueba