For the complete documentation index, see llms.txt. This page is also available as Markdown.

Préparer l’environnement

Tâches de pré-installation ..

Préparer l’environnement

Préparez votre serveur Ubuntu pour une installation Archive du serveur Pentaho.

Ce processus permettra de :

  • Créez une pentaho utilisateur d'installation (avec sudo)

  • Définir les chemins Pentaho - $PENTAHO_BASE

  • Installer Java 21 (OpenJDK)

  • Définir PENTAHO_JAVA_HOME

  • Installer PostgreSQL 17 (la version 15 est prise en charge pour Pentaho 11)

  • Créer l'utilisateur de base de données du référentiel - pentaho pour la configuration

  • Installer pgAdmin 4 (version bureau)

1

Prérequis

  1. Assurez-vous que unzip est installé.

unzip --version
  1. Définissez les variables de chemin Pentaho.

Utilisez ces variables pour simplifier les commandes et éviter les erreurs de chemin. Pensez à les ajouter à votre profil de shell pour plus de commodité.

  • Modifiez le fichier /etc/environment.

cd
cd /etc/
sudo nano environment
  • Ajoutez les chemins suivants.

# Chemins Pentaho
PENTAHO_BASE=/opt/pentaho
PENTAHO_SERVER=/opt/pentaho/server/pentaho-server
TOMCAT_HOME=/opt/pentaho/server/pentaho-server/tomcat
Chemins Pentaho
2

Créer un utilisateur d'installation Pentaho

  1. Mettre à jour les paquets (à exécuter une seule fois) :

sudo apt update -y && sudo apt upgrade -y
  1. Ajoutez l'utilisateur et définissez un mot de passe :

sudo adduser pentaho
  1. Accorder les privilèges sudo :

sudo usermod -aG sudo pentaho
  1. Vérifier l'accès :

su - pentaho
groups
sudo -v
3

Installer Java 21 (OpenJDK)

Pentaho 11.x est certifié avec Java 21.

Quelle est la différence entre Oracle JDK et OpenJDK ?

Oracle JDK et OpenJDK sont tous deux des implémentations de la plateforme Java, mais ils présentent d'importantes différences :

Licence et coût :

  • OpenJDK est entièrement gratuit et open source sous licence GPL. Vous pouvez l'utiliser à n'importe quelle fin sans restrictions.

  • Oracle JDK a modifié son modèle de licence en 2019. Il est désormais gratuit pour le développement et l'usage personnel, mais nécessite un abonnement payant pour une utilisation commerciale en production (Oracle Java SE Subscription).

Source et développement :

  • OpenJDK est l'implémentation de référence de Java et sert de base à la plupart des distributions JDK. Oracle contribue d'ailleurs de manière significative au développement d'OpenJDK.

  • Oracle JDK est construit à partir du code source OpenJDK, mais inclut certains composants propriétaires et fonctionnalités commerciales supplémentaires.

Performances et fonctionnalités :

  • Dans les versions modernes (Java 11+), les différences de performances sont négligeables. Oracle a réinjecté la plupart de ses améliorations de performances dans OpenJDK.

  • Oracle JDK incluait historiquement des outils et fonctionnalités supplémentaires (comme Java Flight Recorder et Java Mission Control), mais beaucoup ont été open source et sont désormais disponibles dans OpenJDK.

Support et mises à jour :

  • OpenJDK reçoit le support de la communauté et des mises à jour pendant environ 6 mois par version (sauf pour les versions LTS maintenues par divers fournisseurs).

  • Oracle JDK offre un support à long terme (LTS) avec des abonnements commerciaux, fournissant des mises à jour et des correctifs de sécurité sur de longues périodes.

Autres distributions : De nombreux éditeurs proposent leurs propres versions d'OpenJDK avec support à long terme, notamment Amazon Corretto, Azul Zulu, Eclipse Temurin (anciennement AdoptOpenJDK) et Red Hat OpenJDK.

Pour la plupart des développeurs et des organisations, OpenJDK ou les distributions OpenJDK prises en charge par un éditeur sont le choix privilégié, sauf si vous avez spécifiquement besoin du support commercial d'Oracle.

  1. Installer Java 21 :

sudo apt install -y openjdk-21-jre-headless
  1. Vérifier Java :

java -version
which java
readlink -f $(which java)
Ubuntu apt installed OpenJDK versions list
Versions d'OpenJDK
java -version output showing Java 21
Java 21

Si plusieurs versions de Java sont installées, sélectionnez la version par défaut :

sudo update-alternatives --config java
4

Définir PENTAHO_JAVA_HOME

Définir PENTAHO_JAVA_HOME globalement afin que le serveur Pentaho utilise systématiquement Java 21.

  1. Modifiez /etc/environment:

sudo nano /etc/environment
  1. Ajoutez (ou mettez à jour) la ligne suivante :

