[TOC] # 管理 OBServer 節點狀態 OceanBase 數據庫提供了命令行方式來管理 OBServer 的節點狀態 在運維操作中，如果需要替換節點、維修節點或者對節點進行診斷，可以通過`STOP SERVER`命令將該節點的分區 Leader 切到其他節點上。然后該 Server 狀態將變為`stopped`并且不會對外提供服務。 節點的`stopped`狀態并非等價于進程退出，進程可能仍然在運行，僅僅是集群的狀態標志認為該節點為`stopped`狀態。同理與之對應的是節點的`started`狀態。 ## **Start Server 操作** Start Server 操作對應 Stop Server 操作。當集群中的 OBServer 啟動后，默認狀態是`started`。在執行 Stop Server 操作后，需要通過 Start Server 操作將 Server 狀態置為`started`。Start Server 操作的命令如下所示： ~~~ ALTER SYSTEM START SERVER 'ip:port' [,'ip:port'…] [ZONE='zone'] ~~~ 示例語句如下所示： ~~~ obclient> ALTER SYSTEM START SERVER "10.10.10.1:2882" ~~~ ## **Stop Server 操作** Stop Server 操作的目的是將該 Server 上的分區 Leader 切到其他節點。當該 Server 上沒有分區 Leader 的情況下，系統將內部標記 Server 為`stopped`狀態，客戶端請求不會再次發送到該 Server，該 Server 也不會再對外提供服務。 Stop Server 操作通常是特殊運維操作時執行，比如機器硬件維修、替換和升級，或者對該 Server 進行診斷等而進行的動作。Stop Server 操作的命令如下所示： ~~~ ALTER SYSTEM STOP SERVER 'ip:port' [,'ip:port'…] [ZONE='zone'] ~~~ 示例語句如下所示： ~~~ obclient> ALTER SYSTEM STOP SERVER "10.10.10.1:2882" zone='z1' ~~~ ## **Add Server 操作** Add Server 操作的目的是添加節點到集群，該操作是運維擴容的操作。被添加的新節點要求是空的，即 CLog 和 ILog 目錄下為空。Add Server 操作的命令如下所示： ~~~ ALTER SYSTEM ADD SERVER 'ip:port' [,'ip:port'…] [ZONE [=] 'zone'] ~~~ 示例語句如下所示： ~~~ obclient> ALTER SYSTEM ADD SERVER "10.10.10.1:2882" zone='z1' ~~~ ## **Delete Server 操作** Delete Server 用于從集群中刪除節點。Delete Server 操作的命令如下所示： ~~~ ALTER SYSTEM DELETE SERVER 'ip:port' [,'ip:port'…] [ZONE [=] 'zone'] ~~~ 示例語句如下所示： ~~~ obclient> ALTER SYSTEM DELETE SERVER "192.168.100.1:2882" zone='z1' ~~~ ## **Cancel Delete Server 操作** Delete Server 的動作會涉及到負載均衡。被刪除的 Server 上的資源單元會在同一個 Zone 中進行資源單元（Unit）遷移。Unit 的遷移動作是 Unit 自動均衡過程由 RootService 控制。Unit 均衡過程中可能發生資源不足，其他同 Zone 的機器資源不足容納這個新遷移的 Unit。這樣將導致 Unit 遷移失敗，通過`/home/admin/oceanbase/log/rootservice.log`可以看到遷移 Unit 失敗的錯誤代碼 -4624。如果希望取消 Delete Server 動作，可以通過 Cancel Delete Server 操作實現。 Cancel Delete Server 操作的命令如下所示： ~~~ ALTER SYSTEM CANCEL DELETE SERVER 'ip:port' [,'ip:port'…] [ZONE [=] 'zone'] ~~~ 示例語句如下所示： ~~~ obclient> ALTER SYSTEM CANCEL DELETE SERVER "10.10.10.1:2882" zone='z1' ~~~ ## 操作限制說明 對節點執行操作時： * 不能跨 Zone 執行 Stop Server 操作，同一個 Zone 可以同時 Stop 多個 Server。 * 一個 Stop 操作發起沒有結束前，不能發起第二個操作。 * `enable_auto_leader_switch`參數必須設置為開啟。 * 分區副本滿足多數派。 * 如果分區數多，或者被 Stop Server 的節點分區的 Leader 數量多， Alter System Stop Server 操作時間會比較長，如果超時，可以加大 SQL 超時時間。 * 如果命令很快失敗，那么可能是日志不同步。 * 檢查`__all_rootservice_event_history`可以確認是否有 Stop Server 動作。 * Stop Server 后該 Server 的狀態仍為`Active`，但`stop_service_time`的值由 0 變為 Stop Server 的時間點。