# Installer les outils clients

{% hint style="info" %}

#### **Outils client Pentaho**

Il existe deux méthodes pour installer les outils de conception Business Analytics (BA). Vous pouvez utiliser l'une ou l'autre de ces méthodes :

* Assistant d'évaluation Pentaho Business Analytics — Bureau Windows
* Installer chaque outil manuellement — Linux / Bureau Windows

L'Assistant d'évaluation est le moyen le plus simple d'installer des outils de conception, des utilitaires ou des plugins sur des postes clients. L'installation manuelle vous permet de placer les fichiers des outils de conception où vous le souhaitez. Choisissez un déploiement qui correspond à vos contraintes DevOps et de poste de travail.
{% endhint %}

{% hint style="warning" %}
Base : Ubuntu 24.04 LTS avec Java 21 (OpenJDK). Pour Windows, voir : [Installation Windows](https://academy.pentaho.com/pentaho-11-installation-en/pentaho-11-installation-fr/installation/evaluation-installation).
{% endhint %}

<figure><img src="https://3016379417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5WjeDOi3MsT9tY3oU6mQ%2Fuploads%2Fgit-blob-c33563818f443f384cea01b2f09645deaeefec67%2Fimage%20(24).png?alt=media" alt="Pentaho Pro Suite - client tools overview"><figcaption><p>Pentaho Pro Suite</p></figcaption></figure>

Les étapes suivantes installent les outils clients sur un bureau Linux. Les noms de fichiers ZIP indiqués sont des exemples ; utilisez vos versions réelles.

{% hint style="info" %}
**Décompressez le package client 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` ).

* `pdi-ee-11.0.0.0-237.zip` - Pentaho Data Integration

* `pad-ee-11.0.0.0-237.zip`   - Pentaho Aggregation Designer

* `psw-ee-11.0.0.0-237.zip`   - Pentaho Schema Workbench

* `pme-ee-11.0.0.0-237.zip`   - Pentaho Metadata Editor

* `prd-ee-11.0.0.0-237.zip`   - Pentaho Report Designer
  {% endhint %}

* Assurez-vous que `package unzip` est installé :

```bash
sudo apt update -y && sudo apt install -y unzip
```

1. Créez le répertoire Pentaho de base : \~`/Pentaho/design-tools`.

```bash
cd
mkdir -p ~/Pentaho/design-tools
```

<pre><code>~/Pentaho/design-tools
├── design-tools             
    └── data-integration  
    └── metadata-editor   
<strong>    └── schema-workbench      
</strong></code></pre>

{% tabs %}
{% tab title="1. Data Integration" %}
{% hint style="info" %}

#### **Pentaho Data Integration (PDI)**

Pentaho Data Integration (PDI) fournit des capacités ETL pour capturer, nettoyer et transformer les données.
{% endhint %}

1. Localiser `pdi-ee-11.0.0.0-237.zip`.

```bash
ls -1 ~/Downloads/'Client Tools'/'PDI (Spoon)'
```

3. Extraire `pdi-ee-11.0.0.0-237.zip`

```bash
cd
cd ~/Pentaho/design-tools

# Remplacez <version> par le nom exact du fichier que vous avez téléchargé.
unzip ~/Downloads/'Client Tools'/'PDI (Spoon)'/pdi-ee-11.0.0.0-2xx.zip
# Vous devrez peut-être ajuster le chemin.
```

4. Rendre `.sh` fichiers exécutables.

```bash
cd
cd ~/Pentaho/design-tools
find . -iname "*.sh" -exec chmod +x {} \;
```

5. Vérifier la structure :

{% hint style="info" %}
\~/Pentaho/design-tools/

* data-integration
* jdbc-distribution
* license-installer
  {% endhint %}

***

{% hint style="warning" %}
**Remarques sur l'interface de bureau Ubuntu 24.04**

Certains composants d'interface hérités dans Spoon peuvent nécessiter des bibliothèques GTK/WebKit qui varient selon l'environnement de bureau. Sur Ubuntu 24.04, si Spoon signale des modules GTK/WebKit manquants, suivez les instructions : [Modules GTK/WebKit manquants](#missing-gtk-webkit-modules)
{% endhint %}

6. Démarrer PDI (Spoon) :

```bash
cd
cd ~/Pentaho/design-tools/data-integration
./spoon.sh
```

<figure><img src="https://3016379417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5WjeDOi3MsT9tY3oU6mQ%2Fuploads%2FnfOMKjuE3wMZxCfiH6FC%2Fimage.png?alt=media&#x26;token=7155cdfb-f986-4716-ba75-e08fde35d2ff" alt=""><figcaption><p>Interface Spoon</p></figcaption></figure>
{% endtab %}

{% tab title="2. Metadata Editor" %}
{% hint style="info" %}

#### **Pentaho Metadata Editor (PME)**

Pentaho Metadata Editor crée et gère des modèles sémantiques adaptés aux utilisateurs métiers.
{% endhint %}

1. Localiser `pme-ee-11.0.0.0-237.zip`.

```bash
ls -1 ~/Downloads/'Client Tools'/'Metadata Editor'
```

2. Extraire `pme-ee-11.0.0.0-237.zip`.

```bash
cd
cd ~/Pentaho/design-tools

# Remplacez <version> par le nom exact du fichier que vous avez téléchargé.
unzip ~/Downloads/'Client Tools'/'Metadata Editor'/pme-ee-11.0.0.0-2xx.zip
# Vous devrez peut-être ajuster le chemin.
```

3. Rendre `.sh` fichiers exécutables.

```bash
cd
cd ~/Pentaho/design-tools
find . -iname "*.sh" -exec chmod +x {} \;
```

4. Vérifier la structure :

{% hint style="info" %}
\~/Pentaho/design-tools/

* data-integration
* jdbc-distribution
* license-installer
* metadata-editor
  {% endhint %}

5. Démarrer PME :

```bash
cd
cd ~/Pentaho/design-tools/metadata-editor
./metadata-editor.sh
```

<figure><img src="https://3016379417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5WjeDOi3MsT9tY3oU6mQ%2Fuploads%2Fgit-blob-77da68f8ddf54c7e27497a575308abd58d4dc116%2FPME.png?alt=media" alt="Pentaho Metadata Editor UI"><figcaption><p>Pentaho Metadata Editor</p></figcaption></figure>
{% endtab %}

{% tab title="3. Schema Workbench" %}
{% hint style="info" %}

#### **Schema Workbench (PSW)**

Schema Workbench est utilisé pour créer et tester des schémas de cubes OLAP Mondrian.
{% endhint %}

1. Localiser `psw-ee-11.0.0.0-237.zip`.

```bash
ls -1 ~/Downloads/'Client Tools'/'Schema Workbench'
```

2. Extraire `psw-ee-11.0.0.0-237.zip`.

```bash
cd
cd ~/Pentaho/design-tools

# Remplacez <version> par le nom exact du fichier que vous avez téléchargé.
unzip ~/Downloads/'Client Tools'/'Schema Workbench'/psw-ee-10.2.0.0-2xx.zip
# Vous devrez peut-être ajuster le chemin.
```

2. Rendre `.sh` fichiers exécutables.

```bash
cd
cd ~/Pentaho/design-tools
find . -iname "*.sh" -exec chmod +x {} \;
```

3. Vérifier la structure :

{% hint style="info" %}
\~/Pentaho/design-tools/

* data-integration
* jdbc-distribution
* license-installer
* metadata-editor
* schema-workbench
  {% endhint %}

4. Démarrer PSW :

```bash
cd
cd ~/Pentaho/design-tools/schema-workbench
./workbench.sh
```

<figure><img src="https://3016379417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5WjeDOi3MsT9tY3oU6mQ%2Fuploads%2Fgit-blob-c72ef9833bc3d1cd5ddab58a6572c78fc89a5ca9%2FSW.png?alt=media" alt="Pentaho Schema Workbench UI"><figcaption><p>Schema Workbench</p></figcaption></figure>
{% endtab %}

{% tab title="4. Aggregation Designer" %}
{% hint style="info" %}

#### **Aggregation Designer (PAD)**

Aggregation Designer recommande et construit des tables d'agrégats pour optimiser les requêtes Analyzer.
{% endhint %}

1. Extraire `pad-ee-*.zip`.

```bash
cd ~/Pentaho/design-tools
unzip ~/Downloads/'Client Tools'/'Aggregation Designer'/pad-ee-10.2.0.0-222.zip
```

2. Rendre `.sh` fichiers exécutables.

```bash
cd ~/Pentaho/design-tools
find . -iname "*.sh" -exec chmod +x {} \;
```

3. Vérifier la structure :

{% hint style="info" %}
\~/Pentaho/design-tools/

* data-integration
* jdbc-distribution
* license-installer
* metadata-editor
* schema-workbench
* aggregation-designer
  {% endhint %}

4. Démarrer PAD :

```bash
cd ~/Pentaho/design-tools/aggregation-designer
./startaggregationdesigner.sh
```

<figure><img src="https://3016379417-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5WjeDOi3MsT9tY3oU6mQ%2Fuploads%2Fgit-blob-989bfddf43ac7ee02bc2d9c9721c37fdc7fb1924%2FAD.png?alt=media" alt="Pentaho Aggregation Designer UI"><figcaption><p>Aggregation Designer</p></figcaption></figure>
{% endtab %}
{% endtabs %}

<details>

<summary>Dépannage général (cliquer pour développer)</summary>

* Spoon ne démarre pas ou affiche des erreurs GTK/WebKit :
  * Installez les bibliothèques GTK/WebKit (voir la note ci‑dessous) et réessayez.
  * Lancez avec des options SWT/GTK supplémentaires si nécessaire, ou testez sur un autre environnement de bureau.
* Problèmes de polices/rendu de l'interface sur des écrans HiDPI :
  * Essayez `GDK_SCALE=2 ./spoon.sh` ou ajustez la mise à l'échelle de votre bureau.
* Pilotes JDBC manquants dans les clients :
  * Copiez les JAR de pilote requis dans les dossiers spécifiques à chaque outil (voir les emplacements des pilotes dans la page Serveur) et redémarrez l'outil.
* Invites de licence ou fonctionnalité désactivée :
  * Assurez-vous que le gestionnaire de licences a activé les droits clients ; vérifiez `PENTAHO_LICENSE_INFORMATION_PATH` si nécessaire.
* Démarrage lent ou erreurs de mémoire insuffisante :
  * Augmentez `-Xms`/`-Xmx` dans le `*.ini` ou le script de démarrage.

</details>

<details>

<summary>Modules GTK/WebKit manquants</summary>

Vous devrez ajouter une version de la précédente publication Jammy :

1. Ajouter le dépôt de paquets.

```bash
sudo apt-get install -qq software-properties-common
```

2. Ajouter l'entrée du dépôt.

```bash
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B4FE6ACC0B21F32
sudo add-apt-repository 'deb [trusted=yes] http://cz.archive.ubuntu.com/ubuntu bionic main universe'
```

3. Mettre à jour les dépôts.

```bash
sudo apt-get update
```

5. Installer le paquet.

```bash
sudo apt-get install -qq libwebkitgtk-1.0-0
```

```bash
sudo apt-get install libcanberra-gtk-module
```

6. Démarrez PDI.

```bash
cd
cd ~/Pentaho/design-tools/data-integration
./spoon.sh
```

</details>

***