操作場景
在FusionInsight Manager界面上下載的客戶端包中包含客戶端批量升級工具,當集群升級或擴容后需要對多個客戶端進行升級時,可以使用該工具對客戶端進行批量一鍵升級。同時客戶端批量升級工具提供了輕量級的批量刷新客戶端所在節點“/etc/hosts”文件的功能。
操作步驟
客戶端升級前準備
- 登錄FusionInsight Manager。
- 選擇“集群 >待操作集群的名稱 > 更多 > 下載客戶端”,下載完整客戶端到服務端指定目錄。
具體操作看參考下載客戶端。
解壓新下載的客戶端,在解壓后的目錄找到batch_upgrade目錄,例如“/tmp/FusionInsight-Client/FusionInsight_Cluster_1_Services_ClientConfig/batch_upgrade”。
- 選擇“集群 >待操作集群的名稱 > 客戶端管理”,進入客戶端管理界面,單擊“導出全部”,將所選的客戶端信息導出到本地。
- 解壓導出的客戶端信息,將client-info.cfg文件上傳到客戶端解壓目錄的batch_upgrade目錄下。
- 參見參考信息,補全“client-info.cfg”中缺失的密碼。
批量升級客戶端
- 執行sh client_batch_upgrade.sh -u -f /tmp/FusionInsight-Client/FusionInsight_Cluster_1_Services_Client.tar -g /tmp/FusionInsight-Client/FusionInsight_Cluster_1_Services_ClientConfig/batch_upgrade/client-info.cfg ,進行升級。
須知
由于配置了密碼信息,執行完升級后建議盡快刪除client-info.cfg文件。
- 升級執行完成后確認結果。確保客戶端升級無誤后執行 sh client_batch_upgrade.sh -c ,確認升級結果。
- 如果客戶端升級后存在問題,可以執行 sh client_batch_upgrade.sh -s ,回滾客戶端。
說明
客戶端批量升級工具本身是將原客戶端move至備份目錄,然后再使用-f參數指定的客戶端包再次安裝客戶端。因此若原客戶端中有定制的內容,請在執行-c命令之前,將定制的內容從備份目錄手動保存或者移至升級后的客戶端目錄。客戶端備份路徑為:?{原客戶端路徑}?-backup。
參數-u是-c和-s的前提,必須在-u命令執行了升級之后,才能選擇是要執行-c進行提交還是-s進行回滾。
升級命令( -u )可以多次執行,每次執行只升級前面升級失敗的客戶端,跳過升級成功的客戶端。
客戶端批量升級工具也支持升級之前的舊客戶端。
執行非root用戶安裝的客戶端升級時,請確保相應用戶在目標節點客戶端所在目錄及父目錄的讀寫權限,否則會升級失敗。
-f參數輸入的客戶端包必須為全量客戶端,不支持單組件或部分組件客戶端包作為輸入。
參考信息
批量升級客戶端前,需手動配置遠程登錄客戶端節點的用戶密碼信息:
執行vi client-info.cfg命令,添加用戶密碼信息。
例如:
clientIp,clientPath,user,password
10.10.10.100,/home/omm/client /home/omm/client2,omm,密碼
配置文件各字段含義如下:
- clientIp:表示客戶端所在節點IP地址。
- clientPath:客戶端安裝路徑,可以包含多個路徑,以空格分隔多個路徑。注意路徑不要以“/”結尾。
- user:節點用戶名。
- password:節點用戶密碼信息。
說明如果執行失敗,請在執行目錄的 work_space/log _XXX下查看node.log日志。