升級主節點外掛程式

成功升級 RaaS 節點後，可以接著升級使用主節點外掛程式連線至 SaltStack Config 的任何 Salt 主節點。

備註：

升級 Salt 主節點之前，請確保 Salt 主節點上已安裝 pip3 應用程式。如果您要從最新版本的主節點外掛程式升級，則已安裝此應用程式。

在 Salt 主節點上升級主節點外掛程式：

使用下列命令停止 salt-master 服務：
```
sudo systemctl stop salt-master
```
檢查 Salt 主節點上正在執行哪個版本的 Python。如果執行的是 Python 3.6 或更高版本，則不需要進行變更。否則，請刪除先前版本的 SSEAPE 模組。(SSEAPE 是 Salt 主節點的 SaltStack Config 外掛程式)。例如：
RHEL/CentOS
```
sudo rm -rf /usr/lib/python3.6/site-packages/SSEAPE*
```
Ubuntu
```
sudo rm /usr/lib/python3.6/dist-packages/SSEAPE*
```
手動安裝更新的 Python wheel 以升級主節點外掛程式。使用以下範例命令，取代 wheel 檔案的確切名稱：
RHEL/CentOS
```
sudo pip3 install SSEAPE-file-name.whl --prefix /usr
```
Ubuntu
```
sudo pip3 install SSEAPE-file-name.whl
```
備註：
某些使用者可能需要將其作業系統的語法更改為 pip3.6 或 pip36。
透過編輯 /etc/salt/master.d/eAPIMasterPaths.conf 檔案以參考各個模組的路徑，進而更新 API (RaaS) 模組路徑。例如，可以將此檔案中的所有 python2.7 參考變更為 python3.6。
備註：
根據最初安裝 SaltStack Config 的方式，eAPI Salt 主節點路徑可能改為位於 /etc/salt/master.d/raas.conf 檔案中。
檢查 /etc/salt/master.d/raas.conf 中的 engines 區段，確認其是否符合下列內容：
```
engines:
  - sseapi: {}
  - eventqueue: {}
  - rpcqueue: {}
  - jobcompletion: {}
  - keyauth: {}
```
備註：
如果發生問題，可能需要還原 /etc/salt/master.d/raas.conf 和 /etc/salt/master.d/eAPIMasterPaths.conf 檔案的備份。
如果使用的是 salt 主節點金鑰驗證 (建議)，請確保已設定 sseapi_pubkey_path 並在 /etc/salt/master.d/raas.conf 中註釋掉 sseapi_username 和 sseapi_password。
```
sseapi_pubkey_path: /etc/salt/pki/master/sseapi_key.pub

#sseapi_username:
#sseapi_password:
```
確認 master_job_cache 和 event_return 項目是否設定為 sseapi。pgjsonb 傳回程式無法再使用。
使用下列命令啟動 salt-master 服務：
```
sudo systemctl start salt-master
```

升級程序現已完成。如果遇到任何其他錯誤，請參閱疑難排解頁面或連絡支援。