Installez le serveur Pentaho

Installation des composants du serveur Pentaho ..

Serveur Pentaho

Cette section vous guide pour installer et démarrer le serveur Pentaho sur Ubuntu.

Vous allez :

Créer des répertoires d'installation
Préparer les bases de données du dépôt Pentaho
Configurer les connexions JDBC/JNDI
Démarrer le serveur Pentaho (et éventuellement configurer systemd)
Configurer le gestionnaire de licences

Base testée : Ubuntu 24.04 LTS avec Java 21 (OpenJDK) et PostgreSQL 17.

Assurez-vous d'avoir terminé Préparer l'environnement d'abord.

Pour les détails de compatibilité, voir Référence des composants.

Prérequis

Serveur Ubuntu 24.04 LTS
Java 21 installé et PENTAHO_JAVA_HOME défini
PostgreSQL 17 installé et en cours d'exécution
Un utilisateur non root pentaho avec sudo
package unzip installé
Archives ZIP et pilotes JDBC téléchargés

Répertoires du serveur Pentaho

Le serveur Pentaho est une application web s'exécutant dans un conteneur de servlets Apache Tomcat.

Créez les répertoires de base sous /opt/pentaho.

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

/opt/pentaho
├── server      # Runtime serveur décompressé (tomcat, pentaho-solutions, scripts)
└── software    # Installateurs, ZIPs, pilotes (zone de préparation)

Créez des sous-répertoires dans /opt/pentaho/software.

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

db-drivers   - pilotes JDBC
docker       - configuration Pentaho on-prem & dockerfiles
ee-client    - plugins client Pentaho EE
ee-plugins   - plugins serveur Pentaho EE
ops-mart     - scripts Operations Mart
sdk          - kit Pentaho SDK
server       - serveur Pentaho
shims        - collections de shims Hadoop

Décompresser le package du serveur Pentaho (ZIP)

Utilisez package unzip pour extraire le ZIP du serveur dans le répertoire runtime. Cela évite d'exiger le JDK complet (le JRE n'inclut pas l'outil jar ).

pentaho-server-ee-11.0.0.0-2xx.zip - Serveur Pentaho (Archive - inclut Tomcat 10)

Assurez-vous que package unzip est disponible et copiez les ZIPs du serveur dans la zone de préparation.

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

Extraire le ZIP du serveur Pentaho dans $PENTAHO_BASE/server.

cd
cd "$PENTAHO_BASE/server"

# Remplacez <version> par le nom de fichier exact que vous avez téléchargé
sudo unzip /opt/pentaho/software/server/pentaho-server-ee-11.0.0.0-2xx.zip

Rendre tous les .sh fichiers exécutables.

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

Définir la propriété et des permissions sensées pour exécuter 'pentaho' en tant qu'utilisateur non 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 signifie que vous pouvez tout faire avec le fichier ou le répertoire, et que les autres utilisateurs peuvent le lire et l'exécuter mais pas le modifier. Convient pour les programmes et répertoires que vous voulez rendre accessibles publiquement.

644 signifie que vous pouvez lire et écrire le fichier ou le répertoire et que les autres utilisateurs peuvent seulement le lire.

Vérifiez la structure du répertoire du serveur.

/opt/pentaho/

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

Les plugins serveur sont installés dans le pentaho-solutions/system dossier.

Composants du dépôt Pentaho

Le dépôt Pentaho (sur PostgreSQL par défaut) se compose de :

Jackrabbit : dépôt de solutions, sécurité et métadonnées de contenu
Quartz : données du planificateur
Hibernate : journalisation d'audit
Pentaho Operations Mart : rapports d'utilisation et de performance

Vérifier les mots de passe par défaut dans les scripts SQL

Inspectez les scripts PostgreSQL fournis avec le serveur.

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

Vous devriez voir des fichiers similaires à :

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

Ouvrez un script pour vérifier les utilisateurs/mots de passe par défaut (modifiez pour la production).

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

Exécuter les scripts SQL pour créer les bases de données du dépôt

Confirmez que PostgreSQL est en cours d'exécution et localisez les scripts.

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

Connectez-vous en tant que pentaho superutilisateur.

Mot de passe : SecurePassword123

sudo -u pentaho psql -d postgres

Exécutez les commandes étape par étape - pas comme un seul bloc de script. Fournissez les mots de passe si demandé - voir ci‑dessous.

\i create_jcr_postgresql.sql
\i create_quartz_postgresql.sql
\q quitter après Quartz et reconnectez-vous ..
assurez‑vous d'être dans le répertoire "$PENTAHO_SERVER/data/postgresql"
sudo -u pentaho psql -d postgres
\i create_repository_postgresql.sql
\i pentaho_mart_postgresql.sql
\q quitter après hibernate et reconnectez-vous ..
assurez‑vous d'être dans le répertoire "$PENTAHO_SERVER/data/postgresql"
sudo -u pentaho psql -d postgres
\i pentaho_logging_postgresql.sql
\q

