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:

  1. Beenden Sie den Dienst salt-master mit dem folgenden Befehl:
    sudo systemctl stop salt-master
  2. Ü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*
  3. 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.

  4. 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.

  5. Ü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.

  6. 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:
  7. Ü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.
  8. 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.