Cockpit ist eine Applikation von cockpit-project.org zur Konfiguration von Linux-Servern. Es bietet eine anwenderfreundliche grafische Oberfläche, die es authentifizierten Benutzern ermöglicht, über eine sichere Verbindung beliebige Konfigurationen und Befehle auf einem Gerät auszuführen. Netzwerkkonfiguration, Benutzerverwaltung, Status- und Log-Ansichten können über einen Browser verwaltet werden. Cockpit, auch Web Konsole genannt, ist ein von Red Hat gesponsertes Open-Source-Softwareprojekt, das unter der GNU Lesser General Public License (LGPL) veröffentlicht wird.

Cockpit für Revolution Pi steht ab dem RevPi Bookworm Image zur Verfügung und ersetzt die bis zum RevPi Bullseye Image verwendete Applikation RevPi Status, auch Webstatus genannt.

Neben der Standard-Serverkonfiguration stehen die Plugins Revolution Pi und Node-RED zur Verfügung. Diese ermöglichen die Konfiguration deines RevPi Basismoduls und ein einfaches Aktivieren bzw. Deaktivieren der installierten Dienste.

Die Modulkonfiguration eines Revolution Pi Systems, also eines RevPi Basismoduls mit Erweiterungsmodulen, erfolgt über die Applikation PiCtory oder ggf. direkt in der Entwicklungsumgebung, z. B. über CODESYS.

Cockpit starten #

✓ RevPi Bookworm Image oder höher ist auf dem RevPi installiert.

▷ Stelle eine Netzwerkverbindung zwischen dem RevPi und deinem PC her.

▷ Öffne einen Webbrowser.

▷ Rufe Cockpit über den Webbrowser mit revpi[Seriennummer].local auf
Die Seriennummer des RevPi findest du auf der Gehäusevorderseite neben dem QR-Code.
Alternativ kannst du die IP-Adresse des RevPi in den Webbrowser eingeben.

❯ Ggf. erscheint im Browser die Warnung NET::ERR_CERT_AUTHORITY_INVALID.

▷ Akzeptiere die Sicherheitsausnahme, um mit dem Login fortzufahren.

❯ Der Login-Bildschirm für Cockpit erscheint.

▷ Melde dich mit Benutzernamen pi und dem Gerätepasswort an.
Das Gerätepasswort findest du auf dem Aufkleber an der Gehäuseseite des RevPi.

❯ Cockpit öffnet sich im Modus Limited access.

▷ Wähle Limited access in der oberen Hauptnavigationsleiste, um auf den Modus Administrative access umzustellen.

❯❯ Mit den erhöhten Rechten des administrativen Zugangs kannst du nun den RevPi konfigurieren.

Konfiguration #

▷ Wähle im Cockpit-Menü RevPi Configuration.

RevPi Apps #

RevPi Apps sind auf dem RevPi verfügbare Anwendungen.

  • PiCtory ist eine RevPi Applikation zur Modulkonfiguration deines Revolution Pi Systems, d. h. für ein RevPi Basismodul mit Erweiterungsmodulen, siehe: PiCtory.

  • Node-RED ist ein grafisches, flow-basiertes Tool zum Verbinden von Geräten und Automatisieren von Arbeitsabläufen, siehe Node-RED.

Runtimes #

RevPiPyLoad ist eine Python-basierte Laufzeitumgebung für RevPi. Die Laufzeitumgebung verwaltet industrielle Automatisierungsaufgaben in Echtzeit und führt benutzerdefinierte Python-Skripte aus.

▷ Aktiviere RevPiPyLoad, wenn Du benutzerdefinierte Python-Skripte auf Deinem RevPi ausführen möchtest.

Note

Stelle vor der Aktivierung der Runtime sicher, dass alle Skripte kompatibel mit RevPiPyLoad sind.

Siehe auch:

System Configuration #

Boot to GUI #

Im Desktop-Betrieb kannst du als Alternative zum Terminal den RevPi direkt in eine grafische Benutzeroberfläche (GUI) booten lassen.

  • Die grafische Benutzeroberfläche benötigt mehr RAM und Rechenleistung als ein Terminal.

  • Empfohlen für Benutzer, die mit den Kommandos in Befehlszeilen nicht vertraut sind.

Swap / page file #

Der Swap-Auslagerungsspeicher fungiert als virtueller RAM. RAM-Daten werden im permanenten Speicher eMMC gespeichert.

▷ Aktiviere Swap, um bei ausgelastetem RAM Systemabstürze zu vermeiden.

▷ Deaktivie Swap, wenn die Auslagerung die Performance verlangsamt.

Avahi (ZeroConf) #

