Cloudera Base on premises で DataViz を使ってみよう - インストール編

# この記事について

Cloudera のデータ可視化機能である Data Viz が、オンプレミスの Base の機能の一部として使えるようになりました。

2025年6月現在では、Data Viz に対応する Base のバージョン（7.1.9, 7.3.1）をインストールしただけでは Data Viz が使えるようにはならず、追加の手順が必要になります。

追加の手順は以下のドキュメントに記載されています。

https://docs.cloudera.com/data-visualization/8/start-base-on-premises/topics/viz-deploy-cdv-in-base-on-premises.html#viz-add-engine-cml

この記事には、⬆️のドキュメントの翻訳と、必要に応じて補足情報を記載します。

すべてを記載すると長大になるため、この記事ではインストールの手順を紹介します。

# 前提条件

- Data Viz を利用可能な Cloudera の Base のバージョンがインストール済みであること
    - 対応バージョンは Cloudera の[サポートマトリクス](https://supportmatrix.cloudera.com/)で確認
- Cloudera Manager がインストールされているサーバーに root 権限でアクセスできること（sudo できること）
- メタデータのストレージとして利用可能なRDBMSに接続できること（MySQL, Postgres など）

:::note warn
（ドキュメントより）リソース競合を避けるため、Data Viz 用に新たなノードを立てることを推奨します。特に、既存のクラスタのワークロードの高いノードと同居させることはおすすめしません。
:::

:::note
（補足）メタデータ用のストレージについて、手元で検証した際はHMSと同じRDBMS（Postgres）に DataViz用のデータベースを作成しました。
:::

:::note warn
（補足）一部の手順は Cloudera Manager の再起動を伴います。稼働中のクラスタに DataViz を追加する場合は、停止が可能な時間帯に行うことをおすすめします。
:::

# インストール手順

## DataViz用のレポジトリを Cloudera Manager に追加する

- Cloudera Manager にログインします

- トップ画面からの左のメニューから ホスト > Parcel を選択します
- 出てきた画面で Parcel Repositories & Network Settings」 を選択します
![Screenshot 2025-06-04 at 9.26.49.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/40ca36a0-1578-455e-bd33-6a664420d7b0.png)

- 現在参照可能なレポジトリの一覧が出てくるので、「+」をクリックします
 ![viz-add-cdv-parcel-repository-2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/4cebe2de-9e3d-461d-828a-d4caabe6cf04.png)
- DataViz の parcel が入ったレポジトリ (`https://archive.cloudera.com/p/cdv/{バージョン名}/parcels/` など)を設定し「Save & Verify Configuration」をクリックします
![Screenshot 2025-06-04 at 9.30.24.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/5fd27052-154a-44ab-aef2-cfa081f58cfd.png)

- ⬆️の画面を閉じると、Parcel の画面上にDataVizの parcel が表示されます
![Screenshot 2025-06-04 at 9.35.12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/01cb3db5-a222-43b6-9727-24d96a800152.png)

- 表示された DataViz の parcel の行の「ダウンロード」ボタンをクリックします
![Screenshot 2025-06-04 at 9.36.32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/4ea925bc-9254-4d05-8877-a06a942c89f2.png)

- ダウンロードが完了すると「配布」ボタンが表示されるので、クリックします
![Screenshot 2025-06-04 at 9.37.45.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/473afc2a-82c1-47e7-953c-8edd4963a354.png)

- 配布が完了すると「アクティブ化」が表示されるので、クリックします
![Screenshot 2025-06-04 at 9.39.51.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/0e2db0e8-3ada-406a-82e7-ff07f5b92a15.png)

- 以下のような画面が表示されたら、「再起動」を選択し「OK」をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/f4f33409-c8cc-4735-8d35-07a9e0190160.png)

- 完了したら「閉じる」をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/93e7360c-1f04-4706-945d-a57e18632cd2.png)

- DataViz の parcel が「配布済み, アクティブ化済み」となればOKです
![Screenshot 2025-06-04 at 9.44.29.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/8fb78d89-d7b5-4785-a437-33be86fea79d.png)

## Data Viz の CSD ファイルをダウンロード・追加する

### この手順について

Cloudera Manager が新たなサービスを認識し管理できるように、以下の手順で Custom Service Descriptor (CSD) ファイルを追加する必要があります。

Cloudera Manager のホストで root になれる、もしくは sudo できる必要があります。

:::note warn
（補足）この手順の最後に Cloudera Manager の再起動を行います。
:::

### 手順

- Cloudera Manager のホストに ssh で入ります

#### `/opt/cloudera/csd` ディレクトリに入る

