> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plasma.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrades

> Software-Updates, Konsens-Upgrades und Wartung

## Warum Upgrades wichtig sind

Plasmas Architektur entwickelt sich schnell weiter, um Hochdurchsatz, stablecoin-native Anwendungsfälle zu unterstützen. Zeitnahe Upgrades:

* Schützen vor Sicherheitslücken
* Verbessern die Performance für Zahlungs-Workloads
* Bewahren die Kompatibilität mit Plasmas Konsensschicht und RPC-Schnittstelle

Veraltete Nodes können Sync-Fehler, degradierte Performance oder Sicherheitsprobleme erfahren. Da Non-Validator-Nodes oft kritischen RPC-Verkehr für Zahlungsanwendungen bereitstellen, ist es essenziell, auf dem neuesten Stand zu bleiben.

<Note>
  Die meisten Non-Validator-Node-Upgrades erfordern 15–30 Minuten Ausfallzeit. Major-Releases, die neue Funktionen oder Konsensänderungen einführen, können längere Sync-Fenster erfordern.
</Note>

## Arten von Upgrades

<Columns cols={3}>
  <Card title="Sicherheitspatches" href="#security-patches">
    Kritische Korrekturen zum Schutz der Zahlungsinfrastruktur
  </Card>

  <Card title="Funktions-Updates" href="#feature-updates">
    Neue Fähigkeiten für Zahlungsanwendungen
  </Card>

  <Card title="Performance-Optimierungen" href="#performance-optimisations">
    Verbesserungen für die Verarbeitung großer Transaktionsmengen
  </Card>
</Columns>

### Sicherheitspatches

Sicherheitspatches beheben Schwachstellen in Non-Validator-Clients, Reth oder Abhängigkeiten.

**Beispiele:**

* Schwachstellen in State-Konsistenz oder Konsens-Desynchronisation
* Korrekturen bei RPC-Zugangskontrolle und Authentifizierung
* Updates kryptografischer Bibliotheken

Diese sollten sofort nach Veröffentlichung angewendet werden.

### Funktions-Updates

Funktions-Releases ermöglichen neue Protokollfähigkeiten oder unterstützen neue Anwendungsmuster.

**Beispiele:**

* Verbesserungen für gebührenfreie USD₮-Transfers
* Unterstützung benutzerdefinierter Gas-Tokens
* Neue oder erweiterte RPC-Methoden
* Optimierungen für State-Queries
* Verbesserungen bei Wallet- und Börsenintegrationen

### Performance-Optimierungen

Auf Performance ausgerichtete Releases verbessern Ausführungsgeschwindigkeit, Sync-Effizienz und Ressourcennutzung.

**Beispiele:**

* Schnellere Datenbank-Lese- und Schreibvorgänge
* Reduzierte RPC-Latenz unter Last
* Verbesserte Speicher- und CPU-Effizienz
* Verbesserungen bei der Konsens-Sync

## Upgrade-Verfahren

Upgrades von Non-Validator-Nodes umfassen typischerweise das Pullen eines neuen Docker-Images, das Aktualisieren von Konfigurationen und den Neustart des Dienstes.

<Steps>
  <Step title="Anwendungen benachrichtigen">
    Informieren Sie verbundene Dienste über die geplante Wartung.
  </Step>

  <Step title="Kompatibilität überprüfen">
    Stellen Sie sicher, dass die neuen Non-Validator-Client-Versionen mit den aktuellen Konsens-Endpunkten funktionieren.
  </Step>

  <Step title="Konfiguration aktualisieren">
    Wenden Sie alle neuen Konfigurationsoptionen für erweiterte Funktionen an. Achten Sie besonders auf Änderungen, die Unterstützung für benutzerdefinierte Gas-Tokens, gebührenfreie Transaktionsverarbeitung oder RPC-Schnittstellen für Zahlungsanwendungen betreffen.
  </Step>

  <Step title="RPC-Endpunkte testen">
    Überprüfen Sie nach dem Upgrade die Kompatibilität mit Zahlungsanwendungen.
  </Step>

  <Step title="Transaktionsverarbeitung überwachen">
    Stellen Sie den normalen Betrieb für USD₮-Transfers und Operationen mit benutzerdefinierten Gas-Tokens sicher.
  </Step>
