De masterplug-in upgraden

Nadat u het RaaS-knooppunt hebt geüpgraded, kunt u daarna alle Salt-masters upgraden die de masterplug-in gebruiken om verbinding te maken met SaltStack Config.

Opmerking:

Voordat u de Salt-master(s) upgradet, moet u ervoor zorgen dat de pip3-applicatie op de Salt-masters is geïnstalleerd. Als u upgradet vanaf de nieuwste versie van de masterplug-in, is deze applicatie al geïnstalleerd.

De masterplug-in op een Salt-master upgraden:

Stop de service salt-master opnieuw met het volgende commando:
```
sudo systemctl stop salt-master
```
Controleer welke versie van Python wordt uitgevoerd op de Salt-master. Als Python 3.6 of hoger wordt uitgevoerd, zijn er geen wijzigingen nodig. Anders verwijdert u de vorige versie van de SSEAPE-module. (De SSEAPE is de SaltStack Config-plug-in voor de Salt-master.) Bijvoorbeeld:
RHEL/CentOS
```
sudo rm -rf /usr/lib/python3.6/site-packages/SSEAPE*
```
Ubuntu
```
sudo rm /usr/lib/python3.6/dist-packages/SSEAPE*
```
Upgrade de masterplug-in door het bijgewerkte Python-wheelbestand handmatig te installeren. Gebruik de volgende voorbeeldcommando's en voeg hierbij de exacte naam van het wheelbestand in:
RHEL/CentOS
```
sudo pip3 install SSEAPE-file-name.whl --prefix /usr
```
Ubuntu
```
sudo pip3 install SSEAPE-file-name.whl
```
Opmerking:
Sommige gebruikers moeten mogelijk de syntaxis wijzigen in pip3.6 of pip36 voor hun besturingssystemen.
Werk de modulepaden van de API (RaaS) bij door het /etc/salt/master.d/eAPIMasterPaths.conf-bestand te bewerken om de paden te verwijzen naar de verschillende modules. U kunt bijvoorbeeld alle python2.7-verwijzingen in dit bestand wijzigen in python3.6.
Opmerking:
Afhankelijk van de manier waarop u SaltStack Config hebt geïnstalleerd, kunnen des eAPI Salt-masterpaden zich in plaats daarvan in het bestand /etc/salt/master.d/raas.conf bevinden.
Controleer het gedeelte engines in /etc/salt/master.d/raas.conf om te bevestigen dat het overeenkomt met het volgende:
```
engines:
  - sseapi: {}
  - eventqueue: {}
  - rpcqueue: {}
  - jobcompletion: {}
```
Opmerking:
Als er een probleem is opgetreden, moet u mogelijk uw back-ups van de bestanden /etc/salt/master.d/raas.conf en /etc/salt/master.d/eAPIMasterPaths.conf herstellen.
Controleer of de vermeldingen master_job_cache en event_return zijn ingesteld op sseapi. De pgjsonb-retourneerder is niet langer beschikbaar.
Start de service salt-master met het volgende commando:
```
sudo systemctl start salt-master
```

Het upgradeproces is nu voltooid. Als er andere fouten optreden, raadpleegt u de pagina Problemen oplossen of neemt u contact op met de helpdesk.