The AI-Native Device Platform
User Manual

awaBerry | Bestehendes Gerät hinzufügen - LINUX

Ein bestehendes Linux-Gerät zu awaBerry hinzufügen. Installations- und Initialisierungsanleitung für Debian, Ubuntu und andere Linux-Distributionen.

Vorhandenes Gerät hinzufügen - LINUX

Zusammenfassung

Die Seite 'Vorhandenes Gerät hinzufügen - LINUX' ist der Ausgangspunkt für die Integration Ihres Linux-basierten Geräts in das awaBerry-System. Dieser mehrstufige Prozess gewährleistet eine sichere und funktionale Verbindung. Sie beginnen damit, Ihrem Gerät einen eindeutigen Namen zuzuweisen, gefolgt von Anweisungen auf dem Bildschirm zur Vorbereitung Ihrer Linux-Maschine, einschließlich der Überprüfung oder Installation von OpenSSH. Entscheidend ist, dass Sie spezifische Befehle von dieser Seite kopieren, um sie im Terminal Ihres Geräts auszuführen und die Installation der awaBerry-Client-Software zu initiieren. Das System wartet dann darauf, dass Ihr Gerät seinen Online-Status meldet, was schließlich zu einer erfolgreichen Verbindung und Bereitschaft für die Fernverwaltung führt.

Seitenaufruf

Sie können diese Seite aufrufen, indem Sie zu folgendem navigieren: /connect_steps_existing?os=linux

Seitenfunktionen

  • Linux-Einrichtungsanforderungen-Box: Dieser Abschnitt enthält wichtige Informationen und Befehle zur Vorbereitung Ihres Linux-Geräts.
    • Prüfen, ob OpenSSH läuft: Zeigt einen Befehl (sudo systemctl status ssh) an, um zu überprüfen, ob OpenSSH auf Ihrem Linux-System aktiv ist. Eine Kopieroption ist zur Bequemlichkeit vorhanden.
    • OpenSSH installieren (falls noch nicht installiert): Bietet einen Befehl (sudo apt-get update && sudo apt-get install -y openssh-server openssh-client && sudo systemctl start ssh && sudo systemctl enable ssh) zur Installation und Aktivierung von OpenSSH. Eine Kopieroption ist vorhanden.
  • Eingabefeld für Gerätenamen: Ein Textfeld, in das Sie einen eindeutigen Namen für Ihr neues awaBerry-Gerät eingeben. Dieser Name hilft bei der Identifizierung Ihres Geräts im awaBerry-Portal.
    • Validierung: Das System stellt sicher, dass der Name mindestens 3 Zeichen lang ist und nicht bereits von einem anderen Ihrer Geräte verwendet wird.
  • Installer-URL-Befehl: Ein Befehl (curl $urlSoftwareDownload/data/software/awaberrybaseinstaller/install.sh -o install.sh) zum Herunterladen des awaBerry-Installer-Skripts. Sie können diesen Befehl einfach in Ihre Zwischenablage kopieren und in das Terminal Ihres Geräts einfügen.
  • Installer-Startbefehl: Ein Befehl (sudo chmod +x install.sh && sudo ./install.sh) zur Ausführung des heruntergeladenen Installer-Skripts. Dies hat ebenfalls eine Kopieroption für die Verwendung in Ihrem Terminal.
    • Hinweis: Der Installer benötigt Root-Rechte, was bedeutet, dass Sie ihn mit sudo ausführen müssen.
  • Anzeige und Kopieren der Geräte-ID: Nach Eingabe eines Gerätenamens zeigt dieser Abschnitt eine eindeutige Geräte-ID an, die für Ihr Gerät generiert wurde. Sie müssen diese ID kopieren und in den awaBerry-Installer einfügen, der in Ihrem Terminal läuft.
  • Warten auf Geräte-Online-Status: Sobald der Installer läuft und die Geräte-ID eingegeben wurde, zeigt dieser Abschnitt eine Fortschrittsanzeige an, die darauf hinweist, dass awaBerry darauf wartet, dass Ihr Gerät online geht und seinen Status meldet.
    • Timeout: Wenn das Gerät nicht innerhalb weniger Minuten online geht, erscheint eine Fehlermeldung mit der Option 'Erneut versuchen'.
  • Details zur erfolgreichen Verbindung: Nach erfolgreicher Verbindung bestätigt dieser Abschnitt die Verbindung, zeigt grundlegende Geräteinformationen (wie IP-Adresse und Speicher) an und zeigt eine Fortschrittsanzeige für die abschließenden Konfigurationsschritte.
  • Weiter-Schaltfläche: Bringt Sie zum nächsten Schritt im Verbindungsprozess, nachdem ein Gerätename angegeben wurde oder nachdem die Geräte-ID angezeigt wurde.
  • Zurück-Schaltfläche: Ermöglicht Ihnen, zum vorherigen Schritt im Verbindungsprozess zurückzukehren.
  • Fehlermeldungsbereich: Wenn Probleme auftreten (z. B. ungültiger Gerätename, Netzwerkprobleme, Gerät geht nicht online), werden hier entsprechende Fehlermeldungen angezeigt.

