マスタープラグインのアップグレード

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 が構成されていること、および sseapi_username と sseapi_password が /etc/salt/master.d/raas.conf でコメントアウトされていることを確認してください。
```
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
```

これで、アップグレードプロセスが完了しました。その他のエラーが発生する場合は、トラブルシューティングページを参照するか、サポートに連絡してください。