GaussDB 100單機版升級指南

本文旨在介紹如何升級GaussDB單機版數據庫，從1.0.0升級到1.0.2版本。單機支持小版本升級和二進制升級這兩種類型的自動升級。進行自動升級時，只需要在節點上執行一次升級命令。

1、上傳軟件包以及解壓

上傳以下兩個軟件包至同一目錄：

GaussDB_T_1.0.2-DATABASE-REDHAT-64bit.tar.gz
DIALECT-SCRIPT-GaussDB_T_1.0.2.tar.gz 
[omm@hwd10 gaussdb]$ tar -xzf GaussDB_T_1.0.2-DATABASE-REDHAT-64bit.tar.gz

2、創建配置文件

[omm@hwd10 gaussdb]$ vi /opt/gaussdb/config_file.ini
192.168.120.31=/opt/software/gaussdb/GaussDB_T_1.0.2-DATABASE-REDHAT-64bit.tar.gz,/opt/gaussdb/app,/opt/gaussdb/
backup,/opt/gaussdb/data
[omm@hwd10 gaussdb]$ mkdir /opt/gaussdb/backup

• 192.168.120.31是數據庫所在服務器IP。
• /opt/software/gaussdb/GaussDB_T_1.0.2-DATABASE-REDHAT-64bit.tar.gz是升級包的絕對路徑。
• /opt/gaussdb/app是數據庫安裝路徑。
• /opt/gaussdb/backup是升級過程中備份文件的存儲路徑(需手工創建)。
• /opt/gaussdb/data是數據庫實例的數據文件目錄。安裝多個實例時，使用同一個安裝目錄啓動的數據庫實例必須一次性升級，此時需要指定多個數據庫實例的數據目錄，多個數據目錄之間使用逗號分隔。

  3、獲取升級類型（可選）

  [omm@hwd10 ~]$ cd /opt/software/gaussdb/GaussDB_T_1.0.2-DATABASE-REDHAT-64bit
  [omm@hwd10 GaussDB_T_1.0.2-DATABASE-REDHAT-64bit]$ python upgrade.py -t upgrade-type --GSDB_HOME=/opt/gaussdb/app --GSDB_DATA=/opt/gaussdb/data --package=/opt/software/gaussdb/GaussDB_T/GaussDB_T_1.0.2-DATABASE-REDHAT-64bit.tar.gz --backupdir=/opt/gaussdb/backup
  Old version: 1.0.0.SPC1.B002 New version: 1.0.2.B319.
  systable-upgrade

  返回Upgrade type: binary-upgrade.時，自動升級時進行二進制升級；返回Upgrade type: systable-upgrade.時，自動升級時進行小版本升級。

  4、升級環境檢查

  [omm@hwd10 GaussDB_T_1.0.2-DATABASE-REDHAT-64bit]$ python upgrade.py -s pre-check --config-file=/opt/gaussdb/config_file.ini --upgrade-mode=single
  Begin to precheck for single upgrade.
  Old version: 1.0.0.SPC1.B002 New version: 1.0.2.B319.
  Precheck for single upgrade finished.
  Upgrade [pre-check] step successfully.
  [omm@hwd10 GaussDB_T_1.0.2-DATABASE-REDHAT-64bit]$

  5、執行一鍵升級

[omm@hwd10 GaussDB_T_1.0.2-DATABASE-REDHAT-64bit]$ python upgrade.py -s run --config-file=/opt/gaussdb/config_file.ini --upgrade-mode=single
Old version: 1.0.0.SPC1.B002 New version: 1.0.2.B319.
Precheck step for single upgrade.
Prepare step for single upgrade.
Replace step for single upgrade.
Begin distrubute key to other instances.
output:
attr:MOUNT
single=============output:
connected.

SQL> 

VALUE                                                           
----------------------------------------------------------------
(/opt/gaussdb/data/protect/kmc_a.ksf, /opt/gaussdb/data/protect/kmc_b.ksf)

1 rows fetched.

single===========status:0
Start step for single upgrade.
Upgrade step for single upgrade.
Sync step for single upgrade.
Dbcheck step for single upgrade.
Flush step for single upgrade.
Run for single upgrade finished.
Upgrade [run] step successfully.

升級完成後，數據庫處於關閉狀態，打開數據庫，通過查詢version視圖也可以獲取到升級後的版本信息。

6、清理環境

執行cleanup清理環境時會刪除升級過程中產生的日誌文件（upgrade.log文件），如果後期需要查看，請在執行cleanup前手動保存upgrade.log文件。upgrade.log文件的存儲路徑是/opt/gaussdb/backup/ha_upgrade_backup/upgrade.log，其中/opt/gaussdb/backup是用戶手動創建的升級過程中備份文件的存儲路徑。

[omm@hwd10 GaussDB_T_1.0.2-DATABASE-REDHAT-64bit]$ python upgrade.py -s cleanup --config-file=/opt/gaussdb/config_file.ini --upgrade-mode=single
clean backup and tmp files.
Upgrade [cleanup] step successfully.

7、回滾操作

如果數據庫升級失敗後，需要通過自動回滾的方式回滾數據庫。

7.1 回滾檢查

進入upgrade.py所在目錄，執行下面的命令：

[omm@hwd10 ~]$ cd /opt/software/gaussdb/GaussDB_T_1.0.2-DATABASE-REDHAT-64bit
[omm@hwd10 GaussDB_T_1.0.2-DATABASE-REDHAT-64bit]$ python upgrade.py -s rollback-check --config-file=/opt/gaussdb/config_file.ini --upgrade-mode=single

7.2 執行回滾

[omm@hwd10 GaussDB_T_1.0.2-DATABASE-REDHAT-64bit]$ python upgrade.py -s rollback --config-file=/opt/gaussdb/config_file.ini --upgrade-mode=single