Avahi ermöglicht ZeroConf-Netzwerke, wodurch Netzwerkdienste automatisch erkannt werden können.

  • Zugriff auf das Gerät über hostname.local anstelle einer IP-Adresse.

  • Automatische Erkennung von Druckern und Dateifreigaben.

Note

Du kannst Avahi nicht deaktivieren, während der RevPi über eine Avahi-Adresse (.local) mit Cockpit verbunden ist. Verwende zum Deaktivieren eine Verbindung über ein Terminal oder verbinde Cockpit über die IP-Adresse des Geräts.

Set clock from NTP-Server #

Synchronisiert die Systemzeit des RevPi mit einem NTP-Server.

  • Gewährleistet genaue Zeitstempel für Protokolle und geplante Aufgaben.

  • Verhindert Zeitabweichungen auf Geräten ohne Real-Time-Clock.

Für die Synchronisierung mit NTP-Servern ist eine aktive Internetverbindung erforderlich.

SSH daemon #

Der SSH-Daemon verwaltet die SSH-Verbindungen mit deinen RevPi.

▷ Aktiviere SSH, um einen Fernzugriff auf den RevPi über ein Netzwerk zu ermöglichen.

▷ Verwende sichere Passwörter oder eine SSH-Schlüsselauthentifizierung.

▷ Verwende ssh pi@revpi[Seriennummer].local, um eine Verbindung über SSH herzustellen.

▷ Deaktiviere SSH, wenn kein Fernzugriff erforderlich ist.

WLAN and BT #

Konfiguration des integrierten Wireless-Moduls. Gilt für:

WLAN #

▷ Aktiviere den Schalter für WLAN.

▷ Wähle den korrekten WLAN-Ländercode für das Land, in dem das Gerät verwendet wird.

  • Durch die Einstellung des richtigen Landes werden Verbindungsprobleme vermieden und die Netzwerkzuverlässigkeit verbessert.

  • In verschiedenen Ländern sind unterschiedliche WLAN-Kanäle und Signalstärken zulässig.

▷ Wähle die verwendete Antenne für die drahtlose Verbindung aus.

  • External antenna (SMA): Eine externe Antenne verbessert den Signalempfang in schwierigen Umgebungen. Verbinde dazu eine RP-SMA-WLAN-Antenne mit der RP-SMA-Buchse am RevPi.

  • Internal antenna: Verwendet die integrierte Antenne.

▷ Starte den RevPi neu.

❯❯ Das WLAN ist aktiviert.

Im Anschluss kannst du die WLAN-Verbindung über nmtui einrichten.

▷ Deaktiviere das WLAN, um den Stromverbrauch zu senken und die Sicherheit zu erhöhen.

BT #

▷ Aktiviere BT, um Bluetooth-Peripheriegeräte wie Tastaturen oder Audiogeräte mit dem RevPi verbinden zu können.

▷ Deaktiviere BT, um den Stromverbrauch zu senken und die Sicherheit zu erhöhen.

Accounts und Gerätepasswort verwalten #

Verwende die Cockpit-Benutzerverwaltung, um das RevPi Gerätepasswort zu ändern oder weitere Accounts anzulegen.

▷ Öffne das Cockpit-Menü Accounts.

▷ Öffne das Drei-Punkte-Menü ⁝ hinter Benutzer pi und wähle Edit user.

▷ Wähle Set password.

▷ Gib das neue Passwort zweimal ein und bestätige mit Set password.

❯❯ Das Gerätepasswort für Benutzer pi ist geändert.

Important

Die Benutzer pi oder root auf keinen Fall löschen, sonst ist ein Login nicht mehr möglich.

Sprache für Cockpit ändern #

Die folgende Sprachen sind für die Cockpit RevPi Applikationen verfügbar:

  • Englisch

  • Deutsch

▷ Öffne das Dropdown-Menü Sessions in der oberen Hauptnavigationsleiste.

▷ Wähle Display language, um die Sprache für Cockpit zu ändern.

Node-RED #

Node-RED ist ein grafisches, flow-basiertes Tool zum Verbinden von Geräten und Automatisieren von Arbeitsabläufen. Mit der RevPi Nodes Laufzeitumgebung können spezifische Knoten im Node-RED Editor für die Ein- und Ausgänge des RevPi verwendet werden.

Pakete für Node-RED installieren #

▷ Öffne das Cockpit-Menü Revolution Pi.

▷ Wähle für die RevPi App Node-RED Install, um die Pakete revpi-nodered und noderedrevpinodes-server zu installieren.

▷ Wähle Configure, um ins Cockpit-Menü Node-RED zu wechseln.

Node-RED starten #

Das Cockpit-Menü Node-RED ermöglicht über die integrierte Benutzerverwaltung einen sicheren authentifizierten Zugriff auf den Node-RED Editor.

▷ Öffne das Cockpit-Menü Node-RED.

