この記事はUbuntuの環境でAI-hubのインストール簡易説明資料です。

AI-hubのオンライン参照資料:Docker-compose deployment - Altair RapidMiner Documentation

記事で実施する環境:

Ubuntu環境: ubuntu22.04
Docker: 27.1.1 - Community
AI-hub: 2024.0.3

これからはAI-hubをインストール手順です。

注意：お客様のIT環境よりますが、proxy環境のでAltairのライセンスサーバーに通信できない場合もあります。

インストールの設定が正確でも、AI-hubは動作できない状況があります。この場On-premライセンス設定の部分でご参照してください。

インストール簡易手順：

実施する前に、AI-hub専用のPort80や443（Httpsを使う場合）、6200（On-premライセンス用）のportを開いてください

  sudo ufw allow 80/tcp

AI-hubをインストールする時、まずHardwareなどの要求をご確認してください。

1. System Requirementの確認

Docker > 20.10 Dockerをインストール: https://docs.docker.com/engine/install/ubuntu/
4 コア
32GB RAM
Disk > 30 GB

2. AI-hubのインストールFileをDownload

Docker-compose deployment - Altair RapidMiner Documentation でインストールしたいAI-hubのバージョンを決めて、Downloadしてください。ここで「2024.0.3」を選択しました。

DownloadしたFile：

3．DownloadしたFileを展開してください。

展開したものをインストールしたパスにコピーしてください。例えば/home/altair/app/prod/

4. ライセンスの設定より、.envを修正が変わります。

On-premライセンス

行数	修正が必要な項目名	設定方法や設定値
9	PUBLIC_DOMAIN	192.168.xxx.xxx (ここはサーバーPCのIP)
10	PUBLIC_PORT	80
19	SSO_PUBLIC_DOMAIN	192.168.xxx.xxx (ここはサーバーPCのIP)
41	TZ	Asia/Tokyo
45	LICENSE_MODE	ALTAIR_UNIT
166	KEYCLOAK_PASSWORD	your_admin_password ([changeit] as default)
191	LICENSE_PROXY_MODE	on_prem
196	ALTAIR_LICENSE_PATH	6200@192.168.xxx.xxx
333	JUPYTERHUB_CRYPT_KEY	openssl rand -hex 32で生成したCRYPT_KEYを設定
561	PANOPTICON_VIZAPP_CONTAINER_MAC_ADDRESS	560行目のcommandを利用してして、生成MAC_ADDRESSを設定

333行目のJUPYTERHUB_CRYPT_KEY を設定する場合：

yj@ai-hub2024:~$ openssl rand -hex 32
c797ccb040e51a18e7ea6e8155ad2b62e30bde1b4a690384a1229f83ddacbcd4

JUPYTERHUB_CRYPT_KEY="c797ccb040e51a18e7ea6e8155ad2b62e30bde1b4a690384a1229f83ddacbcd4"

561行目のPANOPTICON_VIZAPP_CONTAINER_MAC_ADDRESSを設定する場合：

yj@ai-hub2024:~$ head -n80 /dev/urandom | tr -d -c '[:digit:]A-F' | fold -w 12 | sed -E -n -e '/^.[26AE]/s/(..)/\1-/gp' |sed -e 's/-$//g' -e 's/-/:/g' -e 's/^\S\S/66/g'| head -n10
66:CC:7A:B7:59:C8
66:D5:BE:25:F1:3C
66:B6:BA:15:FE:D1
66:83:9D:AE:C0:72
66:85:E7:C2:E4:72
66:F7:F2:5F:BD:D5
66:2C:87:F0:EB:BD
66:20:00:B1:1A:80
66:94:AC:EA:DC:FF
66:03:69:8E:F3:CC

ANOPTICON_VIZAPP_CONTAINER_MAC_ADDRESS="66:CC:7A:B7:59:C8"

Managedライセンス‐AltairOne Account