Szenarioausführungen

Mögliche Nutzungsschritte auf dieser Seite

Szenario 1: Erfolgreiche Geräteverbindung (Neuer Gerätename)

  1. Schritt 1: Gerätenamen eingeben. Suchen Sie auf der Seite "Vorhandenes Gerät hinzufügen - LINUX" das Textfeld "Geben Sie den Namen des Geräts an". Geben Sie einen eindeutigen und beschreibenden Namen für Ihr Linux-Gerät ein (z. B. "HomeServer-Linux").
  2. Schritt 2: Weiter. Klicken Sie auf die Schaltfläche "Weiter". Das System validiert den Namen und generiert eine eindeutige Geräte-ID.
  3. Schritt 3: Geräte-ID kopieren. Der nächste Bildschirm zeigt Ihre generierte Geräte-ID an. Klicken Sie auf die Geräte-ID, um sie automatisch in Ihre Zwischenablage zu kopieren.
  4. Schritt 4: Installer auf Gerät ausführen. Öffnen Sie ein Terminal auf Ihrem Linux-Gerät.
    • Kopieren Sie zuerst den auf der awaBerry-Seite angegebenen "Installer-URL-Befehl" (z. B. curl ... install.sh -o install.sh) und fügen Sie ihn in Ihr Terminal ein, dann drücken Sie Enter. Dies lädt das Installer-Skript herunter.
    • Kopieren Sie anschließend den "Installer-Startbefehl" (z. B. sudo chmod +x install.sh && sudo ./install.sh) und fügen Sie ihn in Ihr Terminal ein, dann drücken Sie Enter. Dies startet den awaBerry-Installer.
    • Wenn Sie vom Installer in Ihrem Terminal dazu aufgefordert werden, fügen Sie die in Schritt 3 kopierte Geräte-ID ein und drücken Sie Enter.
  5. Schritt 5: Auf Verbindung warten. Kehren Sie zur awaBerry-Webseite zurück. Dort wird die Meldung "Warte auf Gerät" mit einer Fortschrittsanzeige angezeigt. Das System wartet nun darauf, dass Ihr Gerät seinen Online-Status meldet.
  6. Schritt 6: Verbindung erfolgreich. Sobald Ihr Gerät erfolgreich verbunden ist und seinen Online-Status meldet (dies kann ein oder zwei Minuten dauern), wird die Seite zu "Geräteverbindung erfolgreich" aktualisiert, zeigt Geräteinformationen wie IP und Speicher an und fährt mit der Gerätekonfiguration fort.

