この記事はUbuntuの環境でAI-hubのインストール簡易説明資料です。
Altair Employeeこの記事は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を設定 |
Altair | Altair One Admin Portalにloginして、AuthCodeを発行
5. Dockerでインストール
cd /home/altair/app/prod/
sudo chmod 664 .env
初期インストールの確認、実施するとimageなどのDownloadingを始めて、テスト環境を構築します。
docker compose up -d deployment-init
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