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:

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, vea Referencia de Componentes.

Prerrequisitos

servidor Ubuntu 24.04 LTS
Java 21 instalado y PENTAHO_JAVA_HOME establecido
PostgreSQL instalado y en ejecución (se recomienda la 17)
Un usuario pentaho no root con sudo
paquete unzip instalado
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 servlet Apache Tomcat.

Cree 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)

Cree 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 SDK de Pentaho
server       - servidor Pentaho
shims        - colecciones de shims de Hadoop

Desempaquetar el Paquete del Servidor Pentaho (ZIP)

Use paquete unzip 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 unzip esté disponible y copie los ZIPs del servidor en la 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 exacto del archivo que descargó
sudo unzip /opt/pentaho/software/server/pentaho-server-ee-11.0.0.0-2xx.zip

Hacer que todos los .sh archivos sean 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 no 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 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

Revise las contraseñas por defecto en los 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

Guía para producción: use contraseñas únicas y fuertes, cámbielas regularmente, almacénelas en una bóveda segura y nunca guarde secretos en el control de versiones.

No mantenga las contraseñas predeterminadas del taller en producción.

Ejecute los 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

Conéctese como un pentaho superusuario.

Contraseña: SecurePassword123

sudo -u pentaho psql -d postgres

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

\i create_jcr_postgresql.sql
\i create_quartz_postgresql.sql
\q salir después de Quartz y volver 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 volver 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) - liste las bases de datos creadas y conéctese - 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 esperado.

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 configuraciones a continuación; 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 — apunte al archivo de configuración de PostgreSQL.

Abra las configuraciones 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 PersistenceManager: postgresql
Journal de Base de Datos: postgresql

Verifique cruzadamente los nombres JNDI y puertos entre Quartz, Hibernate, Jackrabbit y Tomcat context.xml para asegurar consistencia (mismo host, puerto 5432 a menos que se cambie, 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 conectarse 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 (p.ej., 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 driver, 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 pentaho usuario para evitar problemas de permisos.

Inicie el servidor.

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

Ver el registro de Tomcat en tiempo real (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 (cámbielas 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 su política de red):

sudo ufw allow 8080/tcp || true

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

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

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

Systemd (opcional)

Cree un servicio systemd para administrar Pentaho al arrancar y en caso de fallos.

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
# Opción de reserva 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

Administre el servicio:

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

Solució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 los JARs del controlador (p.ej., postgresql-*.jar, mysql-*.jar) existen 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 con el esquema de Jackrabbit: vuelva a comprobar repository.xml que las secciones estén configuradas en postgresql.
Errores de activación de licencia: consulte los registros de Tomcat en tomcat/logs/ por license/elm mensajes.

Gestor de Licencias

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

Licencia de prueba

Puede obtener una licencia de prueba de 30 días registrándose en el descarga de Pentaho. Se requiere acceso a Internet para activar y validar periódicamente la prueba.

Solicite un ID de activación de prueba en: Pentaho Enterprise o contacte Ventas.
Complete el formulario de registro de prueba; el ID de activación se enviará por correo electrónico.
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 licencia:

Licencias Enterprise

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.

Activar vía servidor de licencias en la nube

Si puede alcanzar el servidor de licencias en la nube, pegue la URL del correo de licencia en el campo License Server del diálogo Agregar Licencia y luego haga clic en OK.

Establecer variable de entorno de la ruta de licencia

Cree 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 de 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 a continuación (sin export).

sudo nano /etc/environment

Agregue al final (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 2 días

¿Te fue útil?

Buenas tardes

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