Szenario 2: Erfolgreiche Geräteverbindung (Vorkonfiguriertes OpenSSH)

  1. Schritt 1: Linux-Einrichtungsanforderungen prüfen. Bevor Sie einen Gerätenamen eingeben, überprüfen Sie die Box "Linux-Einrichtungsanforderungen". Wenn OpenSSH auf Ihrem Linux-Gerät bereits installiert und aktiv ist (was Sie mit dem bereitgestellten Befehl sudo systemctl status ssh überprüfen können), können Sie fortfahren.
  2. Schritte 2-6: Folgen Sie Szenario 1. Fahren Sie mit den Schritten 2 bis 6 fort, wie in "Szenario 1: Erfolgreiche Geräteverbindung (Neuer Gerätename)" beschrieben.

Mögliche Fehler, die auf dieser Seite auftreten können

Fehler: Ungültiger Gerätename

Wie es passiert: Sie versuchen, einen Gerätenamen einzugeben, der zu kurz ist (weniger als 3 Zeichen). Zum Beispiel die Eingabe von "ab" anstelle von "mein-gerät".

Was Sie sehen: Unter dem Feld für den Gerätenamen erscheint eine Fehlermeldung wie "Mindestens 3 Zeichen".

Wie zu beheben: Geben Sie einen Gerätenamen ein, der 3 oder mehr Zeichen lang ist.

Fehler: Gerätename bereits in Verwendung

Wie es passiert: Sie versuchen, einen Gerätenamen zu verwenden, den Sie zuvor einem anderen Gerät in Ihrem awaBerry-Konto zugewiesen haben. Zum Beispiel, wenn Sie bereits ein Gerät namens "MeinRaspberryPi" haben und versuchen, diesen Namen erneut zu verwenden.

Was Sie sehen: Eine Fehlermeldung wird prominent über dem Feld für den Gerätenamen angezeigt, z. B. "Ein Gerät mit dem Namen [IhrGewählterName] existiert bereits. Bitte wählen Sie einen anderen Gerätenamen."

Wie zu beheben: Wählen Sie einen anderen, eindeutigen Namen für Ihr neues Gerät.

Fehler: Gerät geht nicht online (Timeout)

Wie es passiert: Nachdem Sie den Gerätenamen eingegeben, die Geräte-ID kopiert und die Installer-Befehle auf Ihrem Linux-Gerät ausgeführt haben, wechselt die awaBerry-Webseite in den Zustand "Warte auf Gerät". Wenn Ihr Linux-Gerät keine Verbindung zu awaBerry herstellt und seinen Online-Status innerhalb von etwa 4 Minuten (240 Sekunden) meldet, tritt ein Timeout-Fehler auf.

Was Sie sehen: Die Fortschrittsanzeige verschwindet, und eine Fehlermeldung wie "Gerät hat nach 4 Minuten keinen Online-Status gesendet." erscheint. Darunter werden die Meldung "Bitte überprüfen Sie die Installation im Terminal." und eine Schaltfläche "Erneut versuchen" angezeigt.

Wie zu beheben:

  1. Terminalausgabe prüfen: Überprüfen Sie die Ausgabe im Terminal Ihres Linux-Geräts, wo Sie den Installer ausgeführt haben. Suchen Sie nach Fehlermeldungen oder unerwartetem Verhalten.
  2. OpenSSH überprüfen: Stellen Sie sicher, dass OpenSSH korrekt installiert und auf Ihrem Linux-Gerät ausgeführt wird, wie im Abschnitt "Linux-Einrichtungsanforderungen" beschrieben.
  3. Netzwerkkonnektivität: Stellen Sie sicher, dass Ihr Linux-Gerät über eine aktive Internetverbindung verfügt und die awaBerry-Server erreichen kann.
  4. Installer erneut ausführen: Wenn Sie unsicher sind, können Sie versuchen, die Installer-Befehle auf Ihrem Linux-Gerät erneut auszuführen.
  5. Erneut versuchen: Klicken Sie auf der awaBerry-Webseite auf die Schaltfläche "Erneut versuchen", um den Warteprozess neu zu starten.

Navigate ← Add existing device - select operating system ← Add Device - how to connect ← Connect New Devices Mainpage ← awaBerry Device Management ← awaBerry User Manual Main Page