ETLツール Pentahoのトライアル版をインストールしてみよう！【Pentaho ファーストステップガイド インストール編】

# Pentaho ファーストステップガイド インストール編
## はじめに

本記事では、Pentahoソフトウェア Ver10.2のトライアル版（評価版）のサーバ・ワークステーション機能をMicrosoft Windowsにインストールする手順/設定手順について示します。

Pentaho（ペンタホ）とは、データ収集・抽出・加工・出力を実行する「データ統合基盤（ETL）」と、 データ可視化・データ分析を実行する「データ分析基盤（BI）」をオールインワンで提供し、アジャイルでのデータ利活用を可能にするプラットフォームです。[^1]

## 注意事項
- インストール手順は、あくまでも動作させるための最低限の手順であり、これらの手順によって、Pentahoソフトウェアの動作を保証するものではありません。機能の必要性に応じて、設定や構成を変更する必要があります。

## Pentaho評価版インストール手順

### 1. Pentaho評価版インストーラーの取得
以下のサイトの手順を参考にインストーラーを取得します。
https://www.hitachi.co.jp/products/it/bigdata/platform/pentaho/trial/index.html

### 2. pentahoユーザの登録
Pentahoソフトウェアのインストールの実行ユーザ（ユーザ名例：pentaho）を登録します。
ユーザの追加は、スタートメニューの「すべて」－「Windows ツール」－「コンピューターの管理」で表示される「コンピューターの管理」画面の「ローカルユーザーとグループ」から実施できます。また、同ユーザに管理者権限を付与してください。
ユーザ名「pentaho」が追加された状態のプロパティ画面は次のようになります。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/381b3527-22c6-461a-8d6c-b5378171e00c.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/23349e2f-d79a-4aeb-be0f-2b14184e3f7b.png)


### 3. インストーラの配備
Pentahoソフトウェアのインストーラをダウンロードし、Pentahoソフトウェアを実行する環境に保存します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/d08a53c0-fce6-41e4-b95d-c04df93177af.png)

### 4. インストーラの起動
Pentahoソフトウェアのインストーラをダブルクリックすると、Pentaho Business Analytics Installerが起動します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/01058d78-c60a-425b-942b-21e1c932ea93.png)

<strong>［Next >］</strong>をクリックしてインストールを続行します。

:::note warn
次のようなユーザーアカウント制御のダイアログが表示されることがあります。<strong>［はい］</strong>をクリックしてインストールを続行してください。
:::
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/f0e73cf8-a5c9-4488-bd00-c3fb46704eda.png)

:::note warn
次のようなAntivirusを無効化するダイアログが表示されることがあります。Antivirusを無効化してからインストールを続行してください。
:::
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/28778a8d-24b1-425e-a04b-b33784e047a2.png)

### 5. 使用許諾の確認
使用許諾を確認してください。使用許諾に合意する場合は<strong>［Accept］</strong>を選択し、<strong>［Next >］</strong>をクリックしてインストールを続行してください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/987143ea-cc25-40de-87aa-d0a446940c64.png)

### 6. インストールディレクトリの入力
インストールディレクトリを入力します。
次の例では<strong>「C:\pent\p102」</strong>と入力しています。パス長はこれより長くならないよう指定してください。入力後、<strong>［Next >］</strong>をクリックしインストールを続行します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/7557506e-a1c2-48ba-b6ca-a7ee6798cfdf.png)


### 7. Repository用PostgreSQLの管理者パスワードの入力（サーバ用コンポーネントをインストールする場合のみ）
<strong>［Password:］</strong>と<strong>［Confirm Password:］</strong>にパスワードを入力し、<strong>［Next >］</strong>をクリックしインストールを続行します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/406d2965-0773-4304-b4dd-70cfff525595.png)


### 8. インストールオプションの選択
開発用コンポーネントとサーバ用コンポーネントとを同じ環境にインストールするか、別の環境にインストールするかを選択します。

:::note warn
商用版では開発用コンポーネントとサーバ用コンポーネントとでサポートするOSが異なります。したがって、開発用コンポーネントとサーバ用コンポーネントを同一マシンにインストールできません。Pentahoソフトウェアを評価する目的でのみインストールしてください。
:::

