Upgrade des Master-Plug-Ins

Nachdem Sie das Upgrade des RaaS-Knotens erfolgreich durchgeführt haben, können Sie anschließend alle Salt-Master aktualisieren, die das Master-Plug-In verwenden, um eine Verbindung zu SaltStack Config herzustellen.

Hinweis:

Stellen Sie vor dem Upgrade des Salt-Masters bzw. der Salt-Master sicher, dass die pip3-Anwendung auf den Salt-Mastern installiert ist. Wenn Sie ein Upgrade von der neuesten Version des Master-Plug-Ins durchführen, ist diese Anwendung bereits installiert.

So führen Sie ein Upgrade des Master-Plug-Ins auf einem Salt-Master durch:

Beenden Sie den Dienst salt-master mit dem folgenden Befehl:
```
sudo systemctl stop salt-master
```
Überprüfen Sie, welche Version von Python auf dem Salt-Master ausgeführt wird. Wenn Python 3.6 oder höher ausgeführt wird, sind keine Änderungen erforderlich. Löschen Sie andernfalls die vorherige Version des SSEAPE-Moduls. (SSEAPE ist das SaltStack Config-Plug-In für den Salt-Master). Beispiel:
RHEL/CentOS
```
sudo rm -rf /usr/lib/python3.6/site-packages/SSEAPE*
```
Ubuntu
```
sudo rm /usr/lib/python3.6/dist-packages/SSEAPE*
```
Führen Sie ein Upgrade des Master-Plug-Ins durch, indem Sie das aktualisierte Python-Wheel manuell installieren. Verwenden Sie die folgenden Beispielbefehle, ersetzen Sie dabei den genauen Namen der Wheel-Datei:
RHEL/CentOS
```
sudo pip3 install SSEAPE-file-name.whl --prefix /usr
```
Ubuntu
```
sudo pip3 install SSEAPE-file-name.whl
```
Hinweis:
Einige Benutzer müssen möglicherweise die Syntax für ihre Betriebssysteme in pip3.6 oder pip36 ändern.
Aktualisieren Sie die API (RaaS)-Modulpfade, indem Sie die /etc/salt/master.d/eAPIMasterPaths.conf-Datei bearbeiten, um die Pfade zu den verschiedenen Modulen zu referenzieren. Sie können z. B. alle python2.7-Referenzen in dieser Datei ändern auf python3.6 ändern.
Hinweis:
Je nachdem, wie Sie SaltStack Config installiert haben, können sich die eAPI Salt-Master-Pfade stattdessen in der /etc/salt/master.d/raas.conf-Datei befinden.
Überprüfen Sie den engines-Abschnitt in /etc/salt/master.d/raas.conf, um zu bestätigen, dass er den folgenden Bedingungen entspricht:
```
engines:
  - sseapi: {}
  - eventqueue: {}
  - rpcqueue: {}
  - jobcompletion: {}
  - keyauth: {}
```
Hinweis:
Wenn ein Problem aufgetreten ist, müssen Sie möglicherweise Ihre Sicherungen der Dateien /etc/salt/master.d/raas.conf und /etc/salt/master.d/eAPIMasterPaths.conf wiederherstellen.
Stellen Sie bei Verwendung der Salt-Master-Schlüsselauthentifizierung (empfohlen) sicher, dass sseapi_pubkey_path konfiguriert ist und sseapi_username und sseapi_password in /etc/salt/master.d/raas.conf auskommentiert wurden.
```
sseapi_pubkey_path: /etc/salt/pki/master/sseapi_key.pub

#sseapi_username:
#sseapi_password:
```
Überprüfen Sie, ob für die Einträge master_job_cache und event_return die Einstellung sseapi festgelegt wurde. Der pgjsonb-Returner ist nicht mehr verfügbar.
Starten Sie den Dienst salt-master mit dem folgenden Befehl:
```
sudo systemctl start salt-master
```

Der Upgrade-Prozess ist jetzt abgeschlossen. Wenn weitere Fehler auftreten, informieren Sie sich bitte auf der Seite Fehlerbehebung oder wenden Sie sich an den Support.