行数	項目名	内容や例
9	PUBLIC_DOMAIN	192.168.xxx.xxx (ここはサーバーPCのIP)
10	PUBLIC_PORT	80
19	SSO_PUBLIC_DOMAIN	192.168.xxx.xxx (ここはサーバーPCのIP)
41	TZ	Asia/Tokyo
45	LICENSE_MODE	ALTAIR_UNIT
166	KEYCLOAK_PASSWORD	your_admin_password ([changeit] as default)
191	LICENSE_PROXY_MODE	altair_one
203	LICENSE_UNIT_MANAGER_AUTHENTICATION_TYPE	credentials
207	LICENSE_UNIT_MANAGER_USER_NAME	Your_altair_account_name
209	LICENSE_UNIT_MANAGER_PASSWORD	Your_altair_account_password
333	JUPYTERHUB_CRYPT_KEY	openssl rand -hex 32で生成したCRYPT_KEYを設定
561	PANOPTICON_VIZAPP_CONTAINER_MAC_ADDRESS	560行目のcommandを利用してして、生成MAC_ADDRESSを設定

333と561行目の設定はOn-premと一緒です。

Managedライセンス‐AuthCode

行数	項目名	内容や例
9	PUBLIC_DOMAIN	192.168.xxx.xxx (your server IP)
10	PUBLIC_PORT	80
19	SSO_PUBLIC_DOMAIN	192.168.xxx.xxx (your server IP)
41	TZ	Asia/Tokyo
45	LICENSE_MODE	ALTAIR_UNIT
166	KEYCLOAK_PASSWORD	your_admin_password ([changeit] as default)
191	LICENSE_PROXY_MODE	altair_one
203	LICENSE_UNIT_MANAGER_AUTHENTICATION_TYPE	auth_code
333	JUPYTERHUB_CRYPT_KEY	openssl rand -hex 32で生成したCRYPT_KEYを設定
561	PANOPTICON_VIZAPP_CONTAINER_MAC_ADDRESS	560行目のcommandを利用してして、生成MAC_ADDRESSを設定

333と561行目の設定はOn-premと一緒です。

auth_codeの発行方法：

Altair | Altair One Admin Portalにloginして、AuthCodeを発行

注意： auth_codeの有効期限は15分になりますが、インターネット状況よりインストール時間は15分を超える場合、AuthCodeは無効になってしまいます。この場に、通常なインストール手順より、まず”sudo docker compose pull” を実施して、Imagesを先をdownloadして、時間を短縮できます。 downloadを完了後に、通常なインストール手順と同じです。

5. Dockerでインストール

注意：Dockerでインストールする前に、必ず3で展開先に移動してください。

展開先に移動

cd /home/altair/app/prod/

FilePermissionを設定

sudo chmod 664 .env

初期インストールの確認、実施するとimageなどのDownloadingを始めて、テスト環境を構築します。

docker compose up -d deployment-init

初期インストールLogの確認

docker compose logs -f deployment-init

もし、下記様なLogが出た際、FilePermissionの設定を追加と初期インストールの再確認が必要です。「[DEPLOYMENT INIT] Successfully finished.」様なLogが出た場合、次は6.AI-hubの構築から参照してください。

| [RM INIT] Starting...
| [RM INIT] Starting job /rapidminer/provision/tasks/01_check_permissions.sh
| touch: cannot touch '/tmp/ssl/.test_permission': Permission denied
| Permission denied on file/directory ssl/ !
|     Please make sure about good permissions of these files/dirs:
|       - .env : it should be writable by anyone (666, or -rw-rw-rw-)
|       - ssl : it should be writable by anyone (777, or drwxrwxrwx)

FilePermissionの設定を追加

sudo chown -R 2011:0 ssl/
sudo chmod -R ug+w ssl/
sudo chmod -R o-rwx ssl/
sudo chmod 666 .env

初期インストールの再確認

docker compose up -d deployment-init
docker compose logs -f deployment-init

下記様なLogを見えると、初期インストール（テスト）の部分は完了。

[DEPLOYMENT INIT] Successfully finished.

6. AI-hubの構築

AI-hubの構築をはじめ：

docker compose up -d

AI-hub構築のLog

docker compose logs -f deployment-init

7. AI-hubにLogin

下記様なLINKでごLoginしてください。

http://your_server_pc_ip_address

8. よく使われるDockerCommand

# docker containers を停止
docker compose down
#License 関連問題がある時、LicenseProxyLogの確認
docker compose run -it license-proxy
#docker container のリスト出す
docker ps