画面ではインストールオプションとして次のどちらかを選択してください。
- **開発用とサーバ用の両方を一つの環境にインストールしたい場合**
「Keep it simple, Give me everything.」を選択してください。
- **開発用とサーバ用をそれぞれ別の環境にインストールしたい場合**
「Let me decide for myself.」を選択してください。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/dc0d63c5-db33-4b9d-8a92-e8af4ceffccc.png)

### 9. インストールするコンポーネントの選択（「8. インストールオプションの選択」で「Let me decide for myself.」を選択した場合）
開発用コンポーネントとサーバ用コンポーネントを別の環境にインストールする場合に、環境に応じて次のように選択してください。
- **開発用コンポーネントのみインストールする場合**
次に示す画面のとおりに設定してください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/b0bdfda6-c617-47f7-8905-6626f9fa3056.png)

- **サーバ用コンポーネントのみインストールする場合**
次に示す画面のとおりに設定してください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/7c3328bd-b867-4112-8d75-ef3b9638b82d.png)

### 10. サンプルコンテンツのインストール（「8. インストールオプションの選択」で「Let me decide for myself.」を選択しサーバ用コンポーネントをインストールする場合のみ）
サンプルコンテンツをインストールするかどうかを指定します。
このドキュメントではサンプルコンテンツを使用するため、サンプルコンテンツをインストールすることを示す<strong>［Sure, give me my sample content.］</strong>を選択し、<strong>［Next >］</strong>をクリックしてインストールを続行します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/525d67d0-f365-42a6-87d7-86ce460702b5.png)

### 11. 評価用ライセンスの有効化
評価用ライセンスの有効化の設定を行います。
Webアクセスにプロキシが必要な環境かどうかに応じて以下のようにします。
- **Webアクセスにプロキシを必要としない環境の場合**
開発元から提供されたアクティベーションＩＤを入力し、<strong> [Next >]</strong>をクリックしてインストールを続行します。（この場合、ライセンスはインストール処理中に自動で有効化されます）
- **Webアクセスにプロキシを必要とする環境の場合**
ここでは何も入力せずに<strong> [Next >]</strong>をクリックしてインストールを続行します。（この場合、ライセンスは「14. 評価用ライセンスの手動有効化（「11. 評価用ライセンスの有効化」で「Webアクセスにプロキシを必要とする環境の場合」を選択しプロキシ設定をする場合のみ）」にて手動で有効化します）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/c464b7f2-3e1d-4b95-9ddd-6d8236943262.png)

### 12. インストール実行
インストールの実行準備ができましたので、<strong>［Next >］</strong>をクリックして、インストールを実行します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/4ff3de0e-7b61-4eac-998f-66597d0365d5.png)

インストールの実行中は次に示す画面が表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/0656ccde-faf5-4b4d-b02d-df5490a5377e.png)


### 13. インストール完了
ここではインストール後に起動したいプログラムを選択しますが、インストール後にも日本語環境向けの設定が必要ですので、それぞれのチェックボックスをオフにします。
- ［Pentaho User Console］     ：オフ（サーバ用コンポーネントをインストールした場合）
- ［Pentaho Data Integration］   ：オフ（開発用コンポーネントをインストールした場合）
<strong>［Finish］</strong>をクリックし、インストールを完了します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/dc3ac86e-d3a0-40bc-91cc-818b6c968d63.png)


### 14. 評価用ライセンスの手動有効化（「11. 評価用ライセンスの有効化」で「Webアクセスにプロキシを必要とする環境の場合」を選択しプロキシ設定をする場合のみ）
評価用ライセンスを手動で有効化します。
開発用コンポーネントとサーバ用コンポーネントのそれぞれの設定手順がありますので、両方実施してください。

