遷移服務器上的基礎服務（集群版適用）
更新時間 2025-09-29 17:49:40
最近更新時間: 2025-09-29 17:49:40
分享文章
本節主要介紹如何使用API遷移服務器上的基礎服務。
此操作用來遷移HBlock服務器上的基礎服務，包括：mdm（元數據管理服務）、ls（日志服務）、cs（協調服務）。
應用場景：基礎服務所在的服務器出現損壞、宕機等時，為了不影響HBlock服務，可以遷移服務器上的基礎服務。
說明
可以通過查詢指定服務器查詢基礎服務的狀態。一次只能遷移一個基礎服務，如果有正在遷移的基礎服務進程，必須等待遷移完成，才可以執行其他服務遷移操作。
注意
遷移ls服務的時候，要確保兩個mdm服務和其他兩個ls服務都是up狀態，除了源服務器之外的所有的其他節點的ms服務（管理服務）正常，服務狀態可以通過查詢服務器獲取。
遷移mdm服務的時候，要確保另一個mdm服務是up，除了源服務器之外的所有的其他節點的ps服務（協議解析服務）和ms服務（管理服務）正常，服務狀態可以通過查詢服務器獲取。
遷移cs服務的時候，要確保其他兩個cs服務都up，除了源服務器之外的所有的其他節點的ps服務（協議解析服務）和ms服務（管理服務）正常，服務狀態可以通過查詢服務器獲取。
請求語法
PUT /rest/v1/system/server/serverId/migrate HTTP/1.1
Date: date
Content-Type: application/json; charset=utf-8
Content-Length: length
Host: ip:port
Authorization: authorization
{
"destServerId": serverId,
"service": service,
"metaDir": path
}請求參數
| 參數 | 類型 | 說明 | 是否必須 |
|---|---|---|---|
| serverId | String | 源HBlock服務器的ID。 | 是 |
| destServerId | String | 目的服務器ID。 | 是 |
| service | String | 需要遷移的基礎服務。 取值：
| 是 |
| metaDir | String | 遷移服務的數據目錄，用于存儲基礎服務的相關數據信息。 說明 為了提升讀寫性能，建議各基礎服務的數據目錄、安裝目錄、存儲數據的數據目錄相互獨立。 取值：只能包含字母、數字、漢字和特殊字符(~ ! @ $ ( ) _ + - ; . :)。默認目錄為安裝目錄。 | 否 |
請求示例
將mdm服務從服務器hblock_1遷移至服務器hblock_3。
PUT /rest/v1/system/server/hblock_1/migrate HTTP/1.1
Date: Thu, 4 Jul 2024 05:50:03 GMT
Content-Type: application/json
Authorization: HBlock userName:signature
Connection: keep-alive
Content-Length: 59
Host: 192.168.0.110:1443
{
"destServerId": "hblock_3",
"service": "mdm"
}響應示例
HTTP/1.1 202 Accepted
x-hblock-request-id: 81b9f9c90114466695f1a114a524c191
Content-Length: 0
Date: Thu, 4 Jul 2024 05:50:03 GMT
Connection: keep-alive
Server: HBlock
