安裝流程

本節說明安裝 Gemini AI Console 詳細流程。

先決條件#

切換為 root 權限
root 密碼需先設為 password
root 可藉由 ssh 登入設備
設備要能夠連上網際網路，以下載安裝包

取得安裝軟體#

請先確認您已從 Gemini FTP v1.0.6 資料夾內取得以下必要軟體
- id_generate.tar
- GMN-SE-{$version}.iso

info

若是還沒取得，請先至gemini ftp下載安裝軟體
http://download.geminiopencloud.com:8080/
請選擇 v1.0.6 資料夾，可利用 wget 指令 download

# wget -c -O GMN-SE-hWRWO.iso http://download.geminiopencloud.com:8080/v1.0.6/GMN-SE-hWRWO.iso
# wget -c -O id_generate.tar http://download.geminiopencloud.com:8080/v1.0.6/id_generate.tar

安裝AI Console#

步驟一：申請 Gemini AI Console License#

將 id_generate.tar 解壓縮

# tar xvf id_generate.tar

執行解壓縮後會出現一個 dist 資料夾，進到此資料夾後會有一個 id_generate.exe 檔案. 請執行並將產生的 Hash Code 寄回 Gemini，我們將產生一組授權碼給您。Email：support@geminiopencloud.com

# cd dist
# ./generate.exe

0b2ef5fafe7380fc5b121f87bc15b8fa6c636b1534140d8718e2e5c8a80a3591

你將會得到一組以下結構的文字檔案, 請於之後的步驟填寫進入安裝設定檔內 License Code 欄位

LICENSE geminiopencloud permanent hosts= users= enable_public= gpu= jobs= projects= mode= sig=<...sig text..>

步驟二：解開安裝包#

將 iso 檔掛載到一個空的目錄下，此目錄為之後 Gemini AI Console 的安裝目錄，以下將以 /mnt/gemini 作為範例

建立 /mnt/gemini
# mkdir -p /mnt/gemini

掛載 iso 檔
# mount -o loop <installer iso> /mnt/gemini

進行 Installer 安裝
# cd /mnt/gemini
# apt-get install -f ./GMN-installer-v1.6.1.deb

步驟三：編寫 gemini.cfg 設定檔#

切換路徑至 /opt/gemini/GMN_installer/ansible，修改 gemini.cfg 安裝設定檔。並確認 /opt/gemini/GMN_installer/ansible 路徑下存在 gemini.cfg 安裝設定檔與 GI.sh。
可自行創建額外的安裝設定檔或使用預設的 gemini.cfg，若自行創建新安裝設定檔時，須注意內容是否符合底下範例。
- pm_bridge : 此為上述步驟中，實體伺服器橋接網卡所設定 IP Address
- ip : AI console web portal 提供服務的 IP Address
- netmask : AI console web portal 的子網路遮罩
- gateway : AI console web portal 的閘道 IP
- dns : AI console web portal 所使用的 DNS server
- lic : 將提供給此台機器使用的 license code 貼於此

以下以預設 gemini.cfg 作為說明：

# gemini.cfg

# Physical machine bridge IP, use ifconfig br-1 to see your bridge ip address
pm_bridge=10.111.20.2

# AI Console IP, this IP will be assigned to AI Console portal
ip=10.111.20.10

# AI Console Netmask
netmask=255.255.0.0

# AI Console Gateway
gateway=10.111.0.254

# AI Console DNS
dns=8.8.8.8

# License Code, please copy the license code from received email
lic=LICENSE geminiopencloud permanent hosts=1 users=5 enable_public=0 gpu=8 jobs=3 projects=1 mode=Single sig=WyJmMGttYkZGN--------略---------UE13L0xnPT0iXQ==

步驟四：執行安裝程式#

在 /opt/gemini/GMN_installer/ansible 路徑下，執行 GI.sh 程式

# ./GI.sh create -f <config file>

開始執行後，可開啟額外 terminal 畫面，輸入以下指令查看安裝 Log 訊息
- install_k8s.log 檔案紀錄實體機器安裝 kubernetes 系統時相關訊息
- install_gmn.log 檔案紀錄 AI Console 系統安裝時相關訊息

# tail -f /var/log/install_k8s.log

# tail -f /var/log/install_gmn.log

若安裝正常執行，安裝完畢後會看到以下訊息

訊息	說明
GMN initializing…	安裝完成，重啟各項服務
GMN installation are finished	重啟完成，可以正常使用 AI Console

若安裝失敗可能出現以下幾種訊息

訊息	說明
GMN installation are failed	AI Console 安裝失敗
Kubernetes installation on physical machine failed, please inform Gemini	在實體機上安裝 kubernetes 失敗。若是 kubernetes 安裝失敗，可以參考 Troubleshooting 進行後續的處理。

檢查與設定#

安裝檢查#

根據上述設定檔內的 AI Console IP，透過瀏覽器開啟網頁，網址為
< AI Console IP >:32666
預設登入帳密如下

# System Admin
帳號：admin
密碼：password

# Project Admin
帳號：default
密碼：password

透過 default 帳號開啟一個容器服務，並確認該容器有正常執行

變更 IP Address（非必要，若有需求再執行）#

若您在安裝完成後，需要變更 IP Address，請更改步驟三的設定檔內容後，重新執行 GI.sh 腳本

# ./GI.sh config -f <config file>

錯誤排查（Troubleshooting）#

若遇到 AI Console 安裝失敗時，可透過以下兩道指令完整清除 AI Console

# ./GI.sh delete gmn
# ./GI.sh delete k8s

若單純為 Kubernetes 安裝失敗，則只需 delete kubernetes 即可

# ./GI.sh delete k8s

caution

執行 delete k8s 後，需重新開機

可依照以下指令查閱本軟體的日誌內容

# dump_logs -h
Dump logs of AI console
Usage: dump_logs.sh [-t DESTINATION] [-h]
    -t DESTINATION
        Dump the logs to a specific file, instead of to dump.tgz in the current folder
    -h
        Display this messages

# dump_logs.sh -t /tmp/dump.tgz
# ls /tmp
dump.tgz