</Steps>

<Tip>
  Wenn Sie mehrere Non-Validator-Nodes betreiben, deployen Sie Upgrades schrittweise. Beginnen Sie mit nicht-kritischen Instanzen, bevor Sie die primäre Zahlungsinfrastruktur aktualisieren, und überwachen Sie den zuerst aktualisierten Node sorgfältig, bevor Sie fortfahren.
</Tip>

## Verifizierung nach dem Upgrade

Überprüfen Sie nach dem Upgrade die vollständige Synchronisierung mit der Konsensschicht und validieren Sie die Kernfunktionalität.

<Check>**Konsens-Synchronisierung**: Die Blockhöhe stimmt mit dem Netzwerk überein</Check>
<Check>**RPC-Funktionalität**: Testen Sie Schlüssel-Endpunkte, die von Zahlungsanwendungen verwendet werden</Check>
<Check>**Performance-Baseline**: Vergleichen Sie Metriken nach dem Upgrade mit früheren Baselines</Check>
<Check>**Monitoring**: Validieren Sie, dass Monitoring- und Alerting-Systeme weiterhin funktionsfähig sind</Check>

<Tip>
  Dokumentieren Sie Konfigurationsänderungen und beobachtetes Verhalten. Das verbessert die Zuverlässigkeit für zukünftige Upgrades und Fehlerbehebung. Für häufige Probleme siehe den [Fehlerbehebungs-Leitfaden](./troubleshooting).
</Tip>

## Rollback-Verfahren

### Wann ein Rollback durchführen

Führen Sie einen Rollback durch, wenn Sie Folgendes beobachten:

* Konsens-Sync-Fehler
* Schwere Degradierung der RPC-Performance
* Inkompatibilität der Anwendung
* Sicherheitsregression
* Dateninkonsistenz, die Guthaben oder Transfers beeinträchtigt

### So führen Sie einen Rollback durch

<Steps>
  <Step title="Dienste stoppen">
    Stoppen Sie die Non-Validator-Node-Dienste.
  </Step>

  <Step title="Image und Konfiguration zurücksetzen">
    Setzen Sie auf das vorherige Docker-Image und die vorherige Konfiguration zurück.
  </Step>

  <Step title="Neu starten und neu synchronisieren">
    Starten Sie die Dienste neu und synchronisieren Sie sich erneut mit dem Netzwerk.
  </Step>

  <Step title="Funktionalität überprüfen">
    Testen Sie RPC-Endpunkte und Transaktionsfunktionalität erneut.
  </Step>

  <Step title="Teams benachrichtigen">
    Benachrichtigen Sie die Anwendungsteams über die Wiederherstellung.
  </Step>
</Steps>

## Bewährte Praktiken

### Automatisierung und Monitoring

* Automatisieren Sie Image-Pulls und Konfigurations-Updates, wo möglich
* Verfolgen Sie Änderungen mit versionskontrollierter Konfiguration
* Erweitern Sie die Observability während Upgrades
* Überwachen Sie RPC-Fehlerquoten, Sync-Status und Transaktionsdurchsatz nach Neustarts genau

## Häufige Fehlerbehebung

Wenn nach dem Upgrade Probleme auftreten:

* **Konsens-Sync**: Endpunktkonnektivität, Anmeldedaten und Allowlist-Status prüfen
* **RPC-Fehler**: Konfiguration, Versionskompatibilität und aktualisierte Schnittstellen validieren
* **Performance-Regression**: Ressourcennutzung überwachen und Release Notes prüfen

Das Upgrade von Plasma-Non-Validator-Nodes ist essenziell, um zuverlässige, sichere RPC-Infrastruktur für stablecoin-basierte Anwendungen aufrechtzuerhalten. Strukturierte Upgrade- und Validierungsverfahren minimieren das Risiko und gewährleisten reibungslose Performance.