Utilisateur

Mot de passe

postgres

SecurePassword123

pentaho

SecurePassword123

jcr_user

password

pentaho_user

password

hibuser

password

Validation rapide (CLI) - lister les bases créées et se connecter - appuyez sur q pour faire défiler la liste.

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

Les tables pour Hibernate et Jackrabbit peuvent être créées plus tard par le serveur Pentaho au premier démarrage. Voir des schémas vides à ce stade peut être attendu.

Optionnel : vérifiez dans pgAdmin (GUI).

Configurer Pentaho pour utiliser PostgreSQL

PostgreSQL est le défaut. Si vous avez conservé les mots de passe et le port par défaut (5432), vérifiez seulement les paramètres ci‑dessous ; sinon, ajustez hôte/port/utilisateur/mot de passe pour correspondre à votre environnement.

Quartz - définir le délégué PostgreSQL et la source de données JNDI.

Ouvrez la configuration Quartz.

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

Vérifiez ces valeurs (les numéros de ligne peuvent différer) :

quartz.properties — entrées requises

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

Hibernate — pointer vers le fichier de configuration PostgreSQL.

Ouvrez les réglages Hibernate.

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

Confirmez la référence du fichier de config :

hibernate-settings.xml

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

Examinez éventuellement postgresql.hibernate.cfg.xml pour le nom de la source de données et le dialecte.

sudo nano -c postgresql.hibernate.cfg.xml

Assurez-vous :

postgresql.hibernate.cfg.xml — propriétés clés

<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 — vérifiez le stockage PostgreSQL dans repository.xml.

Ouvrez la configuration Jackrabbit.

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

Vérifiez que les sections PostgreSQL sont actives (les autres commentées), par exemple :

Schéma Filesystem : postgresql
Datastore databaseType="postgresql"
Schéma PersistenceManager : postgresql
Journal de base de données : postgresql

Vérifiez les noms JNDI et les ports entre Quartz, Hibernate, Jackrabbit et Tomcat context.xml pour assurer la cohérence (même hôte, port 5432 sauf modification, et noms de ressources JNDI correspondants).

Noms JNDI attendus :

Quartz : Quartz
Hibernate : java:comp/env/jdbc/Hibernate
Jackrabbit : comme référencé dans repository.xml

Tomcat

Après avoir configuré le dépôt, configurez le serveur d'applications web (Tomcat 10) pour se connecter au dépôt en utilisant JDBC/JNDI.

Pilotes JDBC

Pour se connecter aux bases de données (y compris le dépôt), installez les pilotes JDBC appropriés. En raison de restrictions de licence, certains pilotes doivent être téléchargés manuellement.

JDBC drivers reference | Pentahodocs.pentaho.com

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

Vérifiez que le pilote JDBC PostgreSQL est présent dans lib de Tomcat (requis pour le dépôt) :

ls -1 "$TOMCAT_HOME/lib" | grep -i postgresql || echo "Pilote PostgreSQL introuvable"

S'il n'est pas trouvé, téléchargez le pilote JDBC PostgreSQL (par exemple, postgresql-42.7.8.jar) et distribuez‑le à l'aide du script d'assistance :

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"

Copiez tous les pilotes JDBC supplémentaires dans le dossier de préparation et distribuez‑les.

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

Distribuez les pilotes vers Tomcat.

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

Vérifiez que les JARs sont présents dans lib de Tomcat.

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

