> For the complete documentation index, see [llms.txt](https://academy.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.pentaho.com/pentaho-11-installation-en/pentaho-11-installation-es/instalacion/archive-installation/install-pentaho-server.md). # Instalar Pentaho Server {% hint style="info" %} #### **Servidor Pentaho** Esta sección le guía a través de la instalación y el inicio del Servidor Pentaho en Ubuntu. Usted hará lo siguiente: * Crear directorios de instalación * Preparar las bases de datos del repositorio de Pentaho * Configurar conexiones JDBC/JNDI * Iniciar el Servidor Pentaho (y, opcionalmente, configurar systemd) * Configurar el Administrador de licencias {% endhint %} {% hint style="warning" %} Línea base probada: Ubuntu 24.04 LTS con Java 21 (OpenJDK) y PostgreSQL 17. Asegúrese de haber completado [Preparar el entorno](/pentaho-11-installation-en/pentaho-11-installation-es/instalacion/archive-installation/prepare-environment.md) primero. Para ver los detalles de compatibilidad, consulte [Referencia de componentes](https://docs.pentaho.com/install/components-reference). {% endhint %} {% hint style="info" %} **Requisitos previos** * Servidor Ubuntu 24.04 LTS * Java 21 instalado y `PENTAHO_JAVA_HOME` establecido * PostgreSQL 17 instalado y en ejecución * Un usuario no root `pentaho` con sudo * `unzip` paquete instalado * Archivos ZIP de archivo y controladores JDBC descargados {% endhint %}
Pentaho Pro Suite overview image

Suite Pentaho Pro

{% tabs %} {% tab title="1. Servidor Pentaho" %} {% hint style="info" %} #### **Directorios del Servidor Pentaho** El Servidor Pentaho es una aplicación web que se ejecuta en un contenedor de servlets Apache Tomcat. {% endhint %} 1. Cree directorios base bajo `/opt/pentaho`. ```bash cd sudo mkdir -p /opt/pentaho/{server,software} ``` ``` /opt/pentaho ├── server # Tiempo de ejecución del servidor descomprimido (tomcat, pentaho-solutions, scripts) └── software # Instaladores, ZIP, controladores (área de preparación) ``` 2. Cree subdirectorios en `/opt/pentaho/software`. ```bash 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 de cliente de Pentaho EE ee-plugins - complementos de servidor de Pentaho EE ops-mart - scripts de Operations Mart sdk - kit SDK de Pentaho server - servidor Pentaho shims - colecciones de shims de Hadoop ``` *** {% hint style="info" %} **Desempaquete el paquete del Servidor Pentaho (ZIP)** Utilice `unzip` para extraer el ZIP del servidor en el directorio de ejecución. 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 - incl. Tomcat 10) {% endhint %} 1. Asegúrese de que `unzip` esté disponible y copie los ZIP del servidor en el área de preparación. ```bash cd sudo apt update -y && sudo apt install -y unzip sudo cp ~/Downloads/'Archive Build (Suggested Installation Method)'/* /opt/pentaho/software/server ``` 2. Extraiga el ZIP del Servidor Pentaho en `$PENTAHO_BASE/server`. ```bash cd cd "$PENTAHO_BASE/server" # Reemplace con el nombre exacto del archivo que descargó sudo unzip /opt/pentaho/software/server/pentaho-server-ee-11.0.0.0-2xx.zip ```

Descomprimir el Servidor Pentaho

3. Haga todos `.sh` los archivos ejecutables. ```bash cd cd "$PENTAHO_BASE/server" sudo find . -iname "*.sh" -exec chmod +x {} \; ``` 4. Establezca la propiedad y permisos razonables para ejecutar 'pentaho' como usuario no root. ```bash 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 {} \; ``` {% hint style="info" %} 755 significa que puede hacer cualquier cosa con el archivo o directorio, y que otros usuarios pueden leerlo y ejecutarlo, pero no modificarlo. Adecuado para programas y directorios que desea poner a disposición pública. 644 significa que puede leer y escribir el archivo o directorio, y que otros usuarios solo pueden leerlo. {% endhint %} 5. Verifique la estructura del directorio del servidor. {% hint style="info" %} /opt/pentaho/ ``` server/ pentaho-server/ pentaho-solutions/ system/ ``` Los complementos del servidor se instalan en la carpeta `pentaho-solutions/system` . {% endhint %} {% endtab %} {% tab title="2. Repositorio Pentaho" %} {% hint style="info" %} #### **Componentes del Repositorio Pentaho** El Repositorio Pentaho (en PostgreSQL por defecto) consta de: * 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 {% endhint %} {% stepper %} {% step %} **Revise las contraseñas predeterminadas en los scripts SQL** 1. Inspeccione los scripts de PostgreSQL incluidos con el servidor. ```bash 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 ``` 2. Abra un script para revisar los usuarios/contraseñas predeterminados (cámbielos para producción). ```bash sed -n '1,120p' create_jcr_postgresql.sql ``` {% hint style="danger" %} Orientación para producción: use contraseñas únicas y seguras, cámbielas periódicamente, guárdelas en un almacén seguro y nunca suba secretos al control de código fuente. No conserve en producción las contraseñas predeterminadas del taller. {% endhint %} {% endstep %} {% step %} **Ejecute los scripts SQL para crear las bases de datos del Repositorio** 1. Confirme que PostgreSQL se esté ejecutando y localice los scripts. ```bash sudo systemctl status postgresql --no-pager cd cd "$PENTAHO_SERVER/data/postgresql" ls -l ``` 2. Conéctese como un `pentaho` superusuario. Contraseña: `SecurePassword123` ```bash sudo -u pentaho psql -d postgres ``` 3. Ejecute los comandos paso a paso, no como un único bloque de script. Proporcione las contraseñas si se le solicita; vea abajo. ```plsql \i create_jcr_postgresql.sql \i create_quartz_postgresql.sql \q salga 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 salga 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 | 4. Validación rápida (CLI): liste las bases de datos creadas y conéctese; pulse q para desplazarse por la lista. ```sql \l+ jackrabbit \l+ quartz \l+ hibuser \l+ opsmart \c jackrabbit \dt \c quartz \dt ``` {% hint style="warning" %} Las tablas para Hibernate y Jackrabbit pueden ser creadas más adelante por el Servidor Pentaho en el primer inicio. Ver esquemas vacíos en esta etapa puede ser normal. {% endhint %} 5. Opcional: verifique en pgAdmin (GUI).

Bases de datos de Pentaho

{% endstep %} {% step %} **Configure Pentaho para usar PostgreSQL** {% hint style="info" %} PostgreSQL es el valor predeterminado. Si mantuvo las contraseñas y el puerto predeterminados (`5432`), solo verifique la configuración siguiente; de lo contrario, ajuste host/puerto/usuario/contraseña para que coincidan con su entorno. {% endhint %} *** {% hint style="info" %} Quartz: establezca el delegado de PostgreSQL y la fuente de datos JNDI. {% endhint %} 1. Abra la configuración de Quartz. ```bash cd "$PENTAHO_SERVER/pentaho-solutions/system/scheduler-plugin/quartz" sudo nano -c quartz.properties ``` 2. Revise estos valores (los números de línea pueden variar): {% code title="quartz.properties — entradas requeridas" %} ``` org.quartz.jobStore.driverDelegateClass=org.quartz.impl.jdbcjobstore.PostgreSQLDelegate org.quartz.dataSource.myDS.jndiURL=Quartz ``` {% endcode %} *** {% hint style="info" %} Hibernate: apunte al archivo de configuración de PostgreSQL. {% endhint %} 1. Abra la configuración de Hibernate. ```bash cd "$PENTAHO_SERVER/pentaho-solutions/system/hibernate" sudo nano -c hibernate-settings.xml ``` 2. Confirme la referencia al archivo de configuración: {% code title="hibernate-settings.xml" %} ``` system/hibernate/postgresql.hibernate.cfg.xml ``` {% endcode %} 3. Revise opcionalmente `postgresql.hibernate.cfg.xml` para el nombre de la fuente de datos y el dialecto. ```bash sudo nano -c postgresql.hibernate.cfg.xml ``` Asegúrese de lo siguiente: {% code title="postgresql.hibernate.cfg.xml — propiedades clave" %} ``` org.postgresql.Driver org.hibernate.dialect.PostgreSQLDialect java:comp/env/jdbc/Hibernate ``` {% endcode %} *** {% hint style="info" %} Jackrabbit: verifique el almacenamiento de PostgreSQL en `repository.xml`. {% endhint %} 1. Abra la configuración de Jackrabbit. ```bash cd "$PENTAHO_SERVER/pentaho-solutions/system/jackrabbit" sudo nano -c repository.xml ``` 2. Verifique que las secciones de PostgreSQL estén activas (las demás comentadas), por ejemplo: {% hint style="info" %} * Esquema del sistema de archivos: `postgresql` * Almacén de datos `databaseType="postgresql"` * Esquema de PersistenceManager: `postgresql` * Registro de base de datos: `postgresql` {% endhint %} {% hint style="warning" %} Compruebe cruzadamente los nombres JNDI y los puertos entre Quartz, Hibernate, Jackrabbit y Tomcat `context.xml` para asegurar la coherencia (mismo host, puerto 5432 salvo 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` {% endhint %} {% endstep %} {% endstepper %} {% endtab %} {% tab title="3. Tomcat" %} {% hint style="info" %} #### **Tomcat** Después de configurar el Repositorio, configure el servidor de aplicaciones web (Tomcat 10) para conectarse al Repositorio mediante JDBC/JNDI. {% endhint %} {% tabs %} {% tab title="1. Controladores de base de datos" %} {% hint style="warning" %} #### **Controladores JDBC** Para conectarse a las bases de datos (incluido el Repositorio), instale los controladores JDBC apropiados. Debido a restricciones de licencia, algunos controladores deben descargarse manualmente. {% endhint %} {% embed url="" %} {% embed url="" %} 1. Verifique que el controlador JDBC de PostgreSQL esté presente en la biblioteca de Tomcat (necesario para el Repositorio): ```bash ls -1 "$TOMCAT_HOME/lib" | grep -i postgresql || echo "Controlador de PostgreSQL no encontrado" ``` {% hint style="info" %} Si no se encuentra, descargue el controlador JDBC de PostgreSQL (por ejemplo, `postgresql-42.7.8.jar`) y distribúyalo usando el script auxiliar: {% endhint %} ```bash 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" ``` 2. Copie cualquier controlador JDBC adicional a la carpeta de preparación y distribúyalo. ```bash 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 ``` 3. Distribuya los controladores a Tomcat. ```bash cd /opt/pentaho/server/jdbc-distribution sudo ./distribute-files.sh "$TOMCAT_HOME/lib" ``` 4. Verifique que los JAR estén presentes en la biblioteca de Tomcat. ```bash ls -1 "$TOMCAT_HOME/lib" | grep -Ei 'mysql|postgresql' || echo "No encontrado" ``` {% hint style="danger" %} Debe reiniciar el Servidor Pentaho (y las herramientas cliente, si están en ejecución) para cargar los nuevos controladores JDBC. No se requiere un reinicio completo del sistema. {% endhint %} {% endtab %} {% tab title="2. context.xml" %} {% hint style="info" %} #### **context.xml** La información de conexión a bases de datos para los recursos JNDI usados por Pentaho se almacena en `context.xml`. {% endhint %} 1. Abra el archivo y revise los recursos JNDI y las credenciales. ```bash cd "$TOMCAT_HOME/webapps/pentaho/META-INF" sudo nano -c context.xml ``` {% hint style="warning" %} 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 coincidan con las configuraciones de Quartz, Hibernate y Jackrabbit. {% endhint %} {% endtab %} {% endtabs %} {% endtab %} {% tab title="4. Iniciar el servidor" %} {% hint style="info" %} #### **Iniciar el Servidor Pentaho** Ejecute el servidor como el `pentaho` usuario para evitar problemas de permisos. {% endhint %} 1. Inicie el servidor. ```bash cd cd "$PENTAHO_SERVER" ./start-pentaho.sh ``` 2. Siga el registro de Tomcat (patrón robusto). ```bash tail -f "$TOMCAT_HOME/logs/catalina."*.log ``` Los mensajes esperados incluyen: ``` ... Iniciando ProtocolHandler ["http-nio-8080"] ... Inicio del servidor en [xxxxx] milisegundos ``` *** {% hint style="info" %} **Consola de usuario de Pentaho (PUC)** La Consola de usuario de Pentaho (PUC) es la interfaz web para crear y ver contenido. {% endhint %} {% embed url="" %} Enlace al Servidor Pentaho {% endembed %} Credenciales predeterminadas (cámbielas inmediatamente después del primer inicio de sesión): ``` Usuario: admin Contraseña: password ```

Consola de usuario de Pentaho

3. También tiene la opción de cambiar a la nueva pantalla de inicio de sesión. {% embed url="" %}

NUEVO - Consola de usuario de Pentaho

{% hint style="info" %} Si ya ha introducido sus datos de licencia, se le redirigirá a la nueva Consola de usuario. {% endhint %} *** {% hint style="success" %} **Validaciones rápidas** {% endhint %} * Compruebe que HTTP responde: ```bash curl -I http://localhost:8080/pentaho/ | head -n 1 ``` * Opcional (acceso remoto): abra el firewall y pruebe desde una máquina cliente (ajústelo a su política de red): ```bash sudo ufw allow 8080/tcp || true ``` ***
Validar el Repositorio después de la primera ejecución (haga clic para expandir) ```sql -- Ejemplo de Quartz \c quartz SELECT COUNT(*) FROM qrtz_scheduler_state; -- Ejemplo de Hibernate (se esperan muchas tablas después del primer inicio) \c hibuser \dt ```
*** {% hint style="info" %} **systemd (opcional)** Cree un servicio systemd para gestionar Pentaho al arrancar y ante fallos. {% endhint %} 1. Guarde el archivo de unidad como `/etc/systemd/system/pentaho-server.service`. {% code title="/etc/systemd/system/pentaho-server.service" %} ```ini [Unit] Description=Pentaho Server After=network-online.target Wants=network-online.target [Service] Type=forking User=pentaho Group=pentaho EnvironmentFile=-/etc/environment # Fallback 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 ``` {% endcode %} 2. Recargue e inicie. ```bash sudo systemctl daemon-reload sudo systemctl start pentaho-server sudo systemctl enable pentaho-server ``` Gestione el servicio: ```bash 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, compruebe `catalina.*.log` si hay errores de despliegue, y verifique los permisos de archivo bajo `$PENTAHO_SERVER`. * El puerto 8080 ya está en uso: cambie el puerto de Tomcat en `server.xml` o detenga el servicio en conflicto. * No se encontró el controlador JDBC: verifique los JAR de los controladores (por ejemplo, `postgresql-*.jar`, `mysql-*.jar`) existen en `"$TOMCAT_HOME/lib"`. * La autenticación en PostgreSQL falla: prefiera `scram-sha-256`; revise `pg_hba.conf`, reinicie PostgreSQL y pruebe `psql -h 127.0.0.1` con el usuario de destino. * Problemas de esquema de Jackrabbit: vuelva a comprobar `repository.xml` las secciones están configuradas en `postgresql`. * Errores de activación de licencia: compruebe los registros de Tomcat en `tomcat/logs/` para `licencia`/`elm` mensajes.
*** {% endtab %} {% tab title="5. Gestor de licencias" %} {% hint style="info" %} #### **Gestor de licencias** Pentaho Pro Suite 11.x utiliza un Gestor de licencias (en la nube o local) para administrar los derechos de PDI y BA y verificar los complementos EE. {% endhint %}

Licencias

{% tabs %} {% tab title="Gestor de licencias" %} {% hint style="info" %} #### **Licencia de prueba** Se incluye una licencia de prueba de 30 días si lo ha descargado desde: [Prueba de Pentaho de 30 días](https://pentaho.com/download/) Si ha descargado los binarios GA desde: [Portal del cliente de Pentaho](https://support.pentaho.com/hc/en-us), entonces necesitará un ID de activación o su URL de licencia. Si lo ha instalado en un entorno aislado, deberá solicitar una licencia sin conexión. {% endhint %} 1. Inicie Pentaho Server > Administración > Licencias para abrir el cuadro de diálogo Agregar licencia. 2. Haga clic en el signo +.

Agregar licencia

5. Introduzca el código de activación o su URL de licencia:
Add License dialog

Gestor de licencias

{% hint style="warning" %} **Licencias empresariales** Si actualiza desde la versión 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. {% endhint %} {% endtab %} {% tab title="Establecer la ruta de licencia de ENV" %} {% hint style="info" %} **Establecer la variable de entorno de la ruta de la licencia** Cree una `PENTAHO_LICENSE_INFORMATION_PATH` variable de entorno para que Pentaho Server encuentre siempre su archivo de licencia. {% endhint %} 1. Asegúrese de que el directorio de destino exista y esté protegido. ```bash sudo -u pentaho mkdir -p /home/pentaho/.pentaho sudo chown -R pentaho:pentaho /home/pentaho/.pentaho chmod 700 /home/pentaho/.pentaho ``` 2. Edite `/etc/environment` y añada la línea siguiente (sin `export`). ```bash sudo nano /etc/environment ``` Añada al final (o actualice) lo siguiente: ``` PENTAHO_LICENSE_INFORMATION_PATH=/home/pentaho/.pentaho/.elmLicInfo.plt ``` 3. Cierre sesión/inicie sesión o recargue el entorno y verifique. ```bash source /etc/environment env | grep PENTAHO_LICENSE_INFORMATION_PATH ``` La `PENTAHO_LICENSE_INFORMATION_PATH` variable ya está configurada. {% endtab %} {% endtabs %} {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://academy.pentaho.com/pentaho-11-installation-en/pentaho-11-installation-es/instalacion/archive-installation/install-pentaho-server.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.