Der farbige Punkt zeigt den Status des Node-RED Dienstes an:

  • rot: Dienst inaktiv

  • gelb: Dienst wird initialisiert

  • grün: Dienst aktiv

▷ Erstelle einen oder mehrere Node-RED Benutzer mit einem sicheren Passwort und einer Rolle (Lesen oder Alle Zugriffsrechte).

  • Alle Node-RED Benutzer haben Zugriff auf dieselbe Node-RED Arbeitsumgebung deines RevPi.

  • Die angelegten Node-RED Benutzer sind unabhängig von den Accounts und Benutzern deines Revolution Pi Systems.

▷ Wähle Apply Settings.

▷ Aktiviere den Hauptschalter oben rechts, um den Node-RED Dienst zu initialisieren.

▷ Wähle Open Node-RED oder verwende die App-URL, um den Node-RED Editor aufzurufen.

Important

Du kannst Node-RED ohne Authentifizierung verwenden, jedoch kann dann jeder mit Netzwerkzugriff auf deinen RevPi auch auf den Node-RED Editor zugreifen.

Siehe auch:

Expert Mode #

Der Experten-Modus ermöglicht die direkte Bearbeitung der Node-RED settings.js über den integrierten Code-Editor.

Important

  • Fehlerhafte Änderungen an der settings.js können den korrekten Start von Node-RED verhindern.

  • Die Optionen uiHost und uiPort nicht verändern, da sie extern verwaltet werden.

Falls erforderlich, verwende Load Node-RED defaults, um die Standardversion der settings.js wieder herzustellen.

Änderungen im Code-Editor bleiben beim Verlassen des Experten-Modus erhalten.

RevPi Nodes Runtime #

Mit der RevPi Nodes Laufzeitumgebung können Knoten im Node-RED Editor verwendet werden, die auf die Ein- und Ausgänge deines Revolution Pi Systems angepasst wurden. Die Laufzeitumgebung ist automatisch aktiviert, da sie für die Verwendung dieser speziellen Knoten in Node-RED erforderlich ist.

RevPi neu starten #

▷ Öffne das Cockpit-Menü Overview.

▷ Wähle Reboot oben rechts.

▷ Wähle unter Delay eine Verzögerung für den Neustart.

▷ Wähle Reboot.

❯ Der RevPi wird heruntergefahren und startet neu. Die Power-LED blinkt rot.

❯ Die Power-LED leuchtet grün, sobald der RevPi betriebsbereit ist.

▷ Wähle Reconnect und logge dich neu ein.

RevPi herunterfahren #

▷ Öffne das Cockpit-Menü Overview.

▷ Öffne das Dropdown-Menü neben Reboot und wähle Shutdown.

▷ Wähle unter Delay eine Verzögerung für das Herunterfahren.

▷ Wähle Shutdown.

❯❯ Der RevPi wird heruntergefahren und die Verbindung zu Cockpit getrennt.

Um den RevPi jetzt wieder zu starten, muss die Spannungsversorgung unterbrochen und neu angeschlossen werden.

Terminal öffnen #

▷ Wähle im Cockpit-Menü Terminal.

❯❯ Es öffnet sich ein integriertes, voll funktionsfähiges Terminal, über das Befehle direkt eingegeben werden können.

Updates installieren #

▷ Öffne das Cockpit-Menü Software updates.

▷ Wähle Check for updates (Pfeil) oben rechts.

▷ Wähle Install all updates, um die verfügbaren Updates durchzuführen.

▷ Starte den RevPi neu.

Alternativ Updates über das Terminal installieren:

▷ Wähle im Cockpit-Menü Terminal.

▷ Gib folgenden Befehl ein, um alle verfügbaren Paketlisten einzulesen und zu aktualisieren:

sudo apt update

▷ Gib folgenden Befehl ein, um alle verfügbaren Updates zu installieren:

sudo apt upgrade

▷ Starte den RevPi neu.

Netzwerkinformationen abrufen #

▷ Öffne das Cockpit-Menü Networking, um Netzwerkinformationen wie IP-Adresse und Netzwerknamen abzurufen.

Siehe auch: Statische IP-Adresse vergeben.

SOS-Report erstellen #

Der SOS-Report sammelt Systeminformationen, die bei der Diagnose von Problemen helfen können. Diese Informationen werden nur auf dem System gespeichert und können im Anschluss heruntergeladen werden.

▷ Öffne das Cockpit-Menü Diagnostic reports.

▷ Wähle Run report.

▷ Definiere ein Report label als Name für den Report und ggf. ein Passwort (Encryption passphrase).

▷ Wähle Run report.

❯ Ein SOS-Report wird erstellt.

▷ Wähle Download, um den SOS-Report herunterzuladen.