Vous devez redémarrer le serveur Pentaho (et les outils clients, si en cours d'exécution) pour charger les nouveaux pilotes JDBC. Un redémarrage complet du système n'est pas requis.

context.xml

Les informations de connexion à la base de données pour les ressources JNDI utilisées par Pentaho sont stockées dans context.xml.

Ouvrez le fichier et vérifiez les ressources JNDI et les identifiants.

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

En production, vérifiez que le nom d'utilisateur, le mot de passe, la classe du pilote, l'hôte/IP et le port correspondent à votre environnement. Assurez‑vous que les noms JNDI correspondent aux configurations Quartz, Hibernate et Jackrabbit.

Démarrer le serveur Pentaho

Exécutez le serveur en tant qu'utilisateur pentaho pour éviter les problèmes d'autorisation.

Démarrez le serveur.

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

Surveillez le journal Tomcat (schéma robuste).

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

Les messages attendus incluent :

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

Console utilisateur Pentaho (PUC)

La Console utilisateur Pentaho (PUC) est l'interface web pour créer et consulter le contenu.

Identifiants par défaut (changez immédiatement après la première connexion) :

Nom d'utilisateur : admin
Mot de passe : password

Vous avez également la possibilité de passer au nouvel écran de connexion.

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

Si vous avez déjà saisi vos informations de licence, vous serez redirigé vers la nouvelle Console utilisateur.

Validations rapides

Vérifiez que HTTP répond :

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

Optionnel (accès distant) : ouvrez le pare-feu et testez depuis une machine cliente (ajustez selon votre politique réseau) :

sudo ufw allow 8080/tcp || true

Validez le dépôt après la première exécution (cliquez pour développer)

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

-- Exemple Hibernate (attendez de nombreuses tables après le premier démarrage)
\c hibuser
\dt

Systemd (optionnel)

Créez un service systemd pour gérer Pentaho au démarrage et en cas d'échec.

Enregistrez le fichier d'unité en tant que /etc/systemd/system/pentaho-server.service.

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

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

[Service]
Type=forking
User=pentaho
Group=pentaho
EnvironmentFile=-/etc/environment
# Repli optionnel si vous n'utilisez pas PENTAHO_JAVA_HOME dans /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

Rechargez et démarrez.

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

Gérez le service :

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

Dépannage (cliquez pour développer)

HTTP 404 sur /pentaho après le démarrage : confirmez "$TOMCAT_HOME/webapps/pentaho" existe, vérifiez catalina.*.log pour les erreurs de déploiement, et vérifiez les permissions des fichiers sous $PENTAHO_SERVER.
Le port 8080 est déjà utilisé : changez le port Tomcat dans server.xml ou arrêtez le service en conflit.
Pilote JDBC introuvable : vérifiez que les JARs du pilote (par ex., postgresql-*.jar, mysql-*.jar) existent dans "$TOMCAT_HOME/lib".
L'authentification à PostgreSQL échoue : privilégiez scram-sha-256; vérifiez pg_hba.conf, redémarrez PostgreSQL, et testez psql -h 127.0.0.1 avec l'utilisateur cible.
Problèmes de schéma Jackrabbit : revérifiez que repository.xml les sections sont réglées sur postgresql.
Erreurs d'activation de licence : vérifiez les journaux Tomcat dans tomcat/logs/ pour license/elm messages.

Gestionnaire de licences

Pentaho Pro Suite 11.x utilise un gestionnaire de licences (cloud ou local) pour gérer les droits PDI & BA et vérifier les plugins EE.

Licence d'essai

Une licence d'essai de 30 jours est incluse si vous avez téléchargé depuis : Essai Pentaho 30 jours

Si vous avez téléchargé les binaires GA depuis : Portail client Pentaho, alors vous aurez besoin d'un ID d'activation ou de votre URL de licence.

Si vous avez installé dans un environnement isolé (air‑gapped), vous devrez demander une licence hors ligne.

Lancez Server Pentaho > Administration > Licences pour ouvrir la boîte de dialogue Ajouter une licence.
Cliquez sur le signe +.

Saisissez le code d'activation ou votre URL de licence :

Licences Enterprise

Si vous mettez à niveau depuis la version 9.x ou antérieure, installez la nouvelle version du produit avant d'activer les licences. Ne démarrez pas le serveur avant d'avoir mis à jour les licences.

Définir la variable d'environnement du chemin de licence

Créez une PENTAHO_LICENSE_INFORMATION_PATH variable d'environnement afin que le serveur Pentaho trouve systématiquement votre fichier de licence.

Assurez-vous que le répertoire cible existe et est sécurisé.

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

Éditez /etc/environment et ajoutez la ligne ci‑dessous (pas de export).

sudo nano /etc/environment

Ajoutez (ou mettez à jour) ce qui suit :

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

Déconnectez-vous/reconnectez-vous ou rechargez l'environnement et vérifiez.

source /etc/environment
env | grep PENTAHO_LICENSE_INFORMATION_PATH

La PENTAHO_LICENSE_INFORMATION_PATH variable est maintenant définie.

PrécédentPréparer l'environnement SuivantPlugins serveur

Mis à jour il y a 1 mois

Ce contenu vous a-t-il été utile ?

Bon après-midi

hashtagServeur Pentaho

hashtagRépertoires du serveur Pentaho

hashtagComposants du dépôt Pentaho

hashtagTomcat

hashtagPilotes JDBC

hashtagcontext.xml

hashtagDémarrer le serveur Pentaho

hashtagGestionnaire de licences

hashtagLicence d'essai

Serveur Pentaho

Répertoires du serveur Pentaho

Composants du dépôt Pentaho

Tomcat

Pilotes JDBC

context.xml

Démarrer le serveur Pentaho

Gestionnaire de licences

Licence d'essai