# définir PENTAHO_JAVA_HOME
PENTAHO_JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
Définir PENTAHO_JAVA_HOME
  1. Enregistrez et rechargez l'environnement (ou déconnectez-vous/reconnectez-vous) :

source /etc/environment
  1. Vérifier :

echo $PENTAHO_JAVA_HOME

Alternative : définir pour un seul utilisateur dans ~/.bashrc.

  1. Modifier :

nano ~/.bashrc
  1. Ajoutez à la fin et appliquez :

export PENTAHO_JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
. ~/.bashrc
5

Installer PostgreSQL 17

Le dépôt par défaut d'Ubuntu 24.04 fournit PostgreSQL 16, plus récent. Pour installer la version 17, ajoutez le dépôt officiel PostgreSQL (PGDG).

Si une autre version de PostgreSQL est déjà présente, purgez-la d'abord pour éviter les conflits de port et de paquets (voir l'onglet facultatif « Nettoyer les installations précédentes »).

Prérequis Ubuntu 24.04 Privilèges root ou accès sudo utiliser sudo su pour passer en root au lieu de pentaho (utilisateur par défaut)

  1. Avant d'installer PostgreSQL, assurez-vous que votre système est à jour.

sudo apt update && sudo apt upgrade -y
  1. Installer les paquets prérequis.

sudo apt install -y wget ca-certificates
  1. Importer la clé GPG PostgreSQL.

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
  1. Ajouter le dépôt PostgreSQL

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
  1. Mettre à jour la liste des paquets.

sudo apt update
  1. Installer les paquets serveur et client PostgreSQL 17.

sudo apt update -y && sudo apt upgrade -y
sudo apt install -y postgresql-17 postgresql-contrib-17

Ce qui est installé :

  • postgresql-17: Serveur de base de données principal

  • postgresql-contrib-17: Utilitaires et extensions supplémentaires

  1. Vérifier le service et la version :

sudo systemctl status postgresql --no-pager
psql --version
PostgreSQL 17.7
  1. Nettoyage facultatif :

Vérification :

sudo systemctl is-enabled postgresql
sudo ss -ltnp | grep 5432 || true
sudo -u postgres psql -c "SELECT version();"
6

Créer l'utilisateur de base de données - pentaho

Lors de l'installation, PostgreSQL crée un superutilisateur local postgres. Définissez son mot de passe et créez éventuellement un pentaho rôle dédié.

  1. Passez à l'utilisateur système postgres.

sudo -i -u postgres
  1. Ouvrez le terminal interactif PostgreSQL.

psql
  1. Vous devriez voir l'invite PostgreSQL :

postgres=#
  1. Afficher les bases de données actuelles.

\l

Cela répertorie toutes les bases de données. Vous devriez voir trois bases de données par défaut : postgres, template0 et template1.

  1. Quitter.

q
  1. Vérifier la version de PostgreSQL depuis SQL.

SELECT version();
  1. Quitter l'invite PostgreSQL.

\q
  1. Et quitter psql.

exit

Créer l'utilisateur pentaho

  1. Définir postgres mot de passe :

sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD 'SecurePassword123';"
  1. Créez une pentaho utilisateur et accorder SUPERUSER les privilèges :

sudo -u postgres psql -c "CREATE USER pentaho WITH PASSWORD 'SecurePassword123';"
sudo -u postgres psql -c "ALTER USER pentaho WITH SUPERUSER;" # Démonstration uniquement
  • sudo -u postgres - Exécutez la commande en tant qu'utilisateur système Linux postgres (qui a un accès local à PostgreSQL sans mot de passe)

  • psql -c - Exécute une seule commande SQL et quitte

  • CREATE USER pentaho - Crée un nouveau rôle/utilisateur PostgreSQL nommé pentaho

  • WITH PASSWORD 'SecurePassword123' - Définit le mot de passe de cet utilisateur


  • ALTER USER pentaho - Modifie l'utilisateur existant pentaho utilisateur

  • WITH SUPERUSER - Accorde tous les privilèges de superutilisateur (peut tout faire : créer des bases de données, créer des utilisateurs, contourner toutes les autorisations, etc.)

  • # Démonstration uniquement - Commentaire d'avertissement indiquant que cela est dangereux pour la production

  1. Tester la connexion en tant que pentaho:

sudo -u pentaho psql -d postgres -c "\conninfo"
7

Facultatif : autoriser les connexions distantes

À titre de référence uniquement, car la connexion à PostgreSQL se fait via localhost

Par défaut, PostgreSQL n'accepte que les connexions locales. Pour des configurations en localhost, cette étape n'est pas nécessaire.

  1. Sauvegardez les configurations et modifiez postgresql.conf (PostgreSQL 17) :

sudo cp /etc/postgresql/17/main/postgresql.conf{,.bak}
sudo nano /etc/postgresql/17/main/postgresql.conf
  1. Définir : listen_addresses = '*' (une interface/IP spécifique en production)