**Step1: 開発用コンポーネントの評価用ライセンスの有効化**
1. 以下のバッチファイルに対して、赤字で示した設定を追記します。
ファイル：C:¥pent¥p102¥license-installer¥install-license.bat
箇所：69行目付近
    
    <strong>【認証なしプロキシの場合】</strong>
    call "%_PENTAHO_JAVA%" %LICENSE_PARAMETER% -DCONSOLE_HOME=. -Dlog4j.configurationFil e=log4j2.xml <font color='red'>-Dhttps.proxyHost=ホスト名/IPアドレス -Dhttps.proxyPort=ポート番号</font> -cp %CLASSP ATH% com.pentaho.dsc.elm.ELMUserInstaller %CMD_LINE_ARGS%
    
    <strong>【認証ありプロキシの場合】</strong>
    call "%_PENTAHO_JAVA%" %LICENSE_PARAMETER% -DCONSOLE_HOME=. -Dlog4j.configurationFile=log4j2.xml <font color='red'>-Dhttps.proxyHost=ホスト名/IPアドレス -Dhttps.proxyPort=ポート番号 -Dhttps.proxyUser=ユーザ名 -Dhttps.proxyPassword=パスワード</font> -cp %CLASSPATH% com.pentaho.dsc.elm.ELMUserInstaller %CMD_LINE_ARGS%

   ※上記のホスト名/IPアドレス、ポート番号、ユーザ名、パスワードは以下に置き換えます。
   |項目名|設定値|
   |:--|:--|
   |ホスト名/IPアドレス|プロキシサーバのホスト名またはIPアドレス|
   |ポート番号|プロキシサーバのポート番号|
   |ユーザ名|プロキシサーバの認証ユーザ名|
   |パスワード|プロキシサーバの認証パスワード|

2. ユーザー権限でコマンドプロンプトを起動します。
3. カレントディレクトリを変更してライセンスインストーラを実行します。 ※xxxxxxxxの部分は開発元から提供されたアクティベーションIDに置き換えます。
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/2be3d062-9e09-4bb2-9003-f876889e0104.png)
4. 登録されたライセンス情報が表示されることを確認します。
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/789daf43-f8d2-4169-aa63-c324f28881d2.png)

**Step2: サーバ用コンポーネントの評価用ライセンスの有効化**
1. Windowsのスタートメニューの「すべて」－「Windowsツール」－「サービス」を選択し、「サービス」を開きます。
2. 次の順でサービスを停止します。
    1. Apache Tomcat 9.0 pentahoserver
    2. Pentaho Solution Repository
    <br>
3. 以下のファイルを開きます。
    *C:\pent\p102\server\pentaho-server\tomcat\bin\pentahoserverw.exe*
    ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/a175cc2c-5e29-4837-932d-ddd9ced835ce.png)

   :::note warn
   次のようなユーザーアカウント制御のダイアログが表示されることがあります。［はい］をクリックしてインストールを続行してください。
   :::
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/f53f2187-827d-4237-a87e-5f9c3713ce66.png)

4. 出現したダイアログの<strong>「Java」</strong>タブを開き、<strong>「Java Options:」</strong>欄に以下の設定を追加して、<strong>［OK］</strong>をクリックします
   ```
   -Dhttps.proxyHost=ホスト名/IPアドレス
   -Dhttps.proxyPort=ポート番号
   -Dhttps.proxyUser=ユーザ名
   -Dhttps.proxyPassword=パスワード
   ```
   ※上記のホスト名/IPアドレス、ポート番号、ユーザ名、パスワードは以下に置き換えます。
   |項目名|設定値|
   |:--|:--|
   |ホスト名/IPアドレス|プロキシサーバのホスト名またはIPアドレス|
   |ポート番号|プロキシサーバのポート番号|
   |ユーザ名|プロキシサーバの認証ユーザ名|
   |パスワード|プロキシサーバの認証パスワード|
   
   ![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/f2931f30-de40-4c80-b930-790ae74c1b76.png)

5. Windowsのスタートメニューの「すべて」－「Windowsツール」－「サービス」を選択し、「サービス」を開きます。
6. 次の順でサービスを停止します。
    1. Pentaho Solution Repository
    2. Apache Tomcat 9.0 pentahoserver
    <br>
7. Pentaho User Consoleにadminユーザでログインします。
   - Pentaho User ConsoleのURL
   http://localhost:8080/pentaho
   - adminユーザのユーザ名
   admin
   - adminユーザのパスワード
   password
   <br>
8. ホーム画面が表示されることを確認します。
※正しく表示されない場合は、<strong>1. 開発用コンポーネントの評価用ライセンスの有効化</strong>を正しく実施できているか、プロキシ設定が正しいかなどをご確認ください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3681459/6e7e0778-ca23-43b2-a72c-c8e510794c79.png)

