Skip to main content
Version: 1.7.1

安裝流程(連網)

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

先決條件#

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

取得安裝軟體#

請來信support@geminiopencloud.com，我們會把下載連結寄給您。

安裝AI Console#

步驟一：申請 Gemini AI Console License#

  • 將 iso 檔掛載到一個空的目錄下，此目錄為之後 Gemini AI Console 的安裝目錄，以下將以 /mnt/gemini 作為範例
# 建立 /mnt/gemini
$ mkdir -p /mnt/gemini
# 掛載 iso 檔
$ mount -o loop ./GMN-{$version}-${build_number}-online.iso /mnt/gemini
  • 進入 /mnt/gemini 資料夾後，將 id_generate.tar 複製至本地資料夾並解壓縮
$ cp id_generate.tar /tmp
$ cd /tmp && 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..>

步驟二：安裝 Installer#

  • 如果有需要安裝 preload solution，則要掛載 Preload Image iso (optional)
# 建立 /mnt/solution
$ mkdir -p /mnt/solution
# 掛載 iso 檔
$ mount -o loop ./SOL-${version}-${build-number}.iso /mnt/solution
caution

如果需要安裝 preload solution，則一定要在安裝 installer 前先掛載好，否則不會將 preload solution 安裝至機器上。

  • 執行以下指令
$ cd /mnt/gemini
$ apt-get install -f ./installer.deb -y

步驟三：編寫 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 貼於此
    • offline_install：切換線上/離線安裝的變數

以下以預設 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==
# online/offline install
offline_install=false

步驟四：執行安裝程式#

  • 在 /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 failedAI Console 安裝失敗

檢查與設定#

安裝檢查#

  • 根據上述設定檔內的 AI Console IP，透過瀏覽器開啟網頁，網址為
    < AI Console IP >:32666
  • 預設登入帳密如下
# System Admin
帳號：admin
密碼：password
# Project Admin
帳號：default
密碼：password
  • 透過 default 帳號開啟一個容器服務，並確認該容器有正常執行

變更 IP Address#

caution

此步驟非必要，若有需求再執行

  • 若您在安裝完成後，需要變更 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