安裝流程(離線)

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

先決條件

• 切換為 root 權限
• root 密碼需先設為 password
• root 可藉由 ssh 登入設備
• 安裝 AI Console 之 VM 需提供其 Gateway 資訊

取得安裝軟體

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

環境設定及安裝 Installer

步驟一：設置離線安裝包

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

# 建立 /mnt/gemini

$ mkdir -p /mnt/gemini

# 掛載 iso 檔

$ mount -o loop ./GMN-{$version}-${build_number}-offline.iso /mnt/gemini

• 進入 /mnt/gemini 資料夾，將 GMN_image_files/common/offline/ 底下的 archives_gmn 以及 installer_pkg 兩個資料夾複製至 /var/cache/apt/ 底下

$ cp -r GMN_image_files/common/offline/archives_gmn /var/cache/apt/

$ cp -r GMN_image_files/common/offline/installer_pkg /var/cache/apt/

• 修改 /etc/apt/sources.list，只留下以下內容

$ deb [trusted=yes] file:/var/cache/apt/archives_gmn ./

$ deb [trusted=yes] file:/var/cache/apt/installer_pkg ./

儲存離開後執行以下指令

$ apt-get update

步驟二：安裝 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 安裝至機器上。

• 安裝 Installer

$ cd /mnt/gemini

$ apt-get install -f ./installer.deb -y

• 安裝第三方軟體，以下為範例。可以直接以 apt 安裝 gcc、make、docker-ce、shc、nvidia-docker2。

$ apt-get install gcc make docker-ce shc -y

• CUDA安裝檔在 GMN_image_files/common/offline/，如需安裝則執行以下指令

$ cd GMN_image_files/common/offline/

$ chmod +x ./cuda_11.2.0_460.27.04_linux.run

$ ./cuda_11.2.0_460.27.04_linux.run --silent

安裝AI Console

步驟一：申請 Gemini AI Console License

• 進入 /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..>

步驟二：編寫 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=true

步驟三：執行安裝程式

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

檢查與設定

安裝檢查

• 根據上述設定檔內的 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>