### 15. インストール後の設定 - Javaのパスの設定
システム環境変数PENTAHO_JAVA_HOMEにPentahoソフトウェア同梱のJavaのパスを設定します。

1. コマンドプロンプトを「管理者として実行」で起動します。 
2. 以下のコマンドを実行します。(※インストールディレクトリが「C:\pent\p102」の場合)
   ```
   SETX /M PENTAHO_JAVA_HOME C:\pent\p102\java'
   ```

:::note warn
この手順はWorkstation に既存のJavaが存在しない場合を前提とします。Workstationに既存のJavaがある場合は、上記の設定に加え、システム環境変数JAVA_HOMEとシステム環境変数PATHに設定済みの 既存のJavaのパスを、Pentahoソフトウェア同梱のJavaのパスに変更します。
:::

### 16. インストール後の設定 - 開発用コンポーネントの設定
この節では、Windows環境にインストールしたPentahoソフトウェアの起動に必要な設定の手順について示します。

:::note warn
編集には、改行コードのLF（ラインフィード）が編集できるテキストエディタが必要です。ご準備をお願いします。
:::

それぞれのバッチファイルに対して、赤字で示した設定を追記します。修正後のバッチファイルの内容は、PCを再起動しなくても有効となります。

- **Aggregation Designer**
  対象ファイル：C:\pent\p102\design-tools\aggregation-designer\startaggregationdesigner.bat
  
  49行目付近  
  > "%_PENTAHO_JAVA%" <font color='red'>-Dfile.encoding="UTF-8"</font> %JAVA_ADD_OPENS% -jar "%~dp0lib\pentaho-application-launcher-10.2.0.0-222.jar"
<br>

- **Data Integration（Spoon）**
  対象ファイル：C:\pent\p102\design-tools\data-integration\Spoon.bat
  
  158行目付近
  > if "%PENTAHO_DI_JAVA_OPTIONS%"=="" set PENTAHO_DI_JAVA_OPTIONS="-Xms1024m" "-Xmx2048m" <font color='red'>"-Dfile.encoding=UTF-8"</font>
<br>

- **Metadata Editor**
  対象ファイル：C:\pent\p102\design-tools\metadata-editor\metadata-editor.bat
  
  100行目付近  
  > if "%PENTAHO_JAVA_OPTIONS%"=="" set PENTAHO_JAVA_OPTIONS="-Xms1024m" "-Xmx2048m" <font color='red'>"-Dfile.encoding=UTF-8"</font>
  <br>

- **Report Designer**
  対象ファイル：C:\pent\p102\design-tools\report-designer\report-designer.bat
  
  64行目付近  
  > set OPT="-Dswing.useSystemFontSettings=false" "-Xms1024M" "-Xmx2048M" <font color='red'>"-Dfile.encoding=UTF-8"</font>
<br>

- **Schema Workbench**
  対象ファイル：C:\pent\p102\design-tools\schema-workbench\workbench.bat
  
  85行目付近  
  > "%_PENTAHO_JAVA%" -Xms1024m -Xmx2048m %JAVA_ADD_OPENS% %JAVA_LOCALE_COMPAT% <font color='red'>-Dfile.encoding=UTF-8</font> -cp "%CP%" -Dlog4j.configurationFile=file:///%ROOT%\.schemaWorkbench\log4j2.xml mondrian.gui.Workbench

## まとめ
今回はPentahoソフトウェア Ver10.2のトライアル版のインストール手順を紹介しました。
Pentahoの使い方についてはこちらの記事を参照してください。
[ETLツール Pentahoを使ってみよう！【Pentaho ファーストステップガイド PDI使い方編】](https://qiita.com/ryota_akai/items/7ebe22d1eb48ff123eda)

## 他社商品名、商標等の引用に関する表示
HITACHIは，株式会社 日立製作所の商標または登録商標です。
Oracle®、Java、MySQL及びNetSuiteは、Oracle、その子会社及び関連会社の米国及びその他の国における登録商標です。
Windowsは、マイクロソフト 企業グループの商標です。
Pentahoは、Hitachi Vantara LLCの商標または登録商標です。
その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

[^1]: データパイプラインの開発を支援する 日立のデータ統合・分析基盤 **Pentaho** https://www.hitachi.co.jp/products/it/bigdata/platform/pentaho/about/index.html