Skip to main content

升級流程

本節說明升級 Gemini AI Console 詳細流程。

info

目前 Installer只支援 單機版(SE) -> 標準版(ST) -> 進階版(AD) 的升級方式，不支援直接安裝標準版或是進階版版本之 AI Console。

升級至 Standard 標準版版本 (ST Mode)#

步驟一：申請 Gemini AI Console License#

  • 將 id_generate.tar 解壓縮
$ tar xvf id_generate.tar
  • 執行解壓縮後會出現一個 dist 資料夾，進到此資料夾後會有一個 id_generate.exe 檔案，請執行並將產生的 Hash Code 寄回雙子星雲端，我們將產生一組授權碼給您。Email：support@geminiopencloud.com
$ cd dist
$ ./generate.exe
0b2ef5fafe7380fc5b121f87bc15b8fa6c636b12345678d8718e2e5c8a80a3591
  • 你將會得到一組以下結構的文字檔案, 請於之後的步驟填寫進入安裝設定檔內 License Code 欄位
LICENSE geminiopencloud permanent hosts= users= enable_public= gpu= jobs= projects= mode= sig=<...sig text..>

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

caution

Config 中 mount_harbor_data_image 選項只有在需要時才啟用。此選項會於 AI Console 所在的 VM 另外掛載一個 data image 於 /data/habor 的位置。

  • 切換路徑至 /opt/gemini/GMN_installer/ansible，修改 gemini.cfg 安裝設定檔。並確認 /opt/gemini/GMN_installer/ansible 路徑下存在 gemini.cfg 安裝設定檔與 GI.sh。
  • 可自行創建額外的安裝設定檔或使用預設的 gemini.cfg，若自行創建新安裝設定檔時，須注意內容是否符合底下範例。
    • lic : 將提供給此台機器使用的 license code 貼於此
    • offline_install：切換線上/離線安裝的變數
    • mount_harbor_data_image: 是否另外掛載 data image 給 AI Console 使用

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

# gemini.cfg
# 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
# Mount data image to the VM installed AI Console
mount_harbor_data_image=false

步驟三：執行升級程式#

caution

可指定 inventory file，如不指定則預設帶入 inventory/deploy_se.cfg。

  • 在 /opt/gemini/GMN_installer/ansible 路徑下，執行 GI.sh 程式
$ ./GI.sh upgrade -f CONFIG_FILE [-i INVENTORY_FILE]

  • 開始執行後，可開啟額外 terminal 畫面，輸入以下指令查看安裝 Log 訊息

    • upgrade_standard.log 檔案紀錄升級 AI Console 時相關訊息
$ tail -f /var/log/upgrade_standard.log
  • 若升級正常執行，升級完畢後會看到以下訊息
訊息說明
gmn upgrade are finished升級完成，可以正常使用 AI Console
  • 若升級失敗可能出現以下訊息
訊息說明
gmn upgrade are failedAI Console 升級失敗

升級至 Advance 進階版版本 (AD Mode)#

步驟一：申請 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
0b2ef5fafe7380fc5b121f87bc15b8fa6c636b87654321d8718e2e5c8a80a3591
  • 你將會得到一組以下結構的文字檔案, 請於之後的步驟填寫進入安裝設定檔內 License Code 欄位
LICENSE geminiopencloud permanent hosts= users= enable_public= gpu= jobs= projects= mode= sig=<...sig text..>

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

caution

Config 中 mount_harbor_data_image 選項只有在需要時才啟用。此選項會於 AI Console 所在的 VM 另外掛載一個 data image 於 /data/habor 的位置。

  • 切換路徑至 /opt/gemini/GMN_installer/ansible，修改 gemini.cfg 安裝設定檔。並確認 /opt/gemini/GMN_installer/ansible 路徑下存在 gemini.cfg 安裝設定檔與 GI.sh。
  • 可自行創建額外的安裝設定檔或使用預設的 gemini.cfg，若自行創建新安裝設定檔時，須注意內容是否符合底下範例。
    • lic : 將提供給此台機器使用的 license code 貼於此
    • offline_install：切換線上/離線安裝的變數
    • mount_harbor_data_image: 是否另外掛載 data image 給 AI Console 使用

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

# gemini.cfg
# 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
# Mount data image to the VM installed AI Console
mount_harbor_data_image=false

步驟三：編寫 Inventory File#

caution

可指定 inventory file，如不指定則預設帶入 inventory/deploy_se.cfg。

note

在開始安裝之前，請先在同一台實體機上另外準備兩個乾淨的 VM 環境。

  • Advance 版本的使用情境下，會需要擴充 System K8S。所以需要修改在 /opt/gemini/GMN_installer/ansible/inventory/ 路徑下的 deploy_se.cfg。格式類似以下提供範本。
[all]
###Physical machine host
localhost ansible_host=10.112.1.2 ip=10.112.1.2
###KVM K8S host
k8s-1 ansible_ssh_user=root ansible_ssh_pass=p@ssw0rd ansible_host=10.112.1.10 ip=10.112.1.10 netmask=255.255.0.0 gateway=10.112.0.254 dns=8.8.8.8
k8s-4 ansible_ssh_user=root ansible_ssh_pass=p@ssw0rd ansible_host=10.112.1.13 ip=10.112.1.13
k8s-5 ansible_ssh_user=root ansible_ssh_pass=p@ssw0rd ansible_host=10.112.1.14 ip=10.112.1.14
##hosts--------------------------
[pm-master]
localhost
[pm-node]
[pm-cluster:children]
pm-master
pm-node
[kube-master]
k8s-1
k8s-4
k8s-5
[kube-node]
k8s-1
k8s-4
k8s-5
[etcd]
k8s-1
[k8s-cluster:children]
kube-node
kube-master
[paas-cluster]
[default-k8s]
localhost

步驟四：執行升級程式#

  • 在 /opt/gemini/GMN_installer/ansible 路徑下，執行 GI.sh 程式
$ ./GI.sh upgrade -f CONFIG_FILE [-i INVENTORY_FILE]

  • 開始執行後，可開啟額外 terminal 畫面，輸入以下指令查看安裝 Log 訊息

    • upgrade_advance.log 檔案紀錄升級 AI Console 時相關訊息
$ tail -f /var/log/upgrade_advance.log
  • 若升級正常執行，升級完畢後會看到以下訊息
訊息說明
gmn upgrade are finished升級完成，可以正常使用 AI Console
  • 若升級失敗可能出現以下訊息
訊息說明
gmn upgrade are failedAI Console 升級失敗