Définir l'écouteur
  1. Enregistrer :

Ctrl + o
Entrée
Ctrl + x
8

Configurer pg_hba.conf

La pg_hba.conf Le fichier (configuration de l'authentification basée sur l'hôte de PostgreSQL) contrôle qui peut se connecter à votre base de données PostgreSQL et comment ils s'authentifient. Vous le configurez pendant l'installation pour définir les règles de sécurité d'accès à la base de données.

En production, vous modifieriez les paramètres pour n'autoriser que les utilisateurs requis à accéder aux bases de données sur les IP des serveurs.

  1. Configurer PostgreSQL pour utiliser l'authentification par mot de passe md5 pg_hba.conf .

sudo cp /etc/postgresql/17/main/pg_hba.conf{,.bak}
sudo nano /etc/postgresql/17/main/pg_hba.conf
  1. Modifier le fichier manuellement :

Ou

  1. Exécutez le script suivant.

# Utilisez le chemin exact
PG_HBA_PATH=/etc/postgresql/17/main/pg_hba.conf

# Vérifiez que le fichier existe
ls -la "$PG_HBA_PATH"

# Si cela fonctionne, exécutez ensuite :
sudo cp "$PG_HBA_PATH" "${PG_HBA_PATH}.backup"
sudo sed -i 's/^local[[:space:]]\+all[[:space:]]\+postgres[[:space:]]\+peer$/local   all             postgres                                scram-sha-256/' "$PG_HBA_PATH"
sudo sed -i 's/^local[[:space:]]\+all[[:space:]]\+all[[:space:]]\+peer$/local   all             all                                     scram-sha-256/' "$PG_HBA_PATH"
sudo sed -i '0,/^host[[:space:]]\+all[[:space:]]\+all[[:space:]]\+127\.0\.0\.1\/32[[:space:]]\+scram-sha-256$/s//host    all             all             0.0.0.0\/0               md5/' "$PG_HBA_PATH"

# Vérifier
sudo cat "$PG_HBA_PATH" | grep -E "^(local|host)[[:space:]]+(all|replication)"
SED : pg_hba.conf

Préférez scram-sha-256 plutôt que md5 dans pg_hba.conf pour un hachage de mot de passe plus fort sur les versions modernes de PostgreSQL.

Assurez-vous que votre pilote JDBC prend en charge SCRAM (par exemple, les pilotes PostgreSQL récents). Si des problèmes de compatibilité surviennent, utilisez md5 comme solution de repli.

  1. Redémarrez le service PostgreSQL.

cd
systemctl restart postgresql
# Mot de passe : password
  1. Autorisez le pare-feu (s'il est activé) et redémarrez :

sudo ufw allow 5432/tcp || true
sudo systemctl restart postgresql
sudo ss -ltnp | grep 5432
9

Installer pgAdmin 4 (version bureau)

Installez le client de bureau pgAdmin 4 à l'aide du dépôt officiel.

  1. Ajouter le dépôt et la clé :

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsS https://www.pgadmin.org/static/packages_pgadmin_org.pub | gpg --dearmor | sudo tee /etc/apt/keyrings/packages-pgadmin-org.gpg > /dev/null
source /etc/os-release
echo "deb [signed-by=/etc/apt/keyrings/packages-pgadmin-org.gpg] https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/${UBUNTU_CODENAME} pgadmin4 main" | sudo tee /etc/apt/sources.list.d/pgadmin4.list
  1. Installer pgAdmin 4 (version bureau) :

sudo apt update -y && sudo apt upgrade -y
sudo apt install -y pgadmin4-desktop
  1. Facultatif : vérifier l'entrée du dépôt

cat /etc/apt/sources.list.d/pgadmin4.list
  1. Ajouter une connexion serveur dans pgAdmin :

  • Cliquez avec le bouton droit sur Serveurs → Enregistrer → Serveur

  • Nom : Pentaho

  • Connexion : hôte, port 5432, utilisateur pentaho, mot de passe SecurePassword123 (ne pas enregistrer en production)

Create server group dialog in pgAdmin
Créer un groupe de serveurs
pgAdmin server group list
Groupe de serveurs
pgAdmin new server connection dialog
Détails de connexion
pgAdmin 4 main UI window
Interface utilisateur de pgAdmin 4
10

Valider l'environnement

  1. Vérifications rapides pour confirmer que tout est prêt pour l'étape suivante.

# Java
java -version
[ "$PENTAHO_JAVA_HOME" = "/usr/lib/jvm/java-21-openjdk-amd64" ] && echo OK || echo "Check PENTAHO_JAVA_HOME"

# PostgreSQL
sudo -u postgres psql -c "SELECT version();"
sudo systemctl status postgresql --no-pager | sed -n '1,5p'
Valider le service PostgreSQL 17 ..

Mis à jour

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