- `/opt/cloudera/csd` ディレクトリが存在することを確認します

```shell:コマンド例
ls -lA /opt/cloudera/csd
```
- `/opt/cloudera/csd` ディレクトリが存在しない場合は作成します
```shell:コマンド例
mkdir /opt/cloudera/csd
```
- `/opt/cloudera/csd` ディレクトリに入ります
```shell:コマンド例
cd /opt/cloudera/csd
```

#### CSDファイルのダウンロード

DataViz の CSDファイルをダウンロードします

```shell:コマンド例
sudo wget https://{レポジトリアクセス用のユーザー}:{レポジトリアクセス用のパスワード}@{ダウンロード元}/{jarファイル名}.jar
```

具体的には以下のようになります。

```shell:コマンド例
sudo wget https://xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:yyyyyyyyyyyy@archive.cloudera.com/p/cdv/8.0.4/redhat8/yum/DATAVIZ-8.0.4-b47.p1.67141340.jar
```

完了後、 `ls -lA` などを実行し、意図した jar ファイルがダウンロードされていることを確認します。

#### Cloudera Manager サービスの再起動

設定を反映させるために、まずはホスト上で Cloudera Manager のサーバーを再起動します。

```shell
sudo service cloudera-scm-server restart
```

完了後、Cloudera Manager の画面にログインし、 Cloudera Management Service の再起動を行います。

ホーム画面から、 Cloudera Management Service の右の三点をクリックし「再起動」をクリックします。
![Screenshot 2025-06-04 at 13.51.52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/4b60b89e-f0d1-4f0b-bfb9-d7d7c5c8b09f.png)

以下のプロンプトが表示されたら、「再起動」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/ecf854dc-5023-492e-8aeb-b90f8c896c24.png)

完了したら「閉じる」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/b034536f-4a8a-4837-bf9f-c56c8121ad1f.png)


## Data Viz サービスの追加

ここまでの手順が完了すると、他のサービス（Hive や Impala など）を入れるときと同じように、Cloudera Manager 上に Data Viz のサービスが表示されて追加できるようになります。

### 手順

- Cloudera Manager のホーム画面で、該当のクラスタの右の三点をクリックし「サービスの追加」をクリックします
![Screenshot 2025-06-04 at 13.57.32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/5a09789d-f4ee-4f85-9861-df5b55e07c93.png)

- 「Dataviz」を選択し「続行」をクリックします
![Screenshot 2025-06-04 at 13.59.32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/4d41b250-3c4c-49af-904b-ff838da7fc69.png)

- Data Viz の Webサーバーを配置するホストを選択し「続行」をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/2735f5b2-2f81-413e-9da3-d20cedd07456.png)

- メタデータ格納用のデータベースへの接続情報を指定し「テスト接続」を実行します
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/638f39b2-a458-47f2-a7f6-9d0b87193343.png)

- 結果が「Successful」になったら「続行」をクリックします
![Screenshot 2025-06-04 at 14.14.10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/7672c71e-8a89-4006-8d9c-b05abf7767cd.png)

- 変更内容を確認し「続行」をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/ce84ae4d-ca5c-4b72-a9b9-0e6ab39b4c23.png)

- 処理が完了したら「続行」をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/c2a9c4b4-1370-4ac6-a9ba-b48f8a2e6d13.png)

- 以下のようなサマリが表示されるので「完了」をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/540d392b-1f12-47aa-a3ae-4a9a97a2f24b.png)

- ホーム画面で、 Cloudera Management Service の右の三点をクリックし「再起動」をクリックします
![Screenshot 2025-06-04 at 13.51.52.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/4b60b89e-f0d1-4f0b-bfb9-d7d7c5c8b09f.png)

- 以下のプロンプトが表示されたら、「再起動」をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/ecf854dc-5023-492e-8aeb-b90f8c896c24.png)

- 完了したら「閉じる」をクリックします
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/b034536f-4a8a-4837-bf9f-c56c8121ad1f.png)

ここまでの手順が完了すると、クラスタ配下のサービスの一覧にDatavizが表示されるようになります。

![Screenshot 2025-06-04 at 14.27.16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/c7eb2a1a-3a0c-4edd-9d47-55b312a6d9d2.png)

Dataviz を選択すると、以下のような Dataviz の管理画面を開くことができます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/587845/c691691d-fd68-4ab6-ac3d-1e436e6883e4.png)

このあとに続く手順（初回ログイン、コネクションの作成）は、以下のページで解説しています

https://qiita.com/IQ_Bocchi/items/e0af49952ba931d95d1b